概要:OneLink Smart Scriptを使用することで、あらゆる流入経路から入ってきたモバイルウェブサイトの訪問者をモバイルアプリへと転換し、成果として紐付けできるようになります。
LPへ遷移する広告などで、LP流入元の媒体へアトリビューションすることができます。
セットアップ
OneLink Smart Scriptには2つのバージョンがあります。
OneLink Smart Script V2(推奨):
初めてOneLink Smart Scriptを実装する場合は、このバージョンを使用してください。これは、開発者の支援がなくてもAppsFlyer管理画面上で実装用コードを生成できます。何らかの理由で開発者が必要な場合は、作業部分が簡単になります。また、Google Tag Manager (GTM) を使用して設定することもできます。(デベロッパー実装ガイドはこちら)
OneLink Smart Script V1(旧仕様) :
Onelink Smart Script をすでにセットアップしている場合は、このバージョンのドキュメントを使用して、このスクリプトを維持・編集してください。注意:必須ではありませんが、OneLink Smart Scriptを使用してビュースルーアトリビューションを正常に利用するために、V2への移行をご検討ください。
OneLink Smart Scriptの設定
Smart Scriptを設定するには、以下の方法があります。
- ウェブサイトに直接スクリプトを埋め込む
- Google Tag Managerを利用してスクリプトを埋め込む
作業範囲
作業担当者 |
---|
|
OneLink Smart Scriptを作成する
- AppsFlyer管理画面 左メニュー エンゲージメント > Web-to-App > Smart Scriptへ移動します。
-
新規ユーザー向け
- 開始 ボタンをクリックします。
- 手順 4 以降に従います。
- ページ上部の + 新しいSmart Scriptを追加 をクリックします。
- 画面の指示に従って、Smart Scriptに名前を付けます。
- スクリプトの基になる OneLinkテンプレートを選択します。テンプレートには、基本的なリダイレクト設定が含まれています。
- 送信URLに含める必要がある、アトリビューションに必要なパラメーターをマッピングします。これらのパラメーターは、受信URLのパラメーターに基づいてマッピングしてください。
注意:メディアソース (pid) パラメーターは必須です。- マッピングする送信用パラメータ/ディメンションを選択します。
多くの場合、これは変更できない AppsFlyerパラメーター名ですが、場合によってはパラメーター名を入力する必要があります。 - 送信パラメーターの値が次のいずれかに基づいて何になるかを決定し、構成します。
- 受信URLパラメーター:送信URLパラメーターで置き換える可能性のある 1つ以上の受信URLに含まれるパラメーターをリストします。
受信URLパラメーターの値は、送信URLパラメーターの値になります。- 例: utm_source, utm_campaign
受信URLに utm_source が含まれる場合、その値は選択した発信URLパラメーターの値として使用されます。 - Smart Scriptは、パラメータのリストを左から右に検索し、最初に一致したパラメータを送信パラメータURLにマッピングします。
- このパラメータのリストは、開発者によってキーと呼ばれます。
- 例: utm_source, utm_campaign
- デフォルト値:受信URLパラメーターが見つからない場合、または受信URLパラメーターをリストしない場合の送信パラメーター値に必要な既定値を入力します。
- 例:送信用パラメーターに、もし受信パラメータとして utm_campaign と pid がセットされていて、どちらのパラメータも受信URLに含まれていない場合は、デフォルト値が送信パラメータの値として使用されます。
- パラメータ値を上書きする: 受信URLの1つまたは複数の値を、置き換えたい送信URLの値と並べて設定します。
- 例:キャンペーン名用パラメーターの場合 - 受信URLの値が campaign_name の場合、送信URLの値を new_campaign_name に変更できます。
- 受信URLパラメーター:送信URLパラメーターで置き換える可能性のある 1つ以上の受信URLに含まれるパラメーターをリストします。
- [オプション] [ + 新しいパラメータ] をクリックして、追加のパラメーターをマッピングします。使用できるすべての 追加引数 (パラメーター構成)を参照してください。
- マッピングする送信用パラメータ/ディメンションを選択します。
- Smart Scriptをウェブサイトに実装する方法を選択します。
- ウェブサイトに直接スクリプトを埋め込む
- Google Tag Managerを利用してスクリプトを埋め込む
- テストをクリックして、Smart Scriptテストページでスクリプト動作のテストをします。正しい送信URLが生成されていることを確認してください。
- クリック
- 生成・保存をクリックして変更を保存します。
-
生成・保存をクリックしてスクリプトを生成・保存します。
- スクリプトのダウンロード をクリックします。
- スクリプトをWebページに直接埋め込む場合: スクリプトを Web開発者に渡して実装し、生成された送信URL の処理方法を指示します。例:モバイルサイトのCTAボタンの下に置いたり、デスクトップユーザー用に動的なQRコードを表示したりできます。[開発者の手順はこちら]
- Googleタグマネージャー経由の実装:
- Googleタグマネージャーで新しいタグを作成し、タグに名前を付けて [タグの設定] をクリックして、[カスタム HTML] を選択します。
- HTMLボックスに、生成されたSmart Scriptコードを貼り付けます。
-
トリガーをクリックし、新しいトリガーを作成して名前を付け、トリガー構成 を選択します。(例:すべてのページビュー)
詳細はGTMのドキュメントを参照してください。 - 保存をクリックしてください。
- 生成された送信URLをどう処理するかを Web開発者に指示します。
例:モバイルサイトのCTAボタンの下に置いたり、デスクトップユーザー用に動的なQRコードを表示したりできます。[開発者向けの手順]
- 保存されたスクリプトは ドロップダウンメニューで表示できます。
重要!
スクリプトを更新するたびに、スクリプトを再実装する必要があります。
スクリプトを編集または削除する
- Smart Script名の横にあるドロップダウン矢印
をクリックします。
ここで、保存されているすべてのスクリプトを確認できます。 - 編集するスクリプトの横にあるペンアイコンをクリックします。
- OneLink Smart Scriptを作成するの手順に従います。
- ゴミ箱アイコンをクリックして、Smart Scriptを削除します。
重要!
スクリプトを更新するたびに、スクリプトを再実装する必要があります。
スクリプトを複製する
- 複製するSmart Scriptに移動します
- トップバナーの複製ボタンをクリックします
- OneLink Smart Scriptを作成するの手順に従います。
引数の構造
OneLink Smart Scriptは、受信URLのパラメータとスクリプトに定義された引数を用いて、送信URLを生成します。afParameters 引数は、アトリビューションとディープリンクに使用される他のいくつかの引数 (パラメータ) で構成される構造を持ち、各引数には、次の表に示すように、キー、オーバーライド値、およびデフォルト値を持つ構造(開発者によって構成オブジェクトと呼ばれます)が含まれています。
Argument | 説明 | 例 |
---|---|---|
受信URLパラメーター (開発者によってキーと呼ばれます) |
|
|
デフォルト値 |
|
例: ['web_video'] スクリプトのchannelパラメータについては、パラメータ in_channel が見つからない場合、web_videoがchannelの値として使用されます。 |
上書き値 |
|
例: {'video': 'video_new'} スクリプトのchannel パラメータは、受信値が video の場合、スクリプトが送信URLにおいて video_new に変更します。 |
引数
OneLink Smart Scriptは、受信URLのパラメータとスクリプトに定義された引数を用いて、送信URLを生成します。
Smart Scriptを実装するための引数(パラメータと値)
Argument | 備考 | レスポンスを記録 | |
---|---|---|---|
oneLinkURL (必須) |
|
||
afParameters (必須)
|
mediaSource (必須) |
|
キー: デフォルト値: 上書き値: |
campaign |
|
キー: デフォルト値: 上書き値: |
|
channel |
|
キー: デフォルト値: 上書き値: |
|
ad |
|
キー: デフォルト値: 上書き値: |
|
adSet |
|
キー: デフォルト値: 上書き値: |
|
deepLinkValue |
|
キー: デフォルト値: 上書き値: |
|
afSub1-5 | af_sub[1-5] のオブジェクト構成 |
キー: デフォルト値: 上書き値: |
|
googleClickIdKey |
GCLID を持つパラメーターの名前を明記します。 注!AppsFlyerのローデータに表示するためには、パラメーターは、af_sub[1-5] のいずれかを使用する必要があります。 |
||
その他の(カスタム)クエリパラメータ |
|
Param key: キー: デフォルト値: 上書き値: |
アドバンス引数
次の表では、技術に精通したマーケティング担当者または開発者がSmart Scriptに実装できる引数について説明します。
Smart Scriptを実装するために開発者に提供される引数(パラメータと値)
Argument | 備考 | レスポンスを記録 | |
---|---|---|---|
referrerSkipList |
|
||
urlSkipList |
|
使用事例
次のセクションでは、一般的なキャンペーン/メディアソースのシナリオについて、Smart Scriptのユースケースをご紹介します。
UTMパラメーター
UTMパラメータのスクリプトを設定するには:
- 受信URLのUTMパラメータのリストを作成し(例: utm_source と utm_campaign )、送信URLのパラメータと照合します(例: media_source と campaign )。
- これらを 引数リストとして ウェブ開発者に提供する。
結果: 受信パラメータ(utm_source と utm_campaign )の値は、送信URLの(media_source と campaign )パラメータの値を入力するために使用されます。
Google Ads—GCLID
Google広告キャンペーン(GCLIDパラメータを含む)のインストールアトリビューションの通常のプロセスでは、広告をクリックしたユーザーがアプリのストアページのURLにリダイレクトされる必要があります。
このケースでは、Google AdsからのリードをWeb/ランディングページにリダイレクトしているため、スクリプトはGoogle AdsインストールキャンペーンのURLからGCLIDパラメータを取得し、選択した送信パラメータ af_sub[1-5] に付与します。
注記!
- インストールキャンペーンにも適用されます。ACI以外の検索広告の場合、つまりリエンゲージメントキャンペーンの場合には、Smart ScriptによるURLの発行に関係なく、Googleがメディアソースとして成果を紐付けられる場合があります。
- GCLIDが見つかった場合、スクリプトは受信パラメータキーワードを探します。見つかった場合は、キーワードの値を af_keywords の値として送信URLに入れます。
前提条件: Google管理画面上で、自動タグ設定(Auto-Tagging)を有効化してください。
自動タグ設定を有効化することで、 URLに GCLID パラメータが含まれるようになります。
Google AdsのGCLID用のスクリプトを設定するには:
- GCLIDを含めるURL上のパラメーターを選択します。
ベストプラクティス:af_sub[1-5]を選択して、データがAppsFlyerのローデータに表示されるようにします。 - これを 引数リストとして ウェブ開発者に提供します。
結果: 送信URLでは、GCLIDは af_sub[1-5] パラメータの値になります。
Google Adsにこれらのインストールを通知する方法:
- インストールごとに、CSV経由、またはPush API経由でリアルタイムに、パラメーター af_sub[1-5] からGCLIDデータを取得します。
- GCLID データを 手動 または Google Ads APIを使用してGoogleにアップロードします。
注記
GoogleはこのGCLIDソリューションを公式にサポート及び推奨をしていません。GoogleがGCLIDパラメータを廃止する場合は、変更をサポートするようにスクリプトを変更します。この記事のヘッダーにあるFollowボタンをクリックしてこの記事をフォローすると、記事またはスクリプトが更新されたときに通知を受け取ることができます。
FacebookクリックID
Meta広告には、 Facebook click IDと呼ばれるクリックIDが含まれています。このIDを AppsFlyerのローデータで利用できるようにする場合は、送信用パラメータとして af_sub[1-5] を選択・使用してください。
Facebook click IDのスクリプト設定:
-
FacebookクリックIDを含むように、送信URLのパラメータを選択します。
ベストプラクティス: af_sub[1-5] を選択すると、AppsFlyerのローデータレポートにデータが表示されます。 - これを 引数リストとして ウェブ開発者に提供します。
結果: 送信URLでは、FacebookのクリックIDは af_sub[1-5] パラメータの値となります。
SRN、オウンドメディア、その他のメディアソースリンク
SnapchatやTwitterのようなSRNは、Google AdsやクロスプラットフォームのFacebookとは異なる動作をします。これらのSRNのキャンペーンでは、ユーザーはWeb/ランディングページに誘導され、モバイルユーザーに有無に関わらず、クリック数に基づいて課金されます。
これらのSRNでは、スクリプトの設定は、オウンドメディアまたは他のメディアソースからのリンクと同じです。
スクリプトの設定方法:
- リンク上のメディアソースとキャンペーンパラメータ―名のリストを作成します。
- これらを 引数リストとして ウェブ開発者に提供してください。
SRN/メディアソースタイプは、受信URLのメディアソースの値でなければならず、スクリプトはそれを見つけて、ウェブ/ランディングページのダウンロードボタンの背後にある送信OneLink URLの media_source の値として使用します。送信URLの media_source 値を変更したい場合は、ウェブ開発者に渡す 引数リスト で、受信URLに含まれるメディアソースの値と上書き(変更)する media_source の値 を指定します。
結果:これらのSRN/メディアソースについては、受信URLのメディアソースおよびキャンペーンのパラメータの値が、送信URLの media_source および campaign パラメータの値を入力するために使用されます。
例
受信URL: https://hotel.me/incoming_mediasource=twitter&incoming_campaign=big_social
OneLink URL: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social
AppsFlyer計測リンク
AppsFlyer計測リンクは、メディアソースがクリックアドネットワークの場合に使用されます。
AppsFlyerでリンクを設定する場合に、Webからアプリへの誘導キャンペーンの計測では、希望のモバイルWebサイトへのURLパスと一緒にリダイレクトURLパス(af_r)パラメーターを追加するオプションがあります。スクリプトで送信用のOneLink URLを作成すると、元のクリックのデータの一部が失われる可能性があるため、作成しない方がよいでしょう。
アクション: urlSkipList 引数で af_r パラメータをリストアップします。
結果:Smart Scriptが受信URLに af_r パラメータを見つけた場合、Smart Scriptは送信URLを生成しないので、開発者はどのリンクを送信URLとして配置するかを決定して実装する必要があります。
例
受信URL: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando& af_r=hotel.me
送信用URL:送信URLはありません。 (null)
ウェブリファラーマッピング
ウェブリファラーマッピングを使用すると、ユーザーがどのページからウェブサイトにアクセスしたか(オーガニック検索結果など)から学習できるため、Smart Scriptのウェブからアプリへのフローから発生したインストールとリエンゲージメントを分析するために、自由にデータを充実させることができます。
Smart Scriptを設定して、ランディングページまたはウェブサイトのHTTPヘッダー Referer
項目からこの情報を収集できます。この項目には、ユーザーがウェブページに誘導するリンクをクリックしたページのベースURLが含まれます。
ウェブリファラーを収集するようにスクリプトを設定するには
- Smart Scriptの画面を開きます。
-
ウェブリファラーマッピング セクションで、ウェブリファラー値の送信URL用のパラメーターキーを選択します。
- af_channel - ダッシュボードとローデータで使用できます
- af_sub1-5 - パラメーターは、ローデータの af_sub1-5 項目と original URL 項目で使用できます。
- カスタムパラメーター - これはパラメーター名と値で構成されます。パラメータの値は、ローデータのoriginal URL項目で確認できます。
ユニバーサルリンクとアプリリンクを使用したリエンゲージメントのオーガニック検索アトリビューションについて詳しくは、 こちらをご覧ください。
デスクトップ
この記事で紹介しているほとんどのユースケースは、モバイルデバイスから来るユーザーについてです。したがって、モバイルWebサイトからアプリストアへ誘導されると、ユーザーはすぐにアプリをダウンロードできます。
ただし、デスクトップユーザーの場合、デバイス(デスクトップやパソコン)はモバイルアプリのダウンロードに対応していないため、すぐにアプリストアへ誘導すべきではありません。
デスクトップユーザー向けのスクリプトの設定方法:
- OneLinkテンプレートにて、デスクトップからクリックされた場合のリンク先URLを設定します。このURLは専用Web/ランディングページにリダイレクトする必要があります。ランディングページには、アプリをダウンロードするためのSMSやメールを受信するフォームを追加することができます。必要に応じて、Webフォームを作成し、そのフォームへのURLをスクリプトで指定することもできます。
結果:スクリプトはユーザーが使用するデバイスまたはプラットフォームを検知します。デスクトップの場合は、スクリプトはユーザーを専用のWeb/ランディングページにリダイレクトするためのOneLink URLを生成します。
詳細は、デスクトップからアプリへのコンバージョンをご参照ください。
代理店
インストールは、af_prt パラメーターを使用する代理店に紐づきます。
OneLink Smart Scriptを使用するこの計測パラメーターを追加するには、ディベロッパーにこれらの手順に従うよう依頼してください。
結果: このスクリプトは、受信側URLの代理店名の追加パラメーターを検出して、送信側URLにaf_prtパラメーターを追加します。
例
受信URL: https://hotel.me/incoming_campaign=gogo&incoming_media_source=email&partner_name=bigagency
送信側URL:https://hotel.me/pid=email&c=gogo&af_prt=agency
QRコード
Smart Scriptで、クリックできるURLの代わりに、QRコードをウェブページに表示します。
QRコードを表示する場合:
- Smart Scriptを実装する際には、必ずSmart Script v2.6+ を使用してください。
- 開発者に、 こちらの実装ガイドに従い、Smart Scriptの結果でQRコードを作成するよう伝えてください。
-
[ベストプラクティス] 開発者に次のことを伝えます:
- アプリのロゴをQRコードセンターに追加したり、色をカスタマイズすることで、QRコードをカスタマイズします。
- ユーザーがデスクトップでアクセスしている際にはQRコードを表示し、ユーザーがモバイルにいるときはリンク付きのボタンを表示します。
結果:このスクリプトは、後ろにURLのあるボタンの代わりにQRコードを表示します。
例
受信URL:
https://hotel.me/qr_code.html?incmp=gogo&inmedia=email
送信URL:
https://hotel.onelink.me/LtRd/?af_js_web=true&af_ss_ver=2_1_0&pid=email&c=gogo
送信QRコード:
インプレッション計測
OneLink Smart Scriptを使用して、Webサイト上のインプレッション数をカウントできます。
これを行うには、開発者はインプレッション関数を呼び出す必要があります。
インストールは、ビュースルーアトリビューションによってインプレッションに紐づけられます。
注意:
- インプレッション数のカウントは、クリック数をカウントする通常のSmart Script生成URLに追加されます。Smart Scriptを使用して、クリック数、インプレッション数、またはその両方をカウントできます。
- Smart Scriptによるビュースルーアトリビューションは、モバイル端末でのみ機能します。デスクトップ上では機能しません。
新規インストールをこれらのインプレッション(ビュースルーアトリビューション)に紐づけるには:
- Smart Script を設定する際には、必ずSmart Script v2.3以降を使用してください。
- Smart Scriptで インプレッション関数を呼び出す ように開発者に指示します。
- ビュースルー計測がオンになっていることを確認します。
重要!
2023年2月1日 (Chrome 110 安定版リリース) の時点で、Googleはユーザーエージェントのデータを減らすためにいくつかの変更を加えました。OneLink Smart Scriptを使用してビュースルーアトリビューションを適切に取得するには、OneLink Smart Script バージョン 2.3 以降を使用する必要があります。
追加情報
よくある質問
ユーザーがウェブサイト内の別のページへ移動した場合、OneLinkリンク生成URLは機能しますか?
はい。受信用URLパラメータは、ブラウジングセッションの間 保存され、Smart Scriptで生成されるOneLinkリンクの送信用パラメータに適用されます。実装の詳細については、AppsFlyer公式Developer Hubをご参照ください。
Googleタグマネージャーを介してSmart Scriptを実装するとエラーが発生するのはなぜですか?
AppsFlyerでSmart Scriptを生成して Google タグマネージャー (GTM) に挿入しようとすると、「JavaScriptが長すぎます」というエラーが表示されることがあります。このような場合は、GTMタグを削除して新しいタグを作成してください。
リストにないパラメータを追加できますか?
はい。Smart Scriptコード生成画面で + 新しいパラメーターをクリックして、追加のパラメーターをマッピングすることで可能です。
- 新しいパラメーターは、ドロップダウンにリストされていないカスタムパラメーターまたはAppsFlyer予約パラメーターにすることができます。
- 使用できるすべての 追加引数 (パラメーター構成)を参照してください。
- ドロップダウンオプションにある「カスタムパラメーター」を使用して、送信URLパラメータとして設定します。
例:is_retargetingをパラメーターとして追加するには、マッピング項目で カスタムパラメーターを選択し送信URLパラメーター 項目に is_retargeting パラメーターを選択します。
広告セットやその他のパラメータがドロップダウンに表示されない
新しいパラメータを作成または追加するときは、ブラウザにある広告ブロッカーをオフにすることをお勧めします。広告ブロッカーは、「広告」という単語が含まれている場合、オプションを削除することがあります。
Smart Scriptはどのブラウザで動作しますか?
Smart Scriptは一般的なJavascriptを使用しているため、すべてのブラウザで動作するはずです。
仕様と制限
仕様 | 備考 |
---|---|
URIスキーム | 既存のユーザーに対してアプリを開くためにOneLink テンプレートでURIスキームが設定されていても、Smart Scriptを使用して作成されたリンクの場合、URIスキームを使用した af_dpパラメーターは、開発者が カスタムパラメーターとして引き継ぎパラメータの1つとしてURLに追加する必要があります。 |
# 受信URL内 | Smart Scriptでは、クエリパラメーターの前にハッシュ ('#') 記号を含む受信 URL を処理するときに問題が発生します('?' 記号で示されます) 。このような場合、Smart Scriptはデフォルト値に戻ります。 |