OneLink Smart Script V2の設定

1. AppsFlyer管理画面 左メニュー エンゲージメント > Web-to-App > Smart Scriptへ移動します。
2. 新規ユーザー向け
   1. 開始 ボタンをクリックします。
   2. 手順 4 以降に従います。
3. ページ上部の + 新しいSmart Scriptを追加 をクリックします。
4. 画面の指示に従って、Smart Scriptに名前を付けます。
5. スクリプトの基になる OneLinkテンプレートを選択します。テンプレートには、基本的なリダイレクト設定が含まれています。
6. 送信URLに含める必要がある、アトリビューションに必要なパラメーターをマッピングします。これらのパラメーターは、受信URLのパラメーターに基づいてマッピングしてください。
   注意：メディアソース (pid) パラメーターは必須です。
   1. マッピングする送信用パラメータ/ディメンションを選択します。
      多くの場合、これは変更できない AppsFlyerパラメーター名ですが、場合によってはパラメーター名を入力する必要があります。
   2. 送信パラメーターの値が次のいずれかに基づいて何になるかを決定し、構成します。
      • 受信URLパラメーター：送信URLパラメーターで置き換える可能性のある 1つ以上の受信URLに含まれるパラメーターをリストします。
        受信URLパラメーターの値は、送信URLパラメーターの値になります。
        • 例: utm_source, utm_campaign
          受信URLに utm_source が含まれる場合、その値は選択した発信URLパラメーターの値として使用されます。
        • Smart Scriptは、パラメータのリストを左から右に検索し、最初に一致したパラメータを送信パラメータURLにマッピングします。
        • このパラメータのリストは、開発者によってキーと呼ばれます。
      • デフォルト値：受信URLパラメーターが見つからない場合、または受信URLパラメーターをリストしない場合の送信パラメーター値に必要な既定値を入力します。
        • 例：送信用パラメーターに、もし受信パラメータとして utm_campaign と pid がセットされていて、どちらのパラメータも受信URLに含まれていない場合は、デフォルト値が送信パラメータの値として使用されます。
      • パラメータ値を上書きする： 受信URLの1つまたは複数の値を、置き換えたい送信URLの値と並べて設定します。
        • 例：キャンペーン名用パラメーターの場合 - 受信URLの値が campaign_name の場合、送信URLの値を new_campaign_name に変更できます。
   3. [オプション] [ + 新しいパラメータ] をクリックして、追加のパラメーターをマッピングします。使用できるすべての 追加引数 （パラメーター構成）を参照してください。
7. Smart Scriptをウェブサイトに実装する方法を選択します。
   • ウェブサイトに直接スクリプトを埋め込む
   • Google Tag Managerを利用してスクリプトを埋め込む
8. テストをクリックして、Smart Scriptテストページでスクリプト動作のテストをします。正しい送信URLが生成されていることを確認してください。
9. クリック
   1. 生成・保存をクリックして変更を保存します。
   2. 生成・保存をクリックしてスクリプトを生成・保存します。
      1. スクリプトのダウンロード をクリックします。
10. スクリプトをWebページに直接埋め込む場合： スクリプトを Web開発者に渡して実装し、生成された送信URL の処理方法を指示します。例：モバイルサイトのCTAボタンの下に置いたり、デスクトップユーザー用に動的なQRコードを表示したりできます。[開発者の手順はこちら]
11. Googleタグマネージャー経由の実装：
    1. Googleタグマネージャーで新しいタグを作成し、タグに名前を付けて [タグの設定] をクリックして、[カスタム HTML] を選択します。
    2. HTMLボックスに、生成されたSmart Scriptコードを貼り付けます。
    3. トリガーをクリックし、新しいトリガーを作成して名前を付け、トリガー構成 を選択します。（例：すべてのページビュー）
       詳細はGTMのドキュメントを参照してください。
    4. 保存をクリックしてください。
    5. 生成された送信URLをどう処理するかを Web開発者に指示します。
       例：モバイルサイトのCTAボタンの下に置いたり、デスクトップユーザー用に動的なQRコードを表示したりできます。[開発者向けの手順]
