Smart Script｜Webサイト訪問者をアプリユーザーへ転換するための設定

OneLink Smart Scriptを作成するには、次の手順を実行します。

1. AppsFlyerのサイドメニューから、エンゲージ ＞ Web-to-app ＞ Smart Scriptの順に選択します。
2. 初めて利用する場合
   1. 利用を開始のボタンをクリックします。
   2. 手順4以降に進みます。
3. ページ上部の + 新しいSmart Scriptを追加 をクリックします。
4. 画面の指示に従って、Smart Scriptに名前を付けます。
5. スクリプトのベースとして使用するOneLinkテンプレートを選択します。テンプレートには、基本的なリダイレクト設定が含まれています。
6. 生成されるURLに含めるパラメーターをマッピングします。これらのパラメーターは、受信URLに含まれるパラメーターを基に設定されます。 注意：メディアソース（pid）パラメーターは必須です。
   1. マッピングする送信URLのパラメーターまたはディメンションを選択します。
      多くの場合、変更できないAppsFlyerのパラメーター名が表示されます。一部のケースでは、使用するパラメーター名を入力する必要があります。
   2. 次のいずれかの方法に基づいて、生成されるURLのパラメーター値を決定し、設定します。
      • 受信URLのパラメーター：生成されるURLのパラメーターへ置き換える対象として、受信URLに含まれる可能性のあるパラメーターを1つ以上指定します。受信URL内のパラメーター値が、生成されるURLのパラメーター値として使用されます。
        • 例：any_param_name、utm_param_name受信URL内にutm_param_nameが見つかった場合、その値が、選択した送信URLのパラメーターの値として使用されます。
        • Smart Scriptは、パラメーター一覧を左から右の順に検索し、最初に一致したパラメーターを生成されるURLのパラメーターへマッピングします。
        • このパラメーター一覧は、開発者向けには「キー」と呼ばれます。
      • デフォルト値：受信URL内に該当するパラメーターが見つからなかった場合、または受信URLのパラメーターを指定していない場合に、生成されるURLのパラメーター値として使用するデフォルト値を入力します。
        • 例：生成されるURLのパラメーターに対して、受信URLのパラメーターとしてany_paramname、utm_paramnameを指定している場合、一覧内のいずれのパラメーターも見つからなければ、デフォルト値が生成されるURLのパラメーター値として使用されます。
      • 値の上書き：受信URL内の値と、その値を置き換える生成後のURLの値を1つ以上設定します。
        • 例：キャンペーンパラメーターについて、流入URL内の値がcampaign_nameの場合、生成されるURL内の値をnew_campaign_nameへ変更できます。
   3. ［任意］＋新しいパラメーターをクリックし、追加のパラメーターをマッピングします。使用可能な追加引数（パラメーター設定）については、一覧をご覧ください。
7. Webサイト上でSmart Scriptを実装する方法を選択します。
   • Webサイトにスクリプトを埋め込む
   • Googleタグマネージャーを使用する
8. テストをクリックし、Smart Scriptのテストページ上でスクリプトをテストします。正しい送信URLが生成されることを確認してください。
9. 次のいずれかをクリックします。
   1. 保存：変更内容を保存します。
   2. 保存して生成：変更内容を保存し、スクリプトを生成します。
      1. スクリプトのダウンロード をクリックします。
10. Webサイトへのスクリプト埋め込みを選択した場合：生成したスクリプトをWeb開発者へ送付し、生成される送信URLの使用方法を伝えます。たとえば、モバイルサイト上のCTAボタンにURLを設定したり、デスクトップサイト上にQRコードを表示したりします。（詳細：開発者向け手順）
11. Googleタグマネージャーの使用を選択した場合：
    1. Googleタグマネージャーで新しいタグを作成し、タグに名前を付けます。 タグの設定をクリックし、カスタムHTMLを選択します。
    2. HTML入力欄に、生成されたSmart Scriptのコードを貼り付けます。
    3. トリガーをクリックし、新しいトリガーを作成して名前を付けます。 トリガーの設定を選択します。たとえば、すべてのページビューを対象に設定します。詳しくは、Googleタグマネージャーのドキュメントをご覧ください。
    4. 保存をクリックします。
    5. 生成される送信URLの使用方法をWeb開発者へ伝えます。たとえば、モバイルサイト上のCTAボタンにURLを設定したり、デスクトップサイト上に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. これらを引数の一覧に記載し、Web開発者に提供します。
    

