google-ad-scraper

Google Ads Transparency スクレーパー

Apify の xtech/google-ad-transparency-scraper アクターを使用して、Google の広告透明性センターから広告をスクレイピングします。検索、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 広告透明性センターを検索します
   • 検索結果から広告主 ID（形式：AR + 20 桁の数字）を抽出します
2. 広告のスクレイピング：
   • 広告主の透明性センターの URL を構築します
   • Apify の xtech/google-ad-transparency-scraper アクターを呼び出します
   • 完了するまでポーリングし、データセットを取得します
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（複数の場合はカンマ区切り。照合を省略）
--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（ウェブスクレーパー 1 ページ分）
• 広告のスクレイピング：アクターの料金によって異なりますが、通常は広告主 1 件あたり数セントです

よくあるワークフロー

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 の照合では、Google の SPA を Puppeteer ベースのウェブスクレイピングで処理します。まれに失敗する場合があります。最良の結果を得るには --domain を使用するか、--advertiser-id を直接指定してください。
• 広告の掲載範囲：Google が表示するのは、確認済みの広告主の広告のみです。規模の小さい広告主は表示されない場合があります。
• 過去のデータ：透明性センターに表示されるのは、主に最近配信された広告です。

設定

API の詳細な設定、トークンの設定、レート制限については、references/apify-config.md を参照してください。