12. 保存されたスクリプトは ドロップダウンメニューで表示できます。

1. Smart Script名の横にあるドロップダウン矢印 をクリックします。
   ここで、保存されているすべてのスクリプトを確認できます。
2. 編集するスクリプトの横にあるペンアイコンをクリックします。
   1. OneLink Smart Scriptを作成するの手順に従います。
3. ゴミ箱アイコンをクリックして、Smart Scriptを削除します。

1. 複製するSmart Scriptに移動します
2. トップバナーの複製ボタンをクリックします
3. OneLink Smart Scriptを作成するの手順に従います。

OneLink Smart Scriptは、受信URLのパラメータとスクリプトに定義された引数を用いて、送信URLを生成します。afParameters 引数は、アトリビューションとディープリンクに使用される他のいくつかの引数 (パラメータ) で構成される構造を持ち、各引数には、次の表に示すように、キー、オーバーライド値、およびデフォルト値を持つ構造（開発者によって構成オブジェクトと呼ばれます）が含まれています。

OneLink Smart Scriptは、受信URLのパラメータとスクリプトに定義された引数を用いて、送信URLを生成します。

Smart Scriptを実装するための引数（パラメータと値）

次の表では、技術に精通したマーケティング担当者または開発者がSmart Scriptに実装できる引数について説明します。

Smart Scriptを実装するために開発者に提供される引数（パラメータと値）

UTMパラメータのスクリプトを設定するには：

1. 受信URLのUTMパラメータのリストを作成し（例： utm_source と utm_campaign ）、送信URLのパラメータと照合します（例： media_source と campaign ）。
2. これらを 引数リストとして ウェブ開発者に提供する。
    

結果: 受信パラメータ（utm_source と utm_campaign ）の値は、送信URLの（media_source と campaign ）パラメータの値を入力するために使用されます。

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用のスクリプトを設定するには：

1. GCLIDを含めるURL上のパラメーターを選択します。
   ベストプラクティス：af_sub[1-5]を選択して、データがAppsFlyerのローデータに表示されるようにします。
2. これを 引数リストとして ウェブ開発者に提供します。 
    

結果： 送信URLでは、GCLIDは af_sub[1-5] パラメータの値になります。

Google Adsにこれらのインストールを通知する方法：

1. インストールごとに、CSV経由、またはPush API経由でリアルタイムに、パラメーター af_sub[1-5] からGCLIDデータを取得します。
2. GCLID データを 手動 または Google Ads APIを使用してGoogleにアップロードします。

Meta広告には、 Facebook click IDと呼ばれるクリックIDが含まれています。このIDを AppsFlyerのローデータで利用できるようにする場合は、送信用パラメータとして af_sub[1-5] を選択・使用してください。

Facebook click IDのスクリプト設定：

1. FacebookクリックIDを含むように、送信URLのパラメータを選択します。
   ベストプラクティス： af_sub[1-5] を選択すると、AppsFlyerのローデータレポートにデータが表示されます。
2. これを 引数リストとして ウェブ開発者に提供します。 
    

結果： 送信URLでは、FacebookのクリックIDは af_sub[1-5] パラメータの値となります。

SnapchatやTwitterのようなSRNは、Google AdsやクロスプラットフォームのFacebookとは異なる動作をします。これらのSRNのキャンペーンでは、ユーザーはWeb／ランディングページに誘導され、モバイルユーザーに有無に関わらず、クリック数に基づいて課金されます。

これらのSRNでは、スクリプトの設定は、オウンドメディアまたは他のメディアソースからのリンクと同じです。

スクリプトの設定方法：

