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

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

Proto

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

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

ファイル 説明 バージョン 最終更新
openrtb-adx.proto Google の OpenRTB プロトコルには、別のプロトコルで提供されるいくつかのエクステンションが含まれています。 v.186 2024 年 11 月 1 日
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 フィールドで使用されます。このフィールドには、スニペットに関連付けられているクリエイティブで表される広告主を指定します。このリストは、エクスチェンジ全体の広告主を反映するものであり、特定の購入者によって代表される広告主を反映するものではありません。
ブランド 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 日