プロトタイプと参照データ

RTB プロトコルをサポートするファイルを表示またはダウンロードします。

Protos

ファイル 説明 バージョン 最終更新
cookie-bulk-upload.proto このメッセージを使用して、ユーザー ターゲティング データを一括アップロードします。 v.24 2024 年 3 月 27 日
openrtb.proto Google は、JSON または Protobuf エンコードを使用して OpenRTB プロトコルをサポートしています。OpenRTB/Protobuf を使用する場合は、この proto が必要です。また、サポートされているフィールドと、それらの Google のネイティブ プロトコルへのマッピングに関するドキュメントも含まれています。 2.6 2025 年 8 月 12 日
openrtb-adx.proto Google の OpenRTB プロトコルには、別の proto で提供される拡張機能がいくつか含まれています。 v.196 2025 年 9 月 4 日
publisher-settings.proto リアルタイム ビッダー ネットワークに固有のパブリッシャー設定のセット。 v.14 2024 年 2 月 5 日

オープンベータ版のプロトタイプ

ファイル 説明 バージョン 最終更新
openrtb-adx.proto Google の OpenRTB プロトコルには、別の proto で提供される拡張機能がいくつか含まれています。 v.203 2025 年 9 月 4 日

参照データ

辞書（クリックして .txt ファイルをダウンロード）
広告の商品カテゴリ BidRequest の excluded_product_category フィールドで使用されます。このフィールドは、パブリッシャーが許可しない商品やサービスのカテゴリを説明します。たとえば、パブリッシャーがオンライン バンキングに関連する広告をホストしたくない場合などです。
広告の制限付きカテゴリ BidRequest の allowed_restricted_category フィールドと BidResponse の restricted_category フィールドで使用されます。allowed_restricted_category フィールドは、通常は制限されているものの、パブリッシャーによって明示的に許可されていると宣言されたカテゴリ（アルコール関連のコンテンツを含む広告など）を表します。
デリケートな広告カテゴリ BidRequest の excluded_sensitive_category フィールドと BidResponse の category フィールドで使用されます。excluded_sensitive_category フィールドは、パブリッシャーが許可していないデリケートなカテゴリを記述します。たとえば、パブリッシャーが政治関連の広告を掲載したくない場合などです。
広告主 SnippetStatusItem の advertiser_id フィールドで使用されます。このフィールドは、スニペットに関連付けられているクリエイティブで表される広告主を指定します。このリストには、エクスチェンジ全体の広告主が反映されます。1 人の購入者が代表する広告主は反映されません。
ブランド クライアント アクセス API で使用されるブランドのリスト。
購入者が申告できるクリエイティブ属性 BidResponse の attribute フィールドに使用されます。このフィールドは、BidRequest の excluded_attribute に表示してはならないクリエイティブの購入者が宣言可能な属性を表します。
コールアウトのステータス コード performancereport メソッド呼び出しで返されるステータス コード。
コンテンツ ラベル BidRequest の detected_content_labels フィールドで使用されます。
Cookie マッチャーのステータス コード RTB プロトコルのパフォーマンス レポートの cookieMatcherStatusRate フィールドで使用されます。利用可能なコードについては、Cookie マッチング ガイドをご覧ください。
クリエイティブのステータス コード

使用するグループ

creative_status_code はリアルタイム フィードバックで返されます。
ホスト型一致ステータス コード RTB プロトコルのパフォーマンス レポートの hostedMatchStatusRate フィールドで使用されます。
入札しない理由 認定バイヤーの入札プロトコルの BidResponse.no_bid_reason フィールドで指定される標準の入札なし理由の値。
事前ターゲティング可能なクリエイティブ属性 購入者 REST API で公開されている PretargetingConfig リソースの supportedCreativeAttribute フィールドで使用されます。このフィールドは、単一の事前ターゲティング構成に対応するすべてのクリエイティブに存在することが想定されるクリエイティブ属性を記述します。
パブリッシャーが除外できるクリエイティブの属性 BidRequest の excluded_attribute フィールドで使用されます。このフィールドには、パブリッシャーが許可していないクリエイティブのタイプが記述されます。たとえば、Cookie の使用が許可されているかどうか、メディア広告やテキスト広告が許可されているかどうかに関する制限を指定できます。
パブリッシャーのカテゴリ BidRequest の detected_vertical フィールドで使用されます。このフィールドは、広告が表示されるページの業種（キーワードに類似）を指定します。Google は、ページをクロールしてどの業種が使用されているかを判断し、このフィールドを生成します。
ベンダー BidRequest の allowed_vendor_type フィールドで使用されます。このフィールドには、パブリッシャーが指定した、配信されるクリエイティブで許可されるリッチメディア ベンダー（Campaign Monitor や VoiceFive など）が一覧表示されます。

サポートが終了した gdn-vendors.txt 辞書ファイルのベンダーが含まれます。
データ プロバイダ BidRequest の SegmentData.id フィールドで使用されます。このフィールドには、パブリッシャー提供のシグナルを提供したエンティティに関する情報が含まれます。

参照テーブル（クリックして CSV をダウンロード）
Android モバイルアプリ ターゲティング可能な Android モバイルアプリのリスト。アプリ ID、カテゴリ ID、人間が読める形式のアプリ名が含まれます。
地理情報テーブル BidRequest の geo_criteria_id フィールドのデコードに使用されるテーブル。詳しくは、地域ターゲティングをご覧ください。
LGPD プロバイダ LGPD のトラフィックで配信が許可されている広告のパーソナライズ プロバイダのリスト。ID、人が読める名前、プライバシー URL、プロバイダに帰属できるドメインのリストが含まれます。LGPD の適用は、認定バイヤーの入札プロトコルの BidRequest.adslot.regs_lgpd フィールドと OpenRTB の入札プロトコルの BidRequest.regs.ext.lgpd フィールドを通じて、特定の入札リクエストで示されます。
携帯通信会社 携帯通信会社のリスト。
モバイル デバイス モバイル デバイスのリスト。
モバイル オペレーティング システム モバイル オペレーティング システムのリスト。
Providers 広告のパーソナライズ プロバイダ ID を、人が読める形式の名前、プライバシー ポリシーの URL、プロバイダに帰属させることができるドメインのリストにマッピングします。現在、プロバイダは AdX プロトコルの BidRequest.AdSlot.consented_providers_settings フィールドと OpenRTB プロトコルの BidRequest.User.UserExt.consented_providers_settings フィールドで使用されています。これらのフィールドでは、欧州経済領域内の国のユーザーについて、パブリッシャーから渡されたユーザーの同意がリストに記載されているプロバイダに適用されます。

公開元の設定

アカウント担当者に publisher-settings.pb.gz ファイルをリクエストします。

クリエイティブの審査ポリシーのトピック

このファイル内のポリシー トピックを使用して、Real-time Bidding API の 審査中にクリエイティブをフィルタできます。

ポリシー トピックを CSV ファイルとしてダウンロードします。

最終更新日: 2022 年 4 月 18 日