附件一 ：监测参数表
以下为快手支持的参数值及对应说明。其中，无对应值或快手未获取到值的占位符，不做替换或替换为空字符串（非空格），注意：占位符前后都为双下划线。
占位符
系统
说明
例子
__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、快手效果统计服务器将接收到的转化信息和广告投放数据匹配，在投放平台报表中披露出对应广告计划-广告组-广告创意的转化数据。
多触点归因数据回传
为提升投放效果，快手希望广告主可以将归因至其它渠道的转化数据也回传至快手，帮助优化深度转化模型训练,上报此类转化数据时，需要增加参数&is_direct_match=false”，表示'该用户看过快手广告，但转化归因到了其它平台”，此类数据不会计入投放报表展现。
本文标题：应用下载类API归因上报（下）| 快手推广代运营
本文链接：https://www.eatui.cn/xinxiliu/17921.html
