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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

RTB プロトコルに対応しているファイルを表示またはダウンロードします。

プロトス

File 説明 バージョン Last Updated
cookie-bulk-upload.proto ユーザーのターゲティング データを一括アップロードする場合は、このメッセージを使用してください。 バージョン 19 2022 年 8 月 23 日
openrtb.proto Google では、JSON または Protobuf エンコードを使用した OpenRTB プロトコルをサポートしています。OpenRTB/Protobuf を使用する場合、この proto が必要です。サポートされているフィールドと、Google のネイティブ プロトコルへのマッピングに関するドキュメントも含まれています。 2.5.0 2022 年 11 月 3 日
openrtb-adx.proto Google の OpenRTB プロトコルには、いくつかの拡張機能が個別のプロトコルで含まれています。 バージョン 118 2022 年 10 月 3 日
publisher-settings.proto リアルタイム ビッダー ネットワークに固有のパブリッシャー設定のセット。 バージョン 12 2022 年 1 月 19 日
realtime-bidding.proto Google 認定バイヤー RTB プロトコル。これは、Google が入札単価のリクエストに使用するメッセージです。BidRequest には、1 回のインプレッションから発生した広告スロットが含まれます。 バージョン 258 2022 年 11 月 9 日
snippet-status-report.proto これは Google がクリエイティブのステータス レポートを伝えるために使用するメッセージです。 バージョン 34 2022 年 1 月 19 日

参照データ

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

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

次の中で使用:

ホスト型マッチ ステータス コード 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 モバイルアプリ アプリ ID、カテゴリ ID、人が読める形式のアプリ名を含む、ターゲットに設定可能な Android モバイルアプリのリスト。
地域テーブル 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 ファイルをリクエストしてください。