OneLink Smart Script V2

概要：自動的に生成されたOneLinkをカスタマイズし、ブランドのWebサイト上のボタンやバナーに埋め込みましょう。

OneLinkスマートスクリプトについて

OneLinkスマートスクリプトは、Webページへ誘導するURLを使用して、アプリストアへ誘導する一意のOneLink URLを自動的に生成します。

The outgoing URLs are generated using arguments you receive from the marketer and input into the script. Note: The afParameters argument has a structure made up of several other arguments (parameters), each of which contains a configuration object that has keys, override values, and a default value.

実装ステップ

スマートスクリプトを設定するには、以下の方法があります。

Embed the script in your website

スマートスクリプトの初期化および呼び出しコードは、 AppsFlyer管理画面のスマートスクリプト生成ツールから取得する（推奨）ことも、開発者が手動でインポートして呼び出すこともできます。

📘

受信URLパラメータを保存する

受信したURLパラメータを生成されたOneLinkに確実にマッピングするために、OneLinkがページ内に生成されているかどうかにかかわらず、すべてのWebサイトページでSmart Scriptをインポートすることをお勧めします。

Smart Scriptバージョン2.5.0以降で利用可能です。

詳細と具体的な例はこちらを参照してください。

スマートスクリプト生成ツールを使用して実装する

1. マーケティング担当者から、スクリプト、初期化コード、および引数を含むファイルを取得します。
2. スマートスクリプトのテストページでスクリプトをテストし、正しい送信URLが生成されていることを確認します。
3. スマートスクリプトの結果のテスト／使用手順 に従って進めてください。

Githubの実装例をご参照ください。

スクリプトを手動で実装する

1. スクリプトをダウンロードしてください。
2. マーケティング担当者から、受信パラメータと送信パラメータをどうマッピングするかのリストを受け取ります。
3. スマートスクリプトの引数とオブジェクト構成を初期化してください。
4. Web/ランディングページのHTML内のスクリプトを以下の方法で呼び出し、URLSを生成してください：

var result = window.AF_SMART_SCRIPT.generateOneLinkURL({
  oneLinkURL,
  afParameters,
  referrerSkipList, // optional
  urlSkipList // optional
})

5. スマートスクリプトの結果のテスト／使用手順 に従って進めてください。

スマートスクリプトの結果を確認して使用する

1. Check the return value in result. Possible return values are:
   • 送信用OneLink URL：必要に応じて結果の値を使用します。
     例：WebサイトのCTA（アプリダウンロード）URLにリンクとして配置する、など
   • null. If the script returns null, implement your desired error flow. For example: the web/landing page's existing URL is not changed.

      var result_url = "No output from script"
      if (result) {
            result_url = result.clickURL;            
            // Put the generated OneLink URL behind CTA buttons
            document.getElementById('andrd_link').setAttribute('href', result_url);
            document.getElementById('ios_link').setAttribute('href', result_url);
            // Optionally - Create QR code from the generated OneLink URL
            window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
            //The size of the QR code is defined in the CSS file under #my_qr_code_div_id
            // #my_qr_code_div_id canvas { 
            //  height: 200px;
            //  width: 200px;
            //}
            // Optionally - fire an impression.
            // The impression will fire to https://impressions.onelink.me//.... 
            setTimeout(() => {
              window.AF_SMART_SCRIPT.fireImpressionsLink();
              console.log("Impression fired"); 
            }, 1000);
      }

Use Google Tag Manager

Google Tag Managerでスマートスクリプトを設定する方法：

1. マーケティング担当者が指示に従って、スマートスクリプトのコードをGTMに設定したことを確認します。
2. Check the return value in AF_SMART_SCRIPT_RESULT. Possible return values are:
   • 送信用OneLink URL：必要に応じて結果の値を使用します。
     例：WebサイトのCTA（アプリダウンロード）URLにリンクとして配置する、など
   • null. If the script returns null, implement your desired error flow. For example: the web/landing page's existing URL is not changed.

      var result_url = AF_SMART_SCRIPT_RESULT.clickURL;
      if (result_url) {
            document.getElementById('andrd_link').setAttribute('href', result_url);
            document.getElementById('ios_link').setAttribute('href', result_url);
            // Optionally - Create QR code from the generated OneLink URL
            window.AF_SMART_SCRIPT.displayQrCode("my_qr_code_div_id");
            //The size of the QR code is defined in the CSS file under #my_qr_code_div_id
            // #my_qr_code_div_id canvas { 
            //  height: 200px;
            //  width: 200px;
            //}
            // Optionally - fire an impression.
            // The impression will fire to https://impressions.onelink.me//.... 
            setTimeout(() => {
              window.AF_SMART_SCRIPT.fireImpressionsLink();
              console.log("Impression fired"); 
            }, 1000);            
      }

