美柚广告之友
行业信息

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

17
发表时间:2023-07-10 02:52

一、概述

针对不在落地页完成的用户转化行为(例如:用户表单提交后,广告主通过电话回访后标记出有效用户),采用线索 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 激活回传的时间需要客户实时回传,延迟回传会导致预估


广告投放
 
 

18971576794

美柚渠道活码.png

免费开户中


需求提交>>