# OPPO 渠道接入说明

OPPO APP 数据回传协议使用 `POST https://api.ads.heytapmobi.com/api/uploadActiveData`。
配置 `adx.oppo-conversion-salt`、`adx.oppo-aes-base64-key` 和可选的
`adx.oppo-owner-token` 后，通过 `OppoClient` 发送回传：`imei`、`mac`、`ouId`
和 `androidId` 会按 OPPO v3.23 的 AES/ECB/PKCS5Padding + Base64 规则加密，
签名严格使用发送的原始 JSON：`md5(postData + timestamp + salt)`。

监测链接必须由 HTTPS 正式域名提供，使用 OPPO 新版宏格式 `__REQ__`、
`__OAID__`、`__TS__`、`__OWNERID__`。扣量比例通过 `deduction_rate` 配置项
传入，取值范围为 0-100；实际扣量判定沿用现有渠道的 Redis 原子计数语义。

OPPO Redis 缓存与其他渠道采用相同生命周期：曝光写入的 qk、mediaTrace
两份缓存 TTL 为 3 小时，内容仅保留点击及转化回传需要的字段。点击处理后，
两份缓存一起移除点击 URL 和跳转链接，并按 `adx.bid-ttl` 重新计时
（默认及当前 prod 配置为 36 小时）。瘦身不会修改当前请求用于跳转的对象。
Stream 仍保存完整事件供后台异步落库，成功后 ACK 并删除消息。
点击按 mediaTrace 查缓存未命中时重新请求广告；转化按 qk 查找仍支持 DB 回查。
已有 Redis key 不会因部署自动缩短 TTL，会在后续写入、点击或自然过期时更新。