附件 2 数据回传（接口二）
当转化事件发生后，广告主需在请求指定接口（httpllad.partner.gifshow.com/tracklactivate）时，将下图中对应的回传参数进行拼接，并上报至快手。
转化数据上报接口详情
请求方：广告主的服务器或客户端
处理方：快手广告服务器
请求协议：HTTP
请求方式：GET
请求接口：http://ad.partner.gifshow.com/track/activate
参数详情：
|
参数名 |
参数含义 |
其他 |
|
callback |
快手广告 ID |
从快手广告投放落地页链接获取 |
|
event_type |
转化事件类型 |
int 类型，枚举值见下方附录 |
|
event_time |
事件转化时间 |
13 位毫秒级时间戳 ![图片[1]-一、线索类 API 归因上报（下篇） | 快手广告-精准获客](https://cos.jingzhunhuoke.net/tu/缩略.jpg) |
|
purchase_amount |
付费金额 |
在付费、授信、商品浏览、添加购物车、提交订单等转化事件中需回传，单位为元，保留两位小数 |
|
user_tags_age |
用户年龄 |
可选参数，整数，仅限保险行业使用 |
|
ext_pred_ltv |
预估 LTV |
double |
|
ext_pred_pay_ratio |
预估付费率 |
double |
|
pay_level |
付费等级 |
S 小 R、M 中 R、L 大 R |
|
novel_chapter_num |
小说章节 |
1 – 1000 |
附件 3 转化事件类型参数（event_type）枚举值
|
转化事件类型 |
参数值 |
使用行业 |
备注 |
|
激活 |
1 |
不限 |
|
|
注册 |
2 |
不限 |
仅需传第一次注册 |
|
付费 |
3 |
不限 |
若多次产生付费行为可多次回传，请求的 callback 地址相同，同时需回传 purchase_amount 参数 |
|
活跃 |
5 |
不限 |
用户每次打开 APP 需请求一次 callback |
|
优质用户 |
6 |
不限 |
由广告主自行定义，回传后可辅助快手算法优化模型 |
|
次日留存 |
7 |
不限 |
|
|
七日留存 |
8 |
不限 |
|
|
表单 |
9 |
不限 |
支持投放 H5 落地页类快手广告，以该事件为优化目标 |
|
授信 |
11 |
金融 |
|
|
商品浏览 |
12 |
电商 |
需同时回传 purchase_amount 参数 |
|
添加购物车 |
13 |
电商 |
需同时回传 purchase_amount 参数 |
|
订单提交 |
14 |
电商 |
需同时回传 purchase_amount 参数 |
|
订单支付 |
15 |
电商 |
需同时回传 purchase_amount 参数 |
|
首次试听课到课 |
43 |
教育 |
|
|
有效线索 |
44 |
不限 |
|
|
支付页曝光 |
51 |
不限 |
|
|
微信复制 |
64 |
不限 |
|
|
教育正价课付费 |
69 |
不限 |
|
|
唤起应用 |
84 |
不限 |
要求仅回传通过快手广告点击唤起应用的转化行为 |
|
电话卡激活 |
109 |
IT 消电 |
|
|
电话建联成功 |
116 |
适用行业：招商加盟、家居建材、生活服务、教育 |
|
|
意向确认 |
117 |
适用行业：招商加盟、家居建材、生活服务、教育 |
|
|
微信加粉 |
118 |
适用行业：招商加盟、家居建材、生活服务、教育 |
|
|
成交 |
119 |
适用行业：招商加盟、家居建材、生活服务、教育 |
|
|
电话建联失败 |
120 |
适用行业：招商加盟、家居建材、生活服务、教育 |
action_reason 可选回传电话建联字段，字段类型：int，必须为整数。取值：1.停机 2.空号 3.关机 4.拒接/秒挂 5.无人接听/忙线 |
|
用户无意向 |
121 |
适用行业：招商加盟、家居建材、生活服务、教育 |
action_reason 可选回传无意向字段，字段类型：int，必须为整数。取值：1.非本人提交 2.非本人接电话 3.无购买能力 4.已无购买意愿 5.业务范围不符 |
|
微信二维码链接点击 |
138 |
小程序客户 |
跳转到小程序加微信场景下 |
|
首次试听课完课 |
139 |
教育 |
首次试听课完成 |
|
第 2 次试听课到课 |
140 |
教育 |
第二节试听课开始 |
|
全部试听完课 |
141 |
教育 |
全部试听课完成 |
|
关键行为 |
143 |
游戏 |
强烈建议同时带上参数描述关键行为：key_action_category：根据行为类型回传对应值；key_action_threshold：根据行为类型的次数/数量/等级回传具体数值。 |
|
大小 R 附费 |
150 |
小说 |
可携带 novel_chapter_num 1 – 1000 阅读章节数 |
|
阅读小说张杰 |
151 |
可携带 paylevel 付费等级和付费金额 purchaseAmount |
|
|
乘客首次发单 |
152 |
出行行业 |
|
|
乘客首次完单 |
153 |
出行行业 |
|
|
主提交认证 |
154 |
出行行业 |
|
|
车主认证通过 |
155 |
出行行业 |
|
|
车首次完单 |
156 |
出行行业 |
|
|
外部预估值回传 |
157 |
所有行业 |
可携带预估付费率及预估 LTV |
|
进入小程序 |
179 |
所有行业 |
进入小程序（微信小程序，QQ 小程序，OPPO 小程序等小程序） |
|
24h 口径次留 |
181 |
不限 |
以 24 小时口径算的次留，如今天中午 12 点产生的激活，明天中午 12 点到后天中午 12 点的活跃算作次留（目前使用需加白），需与次日留存字段（7）进行区分 |
|
用户进入游戏服务器 |
182 |
游戏 |
附加参数：服务器类型，server_type，枚举值：1：专服；2：混服 格式：string 注：上传 connection_server 参数必须携带服务器类型参数（server_type） |
常见错误
Q：为何上报时会报错，返回信息提示“{“result”:0 ,”error_msg”:”callbackinfo decoded failure”,”host-name”…….} ”？
A：请求中的 callback 参数的参数值有误，必须使用通过快手广告上报的完整 callback 值，文档中的样例值、自行编写的测试值以及不完整的 callback 值，都会导致上报报错。
多触点回传
若广告主有能力且愿意将非快手渠道带来的转化数据，通过特定方式匹配到快手广告 ID 并上报给快手，这有助于算法模型更深入地学习理解目标人群的用户特征，从而提高投放的精准性，提升投放效果。可联系快手运营人员提供多触点对接方案，以进行更深度的数据对接。
2 本站部分内容来源于网络，仅供学习与参考，如有侵权，请联系网站管理员删除
3 本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
4 精准获客感谢您的访问！希望本站内容对您有所帮助！
暂无评论内容