AppsFlyer归因链接结构和参数

简介

AppsFlyer使用归因链接来追踪与移动广告的用户点击及展示相关的多种因素。

当用户点击AppsFlyer归因链接时,该URL会被存储到AppsFlyer数据库,且该用户会被引导至应用下载界面。链接中受支持的参数会被解析,且可以通过AppsFlyer原始数据报告下载这些参数用于进一步分析

AppsFlyer基础归因链接

基础归因链接中含有记录点击和引导用户下载应用所需的最少信息。可在链接里的‘?’后面添加额外参数以记录额外信息。

http://app.appsflyer.com/{app_id}


该基础归因链接通过 app.appsflyer.com 转到 AppsFlyer。该链接包含 {App_id} 参数,这个参数是Apple iTunes/App Store app的应用id,或者是Google Play商店的应用包名。

 示例

com.greatapp 这个应用的下述归因链接就用到了包括发布平台(pid)、广告系列名称(c)以及广告集ID(af_adset_id)在内的多个参数。有关支持的归因链接参数及其说明的完整列表, 请参阅下表。
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822

归因链接参数

生成的归因链接中含有以下参数。

 注意

要了解参数值长度限制,请点击这里

参数 显示名称 释义
pid 媒体渠道 媒体渠道名称-系AppsFlyer 为其已对接合作伙伴提供的名称,不应更改。更多详情
c 广告系列活动 广告系列名称-由广告主/发布平台提供。名称长度超过100个字符的广告系列在控制面板上会被显示为"c_name_exceeded_max_length"

af_prt

代理商

代理帐户名称-可以把新增安装归因给相应代理

af_mp

营销合作伙伴

允许主要广告平台的营销合作伙伴接收每次安装的回传

 注意

目前,该参数仅和Pinterest营销合作伙伴相关。

clickid

不适用

广告平台特有的点击识别参数

af_siteid

Site ID

广告平台的发行商ID

af_sub_siteid

次级站点ID

次级广告平台/发行商ID

af_c_id

广告系列活动ID

广告系列活动ID-由广告主/发行商提供

af_adset

广告集

Adset 名称-由广告主/发布平台提供。Adset(广告集)是广告系列活动和广告之间的一个中间级别。查看更多

af_adset_id

广告集ID

广告集ID-由广告主/发行商提供

af_ad

广告

广告名称(查看更多)-由广告主/发行商提供

af_ad_id

广告ID 广告ID-由广告主/发行商提供

af_ad_type*

广告类型

广告类型 - 使用以下预设名称之一:

文本一种仅包含文本的广告单位,例如搜索结果
横幅 一种展示在设备顶端或底部的基础广告形式
插页 -  一种在当前体验间隙展示的整版广告
视频 -  一种标准的视频广告,也就是非激励视频
激励视频一种以观看视频来换取应用内奖励的广告形式
试玩广告 - 一种包含应用体验互动式预览的广告单位
赞助内容 -  包含在赞助内容里的一个链接,如软文广告
音频 - 音频广告

af_click_lookback

点击归因的窗口期。该窗口的持续时间是指把该新增用户归因给显示该ad/link的渠道的最大CTIT(点击至安装时间)值。

可配置的点击归因窗口期。可用参数值: 1d-30d (天) 或 1h-23h (小时)。默认值为7d。

 注意

仅影响点击URL,不影响展示URL。

af_viewthrough_lookback

展示归因的窗口期

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

 注意

仅影响展示URL,不影响点击URL。

is_retargeting

是否为回流广告系列活动?

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

af_reengagement_window

Re-Engagement Window

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

您可以在这里输入从1天到 90天 (1d-90d), 或从1小时到 36小时(1h-36h)之间的任意值。此参数的默认值为30d。

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

af_channel

渠道

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

af_keywords

关键词

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

af_cost_model

成本模式

成本模式-CPI (默认) 是目前唯一受支持的模式, 可以在 AppsFlyer的汇总数据中填充成本值, 如控制面板的数据总览页面。

af_cost_currency

成本货币

货币代码(如:USD, EUR)。寻找所有的货币代码。默认值是USD。

af_cost_value

成本值

转化成本值。支持至小数点后4位数字。

 重要信息!

仅支持纯数字(必要时可用小数点),例如:“56”、“2.85”等。

af_sub1

Sub Param 1

订阅者参数 1-由广告主定义的可选自定义参数。有关这些参数使用情况的详细信息,请查看常见问题解答部分。

af_sub2 Sub Param 2 订阅者参数2
af_sub3 Sub Param 3 订阅者参数3
af_sub4 Sub Param 4 订阅者参数4
af_sub5 Sub Param 5 订阅者参数5
af_r 不适用 把两个平台(Android 和 iOS) 的用户引导至指定的URL
af_web_dp 不适用 将桌面端用户引导至与OneLink模板配置不同的网页。该参数用于将桌面端用户的归因数据保持在其他平台上(如谷歌分析或Omniture等)
af_dp 不适用 把用户深度链接到某应用内活动的路径。可用此方法进行深度链接和再营销。
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 真/假
奖赏性或非奖赏性广告系列活动
af_param_forwarding 当设置为‘否’时,归因链接里的参数不会被转发给重引导页面
若要获得看起来更干净的重引导页面,或者避免归因链接参数可能会因为重引导页面的查询参数处理而造成问题,可使用此项