1. リンク上のメディアソースとキャンペーンパラメータ―名のリストを作成します。
2. これらを 引数リストとして ウェブ開発者に提供してください。
   SRN/メディアソースタイプは、受信URLのメディアソースの値でなければならず、スクリプトはそれを見つけて、ウェブ/ランディングページのダウンロードボタンの背後にある送信OneLink URLの media_source の値として使用します。送信URLの media_source 値を変更したい場合は、ウェブ開発者に渡す 引数リスト で、受信URLに含まれるメディアソースの値と上書き（変更）する media_source の値 を指定します。

結果：これらのSRN/メディアソースについては、受信URLのメディアソースおよびキャンペーンのパラメータの値が、送信URLの media_source および campaign パラメータの値を入力するために使用されます。

AppsFlyer計測リンクは、メディアソースがクリックアドネットワークの場合に使用されます。
AppsFlyerでリンクを設定する場合に、Webからアプリへの誘導キャンペーンの計測では、希望のモバイルWebサイトへのURLパスと一緒にリダイレクトURLパス（af_r）パラメーターを追加するオプションがあります。スクリプトで送信用のOneLink URLを作成すると、元のクリックのデータの一部が失われる可能性があるため、作成しない方がよいでしょう。

アクション： urlSkipList 引数で af_r パラメータをリストアップします。

結果：Smart Scriptが受信URLに af_r パラメータを見つけた場合、Smart Scriptは送信URLを生成しないので、開発者はどのリンクを送信URLとして配置するかを決定して実装する必要があります。

ウェブリファラーマッピングを使用すると、ユーザーがどのページからウェブサイトにアクセスしたか（オーガニック検索結果など）から学習できるため、Smart Scriptのウェブからアプリへのフローから発生したインストールとリエンゲージメントを分析するために、自由にデータを充実させることができます。

Smart Scriptを設定して、ランディングページまたはウェブサイトのHTTPヘッダー Referer項目からこの情報を収集できます。この項目には、ユーザーがウェブページに誘導するリンクをクリックしたページのベースURLが含まれます。

ウェブリファラーを収集するようにスクリプトを設定するには

1. Smart Scriptの画面を開きます。
2. ウェブリファラーマッピング セクションで、ウェブリファラー値の送信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パラメーターを追加します。

Smart Scriptで、クリックできるURLの代わりに、QRコードをウェブページに表示します。

QRコードを表示する場合：

1. Smart Scriptを実装する際には、必ずSmart Script v2.6+ を使用してください。
2. 開発者に、 こちらの実装ガイドに従い、Smart Scriptの結果でQRコードを作成するよう伝えてください。
3. [ベストプラクティス] 開発者に次のことを伝えます：
   • アプリのロゴをQRコードセンターに追加したり、色をカスタマイズすることで、QRコードをカスタマイズします。
   • ユーザーがデスクトップでアクセスしている際にはQRコードを表示し、ユーザーがモバイルにいるときはリンク付きのボタンを表示します。

結果：このスクリプトは、後ろにURLのあるボタンの代わりにQRコードを表示します。

OneLink Smart Scriptを使用して、Webサイト上のインプレッション数をカウントできます。
これを行うには、開発者はインプレッション関数を呼び出す必要があります。
インストールは、ビュースルーアトリビューションによってインプレッションに紐づけられます。

注意：

• インプレッション数のカウントは、クリック数をカウントする通常のSmart Script生成URLに追加されます。Smart Scriptを使用して、クリック数、インプレッション数、またはその両方をカウントできます。
• Smart Scriptによるビュースルーアトリビューションは、モバイル端末でのみ機能します。デスクトップ上では機能しません。

新規インストールをこれらのインプレッション（ビュースルーアトリビューション）に紐づけるには： 

1. Smart Script を設定する際には、必ずSmart Script v2.3以降を使用してください。
2. Smart Scriptで インプレッション関数を呼び出す ように開発者に指示します。
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を使用しているため、すべてのブラウザで動作するはずです。