趣头条 App 转化 API 对接操作流程

6
发表时间:2023-07-09 14:26

1、转化上报接口

1.1实现功能:

广告主在收到 APP 的转化数据后,必须实时匹配点击上报并实时将转化数据上报给趣头条服务器,以免出现统计无效的情况。


1.2回调方案

1、在点击监控接口中,callback_url=__CALLBACK_URL__ 这个宏会被替换成一个urlencode 编码的值

2、广告主收到用户转化数据,并与点击上报匹配成功

3、把 callback_url 返回值 decode 一下,监测平台无需关心这个 URL 的构成和内容, 对监测平台保持透明

4、在 decode 以后的值尾部,拼接&op2 参数,用于区别转化目标的定义(注意:此参数为必填

5、向趣头条发送 GET 请求

6、返回状态码 status:200 表示成功(正式环境和联调环境返回值内容不同,客户只对 status 进行校验即可)

7、若需要回传多级转化,例如同一用户既回传激活也回传注册,则需在用户完成激活事件后,匹配点击上报,匹配成功后拼接对应的 op2 参数,发出回调,之后用户再完成注册事件,再次匹配点击上报,拼接对应的 op2 参数,发出回调即可,回调方式同上

(注:若回传多级转化,激活必须回传)


1.3回调地址示例:

http://rcv.aiclk.com/trace?t=active_third&iclicashsid=9c1XWmq4K3kx3tLMjs-l1tvNBKH_9iOBHQXQGDdX&op2=1&opt_active_time=1567415002


1.4回调参数

归因方式建议:

1、对于安卓系统,建议广告主使用 IMEIMD5、ANDROIDIDMD5 以及 OAID 兼容匹配,由于安卓 6.0 以上版本,需用户授权才可以获取 IMEI,因此仅通过 IMEIMD5 进行匹配可能导致部分转化数据无法匹配,导致回传数据遗漏,投放效果变差

2、设备号匹配优先级说明:IMEIMD5>OAID>ANDROIDIDMD5

3、建议广告主通过 last click 的方式归因,且回调逻辑与自身数据后台归因逻辑保持一致,以避免归因混乱,导致数据无法对齐,最终导致模型效率降低,影响投放


2、联调工具使用:

登录趣头条广告投放平台,在工具箱选项处可以选择 API 转化追踪,即可创建转化监控和联调

3、常见问题解答:

Q:客户后台统计转化数据和趣头条统计数据不一致:

A:首先客户需要排查一下发出多少条回调,是否和自己的平台能对应上Q:收不到转化上报:

A:请求方法和 URL 是否正确, 请求必须使用 GET 方式 ,URL 参照上文说明示例( 如果广告投放目标是 IOS,监控上报链接必须使用 https 协议 )

Q:点击数差异问题:

A:双方平台的去重和反作弊策略不一致可能导致点击数据统计差异

Q:广告主同时在不同渠道投放广告,如何确认点击是来自哪个渠道的:

A:广告主可以在点击监控上报的链接上加上自己定义的渠道号做标记,例如投放趣头条在query string 里面加上 &channel=qutoutiao 的方式 标记

Q:给出的回调地址是 HTTP 还是 HTTPS 的:

A:这个取决于用户请求广告时发送的请求是 HTTPS 的还是 HTTP 的,目前做不到统一输出 HTTPS。

Q:收不到点击上报

A:可以查看点击监控链接是否失效,以及链接是否有空格或者下划线少写了的情况,或者参数名称不符合入库规则


联系方式

手机/微信:18971576794

ABUIABACGAAg1NT8ygUo9tjD1QIwrgM4rgM.jpg

官方服务号

外宣-15807157429_副本.jpg

代理合作

广告投放
 
 

服务热线:18971576794

公司官网渠道活码.png

免费开户中


更多需求提交