美柚女人通-落地页线索 API 对接情况概述

一、概述

针对不在落地页完成的用户转化行为（例如：用户表单提交后，广告主通过电话回访后标记出有效用户），采用线索 API 转化跟踪方式追踪，美柚女人通会在您的投放链接地址自动拼接参数，只要您将符合转化条件的用户参数进行回传，就能完成转化上报，从而追踪投放链接的转化效果。

二、事件定义

1. 广告点击

当美柚用户点击广告素材（包括且不限于标题、按钮、图片、视频）时，触发点击事件，该事件被认为是一次有效的广告点击。进入指定落地页后点击内部相关链接等行为，不算为点击。

2. 在线下单

当用户从美柚客户端点击应用广告，并在落地页下单。

3. 表单提交

当用户从美柚客户端点击应用广告，并在落地页提交表单信息。

4. 数据流示意图（以表单提交为例）

5. 对应操作界面示意图

6. 流程说明（以美柚用户为例）

1) 美柚用户点击广告，美柚客户端收集用户的点击事件

2) 美柚客户端把点击事件相关参数附加在落地页链接上发送给广告主，具体见下方“监测参数说明”

3) 用户完成转化(在线下单、表单提交)后， 广告主的服务端根据落地页请求日志，将拼接了参数的落地页 url 和用户线索做映射, 第一时间通过callback_url 回调女人通广告服务器(转化上报接口)，具体接口见下方 “转化回调接口”

4) 美柚女人通广告服务器将回调的转化数据(在线下单、表单提交)与广告计划 匹配

5) 在投放后台披露转化数据(在线下单、表单提交)

三、监测参数说明

系统会自动在您的落地页链接上拼接以下参数：

os={OS}&material_id={MATERIAL_ID}&track_id={TRACK_ID}&callback={CALLBACK}

广告主自行开发的监测平台：

1. 具体示例

参数说明

2. 响应方式

JSON 数据格式

3. 相应内容

不要求对方返回具体内容，使用 HTTP 的状态码表示是否成功，返回状态码 为 200 或{status:0}或者 SUCCESS 表示成功

四、转化回调接口说明

用于广告主将转化用户上报实时给女人通服务器，女人通会将转化用户与广告计划关联，跟踪每个广告计划的转化效果。

1. 回调方式：CALLBACK 参数回调

1) 落地页请求的拼接参数中, 有 CALLBACK 参数的值 callback_url, 进行 urldecode

2) 广告主自建服务，在匹配到相应转化数据时, 在 callback_url 拼接参数 conv_type 和 conv_time 字段, 同时发起请求

3) 回调地址示例

2. 响应格式

JSON 数据格式

3. 响应内容

五、常见问题

Q：后台提示请求参数错误

A：后台提示请求参数错误的同时会提示具体的错误信息，请根据错误信息并按

照文档中标准参数核对产生错误的原因（报请求参数错误，但广告仍然可以提交

且不影响展示和点击总数）

Q:收不到转化上报:

A:请求方法和 URL 是否正确， 请求必须使用 GET 方式

Q:点击数差异问题:

A:1 双方平台的去重和反作弊策略不一致可能导致点击数据统计差异

2 激活回传的时间需要客户实时回传，延迟回传会导致预估