抖音资讯

douyinzx

快手广告管理平台:​应用下载类广告转化数据API接口文档《NO.2》

iseeyu3年前 (2024-04-08)抖音资讯152

接口二

接口二用于广告主将应用内转化数据上报给快手广告服务器,快手会将收到的转化数据与广告计划-广告组-广告创意关联,跟踪每个广告创意的转化效果。


1. 简介

请求方:广告主提供的监测平台服务器

处理方:快手广告服务器

请求协议:HTTP HTTPS

请求方式:GET

请求地址:监测方通过接口一接收的__CALLBACK__替换后的http地址(需要拼接相应参数)

参数:

1.callback,接口一接收的__CALLBACK__替换后的http地址中的callback参数(参考下方示例中标红处)。

2.event_type,事件类型,转化事件和参数值的对应关系见下表,建议对接前与快手运营同学沟通确认。

3.event_time,事件时间,13位毫秒级时间戳。若请求中携带event_type参数,则必须同时携带event_time参数。

4.purchase_amount,金额。当event_type为{3,12,13,14,15},必须同时回传消费金额参数purchase_amount,单位元,可保留两位小数。

5.user_tags_age,用户年龄,可选参数,整数,仅限保险行业使用。

6.user_tags_insurance,社保情况,可选参数,整数,仅限保险行业使用,取值:0-无社保、1-ext_pred_ltv社保、2-其他。

7.weighted_purchase_amount,加权付费金额,可选参数,双精度浮点型,仅限保险行业使用。

8.action_reason,行为原因,可选参数,整数,当event_type为{120,121}时强烈建议回传,枚举值见下方表格。

9.key_action_category:关键行为类型,可选参数,整数,当 event_type=143 时强烈建议回传,枚举值见下方表格。

10key_action_threshold:关键行为定义对应的次数/数量/等级/金额等信息,可选参数,数字,当 event_type=143 时强烈建议回传,枚举值见下方表格

11.ext_pred_pay_ratio:预估LTV,可选参数,double。

12.ext_pred_ltv:预估LTV,可选参数,double。

13.pay_level:付费等级,可选参数,具体:S/M/L,event_type=151可回传

14.novel_chapter_num:小说章节,可选参数,1-1000。event_type=150可回传



2. 回调请求

回调的请求URL(接口一中__CALLBACK__的对应值,UrlDecode后再拼接相关参数)示例如下:


1)激活

http://ad.partner.gifshow.com/track/activate?event_type=1&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd  (标红区域字段的字符,仅作为样例,不可用于联调)。


2)注册

http://ad.partner.gifshow.com/track/activate?event_type=2&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd  (标红区域字段的字符,仅作为样例,不可用于联调)。


3)付费

http://ad.partner.gifshow.com/track/activate?event_type=3&event_time=1536045380000&purchase_amount=10.88&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd  (标红区域字段的字符,仅作为样例,不可用于联调)。


3. 响应内容

回调后response为JSON格式,result=1代表回调请求上报成功,其他参数及参数值无需关注。


4. 多触点归因数据回传

为提升投放效果,快手希望广告主可以将归因至其它渠道的转化数据也回传至快手,帮助优化深度转化模型训练,上报此类转化数据时,需要增加参数“&is_direct_match=false”,表示“该用户看过快手广告,但转化归因到了其它平台”,此类数据不会计入投放报表展现。上报样例:

http://ad.partner.gifshow.com/track/activate?event_type=1&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd&is_direct_match=false  (标红区域字段的字符,仅作为样例,不可用于联调)


五、联调

广告主可在投放后台“工具-转化追踪-追踪应用”中,新建转化目标,填写相关内容后,按页面说明进行联调。

联调不计入报表,只有体验广告才计入报表。


六、Q&A

强烈建议广告主通过监测链接收集并记录账户/计划/组/创意这四个层级的ID,这样可以清楚的知道转化callback最终上报后,会披露在哪个账户/计划/组/创意下面;我们的广告id已经超过int32位了,请客户按照int64来存储,已经出现有客户因广告id过长导致存储失败,而无法归因的情况。

