RTB プロトコルに対応しているファイルを表示、ダウンロードできます。
Proto
| File | 説明 | バージョン | 最終更新 |
|---|---|---|---|
| cookie-batch-upload.proto | このメッセージを使用して、ユーザー ターゲティング データを一括アップロードします。 | v.24 | 2024 年 3 月 27 日 |
| openrtb.proto | Google は、JSON または Protobuf エンコードを使用した OpenRTB プロトコルをサポートしています。この proto は OpenRTB/Protobuf を使用する場合に必要です。また、サポートされているフィールドと、Google のネイティブ プロトコルへのマッピングについても説明します。 | 2.6 | 2024 年 5 月 22 日 |
| openrtb-adx.proto | Google の OpenRTB プロトコルには、別のプロトコルで提供されている拡張機能が含まれています。 | v.174 | 2024 年 5 月 21 日 |
| publisher-settings.proto | リアルタイム ビッダー ネットワークに固有のパブリッシャー設定のセット。 | v.13 | 2024 年 2 月 5 日 |
| realtime-bidding.proto | 認定バイヤーの RTB プロトコルを使用します。これは、Google が入札をリクエストする際に使用するメッセージです。BidRequest には、1 回のインプレッションの広告スロットが含まれます。 |
v.328 | 2024 年 5 月 21 日 |
オープンベータ版プロトコル
| File | 説明 | バージョン | 最終更新 |
|---|---|---|---|
| openrtb-adx.proto | Google の OpenRTB プロトコルには、別のプロトコルで提供されている拡張機能が含まれています。 | v.179 | 2024 年 5 月 24 日 |
| realtime-bidding.proto | 認定バイヤーの RTB プロトコルを使用します。これは、Google が入札をリクエストする際に使用するメッセージです。BidRequest には、1 回のインプレッションの広告スロットが含まれます。 |
v.338 | 2024 年 5 月 24 日 |
参照データ
辞書（クリックして .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 フィールドで使用されます。このフィールドでは、スニペットに関連付けられているクリエイティブの広告主を指定します。このリストは、エクスチェンジ全体の広告主を反映するものであり、特定の購入者によって代表される広告主を反映するものではありません。 |
| ブランド | 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 フィールドに、標準の入札拒否理由の値。 |
| プレターゲティング可能なクリエイティブの属性 | Buyer REST API で公開される PretargetingConfig リソースの supportedCreativeAttribute フィールドで使用されます。このフィールドでは、1 つのプレターゲティング設定に対応するすべてのクリエイティブに存在することが想定されるクリエイティブの属性を指定します。 |
| パブリッシャーの除外可能なクリエイティブ属性 | BidRequest の excluded_attribute フィールドで使用されます。このフィールドには、パブリッシャーが許可していないクリエイティブのタイプが示されます。たとえば、Cookie の使用を許可するかどうか、メディアやテキスト広告を許可するかどうかといった制限を指定できます。 |
| パブリッシャーのカテゴリ | BidRequest の detected_vertical フィールドで使用されます。このフィールドには、広告が表示されるページのカテゴリ（キーワードに類似）を指定します。このフィールドは、Google がページをクロールして、使用されるカテゴリを決定することで生成します。 |
| ベンダー | BidRequest の allowed_vendor_type フィールドで使用されます。このフィールドには、パブリッシャーが指定したとおり、配信されるクリエイティブの使用が許可されているリッチメディア ベンダー（Campaign Monitor、VoiceFive など）がリストされます。廃止された |
| データ プロバイダ | 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 日