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