附件一 ：监测参数表
以下为快手支持的参数值及对应说明。其中，无对应值或快手未获取到值的占位符，不做替换或替换为空字符串（非空格），注意：占位符前后都为双下划线。
占位符 |
系统 |
说明 |
例子 |
__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 |
__IMEI2__ |
Android |
对15位数字的 IMEI （比如860576038225452）进行 MD5（备注：安卓广告唯一标示，imei双卡手机可能有两个，取默认的一个） |
9a950230e16e0e5adace1cbded88478br |
__IMEI3__ |
Android |
Android下的IMEI，原文计算SHA1 |
BF776E787C360D5B031BF1C877BCDF42BEFF456D（格式样例） |
__IMEI4__ |
Android |
IMEI进行 MD5，适配三方监测方案，imei2 imei4取一个即可，都会替换 |
9a950230e16e0e5adace1cbded88478b |
__OAID2__ |
Android |
Android设备标识计算MD5(引强烈建议使用) |
|
__IDFA2__ |
iOS |
iOS下的idfa计算MD5，规则为32位十六进制数字+4位连接符-"的原文(比如: 32ED3EE5-9968-4F25-A015-DE3CFF569568)，再计算MD5，再转大写。 |
737C5E53A3CDD1904CCOE71B31E5244D |
__IDFA3__ |
iOS |
iOS下的idfa计算SHA1，规则是原文带"-"，计算SHA1 |
9E0A1817011FBAFOD8E52BCB078DCA8D5DA4AE99(格式样例) |
_KENYID_CAA_ |
iOS |
URL Encode后的JSON数组;其中kenyld为中广协ID(即CAID), kenyld_MD5为CAID原值MD5加密后的结果(32位小写) , version为信通院算法包版本号，支持两个版本同时下发(即最新版和上一版) 举例:如果版本未更新则只会下发一个kenyld+kenyld_MD5+version组合 如果版本有更新，我们也只会下发最近的两个版本的kenyld+kenyld_MD5+version组合 |
URLEncode(""[fT"kenyld";:"12345","kenyld_MD51":v"827ccb0eea8a706c4c34a16891f84e7b","version":20200801},f"kenyld\":1"6789O", "kenyld_MD5\":Y"1e01ba3e07ac48cbdab2d3284d1dd0fav", "version\":20200901}] |
__MAC2__ |
Android |
对MAC进行MD5 |
a96bf42b5fbe32456071b4af0291d7bd |
__MAC3__ |
Android |
对MAC去除分隔符之后进行MD5 |
df141bb66712b729acab5feb2ce59e16 |
__ANDROIDID2__ |
Android |
对ANDROIDID (举例:8t6581815307be28)进行MD5 |
c3b54dbc33e7eb69e0c3758158a79daf |
__ANDROIDID3__ |
Android |
Android下的AndroidlD，原文计算SHA1 |
E7456CB4325E42A16FE75B9DDDC29BE91EFD6E32(格式样例) |
__OS__ |
Android|IOS |
操作系统 |
0:Android, 1:ios，3:其他 |
__TS__ |
Android|IOS |
UTC时间戳，自1970年起的毫秒数，取当前设备返回的系统时间，可能和实际时间有误差 |
154597327200o |
__IP__ |
Android|IOS |
用户IP地址(IPV4) |
123.89.234.34 |
__IPV6__ |
Android|IOS |
用户IP地址(IPV6) |
|
__UA__ |
Android|IOS |
用户代理(User Agent) |
上报时Encode—次，样仍救口下:Dalvik%2F2.1.0+(Linux%3B+U%3B+Android+10%3B+HMA-ALOO+Build%2FHUAWEIHMA-ALO0) Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_4%20like%20Mac%20OS%20X%29%20AppleWebKit%2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F15E148 |
__CSITE__ |
Android|IOS |
广告投放场景 |
1-优选广告，2-快手信息流广告(日投放场景，含上下滑大屏广告)，3-视烦播放页广告，5-快手联盟广告，6-上下滑大屏广告，7-快手信息流广告(不含上下滑大屏广告)27-开屏位置39-快手搜索广告24-激励视频 |
__CALLBACK__ |
Android|IOS |
回调信息，编码─次的URL，长度小于10k |
http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJKd |
__MODEL__ |
iOS |
设备型号 |
iPhone10 |
__AC_CREATIVE__ |
Android|IOS |
是否为高级创意 |
1：是 |
__WINFOID__ |
Android|IOS |
仅支持搜索流量，winfoid可通过 marketing api中关键词接口获得，对应word_info_id，如果为非搜索流量或智能扩词流量，则winfoid不替换 |
16015060 |
附件二︰回传参数说明
请求方:广告主提供的监测平台服务器处理方:快手广告服务器
请求协议:HTTP、HTTPS请求方式: GET
请求地址: http:/lad.partner.gifshow.com/track/activate
回传参数列表:
参数名 |
类型 |
是否 必填 |
参数含义 |
描述 |
callback |
string |
必填 |
广告ID |
接口一接收的__CALLBACK__替换后的http地址中的callback参数 (参考下方示例中标红处) |
event_type |
int |
必填 |
转化事件类型 |
枚举值见下方附录， 建议对接前与快手运营同学沟通确认。 |
event_time |
long |
必填 |
事件转化时间 |
单位:毫秒，13位级时间翟戳 |
purchase_amount |
double |
选填 |
付费金额 |
付费、授信、商品浏览、添加购物车、提交订单等转化事件必填， 单位元，保留两位小数 |
user_tags_age |
int |
选填 |
用户年龄 |
仅限保险行业使用 |
user_tags_insurance |
int |
选填 |
社保情况 |
仅限保险行业使用，取值:0-无社保、1-ext_pred_ltv社保、2-其他。 |
weighted_purchase_amount |
double |
选填 |
加权付费金额 |
仅限保险行业使用 |
action_reason |
int |
选填 |
行为原因 |
当event_type为{120,121}时必填，枚举值见下方表格 |
key_action_category |
string |
选填 |
关键行为类型 |
当event_type=143时必填，枚举值见下方表格 |
key_action_threshold |
double |
选填 |
关键行为定义对应的次数/ 数量/等级/金额等信息 |
当event_type=143时必填，枚举值见下方表格 |
ext_pred_ltv |
double |
选填 |
预估LTV |
|
ext_pred_pay_ratio |
double |
选填 |
预估付费率 |
|
pay_level |
string |
选填 |
付费等级 |
S小RM中R L大R event_type=151回传 |
novel_chapter_num |
int |
选填 |
小说章节 |
1-1000,event_type=150回传 |
convsersion_score |
double |
选填 |
转化质量分 |
分数可选择【0，1】之间的数。要求质量分和用户价值有线性关系， 比如0.4质量分用户的价值是0.2质量分用户价值的两倍 |
event_props |
json string |
选填 |
自定义事件属性 |
用户自定义事件回传 |
事件类型event_type参数值:
event type参数值 |
含义 |
行业 |
备注 |
1 |
激活 |
不限 |
|
2 |
注册 |
不限 |
仅需传第一次注册 |
3 |
付费 |
不限 |
多次产生付费行为可多次回传，请求的callback地址相同， 需要同时回传purchase_amount参数 weighted_purchase_amount参数（仅限保险行业使用) |
5 |
活跃 |
不限 |
活跃:用户每次成功打开访问app，回传「活跃」 时需要携带该设备发生「激活」时对应的callback |
6 |
|||
10 |
完件 |
金融 |
|
11 |
授信 |
金融 |
|
12 |
商品浏览 |
电商 |
需要同时回传purchase amount参数 |
13 |
添加购物车 |
电商 |
需要同时回传purchase amount参数 |
14 |
提交订单 |
电商 |
需要同时回传purchase amount参数 |
15 |
订单支付 |
电商 |
需要同时回传purchase amount参数 |
30 |
上报游戏时长 |
游戏 |
|
31 |
创建游戏角色 |
游戏 |
|
32 |
升级游戏角色 |
游戏 |
|
39 |
人脸识别完成 |
金融 |
|
40 |
身份信息填写完成 |
金融 |
|
41 |
银行卡信息填写完成 |
金融 |
附件三︰返回信息
Android
快应用回传
1、快手用户浏览或点击快手客户端展示的快手广告。
2、客户通过魔力建站嵌入快应用，快应用的callback统一由魔力建站填充，客户需在魔力建站填写callback。、
3、广告主或者第三方监测平台接收到快手接口一上报的广告请求后，记录请求参数中的用户信息（例如用户的
IDFA-MD5、IMEI-MD5等)和callback信息(将callback作为唯一匹配值)，后续从产生相关转化的用户中，匹配出由快手推广渠道带来的用户及其转化数据。
4、广告主或者第三方监测平台将匹配出的转化数据，通过请求相应的calback通知快手效果统计服务器(具体见接口二)。
5、快手效果统计服务器将接收到的转化信息和广告投放数据匹配，在投放平台报表中披露出对应广告计划-广告组-广告创意的转化数据。
多触点归因数据回传
