应用下载类 API 归因上报（上篇）| 快手的推广流程

快手广告主依要求填写监测链接，当用户产生行为（如点击）后，监测链接会进行宏参数替换。接着，通过接口，快手将替换后的宏参数信息（设备号）和 callback 传递给快手广告主。快手广告主的 app 接收深度行为记录，然后依据快手传来的设备号与自身的 app 进行匹配归因，最终将匹配好的数据回传给快手。

对于应用下载类的快手广告，用户点击广告后，会对应用展开“下载-安装-激活-注册/次留/付费等应用内行为”这种由浅入深的操作。在应用的不同投放阶段，快手广告主期望获取不同深度的用户，那些他们期望用户达成的操作即为“转化目标”（例如，若快手广告主想获取更多激活用户，“激活”就是“转化目标”；若想获取更多注册用户，“注册”就是“转化目标”）。

然而，快手仅能监测到用户在快手端的广告展示和点击等行为，无法监测到用户的应用内行为；快手广告主能够监测到用户的应用内行为，却无法监测到用户在快手端的广告展示和点击行为。所以，我们需要“转化跟踪”来达成信息的互通，以此提升广告的优化效果和投放效率。

快手广告主按规定填写监测链接，快手系统会自动替换其中的宏参数，从而为快手广告主提供广告展示点击用户的 IMEI、IDFA、OAID、ANDROIDID 等设备信息，广告主把这些信息与自己监测到的转化用户的相关信息进行匹配，并上报给快手广告投放平台。

比如，快手这边监测到 imei 号为 123456789 的用户在快手客户端点击了快手广告主的相关广告，快手会把该用户的相关信息通过监测链接发送给快手广告主。若快手广告主监测到 imei 号分别为 123456789 和 abcdefgh 的两个新增转化用户，那么快手广告主需要将这两个用户的设备信息与之前快手发送的用户信息进行匹配，imei 号为 123456789 的用户成功匹配，就将该用户的信息通过回调地址回调给快手；imei 号为 abcdefgh 的用户无法成功匹配，则不必回传给快手。

快手广告主通过约定特定格式的字符串，用于代表将来要替换的字段位置，这种格式统称为“宏”。宏参数需填写在快手广告主原链接的后面，当用户点击广告后，广告主能够通过设定好的规则（宏），获取到用户相应的信息。

这些均为设备标识符，具体情况如下。

对于 Android 版本小于 6.0 的情况，只需拥有 READ_PHONE_STATE 静态权限（安装 App 时即可获取该权限），就能通过系统 API TelephonyManager#getDeviceld API 获取准确值；对于 6.0 到 9.0 之间的 Android 版本，READ_PHONE_STATE 升级为动态权限，安装 App 时无法获得该权限，需在 App 运行时，经用户在弹窗确认授权后才可获取；对于 Android 版本大于等于 10.0 的情况，设备不可变 ID 的隐私保护进一步加强，需要 READ_PRIVILEGED_PHONE_STATE 权限才能获取 IMEI，而该权限只有系统级别的应用才能获得，因此一般 App 无法获取到 IMEI。

这是目前 iOS 系统主流的获取设备标识符的方式。用户可自行开启或关闭，每次切换会产生新的取值。在 10 以下的版本关闭时也能获取到唯一值，而大于等于 10 的 iOS 版本关闭时获取到的值为 00000000000；当系统大版本升级（如从 11 到 12）时，IDFA 也会发生变化。

在 Android 版本等于 8.0 时，应用签名、用户（即系统上的用户账号）和设备的每个组合都具有唯一的 ANDROID_ID 值，即使系统升级也不会改变。

这是由移动安全联盟（简称 MSA）制定的匿名设备标识符，保留原始值，无需 MD5 编码。可用于 android 系统，补充设备标识，通常 android10 以上的国内主流设备都能够获取。具体的 OAID 介绍以及最新覆盖的厂商范围请详见[MSA 官网]。

在快手广告投放平台创建广告，按照流程操作。

进行转化追踪，并填写对应的监测链接。

依照流程填写监测链接。

监测链接主要由三部分构成：

https://www.example.com? + xx=XXXX + 宏参数（必填）

示例如下：

ios：

https://www.example.com?xxx=XXXX&idfaMD5=__IDFA2__&callback=__CALLBACK__&campaignid=__DID__

Android:

https://www.example.com?xxx=XXXX&oaidMD5=__OAID2__&callback=__CALLBACK__&campaignid=__DID__

监测链接拆分解读：

第一部分：https://www.example.com?

这部分是广告接收点击上报数据的地址，需由快手广告主自行修改。千万不能将其填写成下载链接！！！

第二部分：xxx=XXXX

这部分是快手广告主自定义的参数信息，常见的如 channel = kuaishou，快手在上报时会原样返回，不做任何修改。

第三部分：

这部分极为重要！！ 例如 idfaMD5=__IDFA2_，“idfaMD5” 这部分由快手广告主自定，快手无要求，但后面的__IDFA2__/__OAID2__在上报时，会替换为相应的 md5 加密设备号，其他参数也能获取，比如在链接地址中添加&mac2=__MAC2__，能够获取 md5 加密的 mac 信息，具体可支持的参数列表可查看下方参数说明。必须使用快手规定的参数及格式，否则会出错。 其中__CALLBACK__为必填参数，不能写成__CALL_BACK__ 或其他字段，详细参数请见附件一 。

实例：

快手广告主填写的监测链接为：

https://www.test.com/kuaishoutype=kuaishou&accountid=__ACCOUNTID__&aid=__AID__&cid=__CID__&oaidMD5=__OAID2__&callback=__CALLBACK__

用户点击后会得到：

https://www.test.com/kuaishoutype=kuaishou&aid=2656338&cid=223372032123415808&oaidMD5=d89922d5a0ea3b9894d36bd44a42331c&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd

宏替换结果：

对监测链接的宏变量的被替换后的值有三种可能：

1、被替换为空

2、保持原样，不替换

3、被替换成预期值

其中 1 和 2 是不同的策略，是针对老版本客户端对不识别的宏变量的替换策略问题。客户端只能识别自身版本发布时的全部已知宏变量，对于后期新增的，就会采用 1 或者 2 的策略。这也导致系统在判断监测链接是否为下载链接时，会自动请求一次监测链接，此时完全不替换，属于正常情况，量级极小，不影响正常投放。

按照流程进行即可，其中需要快手广告主在联调前，确保重启快手 APP，如果发现页刷不到联调广告，可尝试在发现页内流刷一下。

出现下图意味着联调成功，需要快手广告主的技术人员将点击数据回传给快手。

快手广告主把转化行为通过上传接口并拼接事件参数带着原 callback（接口一中的）回传给快手，上报接口及详情见下方附件二。