At a glance: Attribution links report user activity related to clicks and mobile ad impressions to AppsFlyer. Clicking on an attribution link redirects the user to download the app. A copy of the URL clicked is sent to AppsFlyer. Portions of the link are used to populate raw data reports.
AppsFlyer基础归因链接
The base attribution link contains the minimum information required to record the click and redirect the user to download the app. Additional parameters are added to the link after the ? character, to record extra information.
http://app.appsflyer.com/{app_id}?pid={media_source}
基本归因链接包括{App_id} ,它是Apple iTunes / App Store应用程序的应用程序ID,或Google Play的程序包名称,以及付费(媒体渠道)。这是归因链接的最低要求。
注意 :对于Amazon应用程序,请使用捆绑包/软件包名称(而不是ASIN)。
示例
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822
归因链接参数
以下参数可在生成的归因链接中使用。
字段类型列中的数字是参数值的字符数限制。要了解参数值长度限制,请点击这里。
参数 | 原始数据中的显示名称 | 释义 |
字段类型 |
---|---|---|---|
pid | 媒体渠道 | AppsFlyer集成合作伙伴的唯一标识不要更改它更多详情。 |
String 50 |
c | 广告系列活动 | 广告系列名称-由广告主/发行商提供。名称长度超过100个字符的广告系列在控制面板上会被显示为"c_name_exceeded_max_length" |
String 100 |
af_prt |
代理商 |
|
String 50 |
af_mp |
不适用 |
|
|
clickid |
不适用 |
广告平台唯一点击标识符 |
|
af_siteid |
Site ID |
广告平台的发行商ID |
String 24 |
af_sub_siteid |
次级站点ID |
次级广告平台/发行商ID |
String 50 |
af_c_id |
广告系列活动ID |
由广告商/发行商提供 |
String 24 |
af_adset |
广告集 |
|
String 100 |
af_adset_id |
广告集ID |
由广告商/发行商提供 |
String 24 |
af_ad |
广告 |
广告名称(查看更多)-由广告主/发行商提供 |
String 100 |
af_ad_id |
广告ID | 由广告商/发行商提供 |
String 24 |
af_ad_type |
广告类型 |
使用以下命名惯例:
|
String 24 |
af_click_lookback |
归因 窗口期 |
注意 :仅影响点击URL,而不影响浏览URL。 |
3 字符上限 |
af_viewthrough_ |
不适用 |
注意 :仅影响浏览URL,不影响点击URL |
3 字符上限 |
af_channel |
渠道 |
传播广告的媒体渠道,如UAC_Search, UAC_Display, Instagram, Facebook Audience Network等。 |
动态枚举。String 20 |
af_keywords |
关键词 |
文本定位广告系列活动的关键字列表 |
String 100 |
af_cost_model |
成本模式 |
String 20 |
|
af_cost_currency |
成本货币 |
|
枚举3个字符 |
af_cost_value |
成本值 |
|
String 20 |
af_sub [n] (n = 1-5)例:af_sub1 |
Sub param [n] |
广告主的自定义参数有关这些参数的用法的更多信息,请参见“ 常见问题解答”部分。 |
String 100 |
af_r | 不适用 | 把两个平台(Android 和 iOS) 的用户引导至指定的URL | |
af_web_dp | 不适用 | 将桌面(例如Windows或Mac)用户重定向到与OneLink模板中配置不同的网页的URL。使用它来保留其他平台上的桌面用户的归因数据(例如Google Analytics或Omniture) | |
af_dp | 不适用 | 用于启动应用程序的后备值,如果Universal Link或Android App Link方法失败,将使用该值,并且适用于6.0以下的Android用户。它仅应指向基本路径,即默认活动。 | |
af_force_deeplink | 不适用 | 在af_dp值指定的活动里实施深度链接 | |
af_ref | 不适用 |
使用S2S点击的广告平台可以通过下列参数发送一个特有的参照值: &af_ref=参照值
af_ref 值必须由独一无二的值构成,结构如下:
NetworkName_UniqueClickValueForEachClick
示例: af_ref=networkname_123456789ABCDEF
网络名称可以是任意有效字符串。可以是networkname_int 或者仅仅是网络名称。
AppsFlyer可能会使用该参数来进行安卓设备的归因。AppsFlyer不使用该参数来对iOS或Windows设备进行归因。
|
|
is_incentivized | 不适用 |
布尔值:true / false
奖赏性或非奖赏性广告系列活动
|
|
af_param_ forwarding |
不适用 |
|
|
af_os | OS version | [For iOS only] The device operating system version | |
af_model | iOS model type |
[For iOS only] The device model. Values permitted:
|
参数 | 原始数据中的显示名称 | 释义 |
字段类型 |
---|---|---|---|
is_retargeting |
再营销(广告系列) | 所有再营销广告系列的点击URL里都应含有&is_retargeting=true 。如果不包括该参数或其值为 "false", 则该广告系列会被认为是常规的新用户获取广告系列。 |
枚举5个字符 |
af_reengagement_window |
再互动窗口期 |
可在归因链接里添加该参数以更改再互动归因窗口期。 可能的窗口范围选项是:
默认值:30天 示例 - |
3 字符上限 |
广告类型参数
根据广告类型的特性,您还可以发送相关的参数。以下是AppsFlyer支持的“af_ad_type”的参数。
参数 | 值格式 | 释义 |
---|---|---|
af_video_total_length | 可能的视频总长度 | |
af_video_played_length | 观看了多少视频 | |
af_playable_played_length | 试玩元素完全加载后玩了多长时间 | |
af_ad_time_viewed | 广告单元在屏幕上展示的时间 | |
af_ad_displayed_percent | 在设备屏幕上可见的广告单元的最大百分比 | |
af_audio_total_length | 可能的音频总长度 | |
af_audio_played_length | 音频播放时长 |
安卓专用参数
参数 | 原始数据中的显示名称 | 释义 |
字段类型 |
---|---|---|---|
advertising_id |
Advertising ID |
谷歌广告 ID-需要广告平台支持 |
40 字符上限 |
sha1_advertising_id |
不适用 |
通过SHA1加密的谷歌广告ID-需要广告平台支持 |
|
md5_advertising_id |
不适用 |
通过SHA1加密的谷歌广告ID-需要广告平台支持 |
仅支持激活和重归因 |
android_id |
Android ID |
设备 Android _ id-需要广告平台支持 |
20 字符上限 |
sha1_android_id |
不适用 |
通过SHA1加密的安卓设备ID-需要广告平台支持 |
|
md5_android_id |
不适用 |
使用MD5 加密的设备Android_id-需要广告平台支持 |
仅支持激活和重归因 |
imei |
IMEI |
设备 IMEI ID |
|
sha1_imei |
不适用 |
使用SHA1加密的设备IMEI ID-需要广告平台支持 |
|
md5_imei |
不适用 |
使用MD5加密的设备IMEI ID-需要广告平台支持 |
|
OAID |
OAID |
打开匿名设备标识符 |
自Android SDK版本4.10.3起可适用 |
sha1_oaid |
不适用 |
打开使用SHA1加密的匿名设备标识符-需要广告平台支持 |
自Android SDK版本4.10.3起可适用 |
md5_oaid |
不适用 | 打开使用MD5加密的匿名设备标识符-需要广告网络支持 | 自Android SDK版本4.10.3起可适用 |
af_android_url |
不适用 |
Redirect Android users to a different URL than the app page on Google Play. Use for out-of- store apps |
|
sha1_el |
不适用 |
用于桌面电脑到移动端的归因 — 用SHA1加密的电子邮箱。需要广告平台支持 |
|
fire_advertising_id |
不适用 |
Amazon Fire Advertising ID |
|
iOS 专用参数
参数 | 显示名称 | 释义 |
---|---|---|
idfa |
IDFA |
Use upper case. Requires ad network support Field type: 40 char max |
idfv |
IDFV | Use upper case. |
af_ios_url |
Redirect iOS (iPhone or iPad) users to a different URL than the app page on iTunes |
此方法用于落地页引导。 |
af_ios_fallback |
不适用 |
为iOS10.3用户提供后备URL |
sha1_idfa |
不适用 |
IDFA hashed with SHA1. Requires ad network support |
sha1_idfv |
不适用 |
IDFV hashed with SHA1 |
mac |
不适用 |
mac 设备地址。需要广告平台支持。 |
md5_idfv |
不适用 |
IDFV hashed with MD5 |
sha1_mac |
不适用 |
通过SHA1加密的mac设备地址。需要广告平台支持 |
示例
http://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign
可以通过安装报告以及分析、报告、API等查看所有参数。
自定义参数
除了默认参数,Android特定和iOS特定的参数外,您还可以指定自定义参数。如果您希望自定义这些安装归因链接从而优化用户体验和内容,这些自定义参数可以为您提供帮助。
您可以以 parameter = value
的格式将自定义参数附加到归因链接。例如:
http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value
有关自定义参数的两个重点:
- 自定义参数不会显示在原始数据中。
- 可以从 获取转换数据SDK API 检索自定义参数。
Why is publisher ID (PID) the Most Important Parameter?
在所有的归因链接参数里,只有PID是唯一的每个归因链接都必须有的参数。
PID-发布平台ID实际上是媒体渠道的名称。这是把安装归因给其来源的主要字段。
Integrated Partners have their own unique PID value, which ends with "_int". When using Custom Attribution Links you can set any PID name you'd like, as long as it's not reserved by integrated partners.
以下是一些重要的已对接平台的PID示例:organic、googleadwords _ int (Google AdWords)、Facebook ads、Twitter等。您可以使用任何名称的非对接渠道, 如电子邮件, 短信或信鸽。
Avoid common PID issues
使用此参数时,请考虑以下 PID 规则:
如果归因链接里没有PID, 则该用户将被自动归因给 "无" 媒体源, 并且无法了解其初始安装来源。
提示
避免在PID 值中使用空格键, 或在使用 URL之前确保已对其进行归因链接编码。
数据粒度级别
可以使用最多四个 URL 参数来深入了解广告效果。
在所有活跃归因链接上使用全部4个参数可以实现下列功能:
- 把所有用户安装和事件归因给具体的广告
- 在汇总报告上按广告集、广告系列、广告平台来分级查看和比较所有广告的综合表现,以便优化
- 在原始数据报告和数据透视表里可以比较所有广告平台的所有广告
参数名称如下:
广告平台 (pid=)
广告系列名称(c=)
广告集 (af_adset=)
广告名称 (af_ad=)
示例
下述归因链接运用4个级别的粒度来记录在"networkx" 广告平台上进行的 "冬季" 广告系列中的 ”外套“广告集中的"羊绒" 广告。
http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere
FAQ
这些参数要用大写格式还是小写格式?
您可以使用任何一个,但必须保持一致。如果您用大小写来自定义参数,请确保一直使用同样的参数。
比如,如果您设置的是pid=MyMediaSource ,请确保一直使用相同的格式。如果在一个归因链接中使用 pid=MyMediaSource,在另一个归因链接中使用pid=mymediasource ,那就会产生数据差异。归因链接中的其他参数设置也是同理。
AppsFlyer 的归因链接是动态的还是静态的?
How can you tell if a link is dynamic or static?
If the attribution link contains parameters, it's a long pre-defined attribution link, and therefore static.
Only shortened URLs, used for custom attribution links, are dynamic.
This means that once you start using an attribution Link for an integrated partner, or a long URL for owned media, it would not change for any leads engaging with it, even if you change the attribution link values on AppsFlyer's dashboard. For the change to take place, you need to use the new long URL going forward.
On the other hand, shortened URLs for owned media, don't directly contain parameters. When a lead engages with an AppsFlyer's shortened URL, the lead is redirected to AppsFlyer and the current set parameters take place dynamically.
谷歌商店的这个报错信息是什么?
如果在下述归因链接之后,您收到谷歌商店的下述报错信息:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#
通常,这些字符会存在于链接之中,因为它们是宏且会被其他值动态取代,所以这不是真正的大问题,可以忽略该消息。
订阅者参数有哪些优点?
示例
一款打车应用-Luber创建了3种颜色的模板:蓝色、黄色和红色。Luber的移动营销人员-Linda想要测试哪种颜色模板带来的安装更多。要做到这一点,她在所有非自归因平台的蓝色广告归因链接里添加了&af_sub3=blue
。黄色和红色广告也是如此。这些信息会被解析并显示在原始数据报告里,Linda就可以据此分析不同颜色广告的效果并选择转化率最高的一个。
广告系列名称的最大长度是多少?
c_name_exceeded_max_length
提示
视频:Playtika的Noam Gohary展示了 3种优化链接结构和数据的最佳方法。