一、线索类 API 归因上报（上部）

归因流程

用户产生行为（如点击等）后，系统会在落地页拼接带有 callback 的 URL 并下发给广告主，之后用户产生转化行为。

广告主通过用户的手机号与 callback 进行匹配，然后填写回传参数上报给快手。

线索收集类归因逻辑简述

1. 当用户点击广告时，打开的落地页链接会自动拼接 callback 宏参数，不过实际的快手广告组 ID、广告创意 ID、广告计划 ID、广告计划名称等宏参数需自行填写。

2. 广告主的服务端依据落地页请求日志，将自动拼接有参数的落地页 URL（包含唯一且不重复的参数 callback）和用户线索（比如手机号）建立映射关系。比如用户 A、B、C 都在页面提交了表单，其中用户 A 对应 callback 1，用户 B 对应 callback 2，用户 C 对应 callback 3。经过电话回访，三人中 B 用户为有意向的高价值用户，那么就将 B 用户的 callback 2 发送至快手回传地址，记为转化用户。

什么是宏替换？

通过约定特定格式的字符串，用以代表将来需要替换的字段位置，这种格式统称为“宏”。可以将其理解为获取看过广告的用户某些信息的工具，不过格式要求严格。例如广告主想要获取所有用户点击的广告的 ID，会提前在落地页后面写上 _AID_，当用户点击该快手广告后，快手会自动将 _AID_替换为真实的广告 ID，这样快手把替换好的链接发给广告主后，广告主就能获取某一特定用户点击的广告的 ID。

Callback 发挥什么作用？

Callback 是用户观看广告后系统自动拼接在落地页链接后面的一段加密字符串。对每个用户而言都是独一无二且恒定不变的，因此能够作为连接前、后链路的标识。当用户在页面填写自己的手机号后，广告主会将二者关联起来，如此一来快手侧下发的 callback 就能与广告主侧收集的手机号相对应，用户后续的行为广告主也能通过找到用户对应的 callback 传递给快手。

流程说明

监测原理

监测接入流程

1）广告主在 DSP 创建广告，依照流程填写即可。

2）联调成功后开始投放广告。

广告主在快手广告平台配置投放的落地页为：https://www.test.com?utm_source=kuaishou&utm_campaign=June，期望通过转化数据对接，回传落地页上产生的

表单行为

、

付费行为

。

广告主若想获取

实际广告组 ID、广告创意 ID、广告计划 ID、广告计划名等这些信息（

支持的参数详见附件 1

），可在落地页拼接宏参数，格式为：

用户实际点击广告时，系统会默认在落地页 URL 后拼接 callback 得到相应结构的网站，此过程由系统完成，广告主无需操作。

宏参数详情见下方附件一。

3）广告主将转化行为通过上传接口（

http://ad.partner.gifshow.com/track/activate

）并拼接事件参数回传给快手，上报接口及详情见下方附件二。

广告主技术人员通过落地页面代码从 URL 上获取 callback，用户提交表单时，将表单的

手机号

与 callback 关联并存储，填写上报事件参数（见回传参数表），如 event_type、event_time

，同时上报表单事件，event time 为事件转化时间，

上报请求链接样例：

若该用户后续产生了付费行为，通过手机号找到该用户对应的 callback，填写上报事件参数（见回传参数表），如 event_type、event_time，将付费事件上报给快手，上报请求链接样例。

附件 1 监测链接参数（用户点击后）

用户实际点击广告时，系统会默认在落地页 URL 后拼接 callback；监测链接上需填写 __CALLBACK__ 宏参数才会进行替换。若使用宏替换，系统会将用户的信息替换占位符，广告主便能获取这部分用户的信息，比如广告主在 URL 后填写了 __AID__，当用户点击某个广告后，系统会将 __AID__ 替换成用户所点击的广告的 ID。

监测链接参数说明：

