
===== PAGE 1 =====
OPPO 效果广告的广告主监测/三方监测规范 
 
名词解释 
名词 解释 
宏参数 监测链接 URL 中将被真实内容替换的占位符 
 
能力介绍： 
监测链接是由广告主提供，并按照OPPO约定的格式填写，用来接收OPPO广告发送的
用户的广告展示和广告点击信息。投放端填写位置如下图： 
 
 
请求方：OPPO广告服务器 
处理方：广告主（或广告主指定的）提供的监测平台服务器 
通信方式：HTTP 协议，GET 方法 
广告主响应内容：OPPO广告请求监测链接URL后，广告主使用Http的状态码告知是
否成功。状态码说明：正常则返回HTTP 200，其余均为异常。 
  
监测链接URL 的格式： 
监测链接URL的构成共三部分，① 前缀"https://XXXX.XXX.com?"+②将被OPPO 替换
的参数”+③广告主自定义的其它参数，其中②和③的参数不限制顺序，所有参数只需
符号"&"分隔即可 
 
其中： 
(1) 前缀只能是 https 开头，服务器域名必须是能够正常访问的正式域名。 
(2) 将被OPPO 替换的宏参数：当产生广告行为时，相应的参数会换成真实的内容，并
发送给广告主服务器。 
• 宏参数格式：“__参数__”（见下表），使用与号 (&) 分隔参数。 
• 可支持的参数：参考下表，广告主可以根据自己的需要选择其中部分参数。 
• 注意： 
o “__参数__”格式中参数左右两边均为两个连续的英文字符"_"，共四
个"_"。 



===== PAGE 2 =====
o 监测链接仅支持大小写字母、数字以及英文下划线。 
o 自2025年 12月起监测链接的宏参数格式统一为“__参数__”；历史上
曾经有部分宏参数格式为“$参数$”，该部分存量宏参数会进行兼容，
增量监测链接的宏参数格式请统一为“__参数__” 
监测链接示例： 
 
①黑色加粗：接收服务域名，用问号“？”分隔 
②绿色高亮部分：广告主自定义的参数，符号“=”后没有英文下划线，不同参数用符
号&分隔 
③黄色高亮部分：广告主自选的OPPO平台将替换的宏参数，英文下划线之间的内容将
被替换成真实值，不同参数用&符号分隔。其中的英文下划线格式内容一定要按照规定
拼写。 
  
  
监测链接参数： 
OPPO将对宏参数替换成真实的内容后，并发送给广告主。 
宏参数格式 含义 描述 是否必填 
__REQ__ 广告请求 ID 代表一次广告请求 必填 
__IMEI__ IMEI 仅支持部分 Android Q 以下版本的设备号，Imei
原值的 md5 加密 
必填 
__OAID__ OAID -Android Q 及以下版本同时上报md5 加密的
IMEI 及原文的oaid 
-Android Q 及更高版本，仅上报64 位原文
oaid。 
如果用户在设置>隐私中关闭了个性化广告跟
踪，OAID 会被设置为全0。 
OAID 广告标识符由64 位字母和数字构成。 
必填 
__TS__  广告行为时间 客户端发生广告行为事件（曝光/点击）的时
间，以毫秒为单位的时间戳，13 位时间戳。 
• 曝光监测：该时间戳被替换为客户端曝
光时间 
• 点击监测：该时间戳被替换为客户端点
击时间 
必填 
__OWNERID__ 广告主账号 ID 由 OPPO 侧为广告主账号生成的id   
__PLANID__ 广告计划 ID 广告主在 OPPO 投放端创建   
__GROUPID__ 广告组 ID 广告主在 OPPO 投放端创建   
__ADID__ 广告创意 ID 广告主在 OPPO 投放端创建 必填 



===== PAGE 3 =====
__AN__ 广告创意名称 广告主在 OPPO 投放端创建   
__OV__ 操作系统版本号 操作系统版本号。示例：14.1   
__OS__  操作系统平台 操作系统平台，只支持安卓。示例：android   
__M__ 机型(model) 手机机型的认证型号。示例：CPH2651，表示
OPPO Find X8 
  
__LAN__ 语言 语言，例如 ZH   
__IP__ 客户端 IP 地址 客户端 IP 地址。正常情况下取值为IPv4 地址；
当 IPV4 无法取到时，则取值为 IPv6。 
  
__UA__ 用户代理(ua,全称
user agent) 
一个特殊字符串头，使得服务器能够识别客户使
用的操作系统及版本、CPU 类型、浏览器及版
本、浏览器渲染引擎、浏览器语言、浏览器插件
等。部分广告位可能缺失。 
  
__SPUID__ 商品 ID 仅投放商品广告时替换此宏参数。   
__PROGRESS__ 视频播放进度 视频广告时有效，单位为毫秒   
__EXPINFO__ 
实验组 ID OPPO 广告平台帮助客户实现不同的流量策略实
验，实验组 ID 随监测下发给客户，客户可以通
过分析 ID 评估不同策略的效果。 
注：需联系客户运营配置 
  
 