トラッキングリンクは、ユーザーが広告とどのようにやり取りしたかを記録します。ユーザーアクティビティは、クリックまたはビューの形式でレポートされます。ユーザーがアトリビューションリンクをクリックすると、アプリをダウンロードするようにリダイレクトされます。クリックすると、AppsFlyerサーバーに通知が送信されます。このガイドには、Appsflyerトラッキングリンクに関して必要な情報がすべて含まれています。
Appsflyerトラッキングリンクの仕組み
必須トラッキングリンクのパラメーター
パラメーター | 説明 |
app.appsflyer.com | これは、Appsflyerのエンドポイントです。 |
app_id | これは、Appsflyerでの一意の識別子です。形式は通常、Apple App StoreまたはGoogle Play IDの形式に従います。 |
media_source | これは、パートナー(つまり、Appsflyer)に対するMolocoの一意の識別子です。 |
AppsFlyerトラッキングリンクは、以下のプロパティで構成されます。Appsflyerトラッキングリンクに、以下の情報がすべて含まれていることを必ず確認してください。
Appsflyerパラメーター | Molocoのマクロ値 | Molocoのマクロ値(レガシー) | プロパティ | マクロ記述 | 注釈 |
af_sub4 | {{mtid}} | %{mtid} | CT,VT |
MTID. これは、Molocoがアトリビューションを識別するために使用するプロト文字列です。
|
|
clickid | {{request.id}} | %{bid_id} | CT,VT | ビッドID | |
pid | moloco_int | moloco_int | CT,VT |
ハードコードされた値は、moloco_intです
|
|
c | {{campaign.title}} | %{campaign} | CT,VT |
これは、Moloco Adsのキャンペーン名です。
|
|
af_c_id | {{campaign.id}} |
%{campaign_name}
|
CT,VT |
これは、Moloco Adsの英数字形式のキャンペーンIDです。
|
|
af_siteid | {{publisher.bundle}} |
%{raw_app_bundle}
|
CT,VT |
これは、広告が表示されるパブリッシャーのストアIDです。
|
|
af_cost_currency | {{price.cost_currency}} |
%{cost_currency}
|
CT,VT | コスト通貨 | |
af_cost_value | {{price.cost_amount}} | %{cost_amount} | CT,VT | コスト金額 | |
af_cost_model | {{price.cost_type}} | %{cost_type} | CT,VT | コストタイプ | |
af_ad_type | {{creative.type}} |
%{creative_type}
|
CT,VT |
クリエイティブファイル名。
|
|
af_ad_id | {{creative.cr_id}} | %{creative_id} | CT,VT |
これは、Moloco AdsのクリエイティブIDです。
|
|
af_ad | {{creative.title}} | %{creative_title} | CT,VT | クリエイティブのタイトル | |
af_adset | {{adgroup.title}} | %{adgroup_title} | CT,VT | アドグループ名 | |
af_adset_id | {{adgroup.id}} | %{adgroup_id} | CT,VT | ||
advertising_id | {{device.gaid}} for Android and {{device.idfa}} for iOS | %{a_idfa} for Android and %{i_idfa} for iOS | CT,VT | ADID(Android)またはIDFA(iOS) | |
af_click_lookback | 7d | 7d | CT | ハードコードされた値 | |
af_viewthrough_lookback | 1d | 1d | VT | ハードコードされた値 | |
&af_sub1 | {{skan.version}} | %{skan.version} | CT,VT | SKAdNetwork(SKAN)バージョン | iOSのみ |
&af_lang | {{device.language}} |
%{device_language}
|
CT,VT | デバイス言語 | S2S |
&af_ua | {{device.user_agent}} | %{user_agent} | CT,VT | ユーザー・エージェント | S2S |
&af_channel | {{request.exchange}} | %{exchange} | CT,VT | アドエクスチェンジ名 |
[Android] クリックスルートラッキングリンクのサンプル
https://app.appsflyer.com/com.appsflyer.adNetworkTest
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_click_lookback=7d
&clickid={{request.id}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[Android] ビュースルートラッキングリンクのサンプル
https://impression.appsflyer.com/com.appsflyer.adNetworkTest
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_viewthrough_lookback=1d
&clickid={{request.id}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] クリックスルートラッキングリンクのサンプル
https://app.appsflyer.com/id554782625
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_click_lookback=7d
&clickid={{request.id}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] ビュースルートラッキングリンクのサンプル
https://impression.appsflyer.com/id554782625
?af_sub4={{mtid}}
&c={{campaign.titl}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.title}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_viewthrough_lookback=1d
&clickid={{request.id}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
Normalトラッキングリンク
このセクションは、MolocoがNormalトラッキングリンクを検証する方法です。一般的なトラッキングリンク関連のエラーを解決する方法は、トラブルシューティングガイドをご覧ください。
ホスト
Moloco Adsは、インプレッション(つまり、ビュー)とクリックのトラッキングリンクタイプのホスト値を検証します。トラッキングリンクに以下のホスト値が含まれていない場合、またはトラッキングリンクのホスト値が以下の値と異なる場合は、エラーメッセージが表示されます。
インプレッション | クリック |
https://impression.appsflyer.com/ | https://app.appsflyer.com/ |
パス
Moloco Adsは、OS互換性のパス値を検証します。以下のいずれかに該当する場合、エラーメッセージが表示されます。
1) アプリで選択されたOSが、トラッキングリンクのOSと異なる。
2) 以下の表のように、パス値がAppsflyerのパス形式と異なる。パス値は、対応するアプリマーケットストアのパッケージ名と同一である必要があります。
OSの種類 | パス値形式 | 例 |
Android | ピリオドで区切られた英数字 | https://impression.appsflyer.com/moloco.cloud.portal |
iOS | 以下で始まる数字 id
|
https://impression.appsflyer.com/id111110100 |
トラッキングリンクのパス値であるapp_id
値は、リンク先アプリのMMPバンドルIDと同一である必要があります。2つの値の不一致が検出されると、エラーメッセージが表示されます。
必須パラメーター
以下の表は、必須パラメーターと値のペアの仕様です。以下のうち一つでも欠けていれば、トラッキングリンクを作成または更新することはできません。
パラメーター | 値 | 注釈 |
&pid | moloco_int | |
&af_sub4 | {{mtid}} | |
&idfa | {{device.idfa}} | iOSのみ |
&advertising_id | {{device.gaid}} | Androidのみ |
OneLink
このセクションは、MolocoがOneLinkトラッキングリンクを検証する方法です。一般的なトラッキングリンク関連のエラーを解決する方法は、トラブルシューティングガイドをご覧ください。
ホスト
OneLinkトラッキングリンクのURLホストは[onelink.me
]で終わる必要があります。
例: httsp://qbc123.onelink.me
パス
OneLinkトラッキングリンクにはパス値がない場合があります。パス値がある場合は、英数字、アンダーバーで構成する必要があります。
必須パラメーター
以下の表は、必須パラメーターと値のペアの仕様です。以下のうち一つでも欠けていれば、トラッキングリンクを作成または更新することはできません。
パラメーター | 値 | 注釈 |
&pid | moloco_int | |
&af_sub4 | {{mtid}} | |
&idfa | {{device.idfa}} | iOSのみ |
&advertising_id | {{device.gaid}} | Androidのみ |