google-ad-scraper

Google Ads Transparency 抓取工具

使用 Apify 的 xtech/google-ad-transparency-scraper Actor，从 Google Ads Transparency Center 抓取广告。涵盖搜索、YouTube、展示广告和 Gmail 广告。

快速开始

需要 APIFY_API_TOKEN 环境变量（或 --token 标志）。安装依赖项：pip install requests。

# Search by company name (auto-resolves advertiser ID)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --company "Nike"

# Search by domain (more precise)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "nike.com"

# Direct advertiser ID (skip lookup step)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --advertiser-id "AR13129532367502835713"

# With region filter
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --company "Shopify" --region US

# Limit results
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "hubspot.com" --max-ads 30

# Human-readable summary
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --company "Stripe" --output summary

工作原理

1. 广告主解析（未提供 --advertiser-id 时）：
   • 接收公司名称或域名
   • 使用 Apify 的网页抓取工具（Puppeteer）搜索 Google Ads Transparency Center
   • 从搜索结果中提取广告主 ID（格式：AR + 20 位数字）
2. 广告抓取：
   • 构建该广告主的 Transparency Center URL
   • 调用 Apify 的 xtech/google-ad-transparency-scraper Actor
   • 轮询直至完成，然后获取数据集
3. 输出：以 JSON 或人类可读的摘要形式返回广告

广告主 ID 解析

脚本会自动处理名称 → ID 查找：

• 按域名（--domain nike.com）：搜索 adstransparency.google.com/?domain=nike.com。这是最可靠的方法。
• 按名称（--company "Nike"）：搜索 adstransparency.google.com/?text=Nike。可能返回多个匹配项。
• 直接提供 ID（--advertiser-id AR...）：完全跳过查找。适用于已有 ID 的情况。

手动查找广告主 ID

如果自动解析失败：

1. 前往 https://adstransparency.google.com
2. 搜索公司
3. 点击广告主
4. 从 URL 中复制 ID：https://adstransparency.google.com/advertiser/AR17828074650563772417
5. 通过 --advertiser-id AR17828074650563772417 传入

CLI 参考

标志	默认值	说明
--company	无	要搜索的公司名称
--domain	无	公司域名（例如 nike.com）——更精确
--advertiser-id	无	Google Ads 广告主 ID（多个 ID 以逗号分隔，跳过查找）
--region	anywhere	区域筛选条件（US、GB、DE 等，或 "anywhere"）
--max-ads	50	要返回的广告数量上限
--output	json	输出格式：json 或 summary
--token	环境变量	Apify 令牌（建议使用 APIFY_API_TOKEN 环境变量）
--timeout	300	等待 Apify 运行的最长秒数

必须至少提供 --company、--domain 或 --advertiser-id 之一。

输出字段

输出中的每条广告可能包含以下字段（视广告格式而异）：

{
  "advertiser_name": "Nike, Inc.",
  "advertiser_id": "AR13129532367502835713",
  "ad_format": "TEXT",
  "headline": "Nike.com - Official Site",
  "description": "Shop the latest Nike shoes, clothing...",
  "display_url": "nike.com",
  "destination_url": "https://www.nike.com/",
  "region": "United States",
  "last_shown": "2026-02-20",
  "first_shown": "2026-01-15",
  "image_url": "https://...",
  "video_url": "https://..."
}

费用

• 广告主查找：约 $0.05（一个网页抓取页面）
• 广告抓取：费用视 Actor 定价而异，通常每个广告主需几美分

常见工作流

1. 竞品广告调研

python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "competitor.com" --max-ads 100 --output summary

2. 比较多个竞品

# Get IDs first, then scrape in one run
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --advertiser-id "AR111,AR222,AR333" --max-ads 50

3. 区域广告定向分析

# See what ads run in specific regions
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "shopify.com" --region US --output summary

python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "shopify.com" --region GB --output summary

限制

• 广告主 ID 查找使用基于 Puppeteer 的 Google SPA 网页抓取，有时可能失败——建议使用 --domain 以获得最佳结果，或直接提供 --advertiser-id。
• 广告覆盖范围：Google 仅展示已验证广告主的广告。一些规模较小的广告主可能不会出现。
• 历史数据：Transparency Center 主要展示近期活跃的广告。

配置

详细的 API 配置、令牌设置和速率限制信息，请参阅 references/apify-config.md。