Google Ads Transparency AR+CR 查询器
项目地址:https://github.com/ye564687617/google-ads-transparency.git
一个 Chrome Manifest V3 扩展,用于在 Google Ads Transparency Center 广告详情页中自动读取 URL 里的 AR(广告主 ID)和 CR(创意 ID),并查询当前固定广告的公开信息。

功能
打开形如下面的广告详情页,然后点击浏览器工具栏里的插件图标:
https://adstransparency.google.com/advertiser/AR.../creative/CR...?region=KR
插件会自动:
- 提取
AR和CR; - 查询广告主(资金方);
- 显示最近一次展示时间;
- 显示主要投放地区;
- 显示图片或视频素材;
- 解析视频广告的 YouTube 播放地址;
- 解析可用的短标题、长标题、描述/摘要;
- 显示展示域名和落地页;
- 显示素材图片;
- 展开、复制或下载原始 JSON。
安装
- 下载或克隆本项目;
- 打开 Chrome:
chrome://extensions/; - 开启右上角的“开发者模式”;
- 点击“加载已解压的扩展程序”;
- 选择本项目的
extension文件夹; - 打开 Google Ads Transparency Center 的广告详情页;
- 点击扩展图标,底部显示
v1.1.1即表示当前版本已加载。
更新代码后,在 chrome://extensions/ 页面点击该扩展的“重新加载”。
查询方式
扩展优先从扩展自身发起不携带登录 Cookie 的公开请求:
POST https://adstransparency.google.com/anji/_/rpc/LookupService/GetCreativeById
请求参数使用 Google 页面内部的 f.req 格式:
{
"1": "AR...",
"2": "CR...",
"5": { "1": 1 }
}
部分登录会话在页面上下文中使用 authuser=0 时会返回空对象,因此当前版本使用扩展直查,并保留无 Cookie 的页面回退查询。
视频/响应式广告的标题、描述、落地页和视频地址,可能位于 displayads-formats.googleusercontent.com 返回的素材脚本中,扩展会继续解析这些脚本。
数据缺失说明
透明中心并不保证每种广告格式都有全部字段。
图片广告常见情况:
- 有图片素材;
- 没有结构化短标题;
- 没有结构化长标题;
- 没有描述字段;
- 没有落地页字段;
- 没有视频地址。
如果文案已经绘制在图片里,接口不会把它自动拆成标题字段。此时可以对素材图片继续做 OCR,但 OCR 结果应视为“图片识别文字”,而不是 Google 返回的结构化广告字段。
项目结构
extension/
├── manifest.json
├── popup.html
├── popup.css
├── popup.js
├── lib.js
├── icons/
└── tests/
本地测试
在项目根目录执行:
node --check extension/lib.js node --check extension/popup.js node extension/tests/test.mjs node extension/tests/live_test.mjs
live_test.mjs 会使用两个真实广告样本进行回归测试,包括此前返回空对象的图片/视频广告样本。
隐私与权限
扩展只声明以下权限:
activeTab:读取当前标签页 URL;scripting:在当前广告详情页执行查询回退;clipboardWrite:复制 AR+CR 或 JSON;adstransparency.google.com:查询广告详情;displayads-formats.googleusercontent.com:解析广告素材脚本。
版本
当前版本:1.1.1