附件2数据回传(接口二)
转化事件发生后,广告主在请求接口后(httpllad.partner. gifshow.com/tracklactivate)拼接上下图中对应的回传参数,并上报给快手。
转化数据上报接口
请求方:广告主服务器/客户端
处理方:快手广告服务器
请求协议:HTTP
请求方式:GET
请求接口: http://ad.partner.gifshow.com/track/activate
参数详情:
参数名 | 参数含义 | 其他 |
callback | 快手广告ID | 从快手广告投放落地页链接上获取 |
event_type | 转化事件类型 | int类型,枚举值见下方附录 |
event_time | 事件转化时间 | 13位毫秒级时间戳 |
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 decodedfailure" ," host-name".... ...} "R?
A:请求中的callback参数的参数值有误,必须使用通过快手广告上报的完整callback值,文档中的样例值、自行编写的测试值以及不完整的callback值,都会导致上报报错。
多触点回传
如果广告主有能力并愿意将非快手渠道带来的转化数据,通过一定方式匹配到快手广告ID并上报给快手,帮助算法模型更深度地学习理解目标人群的用户特征,有助于提高投放的精准性,提升投放效果。可联系快手运营同学提供多触点对接方案,进行更深度的数据对接。
- 2026-04-18
快手广告平台IM咨询-销售线索链路 - 2026-04-16
快手广告推广:私信达人工作台操作手册 - 2026-04-15
快手广告重磅来袭:私信 × 微信加粉,解锁… - 2026-04-15
快手广告游戏行业SDK深度经营能力全面升级… - 2026-04-13
快手广告平台【IM私信】经营手册 - 2026-04-06
快手广告2026年品牌广告春日营销创新产品 - 2026-03-27
快手广告 | 一键拆解爆款素材基因 - 2026-03-24
快手广告|商家38上新季生意爆发,多维拆解… - 2026-03-24
快手磁力引擎广告 | 对谈36氪,AI下凡驱动… - 2026-03-17
快手品牌广告如何代投实现GMV倍增?




















管理员
该内容暂无评论