結果：受信パラメーター（utm_source、utm_campaign）の値が、送信リンクのmedia_sourceパラメーターとcampaignパラメーターの値として使用されます。 

GCLIDパラメーターを含むGoogle広告キャンペーンのインストールアトリビューションでは、通常、広告をクリックしたユーザーをアプリストアのページURLへリダイレクトする必要があります。 

このケースでは、Google広告から獲得した見込み顧客をWebページまたはランディングページへリダイレクトするため、スクリプトはGoogle広告のアプリインストールキャンペーンURLからGCLIDパラメーターを取得し、送信URLに追加します。Smart Scriptバージョン2.9.0以降では、GCLID、WBRAID、GBRAIDパラメーターが存在する場合、Smart Scriptによって生成される送信URLへ、そのまま自動的に引き継がれます。

また、クリックIDを別の送信パラメーター（af_sub[1-5]）へマッピングすることで、AppsFlyerのローデータレポートで確認できるようにすることも可能です。

 

注意

• これはインストールキャンペーンに適用されます。ACI以外の検索キャンペーン、つまりリエンゲージメントキャンペーンでは、Smart Scriptの出力内容にかかわらず、Googleがメディアソースとしてアトリビューションされる場合があります。 
• GCLIDが見つかった場合、スクリプトは受信URL内のkeywordパラメーターを検索します。見つかった場合、そのキーワードの値を送信URLのaf_keywordsの値として設定します。

前提条件： Googleの管理画面で自動タグ設定を有効にしてください。 
自動タグ設定を有効にすると、URLにGCLIDパラメーターが含まれます。

Google広告のGCLIDを他のパラメーターへマッピングする：

1. GCLIDを格納する送信URLのパラメーターを選択します。
   推奨：AppsFlyerのローデータレポートにデータを表示できるよう、af_sub[1-5]のいずれかを選択します。
2. この設定を引数の一覧に記載し、Web開発者に提供します。送信URLでは、GCLIDがaf_sub[1-5] パラメーターの値として設定されます。
    

これらのインストールをGoogle広告へ通知する：

推奨：Google Web連携を設定します。この連携では、インストールの自動ポストバックがサポートされています。 

連携を設定していない場合は、次の手順を実行します：

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

Meta広告には、FBCLIDと呼ばれるクリックIDが含まれます。Smart Scriptバージョン2.8.1以降では、FBCLIDが存在する場合、Smart Scriptによって生成される送信URLへ、そのまま自動的に引き継がれます。また、クリックIDを別の送信パラメーターへマッピングすることで、AppsFlyerのローデータレポートで確認できるようにすることも可能です。

FBCLIDを他のパラメーターへマッピングする

1. FBCLIDを格納する送信URLのパラメーターを選択します。 
   推奨：AppsFlyerのローデータレポートにデータを表示できるよう、af_sub[1-5]のいずれかを選択します。
2. この設定を引数の一覧に記載し、Web開発者に提供します。結果：送信URLでは、FBCLIDがaf_sub[1-5]パラメーターの値として設定されます。
    

TikTok、X（旧Twitter）、Snapの広告キャンペーンにおけるインストールアトリビューションでは、各アドネットワーク固有のクリックIDパラメーターが使用されます。これらのパラメーターは広告のクリック時に追加され、インストールやインストール後イベントと、流入元となった広告を照合するために使用されます。

トラフィックが最初にWebページまたはランディングページへリダイレクトされる場合、適切なアトリビューションを行うため、クリックIDを保持して転送する必要があります。このケースでは、Smart Scriptが受信したクリックIDパラメーターを取得し、生成する送信URLへ追加します。

クリックIDはインストール時に取得され、そのインストールに関連する以降のイベントで使用されます。

Smart Scriptバージョン2.10.0以降では、以下のクリックIDパラメーターが存在する場合、Smart Scriptによって生成される送信URLへ、そのまま自動的に引き継がれます。

