网易易效落地页转化数据接入API文档

一、概述

激活、注册是广告主衡量转化效果的重要指标，为了帮助广告主更好地了解和监测广告投放效果，本文档提供转化数据接入方案，转化数据接入后，广告主可以在投放端查看转化效果数据。

二、接入方案

广告主创建转化追踪，并选择追踪类型，创建完成后进行转化回传联调测试，联调成功后将转化追踪绑定到创意上，易效负责在投放时的创意落地页后拼接相应参数，广告主自主判断发生转化后，按照参数中的 callback url 进行回调，并将转化类型 conv_type 拼接到回调地址上，同时拼接实际激活时间戳 t，单位毫秒。conv_type 对应的值参考第三部分接口说明。
例如：

• 1、用户 A 在落地页 https://www.ad.com/?callback=http://ad.yx.com/?123XXX 中发生转化行为；
• 2、广告主监测到 A 的转化行为后，获取 A 所访问的落地页的 callback 链接即http://ad.yx.com/?123XXX，并拼接参数，最终回调链接形式如下：http://ad.yx.com/?123XXX&&conv_type=actived&t=1533106568000
• 2、流程说明：

三、接口说明

转化回传接口说明广告主通过落地页中 callback 参数携带的转化回传地址，将 APP 转化数据上报给易
效，易效进行归因处理，并将转化数据呈现在易效平台。
1. 接口说明：

• 1) 请求方：广告主；
• 2) 处理方：易效；
• 3) 请求方式：GET/POST；
• 4) 请求协议：HTTP/HTTPS；
• 5) 请求地址：广告主后台收到点击时的 callback 参数即为转化回传地址；
• 6) 请求格式：在原有 callback 地址的基础上，拼接转化时间和转化类型参数，例：
  __CALLBACK__&t=1533106568000&conv_type=actived&conv_num=1；
  

2. 接口参数说明：（原有参数还请务必不要修改）
名称 类型 描述
conv_type string 必填，用以区别数据属于激活或注册（特别注意：
如不回传，则默认回传数据为“激活”数据）：
激活：actived
注册：register
授信：commit_msg
付费：pay
次日留存：retained
拨打电话：phone
表单提交：submit
有效咨询：consult
微信复制：wxcopy
应用下载：download
页面访问：visit
购买：buy
唤起应用：open_app
conv_num string 选填，用于统计转化的具体数量
当转化类型为付费：pay ，conv_num回传付费
金额
t number 必填，实际产生转化的时间戳；
示例：1533106568000
类型
3. 响应格式及内容：
响应格式：json 数据格式；响应内容：
• 处理成功：{"status":"SUCCESSED","msg":"ok"}；
• 处理失败：{"status":"FAILED","msg":"错误提示"}