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

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

Protos

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

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

ファイル 説明 バージョン 最終更新
openrtb-adx.proto Google の OpenRTB プロトコルには、別のプロトコルで提供されるエクステンションがいくつか含まれています。 v.189 2024 年 12 月 10 日
realtime-bidding.proto Google の認定バイヤー RTB プロトコル。これは、Google が入札をリクエストするために使用するメッセージです。BidRequest には、1 回のインプレッションの広告スロットが含まれます。 v.342 2024 年 10 月 31 日

参照データ

辞書（.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 人の購入者が代表する広告主は反映されません。
ブランド Client Access 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 フィールドで使用されます。このフィールドには、1 つのプリターゲティング設定に対応するすべてのクリエイティブに存在することが想定されるクリエイティブ属性を指定します。
パブリッシャーが除外できるクリエイティブの属性 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 日