归因链接的结构和参数

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)。

 示例

The following attribution link for the com.greatapp app uses several parameters including Media source  (pid), campaign name (c) and adset ID (af_adset_id). See the table below for the full list of supported attribution link parameters and their explanations.
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

不适用
  • 启用后每次安装将回传给发行商营销合作伙伴。
  • 注意 :当前此参数仅与Pinterest Marketing Partners相关。

 

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

广告类型

使用以下命名惯例:

  • text: 1个 广告单元,仅包含文本,例如搜索结果
  • banner: 显示在设备屏幕顶部或底部的基本格式
  • interstitial: 在当前体验的休息时间出现的全页广告
  • video: 标准视频,即非奖励视频
  • rewarded_video: 通过观看视频的广告单元换取应用内奖励
  • playable:一个n广告单元,其中包含应用程序体验的交互式预览
  • Sponsored_content: 赞助内容中包含链接,如广告文章
  • audio:一个音频广告

String 24

af_click_lookback

归因 窗口

  • 点击归因的窗口期。该窗口的持续时间是指把该新增用户归因给显示该ad/link的渠道的最大CTIT(点击至安装时间)值。
  • 可配置的点击归因窗口期。可用参数值: 1d-30d (天) 或 1h-23h (小时)。默认值为7d。
  • 可以为OneLink和SRN自定义归因窗口。

注意 :仅影响点击URL,而不影响浏览URL。

3 字符上限

af_viewthrough_
lookback

不适用

  • 可配置的浏览归因窗口期。可用参数值: 1h-48h (小时) 或 1d-7d (天)。默认值为1d。
  • 可以为SRN自定义归因窗口。

注意 :仅影响浏览URL,不影响点击URL

3 字符上限

af_channel

渠道

传播广告的媒体渠道,如UAC_Search, UAC_Display, Instagram, Facebook Audience Network等。

动态枚举。String 20

af_keywords

关键词

文本定位广告系列活动的关键字列表

String 100

af_cost_model

成本模式

  • 成本模型,CPI(默认)是当前唯一受支持的模型,当通过单击上报成本时,它将在AppsFlyer的汇总数据报告中显示 成本值。
  • 尽可能通过 API上报花费。 如果通过链接和API上报花费,则API具有优先权。

String 20

af_cost_currency

成本货币

枚举3个字符

af_cost_value

成本值

  • 使用成本货币的成本价值。
  • 小数点后最多4位数字。
  • 只能设置数字(如果需要,请使用小数点)例如:“ 56”,“ 2.85”

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:

  • iphone (all lower case)
  • ipad (all lower case) 
 
归因链接参数- 新客获取和再营销
参数 原始数据中的显示名称 释义

字段类型

is_retargeting

再营销(广告系列) 所有再营销广告系列的点击URL里都应含有&is_retargeting=true
如果不包括该参数或其值为 "false", 则该广告系列会被认为是常规的新用户获取广告系列。

枚举5个字符

af_reengagement_window

再互动窗口期

可在归因链接里添加该参数以更改再互动归因窗口期。

可能的窗口范围选项是:

  • 按天:1-90天或按小时:1-36小时
  • 生命周期:意味着再互动窗口期是无限的。示例: &af_reengagement_window=lifetime

默认值:30天

示例 - &af_reengagement_window=60d 设置的再互动窗口期是60天。

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   音频播放时长
广告类型 (af_ad_type)

安卓专用参数

参数 原始数据中的显示名称 释义

字段类型

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

有关自定义参数的两个重点:

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, 则该用户将被自动归因给 "无" 媒体源, 并且无法了解其初始安装来源

对于自定义来源,请使用非集成的合作伙伴PID
所有已对接渠道只能使用指定PID,以便正确归因其安装。电子邮件、短信、Facebook帖子之类的自有流量渠道可以使用非对接渠道的PID值。
 
仅使用合法字符
如果归因链接的PID参数含有下列字符 ":<>*&?/" - ,那么控制面板上就会把点击/安装显示在invalid_media_source_name名下。

 

 提示

避免在PID 值中使用空格键, 或在使用 URL之前确保已对其进行归因链接编码。

数据粒度级别

可以使用最多四个 URL 参数来深入了解广告效果。

在所有活跃归因链接上使用全部4个参数可以实现下列功能:

  • 把所有用户安装和事件归因给具体的广告
  • 在汇总报告上按广告集、广告系列、广告平台来分级查看和比较所有广告的综合表现,以便优化
  • 在原始数据报告和数据透视表里可以比较所有广告平台的所有广告

参数名称如下:

  1. 广告平台 (pid=)
  2. 广告系列名称(c=)
  3. 广告集 (af_adset=)
  4. 广告名称 (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 的归因链接是动态的还是静态的?

The attribution links are not trackers, and could either be dynamic or static.
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.

谷歌商店的这个报错信息是什么?

如果在下述归因链接之后,您收到谷歌商店的下述报错信息:

TL_error_message.png

这是因为归因链接中包含 # 字符。例如:例如:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

通常,这些字符会存在于链接之中,因为它们是宏且会被其他值动态取代,所以这不是真正的大问题,可以忽略该消息。

订阅者参数有哪些优点?

订阅者参数, 即从af_sub1到af_sub5的参数,可用于记录任何有用的 KPI。这些参数会被解析并显示在原始数据报告里,进而使得汇总或筛选数据变得非常方便。

 示例

一款打车应用-Luber创建了3种颜色的模板:蓝色、黄色和红色。Luber的移动营销人员-Linda想要测试哪种颜色模板带来的安装更多。要做到这一点,她在所有非自归因平台的蓝色广告归因链接里添加了&af_sub3=blue。黄色和红色广告也是如此。这些信息会被解析并显示在原始数据报告里,Linda就可以据此分析不同颜色广告的效果并选择转化率最高的一个。

广告系列名称的最大长度是多少?

AppsFlyer 对归因链接 URL 中的广告系列名称长度限制为100个字符。如果超过字符限制, 则广告系列活动名称将变为以下字符串:c_name_exceeded_max_length

 提示

视频:Playtika的Noam Gohary展示了 3种优化链接结构和数据的最佳方法。

这篇文章有帮助吗?