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

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

Protos

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

オープンベータ版の Protos

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

参照データ

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

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

リアルタイム フィードバックで返される

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

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

データ提供元 SegmentData.id フィールドで使用されます。BidRequestこのフィールドには、 パブリッシャー提供のシグナルを提供したエンティティに関する情報が含まれます。

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

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

公開元の設定

アカウント担当者に publisher-settings.pb.gz ファイルをリクエストしてください。

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

このファイルのポリシー トピックを使用して、 リアルタイム ビッダー API での審査時にクリエイティブをフィルタできます。

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

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