• TikTok：ttclid
• X（旧Twitter）：twclid
• Snap：ScCid

また、これらのクリックIDをaf_sub1～af_sub5などの別の送信パラメーターへマッピングすることで、AppsFlyerのローデータレポートで確認できるようにすることも可能です。

関連するWeb連携の記事については、以下をご覧ください。 

• TikTok 
• Snap 

SnapchatやX広告などのSRNsは、Google広告やMeta広告のようなクロスプラットフォームとは異なる仕組みで動作します。これらのSRNのキャンペーンでは、ユーザーはWebページまたはランディングページへ誘導されます。また、モバイルアプリユーザーへの転換結果とは関係なく、クリックした見込み顧客数に応じて広告費が請求されます。 

これらのSRNにおけるスクリプトの設定方法は、オウンドメディアやその他のメディアソースのリンクと同じです。 

スクリプトの設定方法：

1. 受信リンクに含まれるメディアソースパラメーターとキャンペーンパラメーターの名前を一覧にします。
2. これらを引数の一覧に記載し、Web開発者に提供します。
   受信URLでは、SRNまたはメディアソースの種類をメディアソースの値として指定します。スクリプトはこの値を検出し、Webページまたはランディングページのダウンロードボタンに設定された送信OneLink URLのmedia_sourceの値として使用します。送信されるmedia_sourceを変更する場合は、受信時のメディアソースの値と、上書き後のmedia_sourceの値を引数の一覧に記載し、Web開発者に提供します。

結果：これらのSRNまたはメディアソースでは、受信リンクのメディアソースパラメーターとキャンペーンパラメーターの値が、送信リンクのmedia_sourceパラメーターとcampaignパラメーターの値として使用されます。 

メディアソースがクリック型アドネットワークの場合、AppsFlyerアトリビューションリンクを使用できます。AppsFlyerでこのようなリンクを設定する際、Webキャンペーンからアプリへのアトリビューションを行うために、モバイルWebサイトへの遷移先URLパスを指定するリダイレクトURL（af_r）パラメーターを追加できます。Smart Scriptによって送信OneLink URLが生成されると、最初のクリックに含まれる一部のデータが失われる可能性があるため、スクリプトで送信OneLink URLを生成させたくない場合があります。

対応：urlSkipList引数にaf_rパラメーターを指定します。

結果：Smart Scriptが受信リンク内でaf_rパラメーターを検出すると、送信URLは生成されません。その場合、開発者が送信URLとして設定するリンクを決定し、実装する必要があります。

Webリファラーのマッピングを使用すると、ユーザーがどのページからWebサイトを訪問したかを把握できます。たとえば、オーガニック検索結果から流入したかどうかを確認できます。これにより、Smart Scriptを使用したWeb-to-Appフローから発生したインストールやリエンゲージメントを分析する際に利用できるデータを充実させることができます。

Smart Scriptでは、ランディングページまたはWebサイトのHTTPヘッダーにあるRefererフィールドから、この情報を取得するよう設定できます。このフィールドには、ユーザーがリンクをクリックしてWebページへ遷移する直前に閲覧していたページのベースURLが含まれます。

Webリファラーを取得するようスクリプトを設定する

1. Smart Scriptのページを開きます。
2. Webリファラーのマッピングのセクションで、Webリファラーの値を格納する送信URLのパラメーターキーを選択します。選択できるパラメーターは次のとおりです。
   • af_channel：管理画面とローデータで確認できます。
   • af_sub1-5：ローデータのaf_sub1-5列とOriginal URLの列で確認できます。
   • カスタムパラメーター：パラメーター名と値で構成されます。このパラメーターは、ローデータのOriginal URL列に表示されます。

ユニバーサルリンクとアプリリンクを使用したリエンゲージメントのオーガニック検索アトリビューションについては、こちらをご覧ください。

この記事で紹介しているユースケースの多くは、モバイルデバイスからアクセスするユーザーを対象としています。そのため、モバイルWebサイトからアプリストアへ遷移したユーザーは、すぐにアプリをダウンロードできます。

