微博广告推广中的广告数据联调相关说明

微博广告推广

广告数据

联调说明

联调步骤

联调即模拟正式回传的操作，下面为大家介绍一下（此文档需客户方技术人员查看）：

一、正式环境中的数据流示意：

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

二、微博广告推广联调操作指引：

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

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

a. 原始落地页链接为 http://www.e.com/landingpage?campaignid=123

b. 广告主添加渠道标记参数的链接为 http://www.e.com/info/landingpage?campaignid=123&from=wb

c. 微博下发时拼接后的链接为 http://www.e.com/landingpage?campaignid=123&from=wb&mark_id=1_reallog_mark_ad:8|1_16000011273892000011273892

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

技术回传 URL

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

Header 请求参数

字段

类型

描述

Authorization

string

验证 token，创建 token ，例如：Bearer（固定值) ACCESS_TOKEN

Accept

string

固定为：application/json,application/text+gw2.0

请求参数

参数名

类型

是否必填

描述

advertiser_id

long

否

您管理的广告主 ID，为空则为 token 对应账户。不使用请勿下发。

time

int

是

转化时间，如：1534730754456(毫秒)

mark_id

string

否

mark_id 允许为空，为空时计为自然量。联调时参考下方格式。

behavior

int

是

客户行为码，behavior 编码见下文。

host

string

否

回传来源，默认填写您的域名，如：weibo.com

mark_id 在真实广告环境下才会下发的一串字符，非广告环境下不会拼接在落地页地址之后。所以联调时需自行模拟一个 mark_id 用于联调回传，此 mark_id 仅用于联调，不会计入报表。

联调时 mark_id 值请手动拼接后填写，规则为”广告账户 uid|时间|test”，例如：2608812381|1581645600000|test

behavior 行为码

4. 微博收到回调后，依据 mark_id 获取相应广告信息并入库保存，在超粉后台显示联调成功。

每个账户仅需联调一次，若有多个账户，则每个账户均需联调一次。联调与落地页无关，我们会自动识别计划中的落地页地址进行 markid 拼接。

微博广告推广联调成功后，在正式投放中，每次接收到正式的 mark_id ，依旧使用上述接口和参数实时回传微博即可。

需注意，回传【mark_id+行为码】时不能与过往回传记录重复，即同一个 mark_id 搭配不同行为码，分次传给微博是可行的。