附件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并上报给快手,帮助算法模型更深度地学习理解目标人群的用户特征,有助于提高投放的精准性,提升投放效果。可联系快手运营同学提供多触点对接方案,进行更深度的数据对接。
本文标题:一、线索类API归因上报(下) | 快手广告
本文链接:https://www.eatui.cn/xinxiliu/17919.html