概要:OneLink Smart Scriptをセットアップして、あらゆるソースからのモバイルウェブサイト訪問者をモバイルアプリユーザーに変え、属性を付けます。 注:必須ではありませんが、OneLink Smart Script V2 への移行をご検討ください。
設定方法
OneLink Smart Scriptには2つのバージョンがあります。
OneLink Smart Script V2(推奨):OneLink Smart Scriptを初めてセットアップする場合は、このバージョンを使用することをおすすめします。開発者の作業部分がより簡単になり、Google Tag Manager経由で設定することもできます。 注:必須ではありませんが、V2への移行をご検討ください。
OneLink Smart Script V1(旧仕様):すでにOnelink Smart Scriptを設定している場合は、このバージョンのドキュメントを使用して、このスクリプトを保守および編集してください。
作業担当者
|
作業担当者
|
|
前提条件
|
Webページにスクリプトを実装する方法:
パラメーター
スマートスクリプトを実装するためにディベロッパーに提供するパラメーター/値
| パラメーター/値 | 備考 | レスポンスを記録する (開発者向け) |
|---|---|---|
| oneLinkURL (必須) |
|
|
| pidKeysList (メディアソース) |
|
|
|
pidOverrideList |
|
|
|
pidStaticValue |
|
|
| campaignKeysList (キャンペーン) |
|
|
| campaignStaticValue |
|
|
| gclIdParam |
|
|
| skipList |
|
|
|
その他のクエリパラメーター |
|
使用事例
次のセクションでは、一般的なキャンペーン/メディアソースのシナリオについて、スマートスクリプトの使用事例ご紹介します。
Meta広告:クロスプラットフォームアトリビューション
Facebookは外部の計測リンクを使用しないSRNです。
AppsFlyerは、アプリの初回起動時に、ユーザーが以前(過去28日間)に広告に接触したことがあるかどうかをFacebookに問い合わせます。ユーザーがFacebook広告に接触していた場合、Facebookが自己へアトリビューションを行います。Meta広告はクロスプラットフォームにも対応しています。つまり、ユーザーは、あらゆるプラットフォーム上で、モバイルかどうかに関わらず、あらゆるタイプのキャンペーンと関連付け、Meta広告へアトリビューションできます。
アクション:skipListメソッドを使用して、Meta 広告用のスマートスクリプト(またはその他の任意の文字列)を無効にするように開発者に伝えてください。Meta 広告またはスキップリスト内のいずれかの文字列がクリックのHTTPリファラーに表示されると、スマートスクリプトが返されます。null
注:注意:2021年にiOS 14ユーザーで想定されているように、ユーザーがデバイスIDの共有をオプトアウトした場合、Facebookのクロスプロモーション計測に影響がある可能性があります。
Google Ads—GCLIDとUTMパラメーター
Google Adsキャンペーン (GCLIDパラメーターを含む) のインストール計測の通常のプロセスでは、クリックがアプリストアのページURLにリダイレクトする必要があります。
このケースでは、Google AdsからのリードをWeb/ランディングページにリダイレクトしているため、スクリプトはGoogle AdsインストールキャンペーンのURLからGCLIDパラメータを取得し、選択した送信パラメータ af_sub[1-5] に付与します。 注意これはインストールキャンペーンにも適用されます。ACIではない検索キャンペーンの場合、つまりリエンゲージメントキャンペーンの場合には、スマートスクリプトによるURLの発行に関係なく、Googleがメディアソースとして成果を紐付けられる場合があります。
前提条件: Googleダッシュボードで、自動タグ付けを有効にします。
自動タグ付けを有効にし、 URLにGCLIDパラメーターを含めます。
Google Adsのスクリプトを設定するには :
- 受信リンクにある、メディアソースとキャンペーンパラメーター名のリストを作成します。
例:utm_source と utm_campaign - GCLIDを含める送信URLでのパラメーターを選択します。
ベストプラクティス:af_sub[1-5]を選択すると、AppsFlyerのローデータレポートにデータが表示されます。 -
パラメーターリストをWebディベロッパーに提供します。
結果:
- Incomingリンク上のメディアソースとキャンペーンパラメータの値(utm_source と utm_campaign)は、Outgoingリンクのpid と c パラメーターの値を入力するために使用されます。
- Outgoing URL上では、GCLID は af_sub[1-5] パラメーターの値です。
Google Adsにこれらのインストールを通知する方法:
- CSV経由、またはPush API経由で、インストールごとにリアルタイムでパラメーターaf_sub[1-5]からGCLIDデータを取得します。
- 手動またはAdwords API経由で、GoogleにGCLIDデータをアップロードしてください。
注意
GoogleはこのGCLIDソリューションを公式にサポート及び推奨をしていません。GoogleがGCLIDパラメーターを廃止する場合は、当社が変更をサポートするようにスクリプトを変更します。この記事のヘッダーにあるフォローボタンをクリックしてこの記事をフォローすると、記事またはスクリプトが更新されたときに通知を受け取ることができます。
SRN、オウンドメディア、その他のメディアソースリンク
スナップチャットやX広告のようなSRNは、Google広告やMeta広告のようなクロスプラットフォームとは仕組みが異なります。これらのSRNのキャンペーンでは、ユーザーはウェブページまたはランディングページに誘導され、モバイルユーザーであるかどうかに関わらず、クリック数に基づいて課金されます。
これらのSRNでは、スクリプトの設定は、オウンドメディアまたは他のメディアソースからのリンクと同じです。
スクリプトの設定方法:
- 受信リンクにある、メディアソースとキャンペーンパラメーター名のリストを作成します。
-
パラメーターリストをWebディベロッパーに提供します。
SRNまたはメディアソースタイプは、受信URLのメディアソースの値であり、スクリプトはそれを見つけて、ウェブページまたはランディングページのダウンロードボタンの後ろにある、送信OneLink URLのmedia_sourceの値として使用します。OneLink上のpidを変更したい場合は、pid上書きリストに流入メディアソースの値と置き換えるpid値を提供します。
結果:結果 :これらの SRN/メディアソースの場合、リンク上のメディアソースおよびキャンペーンパラメーターの値を使用して、OneLink上の pid および c パラメーターの値を設定します。
例
流入URL: https://hotel.me/af_pid=twitter&af_c=big_social
OneLink URL: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social
AppsFlyer計測リンク
AppsFlyer計測リンクは、メディアソースがクリックアドネットワークの場合に使用されます。AppsFlyerでリンクを設定する場合、Webキャンペーンからアプリの計測のために、リダイレクトURLパス(af_r)パラメーターを希望のモバイルサイトへのURLパスと一緒に追加するオプションがあります。
結果:結果:af_r と af_redirect=true パラメーターが流入リンクに存在する場合、ランディングページのスクリプトは変化しません。Web/ランディングページ上のアプリストアへの直接リンクはそのまま維持されます。
例
流入URL: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_redirect=true&af_r=hotel.me
送信URL:同じ
デスクトップ
この記事のほとんどの使用事例は、モバイルデバイスから来るユーザーのものです。そのため、モバイルサイトからアプリストアに誘導されると、すぐにアプリをダウンロードすることができます。
ただし、デスクトップユーザーの場合、デバイス(デスクトップやパソコン)はモバイルアプリのダウンロードに対応していないため、すぐにアプリストアへ誘導されるべきではありません。
デスクトップユーザー向けのスクリプトの設定方法:
- OneLinkテンプレートにて、デスクトップでクリックされた場合のリンク先URLを設定します。このURLは、専用ウェブページまたはランディングページにリダイレクトする必要があります。ランディングページには、アプリのダウンロードリンクをSMSやメールで受信するためのフォームを追加することができます。必要に応じて、ウェブフォームを作成し、そのフォームのURLをスクリプトで提供することもできます。
結果:スクリプトは、ユーザーが使用しているデバイスまたはプラットフォームを検出します。デスクトップの場合は、スクリプトは送信OneLink URLを生成し、ユーザーを専用のウェブページまたはランディングページにリダイレクトします。
詳細はデスクトップからアプリへのコンバージョンをご参照ください。
制限事項
| 制限事項 | 備考 |
|---|---|
| タグマネージャー |
スマートスクリプトは、タグマネージャーでは実装することができません。Webからアプリへの代替アトリビューションソリューションとして、OneLinkスマートスクリプトV2またはスマートバナーをご覧ください。 |