美柚女人通之落地页线索 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）激活回传的时间需要客户实时回传，延迟回传会造成预估偏差。