一、趣头条广告API概述
本文档介绍，使用ocpc出价的广告计划在落地页产生转化数据后广告主如何回传转化数据跟踪落地页转化效果。推荐使用场景为用户深度转化行为不在落地页内完成，例如用户通过落地页填写电话号码，趣头条广告主通过电话回访确定有效用户。
二、线上响应过程
1、用户点击广告，趣头条上报点击相关参数（接口一）给广告主创意层级设置的落地页url（落地页url直接拼接点击宏替换参数）
2、广告主或第三方监控平台解析用户打开的落地页url，记录用户与该url的对应关系并保存点击参数的信息（例如CALLBACK_URL等）
3、用户完成转化（提交表单、落地页跳转、有效咨询）后，广告主将上报点击信息与用户进行映射，通过CALLBACK_URL回调给趣头条广告平台（接口二）
三、落地页url规则（接口一）
1、简介
实现功能：
实现广告主接收趣头条上报的广告点击信息（请求方式：C2S）
请求方：
趣头条服务器
处理方：
广告主提供的监测平台服务器请求地址：广告主在趣头条投放时使用的落地页url，落地页url中需使⽤双下滑线参数的形式来设置所需返回的数据，用户点击趣头条广告时，我们会把__参数__替换成真实值上报给广告主。
响应内容：
不要求对方返回具体内容，使用http的状态码表示是否成功。返回状态码为200、{status：0}或success表示成功。
落地页链接示例：
例如广告主提供的落地页url HOST为http://www.myurl.com，则可以拼接以下参数，用户点击趣头条广告时，我们会把参数替换成真实值上报给广告主：
示例：http://www.myurl.com?cid=__CID__&os=__OS__×tamp=__TS__&plan=__PLAN__&unit=__UNIT__&
callback_url=__CALLBACK_URL__&tsms=__TSMS__&uid=__UID__&ua=
__UA__&ip=__IP__&imeimd5=__IMEIMD5__&androididmd5=
__ANDROIDIDMD5__&oaid=__OAID__&idfa=__IDFA__
其中callback_url为必填项，因为我们需要告诉你回调地址
| 参数 | 描述 | 格式 |
| CID | 趣头条广告创意ID | 原值 |
| OS | 客户端操作系统类型 | 0代表安卓，1代表iOS |
| TS | 客户端触发监控的时间 | UTC时间戳，自1970年起的秒数 |
| TSMS | 客户端触发监控的时间 | UTC时间戳，自1970年起的毫秒数 |
| CALLBACK_URL | 激活回调地址 | 在广告点击的时候趣头条通过callback_url=__CALLBACK_URL__回调地址发送给点击监测链接对应的服务器，URL用urlencode编码。监测平台收到对应用户的激活信息后，向CALLBACK_URL发一个http请求，回调激活信息。监测平台无需关心这个URL的构成和内容，URL对监测平台保持透明 |
| UNIT | 单元ID | 原值 |
| PLAN | 计划ID | 原值 |
| UID | 用户ID | 原值 |
| UA | 客户端上报数据时http的header中的user_agent | encode之后的值 |
| IP | 媒体投放系统获取的用户终端的公共IP地址 | A.B.C.D(4段点分) |
| IPMD5 | 媒体投放系统获取的用户终端的公共IP地址 | A.B.C.D(4段点分)，MD5加密值 |
| IMEIMD5 | 用户客户端的IMEI号，MD5加密 | MD5加密值 |
| ANDROIDIDMD5 | 用户终端ANDROIDID,md5加密 | 取md5摘要 |
| OAID | android设备的标识 | 原值 |
| OAIDMD5 | android设备的标识 | MD5加密值 |
| IDFA | iOS设备的标识 | 原值 |
| IDFAMD5 | iOS设备的标识 | MD5加密值 |
2、注意事项
参数宏必须全部大写且不可更改
参数的命名可以自定义
接收监测链接的字符限制建议为2048
若落地页链接拼接了点击下发字段后，监测链接为非必填项
四、转化上报接口（接口二）
1、实现功能
广告主在收到落地页的转化数据后，必须实时匹配点击上报，并实时将转化数据上报给趣头条服务器，以免出现统计无效的情况（请求方式：S2S）
2、回调方案
◇在点击监控接口中，callback_url=__CALLBACK_URL__这个宏会被替换成一个urlencode编码的值
◇广告主收到用户转化数据并找到该用户对应的落地页url参数
◇把callback_url返回值decode，监测平台无需关心这个URL的构成和内容，对监测平台保持透明
◇在decode以后的值尾部拼接&op2参数，用于区别转化目标的定义（注意：如不添加则转化无法识别，无法进行投放）
◇向趣头条发送GET请求
◇返回状态码status：200表示成功
3、回调地址示例：
https://millionapi.aiclk.com/external/common/trace?t=active_third&iclicashsid=
CxeJC5SVrLE88lbdn3Y85nzEessKYjaljuliVuyy&os=1×tamp=
1594969359&opt_ideaid=6729231&op2=29
注意其中包含的t、iclicashsid、os、timestamp和opt_ideaid五个参数，如果广告主回传时有丢失参数，则会导致我们无法解析该回传。
转化目标定义
| 参数 | 对应值 | 转化目标 | 定义 |
| op2 | 26 | 提交表单 | 在落地页填写信息后提交成功 |
| 31 | 表单付费 | 在落地页成功付费 | |
| 27 | 其他 | ||
| 28 | 有效咨询 | 成为一个有效用户，可以是加群/付费等深度转化行为 | |
| 29 | 落地页跳转 | 落地页成功跳转小程序 |
五、联调小工具使用
登录趣头条广告投放平台http://adv.aiclk.com（账户密码可从运营同学处获取），在工具箱选项处可以选择API转化追踪，即可创建转化监控和联调
联调工具仅模拟转化事件回传，联调工具下发的回调地址和线上真实环境下发的回调地址不同联调工具模拟回调地址示例：
http://adv.aiclk.com/tools/callback/target-urlmonitor/48087?md5=
ab356f45873c063737aa3b8ba86ab991&tsms=1611563046851&uid=46237121
联调工具模拟回调地址正确上报激活示例：
http://adv.aiclk.com/tools/callback/target-urlmonitor/48087?md5
=ab356f45873c063737aa3b8ba86ab991&tsms=1611563046851&uid
=46237121op2=0&opt_active_time=1567415002
线上真实回调地址示例：
https://millionapi.aiclk.com/external/common/trace?t=
active_third&iclicashsid=CxeJC5SVrLE88lbdn3Y85nzEessKYjaljuliVuyy&os
=1×tamp=1594969359&opt_ideaid=6729231
线上真实回调地址正确上报落地页跳转示例：
https://millionapi.aiclk.com/external/common/trace?t=
active_third&iclicashsid=CxeJC5SVrLE88lbdn3Y85nzEessKYjaljuliVuyy&os
=1×tamp=1594969359&opt_ideaid=6729231&op2=29
六、常见问题解答
Q：收不到转化上报
A：请求方法和URL是否正确，请求必须使用GET方式，URL参照上文说明示例(如果趣头条广告投放目标是IOS，监控上报链接必须使用https协议)。
Q：点击数差异问题
A：双方平台的去重和反作弊策略不一致可能导致点击数据统计差异。
Q：广告主同时在不同渠道投放广告，如何确认点击是来自哪个渠道的
A：广告主可以在点击监控上报的链接上加上自己定义的渠道号做标记，例如投放趣头条在落地页url里面加上&channel=qutoutiao的方式标记。
Q：给出的回调地址是HTTP还是HTTPS的
A：这个取决于用户请求广告时发送的请求是HTTPS的还是HTTP的，目前做不到统一输出HTTPS。
Q：收不到点击上报
A：可以查看点击监控链接是否失效，以及链接是否有空格或者下划线少写了的情况，或者参数名称不符合入库规则。
管理员
该内容暂无评论