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

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、联调工具使用：

登录趣头条广告投放平台 http://adv.aiclk.com （账户密码可从运营同学处获取），在工具箱选项处可以选择 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：可以查看点击监控链接是否失效，以及链接是否有空格或者下划线少写了的情况，或者参数名称不符合入库规则