一、线索类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）进行 MD 5（备注：安卓广告唯一标示，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

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址：http://www.mqs.net/post/18341.html