* 还可以根据广告类型发送相关的可视性参数, 详细说明互动规格。下面列出了可能的"af _ ad _ type"值以及预期的可视性参数。

参数 值格式 释义
af_video_total_length 秒 (例如"30") 可能的视频总长度
af_video_played_length 秒 (例如"2") 观看了多少视频
af_playable_played_length 秒 (例如"30") 试玩元素完全加载后玩了多长时间
af_ad_time_viewed 秒 (例如"1") 广告单元在屏幕上展示的时间
af_ad_displayed_percent % (例如"75") 在设备屏幕上可见的广告单元的最大百分比
af_audio_total_length 秒 (例如"30") 可能的音频总长度
af_audio_played_length 秒 (例如"2") 音频播放时长

安卓专用参数

参数 显示名称 释义

advertising_id

Advertising ID

谷歌广告 ID-需要广告平台支持

sha1_advertising_id

不适用

通过SHA1加密的谷歌广告ID-需要广告平台支持

android_id

Android ID

设备 Android _ id-需要广告平台支持

sha1_android_id

不适用

通过SHA1加密的安卓设备ID-需要广告平台支持

af_android_url

不适用

将 Android 用户引导至与 Google Play 上不同的URL应用页面。用于商店外应用

sha1_el

不适用

用于桌面电脑到移动端的归因 — 用SHA1加密的电子邮箱。需要广告平台支持

fire_advertising_id

不适用

亚马逊的Fire广告 ID


iOS 专用参数

参数 显示名称 释义

idfa

IDFA

苹果广告主 ID-应使用大写格式。需要广告平台支持

af_ios_url

将 iOS 用户引导至与 iTunes 上不同的 URL应用页面。

此方法用于落地页引导。

af_ios_fallback

不适用

iOS10.3用户提供后备URL

sha1_idfa

不适用

用SHA1加密的苹果广告主ID。需要广告平台支持。

mac

不适用

mac 设备地址。需要广告平台支持。

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等查看所有参数。

为什么 PID (发行商ID) 是最重要的参数?

在所有的归因链接参数里,只有PID是唯一的每个归因链接都必须有的参数。

PID-发布平台ID实际上是媒体渠道的名称。这是把安装归因给其来源的主要字段。

AppsFlyer的每个已对接合作伙伴都有自己特有的 PID 值, 以 "_ int" 结尾。当使用自定义链接时,可以使用已对接平台名称之外的任意名称来命名 PID。

以下是一些重要的已对接平台的PID示例:organic、googleadwords _ int (Google AdWords)、Facebook ads、Twitter等。您可以使用任何名称的非对接渠道, 如电子邮件, 短信或信鸽。

避免这些常见的 PID 问题

使用此参数时,请考虑以下 PID 规则:

1. 归因链接中要始终含有 PID

如果归因链接里没有PID, 则该用户将被自动归因给 "无" 媒体源, 并且无法了解其初始安装来源

2. 自有渠道可以使用非对接合作伙伴 PID
所有已对接渠道只能使用指定PID,以便正确归因其安装。电子邮件、短信、Facebook帖子之类的自有流量渠道可以使用非对接渠道的PID值。
 
3. 仅使用合法字符
如果归因链接的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

常见问题解答

这些参数要用大写格式还是小写格式?

可以使用任一格式,只要格式前后一致即可。如果您用大小写来自定义参数,请确保一直使用同样的参数。

比如,如果您设置的是pid=MyMediaSource ,请确保一直使用相同的格式。如果在一个归因链接中使用 pid=MyMediaSource,在另一个归因链接中使用pid=mymediasource ,那就会产生数据差异。归因链接中的其他参数设置也是同理。

AppsFlyer 的归因链接是动态的还是静态的?

AppsFlyer的归因链接不是跟踪器, 可以是动态的, 也可以是静态的。
如何判断链接是动态的还是静态的?
如果某归因链接含有参数, 并且是一个较长的预定义归因链接, 那么它就是静态的。
只有用于自定义归因链接的短版URL是动态的
这就意味着,一旦开始使用已对接平台的归因链接或自有渠道的长链接,即使在AppsFlyer后台对链接配置进行更改,也无法让与之互动的任何潜在客户跟着变动。若要让这个链接的受众跟着变动,就要使用新的长链接。
此外,自有渠道的短链接里不直接包含参数。当潜在客户与AppsFlyer的短链接发生互动时,该客户就会被引导至AppsFlyer并动态启用当前的参数设置。

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

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

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
这篇文章有帮助吗?
5 人中有 4 人觉得有帮助