# 腾讯优量汇广告配套接入

公共服务0.4.4新增腾讯优量汇直连激励验真，配套Flutter附属包0.2.0。AI从agent.frontendAddon.gdtGuide读取完整说明，从下载包取得Android开屏/激励适配、双渠道路由、示例及可信回调入口参考。穿山甲原功能保留，旧版本下载不覆盖。

腾讯激励adPlacements必须设置provider=gdt、type=rewarded、networkAppId、adUnitId、rewardScene及独立keyEnv。前两个ID是腾讯公开App/广告位ID，不是火花App ID。开屏只记录展示，不配置奖励。

原生customData透传公共contextId，用户字段透传公共userId。可信App回调入口把原始RawQuery通过管理令牌POST至 `/v1/apps/{appId}/ads/callbacks/{placement}`。服务检查渠道配置、归属、交易幂等，并独立更新验真状态；奖励仍由客户端视频完成通知先触发，验真失败不自动扣奖或封禁。

腾讯签名顺序为transid:secret，穿山甲为secret:trans_id，不能混用。腾讯签名不覆盖所有归属字段，回调入口须另有可信来源校验。不得用通用前端运行凭据代替管理凭据，也不得把密钥放入SDK或回调URL。

全部正常、待验真及异常快照进入既有ad_reports队列；火花保持provider=gdt事实，邀请归因由平台内部关系计算。测试回调不等于真实腾讯流量验收。

Android源码按官方固定Maven4.712.1582编译校验；iOS广告适配未实现。真实广告加载、播放完成、回调来源、正式签名及各App业务策略需逐项验收。

官方协议：https://developers.adnet.qq.com/doc/ios/union/union_reward_video 。