3. スマートスクリプトのテストページでスクリプトをテストし、正しい送信URLが生成されていることを確認します。

Create a QR code with the Smart Script result

前提条件： スマートスクリプト V2.6+以降の実装

📘

推奨：

• アプリのブランドに応じて、中央のロゴとQRコードの色を変更してQRコードをカスタマイズします。
• ユーザーがデスクトップでアクセスしている際にはQRコードを表示し、ユーザーがモバイルにいるときはリンク付きのボタンを表示します。

QRコードを作成する方法：

1. サイトのHTMLページに特定のIDを持つ div タグを作成して QRコードをホストしてください。
   div タグのスタイルは、好きなように設定できます。
2. スマートスクリプトを実行してOneLink URLを生成したら、次のメソッドを呼び出します： displayQrCode

displayQrCode

メソッドのシグネチャ

const qrOptions = {
  logo,
  colorCode
}

window.AF_SMART_SCRIPT.displayQrCode(divId, qrOptions)

引数の入力

qrOptions object

使用例：

• QR code without logo and without custom color Github example
• QR code with logo and custom code color Github example

Fire an impression

インプレッションは、ページの読み込み時、CTAやバナーの表示時などに発生させることができます。
注意： インプレッションはモバイル端末でのみ発生させることができます。デスクトップ上では発火されません。

前提条件： スマートスクリプト V2.2+

インプレッションを発火させるには：

1. 指示に従ってスマートスクリプトを実行し、クリックURLを生成します。
2. 結果が有効である（null ではない）ことを確認してください。
3. 次のインプレッションファンクションを実行します：

🚧

必須の回避策

呼び出しをラップしてください fireImpressionsLink with setTimeout 呼び出しの間に少なくとも 1 秒の遅延があることを確認するには generateOneLinkURL and fireImpressionsLink

setTimeout(() => {
  window.AF_SMART_SCRIPT.fireImpressionsLink();
  console.log("Impression fired"); 
}, 1000);

You can find examples for firing impressions for mobile only and for cross platform support

引数

オブジェクトの構成

OneLinkスマートスクリプトは、受信URLのパラメータとスクリプトに定義された引数を用いて、送信URLを生成します。afParameters 引数は、アトリビューションやディープリンクに使用される他のいくつかの引数（パラメータ）で構成される構造を持っており、それぞれの引数には、次の表に示すように、キー、オーバーライド（上書き）値、デフォルト値を持つオブジェクト構成が含まれています。

例

Basic attribution

media_source と campaignに単一のキーを使用している、受信URLから送信OneLink URLへの基本的な変換の例を参照してください。

Multiple keys

media_source と campaignに複数のキーを使用している、受信URLから送信OneLink URLへの変換の例を参照してください。

UTM parameters

media_source と campaignにUTMパラメーターを使用している、受信URLから送信OneLink URLへの基本的な変換の例を参照してください。

Override values

受信 media_source の値を置き換えている、受信URLから送信OneLink URLへ変換の例を参照してください。

Default values

受信した media_source の値が見つからない場合に、デフォルト値を使用している受信URLから送信OneLink URLへの変換の例を参照してください。

Forced default values

受信 media_source の値が見つかった場合でも、デフォルト値を使用している、受信URLから送信OneLink URLへの基本的な変換の例を参照してください。

GBRAID and WBRAID

See example of the conversion of an incoming URL to an outgoing OneLink URL, passing the gbraid parameter and another example for passing the wbraid パラメーター

Google click ID passthrough

