===== 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 评估不同策略的效果。 注：需联系客户运营配置