一方、デスクトップまたはノートパソコンはモバイルアプリのダウンロードに対応していないため、デスクトップユーザーをすぐにアプリストアへ遷移させることは適切ではありません。 

デスクトップユーザー向けにスクリプトを設定する：

• OneLinkテンプレートで、デスクトップでリンクがクリックされた場合の遷移先URLを設定します。このURLには、専用のWebページまたはランディングページを指定します。ランディングページには、ユーザーが情報を入力し、アプリのダウンロードリンクをSMSまたはメールで受け取るためのWebフォームを設置できます。Webフォームはご自身で作成し、そのURLをスクリプトに設定する必要があります。 

結果：スクリプトは、ユーザーが使用しているデバイスまたはプラットフォームを検出します。デスクトップの場合、専用のWebページまたはランディングページへユーザーをリダイレクトする送信OneLink URLを生成します。

「デスクトップからアプリへの転換」も併せてご覧ください。

Smart Scriptでは、リンクが設定されたボタンの代わりに、Webページ上へQRコードを表示できます。

QRコードを表示する：

1. Smart Scriptを設定する際は、Smart Script 2.6以降を使用してください。
2. Web開発者に、開発者向け手順に従ってSmart Scriptの生成結果からQRコードを作成するよう依頼します。
3. ［推奨］Web開発者に、次の対応を依頼します：
   • QRコードの中央にアプリのロゴを追加し、色を変更してQRコードをカスタマイズする。
   • ユーザーがデスクトップを使用している場合はQRコードを表示し、モバイルを使用している場合はリンクが設定されたボタンを表示する。

結果：スクリプトは、URLが設定されたボタンの代わりにQRコードを表示します。

OneLink Smart Scriptを使用して、Webサイト上のインプレッションを計測できます。インプレッションを計測するには、開発者がインプレッション関数を呼び出す必要があります。その後、ビュースルーアトリビューションによって、インストールがインプレッションにアトリビューションされます。

注意：

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

新規インストールをインプレッションへアトリビューションする：

1. Smart Scriptを設定する際は、Smart Script 2.3以降を使用してください。
2. Web開発者に、Smart Script内でインプレッション関数を呼び出すよう依頼します。
3. ビュースルーアトリビューションが有効になっていることを確認します。

OneLinkリンクを生成する際、ユーザーがWebサイト内の別のページへ移動しても、受信URLの情報は引き続き使用されますか？

はい。受信URLのパラメーターは、ユーザーがWebサイトを閲覧しているセッションの間保存され、Smart Scriptによって生成されるOneLinkリンクの送信パラメーターに適用されます。実装の詳細については、開発者ハブをご覧ください。

Googleタグマネージャー経由でSmart Scriptを実装するとエラーが発生するのはなぜですか？

AppsFlyerでSmart Scriptを生成し、Googleタグマネージャー（GTM）へ挿入しようとすると、「JavaScriptが長すぎます」というエラーが表示される場合があります。このエラーが発生した場合は、GTMのタグを削除し、新しいタグを作成してください。

一覧にないパラメーターを追加できますか？

はい。OneLink Smart Scriptページで、＋新しいパラメーターをクリックして、追加のパラメーターをマッピングできます。

• 新しいパラメーターには、カスタムパラメーター、またはドロップダウンに表示されていないAppsFlyerの予約済みパラメーターを使用できます。
  • 使用可能な追加の引数（パラメーター設定）については、一覧をご覧ください。
• ドロップダウンからカスタムを選択し、送信URLのパラメーターフィールドにパラメーターを入力します。

たとえば、is_retargetingをパラメーターとして追加するには、マッピング先のフィールドでカスタムパラメーターを選択し、送信URLのパラメーターフィールドにAppsFlyerのis_retargetingパラメーターを入力します。

広告セットやその他のパラメーターがドロップダウンに表示されません

新しいパラメーターを作成または追加する際は、ブラウザで使用している広告ブロッカーを無効にすることを推奨します。広告ブロッカーによっては、「Ad」という単語を含む選択肢が削除される場合があります。

Smart Scriptはどのブラウザで動作しますか？

Smart ScriptはJavaScriptを使用しているため、すべてのブラウザで動作します。