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以降で利用可能です。
詳細と具体的な例はこちらを参照してください。
スマートスクリプト生成ツールを使用して実装する
- マーケティング担当者から、スクリプト、初期化コード、および引数を含むファイルを取得します。
- スマートスクリプトのテストページでスクリプトをテストし、正しい送信URLが生成されていることを確認します。
- スマートスクリプトの結果のテスト/使用手順 に従って進めてください。
スクリプトを手動で実装する
- スクリプトをダウンロードしてください。
- マーケティング担当者から、受信パラメータと送信パラメータをどうマッピングするかのリストを受け取ります。
- スマートスクリプトの引数とオブジェクト構成を初期化してください。
- Web/ランディングページのHTML内のスクリプトを以下の方法で呼び出し、URLSを生成してください:
var result = window.AF_SMART_SCRIPT.generateOneLinkURL({
oneLinkURL,
afParameters,
referrerSkipList, // optional
urlSkipList // optional
})
- スマートスクリプトの結果のテスト/使用手順 に従って進めてください。
スマートスクリプトの結果を確認して使用する
- Check the return value in
result
. Possible return values are:- 送信用OneLink URL:必要に応じて結果の値を使用します。
例:WebサイトのCTA(アプリダウンロード)URLにリンクとして配置する、など null
. If the script returnsnull
, implement your desired error flow. For example: the web/landing page's existing URL is not changed.
- 送信用OneLink URL:必要に応じて結果の値を使用します。
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//....
window.AF_SMART_SCRIPT.fireImpressionsLink();
}
Use Google Tag Manager
Google Tag Managerでスマートスクリプトを設定する方法:
- マーケティング担当者が指示に従って、スマートスクリプトのコードをGTMに設定したことを確認します。
- Check the return value in
AF_SMART_SCRIPT_RESULT
. Possible return values are:- 送信用OneLink URL:必要に応じて結果の値を使用します。
例:WebサイトのCTA(アプリダウンロード)URLにリンクとして配置する、など null
. If the script returnsnull
, implement your desired error flow. For example: the web/landing page's existing URL is not changed.
- 送信用OneLink URL:必要に応じて結果の値を使用します。
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//....
window.AF_SMART_SCRIPT.fireImpressionsLink();
}
- スマートスクリプトのテストページでスクリプトをテストし、正しい送信URLが生成されていることを確認します。
Create a QR code with the Smart Script result
前提条件: スマートスクリプト V2.6+以降の実装
推奨:
- アプリのブランドに応じて、中央のロゴとQRコードの色を変更してQRコードをカスタマイズします。
- ユーザーがデスクトップでアクセスしている際にはQRコードを表示し、ユーザーがモバイルにいるときはリンク付きのボタンを表示します。
QRコードを作成する方法:
- サイトのHTMLページに特定のIDを持つ div タグを作成して QRコードをホストしてください。
div タグのスタイルは、好きなように設定できます。 - スマートスクリプトを実行してOneLink URLを生成したら、次のメソッドを呼び出します:
displayQrCode
displayQrCode
displayQrCode
メソッドのシグネチャ
const qrOptions = {
logo,
colorCode
}
window.AF_SMART_SCRIPT.displayQrCode(divId, qrOptions)
引数の入力
タイプ | 必須 | 名前 | 詳細 | コメント |
---|---|---|---|---|
String | はい | divID | A div HTMLページに特定のIDを持つタグを作成して QRコードをホストしてください。 | |
Object | いいえ | qrOptions | Configuration object (see details in the table below) | If the object is missing, the QR code will be created without a logo in default color |
qrOptions
object
タイプ | 必須 | 名前 | 詳細 | コメント |
---|---|---|---|---|
String | いいえ | logo | A valid image URL or an image data-URI | If the value is invalid, the QR code will be generated without the logo |
String | いいえ | colorCode | Hex color of the QR code | If the value is invalid, the code color will fallback to the default black color |
使用例:
- 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+
インプレッションを発火させるには:
- 指示に従ってスマートスクリプトを実行し、クリックURLを生成します。
- 結果が有効である(null ではない)ことを確認してください。
- 次のインプレッションファンクションを実行します:
window.AF_SMART_SCRIPT.fireImpressionsLink();
引数
Argument | 備考 | 例 | |
---|---|---|---|
oneLinkURL (必須) |
|
|
|
afParameters (必須)
|
mediaSource (必須) |
メディアソースのオブジェクト構成 |
|
campaign |
キャンペーンのオブジェクト構成 |
|
|
channel |
チャネルのオブジェクト構成 |
|
|
ad |
広告のオブジェクト構成 |
|
|
adSet |
広告セットのオブジェクト構成 |
|
|
deepLinkValue |
|
|
|
afSub1-5 |
|
||
googleClickIdKey |
GCLID を持つパラメーターの名前を明記します。 |
||
他の(カスタム)クエリパラメーター |
|
|
|
referrerSkipList |
特定のクリック(TwitterやFacebookなど)のHTTPリファラーに含まれる文字列のリストで、これが見つかった場合、スマートスクリプトは null を返します。この機能は、TwitterやFacebookのような、既にクリックの計測が行われているSRN媒体の場合などに有効です。
|
||
urlSkipList |
特定のクリックに対するURLに含まれる文字列(例:af_r )のうち、見つかった場合にスマートスクリプトが以下を返す文字列: null 。これは、af_r を含むAppsFlyer計測リンクを使用してユーザーをモバイルサイトにリダイレクトし、元のクリックのデータが失われないようにしたい場合に便利です。
|
オブジェクトの構成
OneLinkスマートスクリプトは、受信URLのパラメータとスクリプトに定義された引数を用いて、送信URLを生成します。afParameters 引数は、アトリビューションやディープリンクに使用される他のいくつかの引数(パラメータ)で構成される構造を持っており、それぞれの引数には、次の表に示すように、キー、オーバーライド(上書き)値、デフォルト値を持つオブジェクト構成が含まれています。
Argument | 詳細 | 例 |
---|---|---|
keys |
|
|
overrideValues |
|
例: {'video': 'video_new'} スクリプトのchannel パラメータは、受信値が video の場合、スクリプトが送信URLにおいて video_new に変更します。 |
defaultValue |
|
例: ['web_video'] スクリプトのchannelパラメータについては、パラメータ in_channel が見つからない場合、web_videoがchannelの値として使用されます。 |
例
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への基本的な変換の例を参照してください。
Google click ID passthrough to af_sub
受信URLから、GoogleクリックIDを af_sub4 に渡している送信OneLink URLへの基本的な変換の例を参照してください。注:GCLIDが見つかった場合、スクリプトは受信パラメータキーワードを探し、キーワードの値を af_keywords の値として送信URLに入れます。
Facebook click ID passthrough to af_sub
受信URLから、FacebookクリックIDを af_sub2 に渡している送信OneLink URLへの基本的な変換の例を参照してください。
Set attribution and OneLink parameters
AppsFlyerのアトリビューションとOneLinkパラメータを使用して、受信URLを送信OneLink URLに変換している例を参照してください。
Set additional custom parameters
追加のカスタムパラメーター (代理店向けの「af_prt」を含む) がある場合の受信URLから送信OneLink URLへコンバージョンの例を参照してください。
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
withsetTimeout
呼び出しの間に少なくとも 1 秒の遅延があることを確認するにはgenerateOneLinkURL
andfireImpressionsLink
Impressions - OneLink Template with Cross-platform support
クロスプラットフォームをサポートしているOneLinkテンプレートを使用して発生したインプレッションの例 をご覧ください。
参照:モバイル以外のプラットフォーム(PCやコンソールなど)から発生したインプレッションの例
必須の回避策
呼び出しをラップしてください
fireImpressionsLink
withsetTimeout
呼び出しの間に少なくとも 1 秒の遅延があることを確認するにはgenerateOneLinkURL
andfireImpressionsLink
Preserve incoming URL parameters across pages
Smart Scriptバージョン2.5.0以降で利用可能です。
ランディングページの受信パラメータ(例: utm_source
{0})は、デフォルトではWebサイト内の他のページに渡されません。すべての Web サイトページにスマートスクリプトをインポートすると、受信URLパラメータが保持され、スマートスクリプトが他のページで使用できるようになります。
このユースケースの例についてはこちらをご覧ください。
更新済 16日前