追踪链接记录了用户如何与您的广告互动。用户活动以点击或观看的形式报告。用户点击归因链接后,会被重定向以下载 App。该点击随即会触发一个发送给 AppsFlyer 服务器的通知。本指南包含您需要了解的有关 Appsflyer 追踪链接的所有信息。
Appsflyer 追踪链接的组成结构
必要的追踪链接参数
参数 | 说明 |
app.appsflyer.com | 这是 Appsflyer 的末端。 |
app_id | 这是 Appsflyer 中的唯一标识符。格式通常遵循 Apple App Store 或 Google Play ID 的格式。 |
media_source | 这是 Moloco 合作伙伴(即 Appsflyer)的唯一标识符。 |
AppsFlyer 追踪链接包含以下属性。请务必检查 Appflyer 追踪链接是否包含以下所有信息。
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上的 Campaign 名称。
|
|
af_c_id | {{campaign.id}} |
%{campaign_name}
|
CT,VT |
这是 Moloco Ads上字母数字格式的 Campaign ID。
|
|
af_siteid | {{publisher.bundle}} |
%{raw_app_bundle}
|
CT,VT |
这是展示广告的发布商的 Store 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 | Ad Exchange 名称 |
[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 追踪链接。若要了解如何解决与追踪链接相关的常见错误,请参阅故障排除指南。
Host
Moloco Ads将验证以下追踪链接类型的 Host 值:展示(即观看)和点击。如果追踪链接不包括以下 Host 值或追踪链接的 Host 值与下列值不同,则会显示错误消息。
展示 | 点击 |
https://impression.appsflyer.com/ | https://app.appsflyer.com/ |
路径
Moloco Ads会针对 OS 兼容性验证路径值。如果出现以下情况之一,会显示错误消息。
1) 所选的 App OS 与追踪链接的 OS 不同。
2) 路径值与 Appsflyer 的路径格式不同,如下表所示。路径值必须与相应的 App market 商店的安装包名称相同。
OS 类型 | 路径值格式 | 示例 |
Android | 以句号分隔的字母数字字符 | https://impression.appsflyer.com/moloco.cloud.portal |
iOS | 以下列字符开头的数字 id
|
https://impression.appsflyer.com/id111110100 |
您的追踪链接路径值,即 app_id
值必须与其关联的 App 的 MMP Bundle ID 相同。如果检测到两个值不匹配,将显示错误消息。
必要参数
下表显示了必要参数和值对的规范。如果以下任何一项缺失,您将无法创建或更新追踪链接。
参数 | 值 | 注释 |
&pid | moloco_int | |
&af_sub4 | {{mtid}} | |
&idfa | {{device.idfa}} | 仅限 iOS |
&advertising_id | {{device.gaid}} | 仅限 Android |
OneLink
本节介绍 Moloco 如何验证 OneLink 追踪链接。若要了解如何解决与追踪链接相关的常见错误,请参阅故障排除指南。
Host
OneLink 追踪链接的 URL Host 必须以 onelink.me
结尾。
例如, httsp://qbc123.onelink.me
路径
OneLink 追踪链接可能没有路径值。如果有路径值,该值必须包含字母、数字和下划线。
必要参数
下表显示了必要参数和值对的规范。如果以下任何一项缺失,您将无法创建或更新追踪链接。
参数 | 值 | 注释 |
&pid | moloco_int | |
&af_sub4 | {{mtid}} | |
&idfa | {{device.idfa}} | 仅限 iOS |
&advertising_id | {{device.gaid}} | 仅限 Android |