微博应用监测联调API对接文档v1.13

用户5633

3月9日修改

更新日志

更新时间	更新内容	具体更新说明
2025/6/30	中广协caid 原值格式为ver_caid, ver_caid, 将从版本20230330,20220111, 调整为版本20250325_xxx,20230330_xxx	7月31日切换，格式为20250325_xxx,20230330_xxx；
2024/10/30	微博应用支持回传3日留存和7日留存	新增对应留存回传参数： • action_type=9 表示3日留存 • action_type=10 表示7日留存
2024/11/21	微博应用监测新增IP地址 (IP需加入您的服务器白名单，避免造成与微博服务器无法通信的情况。)	新增微博IP地址： 116.133.12.0 —至— 116.133.12.24

一、概述

对于应用激活类广告而言，用户和广告产生互动后，会对应用采取"下载-安装-激活-注册等应用内行为"的由浅入深的操作。但是，微博只能监测到用户在微博端的广告互动行为，无法监测到用户的应用内行为；广告主可以监测到用户的应用内行为，无法监测到用户在微博端的广告互动行为。​

因此，我们需要"转化上报"来实现信息的互通，根据上报的用户行为特征为您找到更多更可能实现转化目标的用户，从而提高广告的优化效果，提高广告投放效率。​

二、数据链路

1.
用户在微博客户端产生广告互动行为后，微博server将此互动事件按归因策略向广告主server（或第三方监控，下同）发送，包含对应设备 ID 及相关信息；​

2.
用户跳转应用商店或AppStore下载广告主 App；​

3.
APP下载完成后，用户打开广告主 App，发送激活消息到广告主server，回传设备 ID 及相关信息；​

4.
广告主 server 通过排重、过滤及归因，将激活消息与请求相匹配，向微博 server  发送激活消息（接口二）​

三、接口一说明

1.
广告监测消息(微博→广告主/第三方)​

•
监测链接请按照下方示例开发，非必填参数请根据业务需要自行选择。联调通过的监测链接请在广告投放时填⼊。​

代码块

https://adv.com?campaignid=xxx&ip=__IP__&clicktime=__TS__&idfa_md5=__IDFA_MD5__&IMP=___CALLBACK_PARAM__&AID=__AID__&creative_id=__CID__&devicetype=__OS__ &osversion=__OSVERSION__&caid=__CAID__​

•

请求方式： HTTP GET 请求格式：（样例）

◦
ios： ​

代码块

https://adv.com?campaignid=12345&osversion=os8.1.2&ip=61.135.152.218&clicktime=1440486732816&idfa_md5=749AB3B68632680660D776891751E812&IMP=E575BF2F8F39F1F062EFC5BA9E8744DAB730614DD5662C0A82C793A7AFEA3365C336F15E125B1BB61BDDF9123C6C77725678FB46259836835DECCBC26597D042&ad_id=123456&creative_id=54321&brand=&devicetype=ios&osversion=os11.4.1​

代码块

android：​
https://adv.com?campaignid=12345&osversion=android5.4.0&ip=219.142.118.233&clicktime=1440486732816&imei_md5=749AB3B68632680660D776891751E812&IMP=E575BF2F8F39F1F062EFC5BA9E8744DAB730614DD5662C0A82C793A7AFEA3365C336F15E125B1BB61BDDF9123C6C77725678FB46259836835DECCBC26597D042&ad_id=123456&creative_id=54321&brand=&devicetype=android&osversion=android1.1.1 ​

注意：在请求时微博会替换所有能取到的字段，未能取到的字段将替换为空值。替换后的链接参见下例：​

代码块

https://adv.comcampaignid=xxx&ip=&clicktime=&idfa_md5=&IMP=&ad_id=&creative_id=&devicetype=&osversion=​

2.
微博下发参数说明​

字段	含义	对应宏	说明	是否必填	备注
adv.com	广告主（第三方）提供的域名	无	广告主提供，用于接收下载通知消息，广告主需要在建⽴计划时将此链接填到超粉后台	是
campaignid	广告主（第三方）自定义的监测id，与微博⽆关	无	如广告需要区分不用的监测任务，可自行添加参数，参数名⾃定，在此只做示范。注意该字段须使用数字或字⺟组成字符串格式，使用特殊字符可能存在报错情况。	否
devicetype	设备机型信息	__OS__ 或{devicetype}	如果使用__OS__，IOS为1，android为0 如果使用{devicetype}，样例 android 或 ios；	否
osversion	设备操作系统信息	__OSVERSION__或{osversion}	样例 android4.4.4； os11.4.1	否
mac_MD5	移动设备mac 地址	__MAC1__或{mac_MD5}	发送移动设备 mac 地址, 先对mac地址原值md5，然后转大写，32位	否
MODEL	设备机型	__MODEL__或{MODEL}	原值举例：vivo-vivo+X21	否
LANGUAGE	设备语言	__SL__或{LANGUAGE}	原值举例：zh_CN或zh-hans-CN	否
ip	设备IP地址（ipv6或ipv4）	__IP__或{ip}	⽀持ipv6/ipv4访问的站点使用，微博优先获取用户ipv6地址；	否

微博应用监测联调API对接文档v1.13​

微博应用监测联调API对接文档v1.13