一、功能概述

为落地页转化数据回传提供API对接方式，提高数据回收效率。

二、数据流示意图

落地页采用API方式进行线索追踪时，微博会在您的落地页链接上拼接参数，如下图过程1&2示意。随后您将符合转化条件的用户参数进行回传，完成转化上报，追踪落地页转化效果。如下图过程3示意。 请注意实时上报，回传延迟大于2小时的转化无法计入模型进行优化和门槛计算。

1. 终端用户访问微博，并点击广告主的落地页，广告主可在URL后添加from=wb或其他广告主自定义的参数来识别微博来源的流量；

2. 用户通过微博APP访问广告主的落地页，微博在落地页URL后添加mark_id， 例如:

3. 广告主落地页在收到微博的访问后，判断是否为微博的访问，如果是则回调微博的回传接口，计入微博广告量，则必须回传mark_id等参数。

4. 微博收到回调后，根据mark_id 获取相应的广告信息，并入库保存。并归因至相关广告计划，优化流量及转化效果。

三、使用步骤

1. 按照API对接文档，将落地页转化量回调微博回传接口，并进行回传测试。

转化数据回传接口：

广告量监测\自然量监测请求接口

GET https://api.biz.weibo.com/v3/track/activate

回传测试流程：

联调目的在于确保您正确调用了回传地址，能够将转化用户进行回传。

回传测试地址：

curl \
-X GET \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Accept: application/json,application/text+gw2.0" \
"https://api.biz.weibo.com/v3/track/activate?time={TIME}&behavior={BEHAVIOR}&mark_id={MARK_ID}&host={HOST}"

备注：

{ACCESS_TOKEN} 是您接入开放平台访问凭证，具体请参考接入流程。

{TIME} 是您线索数据的转化时间，如：1581645600000(毫秒)。注意！我们会过滤2小时以外的数据转化为自然量，不计入门槛统计、计划维度报表展示。

{BEHAVIOR} 行为码，具体参考本业末端。

{MARK_ID} 是您需要上报的追踪标识，允许为空，此时为自然量。联调时请手动拼接，规则为"广告账户uid|时间|test"，例如：2608812381|1581645600000|test

{HOST} 回传来源，默认请填写您的域名，如：weibo.com。

您还可以参考我们的详细文档

例如：

curl \
-X GET \
-H "Authorization: Bearer acb1d926e400e701b45a10e63a80bac8" \
-H "Accept: application/json,application/text+gw2.0" \
" https://api.biz.weibo.com/v3/track/activate?time=1581645600000&behavior=1001&mark_id=2608812381|1581645600000|test&host=weibo.com"

请用上述回传测试地址测试转化数据上报，成功返回 

{
    "code": 0,
    "message": "OK"
}

失败返回 

{
  "message":"Error",
  "code":"xxxxx"
}

behavior编码

监测字段 编码
表单提交 1001
电话拨打 1002
有效咨询 1003
微信复制 1004
落地页访问 1005
下载开始 1006
商品购买 1007
其他(other) 1100

2. 回传测试完成后，请按照流程建立广告计划。

在营销目标收集销售线索下，建立投放目标为表单提交的广告计划：

按照您所选择的人群定向或内容定向，为目标表单的转化成本进行出价设置：

进入创意设置页面，在表单链接处手动粘入拼接了from=wb微博标识的落地页链接：

其他设置与当前表单类广告无区别，请正常提交广告计划并投放。

四、Q&A

Q:1. 如果回传数据中没有mark_id或mark_id丢失，会对广告计划有什么样的影响？

A:mark_ID是转化数据精准归因至计划的唯一标识。如回传时间大于2小时或者回传数据为空，则广告模型中未成功计入此转化数据。在OCPM的跑量阶段，成本保证和门槛统计阶段均无法有效保障。


Q:2. 如果落地页链接中未拼接from=wb字段会如何？

A:您在接收落地页转化时，将无法判断此转化来自微博渠道。