Google Ad Library Advertiser Search
Google広告透明性センターでは、ブランド、組織、ウェブサイトの検索語に対して、地域別の法人や似た名前の団体を含む複数の広告主レコードが表示されることがあります。ID、名前、ウェブサイト、ロゴ、地域、取得可能な広告数を確認することで、クリエイティブを収集する前に正しい公開広告主レコードを選べます。
Google Ad Library Advertiser Search API の主な機能
- 名前による広告主の発見空でないブランド名、組織名、広告主名、またはウェブサイトの語句を1つ指定して検索し、広告クリエイティブではなく正規化された広告主候補を受け取ります。
- 任意の地域指定US などの region を渡して上流の検索に地域の文脈を与えます。region は広告の配信地域とは区別して扱われます。
- 候補の識別フィールド公開広告主ID、名前、URL、ウェブサイト、ロゴ、地域、取得元が報告する広告数(取得できた場合)を、推測による補完なしで比較できます。
- 単一レスポンスの完全保存上流の1回の検索レスポンスで返された、使用可能な広告主をすべて保存します。呼び出し側が指定する結果件数の上限や、プロバイダーのページネーションによる繰り返し取得は行いません。
Google Ad Library Advertiser Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。空でない広告主名、ブランド名、組織名、またはウェブサイトの検索語です。一致の方法は取得元に依存し、完全一致・前方一致・あいまい一致のいずれも保証されません。 |
region | 任意 | 任意。US などの空でない地域文字列で、地理的な検索条件として渡されます。広告主の広告が実際にどこで配信されたかを示すものではありません。 |
Google Ad Library Advertiser Search API の使い方
検索語を送信して非同期タスクを追跡し、正規化された各広告主候補を確認してから、その識別情報を以降の調査に使います。
- 具体的な広告主名、ブランド名、組織名、またはウェブサイトの語句を選び、必要に応じて US などの region を追加します。
- query と任意の region を /v1/google-ad-library/advertiser-search に POST し、task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、広告主IDを選ぶ前に、名前の類似性だけでなく複数の情報で候補を確認します。
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidatesGoogle Ad Library Advertiser Search API の主なユースケース
- ブランドから広告主IDを特定: 名前やウェブサイトの語句から候補リストを作成し、別途行う公開広告一覧のリクエストに使う広告主IDを選びます。
- 地域別・法人別の区別: 似たレコードが複数あり、子会社、販売代理店、無関係の組織である可能性がある場合に、名前、地域、ウェブサイト、公開広告主ページを比較します。
- 確認待ちリストの作成: 候補の識別情報と取得タイムスタンプを保存し、名前の類似性だけで所有関係を断定せずに手動で確認できるようにします。
Google Ad Library Advertiser Search API 活用のヒント
- 具体的な正式名称、ブランド名、またはドメインに近い語句を使用してください。広い語句ではあいまいな候補が返ることがあり、一致ルールも保証されません。
- region は検索条件として扱い、その広告主のすべての広告がその地域で配信された証拠とはみなさないでください。
- レコードを統合したりクリエイティブを収集したりする前に、ID、名前、ウェブサイト、地域、公開広告主ページで候補を確認してください。
- results_limit は送信しないでください。この処理は上流の1回のレスポンスで返された使用可能な広告主の配列を保存するもので、取得元のページネーションは行いません。
関連API
Google Ad Library Advertiser Search API 以外に別の種類の公開Google Ad Libraryデータが必要な場合は、これらのAPIをご利用ください。
- Google Ad Library Ad API — Transparency Centerの既知の公開クリエイティブ1件をURLから取得し、広告主、広告文、メディア、配信、地域、フォーマット、遷移先、インプレッションの各フィールドを返します。
- Google Ad Library Company Ads API — 企業ドメインまたは広告主IDから、Transparency Centerの公開クリエイティブを取得します。トピック、地域、日付、掲載面、フォーマット、取得件数上限を指定できます。