
準備と公開ビルドの詳細
Google Ads Transparencyの公開ビルド0.2.7は、名前、ドメイン、広告主ID、または広告主や広告クリエイティブの公開URLを含むtargetsと、region、platform、adFormat、任意のdateFrom/dateTo、includeDeliveryDetails、maxItemsを受け付けます。保存済みのTaskプリセットでは、targetsに`["nike.com", "adidas.com"]`などを指定し、regionを`CA`、platformを`ALL`、adFormatを`ALL`、includeDeliveryDetailsを`false`、maxItemsを`10`に設定しています。最初の確認では、このサンプルのtargetsを、調査対象として確認済みの広告主ID1件に置き換えます。targetsは`[oneID]`、regionは`CA`、platformは`ALL`、adFormatは`ALL`、includeDeliveryDetailsは`false`、maxItemsは`2`にします。adFormatには、実際にサポートされている正確な値を使い、独自の入力値を作らないでください。任意のdateFrom/dateToを設定する場合は、比較するサンプル間で値をそろえる必要があります。存在しないページネーションの仕様を想定しないでください。
標準の必須フィールドには、input、inputType、requestedRegion、requestedPlatform、requestedFormat、advertiserId、advertiserName、advertiserLegalName、advertiserDomain、advertiserCountryCode、advertiserVerified、creativeId、creativeUrl、observedAt、status、statusReasonがあります。任意のpayerName、servedRegions、servedPlatformsはnullになる場合があります。requestedRegionは、advertiserCountryCodeや任意の配信地域情報と区別してください。ターゲティング、オーディエンスの国籍、非公開の広告成果を推測してはいけません。
OUTPUTは実行の証拠となる情報で、targetsReceived、targetsResolved、targetOutcomes、duplicatesSkipped、unusableCreativesSkipped、creativesSaved、statusCounts、stopReasonを含みます。現時点で実際に行った限定的な受け入れ検証の結果は、架空例とは異なります。正確な広告主IDを指定したカナダの試験実行では、上限2件に対して利用可能な広告クリエイティブが1件返されました。配信詳細をオフにした状態で、requestedRegionはca、advertiserCountryCodeはSG、advertiserDomainはnull、servedRegionsはnull、servedPlatformsはnullでした。nullは情報を取得できなかったことを示し、配信がなかったことを意味しません。OUTPUTでは、受信した対象が1件、特定できた対象が1件、保存した広告クリエイティブが1件で、ステータスはok、終了理由はsources_finishedと報告されました。上限2件は最大件数であり、必ず2件取得できるという約束ではありません。また、sources_finishedは、その国の広告をすべて網羅したことを保証しません。検証したのはカナダのみです。実際に2か国を比較するには、同じ条件で別の国を対象とした2回目の実行を行い、その結果が受け入れ検証を通ってから比較する必要があります。米国の架空例を、製品の受け入れ検証結果として示してはいけません。
地域別に広告クリエイティブを比較する手順
- 最初に、正確な広告主IDを確認します。1つのドメイン名が複数のアカウントに一致する場合があるため、開始前に対象に含めるアカウントを確認してください。
- 2つの国を選びます。両方の実行で、プラットフォーム、広告形式、日付設定、取得件数の上限を同じにします。広告主の国と、広告の検索対象として指定する地域を区別してください。
- まず小規模なテストを行います。カナダの場合は、targetsに確認済みの広告主IDを指定し、regionをCA、platformをALL、広告形式をALL、includeDeliveryDetailsをfalse、maxItemsを2に設定します。上限は最大件数であり、その件数の取得を約束するものではありません。
- 取得した標準形式の広告クリエイティブの行データをすべて保存します。広告主ID、広告クリエイティブID、広告クリエイティブURL、地域、ステータスを記録します。これらの日付からオーディエンスのターゲティングや広告成果を推測してはいけません。
- 集合を比較する前に、各ソースへの実行結果を確認します。クエリの失敗や上限への到達は、ソース側の制約を示すものであり、母集団が空であることを意味しません。入力条件、広告主の同一性、収集日に実質的な違いがある場合は、条件が一致していないサンプルと明記し、差を地域フィルターの影響とみなさないでください。
- 各地域のサンプルについて、広告主IDと広告クリエイティブIDを組み合わせたキーを使って集合を作成します。共通部分と各サンプルだけに含まれる集合は、この正確なキーを使って報告します。不明なIDは未解決のままにします。1つの広告クリエイティブに複数のバリエーションがあっても、広告クリエイティブIDが複数あることにはなりません。
- 結果を明確に説明します。「両方で確認」「地域Aのみ」「地域Bのみ」「このサンプルでは未確認」などのラベルを使います。「このサンプルでは未確認」と「一度も配信されていない」は区別してください。結果の違いは、広告主の戦略が証明されたものではなく、ソースの選択、件数の上限、時間の経過による変化、詳細情報の欠損を反映している可能性があります。
- 各サンプルへの所属を示す表と記録票を提出します。クエリが失敗した場合や、広告主の不一致が解消されない場合は、比較を中止し、1つの地域で得た証拠を保存します。地域を限定しないサンプルと、特定の国のサンプルを組み合わせてはいけません。
独自に作成した架空例:地域別サンプル台帳と記録票
以下のサンプル記録票と所属表は、独自に作成した架空例です。読者が自分で作る記録票を示しており、製品の標準フィールドや、実際に米国を対象として行った製品の実行結果ではありません。広告主Aについて、プラットフォームALL、広告形式ALL、上限5件、includeDeliveryDetails false、明示的に指定したdateFrom 2026-01-01とdateTo 2026-03-31という同一条件で、カナダと米国の両方のデータを収集したとします。また、両方について2026-02-15の具体的な観測時刻を記録し、入力条件をそろえた記録票があるものとします。広告主の設定や収集範囲に実質的な違いがあれば、条件が一致していないサンプルとなり、地域による効果とはみなせません。
| 地域別サンプル | 入力設定 | 観測日時(UTC) | 利用可能な行数 | 終了理由 |
|---|---|---|---|---|
| カナダのサンプル | 広告主A、CA、ALL、ALL、maxItems 5、includeDeliveryDetails false、dateFrom 2026-01-01、dateTo 2026-03-31 | 2026-02-15T10:30:00Z | 3 | sources_finished |
| 米国のサンプル | 広告主A、US、ALL、ALL、maxItems 5、includeDeliveryDetails false、dateFrom 2026-01-01、dateTo 2026-03-31 | 2026-02-15T11:15:00Z | 4 | sources_finished |
以下は、advertiserIdとcreativeIdを組み合わせた5つの複合キーについて、地域別サンプルへの所属を示す、独自に作成した架空例の表です。ここでは、AC1、AC2、AC3、AC4、AC5が、広告主Aの架空の広告クリエイティブキーを表します。
| 広告クリエイティブキー | カナダのサンプル | 米国のサンプル | サンプルへの所属状況 |
|---|---|---|---|
| AC1 | 確認済み | 未確認 | カナダのみ |
| AC2 | 確認済み | 確認済み | 両方で確認 |
| AC3 | 確認済み | 確認済み | 両方で確認 |
| AC4 | 未確認 | 確認済み | 米国のみ |
| AC5 | 未確認 | 確認済み | 米国のみ |
この独自に作成した架空例の集合では、カナダのサンプルは3件、米国のサンプルは4件、共通部分は2件(AC2、AC3)、カナダのみに含まれるものは1件(AC1)、米国のみに含まれるものは2件(AC4、AC5)で、和集合は5件です。「未確認」は、保存して確認したそのサンプル内にないことだけを意味し、一度も配信されていないという意味ではありません。広告クリエイティブC3を重複して観測しても、既知のキーとして数えるのは1件だけです。不明なキーは未解決のままとし、信頼できる集合には含めません。米国を対象とした実行が失敗した場合、その集合は空ではなく不明となり、その集合を使って一方のサンプルだけに含まれる件数を計算することはできません。
出典と参考資料
著者 Chronometrica · 更新日
ページの先頭へ ↑