占位符	系统	说明	例子
__ACCOUNTID__	iOS/Android	原值，广告账户 ID	12345
__AID__	iOS/Android	原值，广告组 ID	2656338
__CID__	iOS/Android	原值，广告创意 ID	223372032123415808 创意 ID 已超过 int32 的最大值，请广告主务必按照 int64 存储，否则会导致存储失败无法正常归因
__DID__	iOS/Android	原值，广告计划 ID	223372036854775808
__DNAME__	iOS/Android	原值，广告计划名称	游戏-男-18 岁
__PHOTOID__	iOS/Android	原值，素材 ID	2656338
__IP__	iOS/Android	用户 IP 地址（IPV4）	123.89.234.34
__IPV6__	iOS/Android	用户 IP 地址（IPV6）
__IMEI2__	Android	对 15 位数字的 IMEI （比如 860576038225452）进行 MD5（备注：安卓广告唯一标示，imei 双卡手机可能有两个，取默认的一个）	9a950230e16e0e5adace1cbded88478b
__IMEI3__	Android	Android 下的 IMEI，原文计算 SHA1	BF776E787C360D5B031BF1C877BCDF42BEFF456D（格式样例）
__IMEI4__	Android	IMEI 进行 MD5，适配三方监测方案，imei2 和 imei4 取一个即可，都会替换	9a950230e16e0e5adace1cbded88478b
__IDFA__	iOS	iOS 下的 idfa 原值替换	BD49E7C0-9ADF-4A0D-AC31-4B330D53121A
__IDFA2__	iOS	iOS 下的 idfa 计算 MD5，规则为 32 位十六进制数字+4 位连接符“-”的原文（比如：32ED3EE5-9968-4F25-A015-DE3CFF569568），再计算 MD5，再转大写	737C5E53A3CDD1904CC0E71B31E5244D
__IDFA3__	iOS	iOS 下的 idfa 计算 SHA1，规则是原文带“-”，计算 SHA1	9E0A1817011FBAF0D8E52BCB078DCA8D5DA4AE99（格式样例）
__KENYID_CAA__	iOS	URL Encode 后的 JSON 数组；其中 kenyId 为中广协 ID（即 CAID），kenyId_MD5 为 CAID 原值 MD5 加密后的结果（32 位小写）, version 为信通院算法包版本号，支持两个版本同时下发（即最新版和上一版）举例：若版本未更新则只会下发一个 kenyId+kenyId_MD5+version 组合若版本有更新，我们也只会下发最近的两个版本的 kenyId+kenyId_MD5+version 组合	URLEncode(“[{\”kenyId\”:\”12345\”,\”kenyId_MD5\”:\”827ccb0eea8a706c4c34a16891f84e7b\”,\”version\”:20200801},{\”kenyId\”:\”67890\”,\”kenyId_MD5\”:\”1e01ba3e07ac48cbdab2d3284d1dd0fa\”,\”version\”:20200901}]
__MAC2__	Android	对 MAC 进行 MD5	a96bf42b5fbe32456071b4af0291d7bd
__MAC3__	Android	对 MAC 去除分隔符之后进行 MD5	df141bb667f2b729acab5feb2ce59e16
__ANDROIDID2__	Android	对 ANDROIDID（举例:8f6581815307be28）进行 MD5	c3b54dbc33e7eb69e0c3758158a79daf
__ANDROIDID3__	Android	Android 下的 AndroidID，原文计算 SHA1	E7456CB4325E42A16FE75B9DDDC29BE91EFD6E32（格式样例）
__OAID__	Android	Android 下的 OAID	dbeffeff-b9df-723c-9c12-dddedfff87a8
__OAID2__	Android	对 OAID 进行 MD5	c9c32c0caff5c91d120cc55349e69841
__TS__	iOS/Android	UTC 时间戳，自 1970 年起的毫秒数，取当前设备返回的系统时间，可能和实际时间有误差	1545973272000
__UA__	iOS/Android	（7.6.10 及以后版本支持）客户端 UA	进行了 urlencode iOS: Android:Mozilla%2F5.0 + %28Linux%3B + Android + 10%3B + Mi + 10 + Build%2FQKQ1.200419.002%3B + wv%29 + AppleWebKit%2F537.36 + %28KHTML%2C + like + Gecko%29 + Version%2F4.0 + Chrome%2F81.0.4044.138 + Mobile + Safari%2F537.36 Mozilla/5.0 (Linux; Android 10; Mi 10 Build/QKQ1.200419.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/81.0.4044.138 Mobile Safari/537.36
__OS__	iOS/Android	OS 系统	1-iOS，0-安卓
__MODEL__	iOS	手机型号
__WINFOID__	iOS/Android	仅支持搜索流量，winfoid 可通过 marketing api 中关键词接口获得，对应 word_info_id，如果为非搜索流量或智能扩词流量，则 winfoid 不替换	16015060