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

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

proto

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

オープンベータ版 Protos

File 説明 バージョン 最終更新
openrtb-adx.proto Google の OpenRTB プロトコルには、別のプロトコルでいくつかの拡張機能が含まれています。 v.174 2024 年 4 月 17 日
realtime-bidding.proto これは Google の認定バイヤーの RTB プロトコルですこれは、Google が入札をリクエストするために使用するメッセージです。BidRequest には、1 回のインプレッションの広告スロットが含まれます。 v.331 2024 年 4 月 17 日

参照データ

辞書(クリックして .txt ファイルをダウンロード)

広告の商品カテゴリ BidRequestexcluded_product_category フィールドで使用されます。このフィールドは、パブリッシャーが許可していない商品やサービスのカテゴリを示します。たとえば、パブリッシャーがオンライン バンキングに関連する広告をホストしない場合などです。
広告の制限付きカテゴリ BidRequestallowed_restricted_category フィールドと BidResponserestricted_category フィールドで使用されます。allowed_restricted_category フィールドには、アルコール関連コンテンツを含む広告など、通常は制限されているものの、パブリッシャーが許可しているものとして明示的に宣言しているカテゴリを指定します。
広告のデリケートなカテゴリ BidRequestexcluded_sensitive_category フィールドと BidResponsecategory フィールドで使用されます。excluded_sensitive_category フィールドは、パブリッシャーが許可していないデリケートなカテゴリを示します(政治に関連する広告をホストしたくない場合など)。
広告主 SnippetStatusItem の advertiser_id フィールドで使用されます。このフィールドには、スニペットに関連付けられたクリエイティブによって表される広告主を指定します。このリストはエクスチェンジ全体の広告主を反映するものであり、1 人の購入者が代表する広告主のものではありません。
ブランド Client Access API で使用されるブランドのリスト。
購入者が宣言できるクリエイティブ属性 BidResponseattribute フィールドに使用されます。このフィールドでは、BidRequestexcluded_attribute には指定できない、購入者が宣言できるクリエイティブの属性を指定します。
コールアウトのステータス コード performancereport メソッド呼び出しによって返されるステータス コード。
コンテンツ ラベル BidRequestdetected_content_labels フィールドで使用されます。
Cookie マッチャーのステータス コード RTB プロトコルのパフォーマンス レポートの cookieMatcherStatusRate フィールドで使用されます。使用可能なコードについては、Cookie マッチング ガイドをご覧ください。
クリエイティブのステータス コード

次の中で使用:

リアルタイム フィードバックcreative_status_code が返されました。
ホスト型マッチのステータス コード RTB プロトコルのパフォーマンス レポートの hostedMatchStatusRate フィールドで使用されます。
入札しない理由 標準の入札しない理由の値は、認定バイヤーの入札プロトコルの BidResponse.no_bid_reason フィールドに指定します。
事前にターゲットに設定できるクリエイティブの属性 Buyer REST API で公開される PretargetingConfig リソースの supportedCreativeAttribute フィールドで使用されます。このフィールドでは、1 つのプレターゲティング設定に対応するすべてのクリエイティブに含まれることが想定されるクリエイティブ属性を記述します。
パブリッシャーが除外できるクリエイティブ属性 BidRequestexcluded_attribute フィールドで使用されます。このフィールドは、パブリッシャーが許可していないクリエイティブのタイプを示します。たとえば、Cookie の使用を許可するかどうか、メディア広告やテキスト広告を許可するかどうかの制限を指定できます。
パブリッシャーのカテゴリ BidRequestdetected_vertical フィールドで使用されます。このフィールドでは、広告が表示されるページのカテゴリ(キーワードに類似)を指定します。Google がページをクロールし、使用されるカテゴリを決定することで、このフィールドが生成されます。
販売者ネットワーク ID BidRequestseller_network_id フィールドで使用されます。このフィールドでは、パブリッシャーが属する販売者のネットワークを指定します。このファイルの内容は、販売者のネットワーク ID の値に基づいて昇順になっています。
ベンダー BidRequestallowed_vendor_type フィールドで使用されます。このフィールドには、パブリッシャーの指定に従って、配信を許可するリッチメディア ベンダー(Campaign Monitor、VoiceFive など)がリストされます。

廃止された gdn-vendors.txt 辞書ファイルのベンダーが含まれます。

参照テーブル(クリックして CSV をダウンロード)

Android モバイルアプリ ターゲット設定可能な Android モバイルアプリのリスト(アプリ ID、カテゴリ ID、人が読める形式のアプリ名を含む)。
地域テーブル BidRequestgeo_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 日