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。

安装

  1. 下载或克隆本项目;
  2. 打开 Chrome:chrome://extensions/
  3. 开启右上角的“开发者模式”;
  4. 点击“加载已解压的扩展程序”;
  5. 选择本项目的 extension 文件夹;
  6. 打开 Google Ads Transparency Center 的广告详情页;
  7. 点击扩展图标,底部显示 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

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注