See example of the conversion of an incoming URL to an outgoing OneLink URL that passes the Google click ID to af_sub4 and gclid.
As of Smart Script version 2.8.1, the GCLID is automatically forwarded to the outgoing URL when present in the incoming URL.
Note: When a GCLID is detected, the script searches for the incoming keyword parameter, and inserts its value into the outgoing URL as the value for the af_keywords パラメーター

Facebook click ID passthrough

See example of the conversion of an incoming URL to an outgoing OneLink URL that passes the Facebook click ID to af_sub2 and fbclid.
As of Smart Script version 2.8.1, the FBCLID is automatically forwarded to the outgoing URL when present in the incoming URL.

Set attribution and OneLink parameters

AppsFlyerのアトリビューションとOneLinkパラメータを使用して、受信URLを送信OneLink URLに変換している例を参照してください。

Set additional custom parameters

See example of the conversion of an incoming URL to an outgoing OneLink URL with additional custom parameters.

Referrer skip list

特定のクリック（例えば、TwitterまたはFacebook）に対してスマートスクリプトを無効にする方法について例を参照してください。クリックのHTTPリファラにスキップリストの文字列が含まれている場合、スマートスクリプトは https://appsflyersdk.github.io/appsflyer-onelink-smart-script/examples/referrer_skip_list.html?incmp=gogo&inmedia=email を返します。 null.

URL skip list

See example of how you can disable the Smart Script for a particular string in the URL (for example, af_r) by creating a skip list. If any of the strings in the skip list appear in the URL of the click, the Smart Script returns null.

Smart Script set up with Google Tag Manager

Google Tag Managerを使ったOneLinkスマートスクリプトの設定を使用した場合の受信URLから送信OneLink URLへの変換の例を参照してください。

Impressions - OneLink Template with mobile-only support

モバイルデバイスのみを持つOneLinkテンプレートを使用して発生したインプレッションの例 をご覧ください。

🚧

必須の回避策

呼び出しをラップしてください fireImpressionsLink with setTimeout 呼び出しの間に少なくとも 1 秒の遅延があることを確認するには generateOneLinkURL and fireImpressionsLink

Impressions - OneLink Template with Cross-platform support

クロスプラットフォームをサポートしているOneLinkテンプレートを使用して発生したインプレッションの例 をご覧ください。
参照：モバイル以外のプラットフォーム（PCやコンソールなど）から発生したインプレッションの例

📘

Firing an impression from a cross platform landing page

You can find here a code example for firing an impression from a demo landing page

🚧

必須の回避策

呼び出しをラップしてください fireImpressionsLink with setTimeout 呼び出しの間に少なくとも 1 秒の遅延があることを確認するには generateOneLinkURL and fireImpressionsLink

Preserve incoming URL parameters across pages

📘

Smart Scriptバージョン2.5.0以降で利用可能です。

ランディングページの受信パラメータ（例： utm_source{0}）は、デフォルトではWebサイト内の他のページに渡されません。すべての Web サイトページにスマートスクリプトをインポートすると、受信URLパラメータが保持され、スマートスクリプトが他のページで使用できるようになります。

このユースケースの例についてはこちらをご覧ください。

Copy HTTP referrer to outgoing URL

📘

Available from version 2.7.0.

You can set Smart Script to copy the HTTP document.referrer to either a custom outgoing URL parameter or predefined outgoing URL parameters. If you want to see web referrer values in dashboards or in raw data reports, we suggest using one of the following predefined outgoing URL parameters:

• af_channel - Parameter is available in dashboards and raw data
• af_sub1-5 - The parameter is available in raw data under the af_sub1-5 columns and in the original URL column.

If you want to set a custom parameter, Smart Script has to copy the  document.referrer property value and set it as the value of the parameter. In this example, Smart Script copies the document.referrer value to a custom outgoing URL parameter key defined by webReferrer. The selected custom key in the example is this_referrer.

For more information, see Web referrer mapping.

Utilizing Local Storage to Set Parameters for Deep Linking

You can choose to save any data from the website to local storage, and then configure Smart Script to retrieve this data and assign it to an outgoing URL parameter. For example, you can leverage website information to dynamically populate the deep_link_value parameter, enabling the deep linking of users directly to the app's relevant content.

In this example, you can see how the outgoing URL deep_link_value is populated by a value copied from the website's local storage. The copied value in this example is the product ID arriving from the website data.