趣头条 App 转化 API 对接操作说明发表时间:2023-07-10 00:39 一、概述 本文档介绍,如何把从趣头条渠道产生转化数据,回传到趣头条广告平台,帮助广告主跟踪转化效果。支持对于回调了转化数据的 ocpc 单元。回调方案适用于 Android 和 iOS系统。 二、线上响应过程 UML: 线上流程说明: 1、用户点击广告, 趣头条收集用户的点击事件。 2、趣头条把点击事件相关参数发送给广告主设置的点击监控 url(点击监控接口)。 3、当广告主或第三方监控平台接受到点击监控的请求后,保存此请求相关的参数(例如用户的 oaid等) 4、用户完成转化(激活、注册、付费等)后,通过设备号等用户信息,匹配近 7 天的点击点击数据 5、匹配成功后,应第一时间通过 callback_url 回调给趣头条(转化上报接口) 三、点击监控接口: 1.简介 实现功能:点击监控接口用来实现广告主接收趣头条上报的广告点击信息 请求方:趣头条服务器 处理方:广告主提供的监测平台服务器 请求地址: 广告主在趣头条投放时提供的监测 URL,监测 URL 中,使⽤双下滑线__参数__的形式来设置所需返回的数据。用户点击广告时,我们会把__参数__替换成真实值上报给广告主。 2.响应内容 不要求对方返回具体内容,使用 http 的状态码表示是否成功,返回状态码为 200 或 {status: 0}或者 success 表示成功,趣头条不对返回内容进行校验,只需要保证可正常接收点击上报即可。 3.监控链接示例 例如广告主提供的监控链接 HOST 为 http://www.myurl.com,则可以提供以下示例的监控链接,用户点击广告时,我们会把__参数__替换成真实值上报给广告主: 安卓示例: http://www.myurl.com?cid=__CID__&imeimd5=__IMEIMD5__&os=__OS__×tamp=__TS__&plan=__PLAN__&unit=__UNIT__&callback_url=__CALLBACK_URL__&tsms=__TSMS__&androididmd5=__ANDROIDIDMD5__&uid=__UID__ &oaid=__OAID__ IOS 示例: http://www.myurl.com?cid=__CID__&idfa=__IDFA__&os=__OS__×tamp=__TS__&plan=__PLAN__&unit=__UNIT__&callback_url=__CALLBACK_URL__&tsms=__TSMS__&uid=__UID__ 其中 callback_url、imiemd5(idfa)、androididmd5、oaid 为必须,因为我们需要告诉你回调地址,以及通过设备号去匹配转化数据。 注意事项 1、 参数宏必须全部大写且不可更改 2、 参数的命名可由广告主自定义 3、 监测链接不能是下载链接或者 apk 包 4、 接收监测链接的字符限制建议为 2048 |