对接中如果遇到问题,广告主通常可关注以下几点来进行问题排查:1. 是否正确收到监测请求上报,2. 转化归因匹配是否正常,3. 是否成功回调转化callback。

若遇到其他问题,可查看Q&A文档。文档中包含了对接期间注意事项、常见问题的排查方向、以及产生数据差异时,双方的协作流程。

点击这里。


扫描二维码推送至手机访问。

版权声明:本文由西安泽虎代运营发布,如需转载请注明出处。

转载请注明出处https://www.0291.com.cn/post/60974.html

相关文章

直播代运营合同避坑:报价、KPI、违约金一次说清

直播代运营合同避坑:报价、KPI、违约金一次说清

去年西安一家女装店老板拿着合同来找我看,就一页纸,上面写着“保证月销30万”。签的时候高高兴兴,三个月后只卖了8万,代运营公司一句“市场环境不好”就撒手不管了。老板想退钱,翻出合同才发现,什么叫销售额、含不含退款、考核多久、数据以谁为准,一个字都没写。这种坑我这两年见了不止十回。 直播代运营合同看...

抖音千川投放怎么投?2026新手起量避坑指南

抖音千川投放怎么投?2026新手起量避坑指南

西安一家做本地餐饮的老张,去年底听人说抖音能拉客,先充了3000块投DOU+。一个月下来,视频播放量是上去了,团购券没卖出几张。后来他才搞清楚,DOU+是给内容加热用的,真正能把团购券卖出去的工具叫巨量千川。2026年,在抖音上做生意的商家基本绕不开这两个东西:DOU+管内容热度,千川管成交转化。...

抖音短视频带货怎么做?2026年挂车出单实操指南

抖音短视频带货怎么做?2026年挂车出单实操指南

直播带货要开播、要人设、要话术,很多西安商家试了两次就放弃了。其实还有一条更轻的路:短视频带货。拍一条视频挂上商品链接,用户刷到直接下单,不用开播,不用连麦,一个人一部手机就能跑。我见过高新一家卖手工辣条的档口,老板就拍后厨炒料,一条视频爆了,挂车链接三天卖了四千多单。我自己也帮几个西安客户跑过这...

抖音矩阵号怎么做?2026年企业多账号布局实操

抖音矩阵号怎么做?2026年企业多账号布局实操

有个西安做门窗的老板跟我抱怨,说一个号发了大半年,播放量卡在一两千上不去,问我是不是号被限流了。我让他去搜搜本地同行,人家三个号轮着发,客户搜「西安封阳台」,翻两屏全是那一家。这不是玄学,就是矩阵。说白了,矩阵不是一个号发十遍,也不是开十个号复制粘贴,而是按客户会搜什么、信什么,把账号分工排好。尤...

抖音蹭热点总翻车?2026年商家追热点的正确姿势

抖音蹭热点总翻车?2026年商家追热点的正确姿势

上周有个做建材的老板问我:热搜上那个话题全网都在拍,我是不是也该跟一条?我反问他,拍完这条视频,客户凭什么找你买瓷砖?他愣了半天没答上来。这就是大多数商家蹭热点的真实状态——看见热点就冲,拍完发现除了播放量,什么都没留下。热点不是不能蹭,是大多数人都蹭错了。我盘过自己服务的客户数据:蹭热点视频的平...

企业抖音蓝V认证2026流程:材料准备与审核避坑

企业抖音蓝V认证2026流程:材料准备与审核避坑

企业号蓝V认证,现在几乎成了西安本地商家做抖音的起手式。不管是餐饮、装修、教育还是批发档口,想挂电话、想开团购、想投DOU+,基本都绕不开这一步。这篇文章把2026年最新的蓝V认证流程、要准备的材料、审核容易挂的地方一次讲清楚。蓝V认证到底有什么用?值不值600块蓝V说白了就是抖音给企业主体做的实...

现在,非常期待与您的又一次邂逅

我们努力让每一部企业宣传片和抖音短视频成为商业大片