附件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值，都会导致上报报错。
多触点回传
