转化数据API对接文档-360移动推广

1 概述
激活、注册数据是APP广告主衡量转化效果的重要指标之一，360提供广告实时点击打点的数据，360广告主拼接转化后通过 API 回传数据给360移动推广平台。平台将数据匹配到相应创意、推广组，以便广告主在效果报告中查看。同时，对于回传了转化数据的广告主，360 支持 oCPC（目标转化出价）竞价方式，帮助广告主优化转化。目前支持的转化类型有激活、注册，回调方案适用于 Android 和 iOS。

2 事件定义
API：Application Programming Interface，应用程序编程接口，简称 API。API 是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。
广告点击：Advertisement Click，用户与广告的有效交互行为，移动端广告点击是指用户对360广告控件的用户触屏（touchend）事件，该行为促成广告页面的打开或应用下载。
应用激活：用户点击360应用推广类广告后，安装该应用并首次打开。以下简称激活。
应用注册：用户点击360应用推广类广告后，安装该应用并进行注册。以下简称注册。

3 实现原理

3.1 数据流示意图（以激活为例）

流程说明：
1． 用户点击广告，媒体客户端收集用户点击事件；
2． 媒体客户端将点击数据发送给 360 广告服务器；
3． 监测平台（广告主服务器或第三方监测平台服务器）提供接口一 feedback URL，360 广告服务器将点击数据转发给监测平台；
4． 广告主或第三方监测平台接收到点击数据后，根据请求参数中的用户信息（如 imei，idfa 等），到激活用户数据库中查询匹配；
5． 监测平台将匹配成功的激活信息第一时间回调给 360 广告服务器；
6． 360 将回调的激活数据和广告投放计划相匹配；
7． 360 在报表中披露激活数据。
3.2 平台操作界面
入口：360 点睛实效平台-移动推广 -> 实用工具 –> 转化跟踪

监测地址：即接口一（广告主接收点击数据的接口），也称为 Feedback URL；

转化回传地址：即接口二（360 回调转化数据的接口），也称为 callback URL。

目前支持的第三方监测平台有：AdMaster、TalkingData、热云、AppsFlyer、友盟。

4.1.1 简述
接口一帮助广告主接收 360 广告服务器提供的广告点击信息。
◆  接口实现方：广告主
◆  接口调用方：360
◆  请求协议：HTTP 协议
◆  请求方式：GET
◆  字符编码：UTF-8
◆  响应格式：JSON
◆  Feedback URL：广告主在 360 点睛投放平台提供的监测 URL，通过设置宏替换参数，可返回广告主需要的点击数据。
4.1.2 格式及示例（非常重要）
feedback URL：广告主服务器地址或第三方监测平台服务器地址，由广告主填写，格式参照下方说明。形如：http://www.xxx.com/clickdata?xxx=__xxx__宏替换参数形式：支持双下划线 __，如__imei_md5__目前支持的第三方监测平台有：AdMaster、TalkingData、热云、AppsFlyer、友盟。
URL 示例：
http://www.xxx.com?UniqueID=__UniqueID__&clicktime=__clicktime__&IP=__IP__&OS=__OS__&devicetype=__devicetype__&imei_md5=__imei_md5__&IDFA=__IDFA__&MAC_MD5=__MAC_MD5__&callback_url=__callback_url__
注意 ：红色部分标注的参数，不能改变，必须保持一致，否则会造成参数无法替换，转化匹配出错。参数说明可见 4.1.4。
360针对不同的流量，会存在客户端（用户端）打点和服务器打点两种方式，因此针对某些流量，clicktime、IP 字段可能不会被替换。 如果字段未替换，可使用接收到点击数据的时间作为clicktime。
4.1.3 响应返回结果
返回成功结果
HTTP Status Code: 200

4.1.4 参数说明

4.2 接口二：360回调转化数据的接口
4.2.1 简述
接口二用于广告主将转化数据回调给360推广服务器，360会将转化与推广主计划关联，跟踪转化效果。广告主在匹配上转化后，须将转化数据实时回调给 360 服务器。对于回调了转化数据的广告主，360推广支持OCPC（目标转化出价）竞价。
◆ 接口实现方：360
◆  接口调用方：广告主
◆  请求协议：HTTP 协议
◆  请求方式：GET
◆  字符编码：UTF-8
◆  响应格式：JSON
◆  Callback URL：360回调转化数据的地址，固定，不可修改。
4.2.2 格式及示例
Callback URL 由360平台系统自动填写，360广告主不可修改，需直接回传，格式如下：

http://e.tf.360.cn/b/third?UniqueID={UniqueID}&activetime={activetime}&OS={OS}&devicetype={devicetype}&imei_md5={imei_md5}&IDFA={IDFA}&MAC_MD5={MAC_MD5}&convert_type=2&signature={signature}
4.2.3 响应返回结果
{
errno: 0,
error: "Success"

}
Errno Int 返回状态码，0：请求正确；
Error String 对 errno 的文字说明。

4.2.4 参数说明

5 常见问题

若有问题，可邮件联系：g-FAQ-Mobile@360.cn

360移动推广请联系巨宣网络，公司网址：https://www.juxuan.net；电话：4009602809

公司优势

开户流程

注意事项