認定バイヤーのリアルタイム ビッダー プロトコル

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

このガイドでは、認定バイヤーのリアルタイム ビッダー プロトコル v.258 の各フィールドについて、その他の実装のヒントと情報を説明します。

このガイドのベースとなっている認定バイヤーの RTB proto ファイルもご覧ください。

BidRequest オブジェクト

これは Google が入札をリクエストするために使用するメッセージです。BidRequest には 1 回のインプレッションで生成された広告スロットが含まれます。

このセクションには、ユーザーについてわかっている情報が記載されています。

インプレッションが発生したウェブページまたはモバイルアプリに関する情報。
属性 必須 / 任意 タイプ 実装の詳細
id required バイト Google が生成した一意のリクエスト ID。これは 16 バイトです。
ip optional バイト IPv4 のネットワーク バイト順で IP アドレスの最初の 3 バイト、IPv6 の場合は最初の 6 バイト。IPv6 アドレスに含まれるバイト数と位置は後で変更される可能性があります。
user_data_treatment repeated enum user_data_treatment が設定されている場合、ユーザーの Cookie/ID データはリクエストから削除され、コールアウトでは送信されません。影響を受けるフィールドは次のとおりです。
  • google_user_id
  • host_match_data
  • mobile.encrypted_ads_id
  • mobile.encrypted_hashed_idfa
  • session_id

TAG_FOR_CHILD_DIRECTED_TREATMENT = 0 - 現在のリクエストは、児童オンライン プライバシー保護法(Children's Online Privacy Protection Act)に基づき、子供向けとして扱われる必要があります。詳しくは、こちらの記事をご覧ください。

google_user_id optional 文字列 Cookie マッチング サービスのドキュメントに記載されているユーザーの Google ID。このフィールドは、パディングされていないウェブ セーフの Base64 エンコードのバイナリ Cookie ID です。エンコードの詳細については、RFC 3548 の URL およびファイル名セーフ アルファベットによる Base 64 エンコード セクションをご覧ください。このフィールドは、Cookie マッチング サービスによって返される Google ID と同じです。
cookie_version optional int32 google_user_id のバージョン番号。Google は、Cookie から google_user_id へのマッピングを変更することがあります。この場合、バージョンはインクリメントされます。
cookie_age_seconds optional int32 google_user_id が作成されてからの経過時間(秒)。この数値は量子化できます。
hosted_match_data optional バイト Cookie マッチング サービスを介してこの google_user_id に保存されているデータを照合します。一致が存在する場合、このフィールドは google_hm パラメータで渡されたデコードされたデータを保持します。
session_id optional 文字列 CTV/OTT デバイス上の有効期間が短いユーザー セッションで、最大セッション時間は 6 時間です。 広告のパーソナライズに session_id の使用は許可されません。 session_id は、フリークエンシー キャップ、競合相手の除外、または関連する目的にのみ使用できます。
user_agent optional 文字列 リクエストを送信したブラウザとデバイスの種類を識別する文字列です。特定のデータは削除または置換される場合があります。
privacy_treatments optional プライバシーの扱い プライバシーに関する扱い。入札リクエストの一部のフィールドは、ユーザーのプライバシーを保護するために、加工または秘匿化できます。このメッセージでは、このリクエストを通じて提供される広告配信予想に適用される、プライバシーの取り扱いについて説明します。
user_agent_data optional UserAgent ユーザー エージェント情報。
publisher_country optional 文字列 パブリッシャーの請求先住所の国。geo_criteria_id でユーザーが検出された国や、ウェブサイトのホスティング国とは異なる場合があります。国コードの一覧については、国コードのリストのドキュメントをご覧ください。
host_publisher_id optional 文字列 ホスト パブリッシャーの ID。入力されている場合は、ホスト パブリッシャーが収益分配に参加し、この ID を使用して ads.txt を承認できることを示します。
geo_criteria_id optional int32 エンドユーザーの所在地。Google Ads API で使用されるコードのサブセットを使用します。ID のリストについては、技術ドキュメントの geo-table.csv テーブルをご覧ください。サポートが終了した国、地域、都市、大都市圏のフィールドは、geo_criteria_id フィールドに置き換えられます。
geo optional 地域 ユーザーのおおよその位置情報。位置情報はすべて IP 位置情報から取得されます。緯度/経度フィールドは、他のフィールド(都市など)によってもたらされる IP 位置情報から派生した場所の基準位置(セントロイドなど)であり、精度はその場所のおおよその領域を含む円の半径です。ユーザーのプライバシーを保護するため、必要に応じて位置情報とその精度を微調整します。
postal_code
postal_code_prefix
optional 文字列 エンドユーザーの国に適した郵便番号が検出されました(国が米国の場合は郵便番号など)。postal_code_prefix フィールドは、精度が低すぎて完全なコードを暗示できない場合に設定されます。それ以外の場合は postal_code フィールドが設定されます。
encrypted_hyperlocal_set optional バイト ハイパーローカル ターゲティング シグナル(利用可能な場合)。ハイパーローカル ターゲット シグナルの復号ガイドに記載されているように暗号化されます。
hyperlocal_set optional HyperlocalSet encrypted_hyperlocal_set の暗号化されていないバージョンこのフィールドは、SSL 接続を使用する場合にのみ設定されます。
timezone_offset optional int32 ユーザーの時間に対する GMT からのオフセット(分単位)。たとえば、GMT+10 は timezone_offset = 600 です。
user_list repeated ユーザーリスト
publisher_id optional 文字列 ウェブ プロパティ コードのパブリッシャー コードの接尾辞で定義されたパブリッシャー ID。たとえば、「pub-123」はウェブ プロパティ コード「ca-pub-123」のパブリッシャー コードです(ca- はウェブ プロパティのプロダクト固有の接頭辞です)。
seller_network_id optional int32 販売者のネットワーク ID。ID の一覧については、技術ドキュメントの seller-network-ids.txt ファイルをご覧ください。サイトが匿名ではなく、パブリッシャーがサイトのターゲティングを許可している場合にのみ、設定されます。
partner_id optional 固定 64 この広告枠を提供するパートナーの ID。これは、seller_network_id も設定され、seller_network_id 以外のパートナー情報も利用可能である場合にのみ設定されます。partner_id の値は、安定した識別子を提供するだけでは意味がありません。
url optional 文字列 パラメータが削除されたページの URL。常にプロトコル(http または https)で始まります。
is_semi_transparent_request optional ブール値 リクエストで半匿名が使用されていることを示します。つまり、リクエスト URL の短縮バージョンのみが提供されます。この決定はニュース メディアが決定します。//support.google.com/admanager/answer/4584891 をご覧ください。
detected_language repeated 文字列 ウェブページの言語、ブラウザの設定、その他のシグナルに基づいて検出されたユーザーの言語。順序は任意です。コードは 2 文字または 5 文字で、言語コードの表に記載されています。
detected_vertical repeated 業種 注: このフィールドの値は編集されました。検出されたコンテンツ カテゴリの順序付けリスト。ID のリストについては、技術ドキュメントの publisher-verticals.txt ファイルをご覧ください。
detected_content_label repeated int32 注: このフィールドの値は編集されました。検出されたコンテンツ ラベルのリスト。ID のリストについては、技術ドキュメントの content-labels.txt ファイルをご覧ください。
google_query_id optional 文字列 これは、クエリ全体の一意の ID を表します。1 つのクエリに複数のコールアウトがある場合、そのクエリのすべてのコールアウト リクエストに同じ google_query_id が含められます。
auction_type optional enum このクエリを実行するオークションのタイプ。デフォルト = SECOND_PRICE

UNKNOWN_AUCTION_TYPE = 0
FIRST_PRICE = 1
SECOND_PRICE = 2
FIXED_PRICE = 3

device optional デバイス
key_value repeated KeyValue
mobile optional モバイル
video optional 動画
publisher_settings_list_id optional 固定 64 このページに適用されるパブリッシャー設定リスト ID。詳しくは、RTB パブリッシャーの設定ガイドをご覧ください。
publisher_type optional enum 広告を表示する広告枠のパブリッシャー タイプです。リクエストの場合、パブリッシャーの広告枠は、パブリッシャーが所有および運営する(O&O)、パブリッシャーによる代理、または不明なステータスのいずれかになります。デフォルト = UNKNOWN_PUBLISHER_TYPE

UNKNOWN_PUBLISHER_TYPE = 0
PUBLISHER_OWNED_AND_OPERATED = 1
PUBLISHER_REPRESENTED = 2

page_visibility optional enum 広告スロットを含むウェブページの表示状態。www.w3.org/TR/page-visibility/ をご覧ください。

VISIBILITY_STATE_UNKNOWN = 0
VISIBILITY_STATE_VISIBLE = 1
。ページは少なくとも部分的に表示されています。たとえば、最小化されていないウィンドウの [フォアグラウンド] タブで確認します。
VISIBILITY_STATE_HIDDEN = 2このページはユーザーに表示されません。たとえば、ページがバックグラウンドのブラウザタブにある場合や、最小化されたウィンドウに表示されている場合です。

adslot repeated 広告スロット
bid_response_feedback repeated BidResponseFeedback
response_deadline_ms optional int32 この特定の入札リクエストに対する Google のレスポンスの待機時間をミリ秒単位で示します。未設定の場合、ビッダーではデフォルトの期限が使用されていると見なされます。
is_test optional ブール値 true の場合、これはテスト リクエストです。結果がユーザーに表示されず、オークションに勝っても料金が請求されることはありません。リクエストは、レイテンシの評価やその他のテストに使用される場合があるため、通常の処理を行う必要があります。Google での最初のテスト中に、このオプションが true または false の値であるかどうかにかかわらず、すべてのレスポンスがオークションから除外されます。
is_ping optional ブール値 true の場合、このリクエストはネットワーク レイテンシを測定することを目的としています。入札ロジックを実行せずに、できるだけ早く fast_processing_time_ms を設定して空の BidResponse を返します。
is_predicted_to_be_ignored optional ブール値 true の場合、コールアウト モデルは、このリクエストには入札しないと予測しています。Google は、このようなリクエストからサンプリングした割合を送信して、入札パターンが変化したときにモデルを自動的に更新できるようにします。
supply_chain optional SupplyChain

UserAgent オブジェクト

ユーザー エージェント情報。ここには、User-Agent ヘッダーや Sec-CH-UA ヘッダーから抽出された、ユーザー エージェントに関する情報が設定されます。

属性 必須 / 任意 タイプ 実装の詳細
browser optional BrandVersion ブラウザを示します。
platform optional BrandVersion プラットフォームを識別する ID を指定します。
mobile optional ブール値 エージェントがモバイル優先コンテンツを優先する場合は true。デバイスに関する具体的な情報については、BidRequest.device フィールドをご覧ください。このフィールドと一致しない場合もあります(たとえば、スマートフォンのブラウザがパソコン向けサイトをリクエストできます)。
architecture optional 文字列 デバイス アーキテクチャ(「x86」や「arm」など)。
bitness optional 文字列 デバイスのビット数(例: 64 ビット アーキテクチャの場合は「64」)。
model optional 文字列 デバイスのモデル。

PrivacyTreatments オブジェクト

プライバシーに関する扱い。入札リクエストの一部の項目は、ユーザーのプライバシーを保護するために、加工または秘匿化できます。このメッセージでは、このリクエストを通じて提供される広告配信予想に適用される、プライバシーの取り扱いについて説明します。

属性 必須/任意 タイプ 実装の詳細
non_personalized_ads_reason optional NonPersonalizedAdsReason 列挙型

このリクエストへのレスポンスとして返された広告をパーソナライズしない理由を指定します。

UNKNOWN = 0。理由は不明です。

PUBLISHER_DECLARED_NPA = 1 パブリッシャーは、他のシグナルとは無関係に、パーソナライズされていない広告を配信することを宣言しました。

RESTRICT_DATA_PROCESSING= 2: パブリッシャーがこのリクエストについて制限付きデータ処理をリクエストしました。

USER_OPT_OUT = 3: ユーザーが広告のパーソナライズを無効にしている。

allow_user_data_collection optional ブール値 パブリッシャーがユーザーのサイト訪問に関する情報を使用してインタレスト カテゴリを作成し、そのカテゴリに基づいて広告を配信するための許可をパブリッシャーが付与している場合は true。このデータを使用してインタレスト カテゴリを作成するには、ビッダーが所定のインプレッションを獲得できる必要もあります。データ収集の管理機能(ベータ版)についてをご覧ください。

BrandVersion オブジェクト

ブラウザまたはプラットフォーム用のタプル(ブランド、バージョン)。

属性 必須 / 任意 タイプ 実装の詳細
brand optional 文字列 ブランド識別子(「Chrome」や「Windows」など)。
version repeated 文字列 バージョン。必要に応じてコンポーネントに分割します(例: {"85", "1"} = v85.1)。

地理オブジェクト

ユーザーのおおよその位置情報。位置情報はすべて IP 位置情報から取得されます。緯度/経度フィールドは、他のフィールド(都市など)によってもたらされる IP 位置情報から派生した位置の基準位置(セントロイドなど)であり、精度はその場所のおおよその領域を含む円の半径です。ユーザーのプライバシーを保護するため、必要に応じて位置情報とその精度が微調整されます。

属性 必須 / 任意 タイプ 実装の詳細
lat optional 倍精度
lon optional 倍精度 経度は -180.0 ~+180.0 で、マイナスは西です。
country optional 文字列 ISO-3166-1 Alpha-3 を使用する国。
region optional 文字列 ISO-3166-2 を使用した地域コード。米国の場合は 2 文字の州コード。
metro optional 文字列 Google 大都市圏コード(Nielsen の DMA に類似しているわけではありません)。
city optional 文字列 国際連合の貿易、運輸に関する地域コードを使用している都市。国のリストで国をクリックすると、都市コードが表示されます。
zip optional 文字列 郵便番号。
accuracy optional int32 推定位置情報の精度(メートル単位)。
utcoffset optional int32 UTC からのローカル時間(+/- 分)。

HyperlocalSet オブジェクト

属性 必須 / 任意 タイプ 実装の詳細
hyperlocal repeated ハイパーローカル このフィールドには現在、最大 1 つのハイパーローカル ポリゴンが含まれています。
center_point optional ハイパーローカル.Point ジオフェンス領域のおおよその幾何学的中心。ジオフェンス領域の幾何学的形状のみに基づいて計算されます。ジオフェンス領域内のモバイル デバイスの実際の位置を示すものではありません。上で複数のハイパーローカル ポリゴンが指定されている場合、center_point はすべてのハイパーローカル ポリゴンの幾何学的中心です。

ハイパーローカル オブジェクト

ハイパーローカルなターゲット地域(利用可能な場合)。

属性 必須 / 任意 タイプ 実装の詳細
corners repeated モバイル デバイスは、隅のリストで定義されたジオフェンス ポリゴン内の任意の位置に存在します。現在、ポリゴンは常に四隅の平行四辺形です。
ポイント オブジェクト

地表面上の位置。

属性 必須 / 任意 タイプ 実装の詳細
latitude optional float 場所の緯度。
longitude optional float 場所の経度。

UserList オブジェクト

このフィールドはデフォルトでは入力されません。代わりに、ビッダーは google_user_id または hosted_match_data をキーとしてリスト ID を保存し、検索することをおすすめします。

属性 必須 / 任意 タイプ 実装の詳細
id optional int64 ユーザーリスト ID。
age_seconds optional int32 ユーザーがリストに追加されてからの経過時間(秒)。

垂直方向のオブジェクト

Google が決定した、ページの 1 つ以上の検出されたカテゴリ。

属性 必須 / 任意 タイプ 実装の詳細
id required int32 カテゴリ ID。ID のリストについては、技術ドキュメントの publisher-verticals.txt ファイルをご覧ください。
weight required float このカテゴリのウェイト。[0.0, 1.0] の範囲。関連するカテゴリは重み付けが高くなります。

デバイス オブジェクト

デバイスに関する情報。

属性 必須 / 任意 タイプ 実装の詳細
device_type optional enum 広告が表示されるデバイスの種類。デフォルト = UNKNOWN_DEVICE

UNKNOWN_DEVICE = 0
HIGHEND_PHONE = 1
TABLET = 2
PERSONAL_COMPUTER = 3
- パソコンまたはノートパソコン。
CONNECTED_TV = 4 - コネクテッド テレビ(スマートテレビ)とコネクテッド デバイス(Roku、Apple TV など)の両方。
GAME_CONSOLE = 5

platform optional 文字列 デバイスのプラットフォーム。例: Android、iPhone、Palm。
brand optional 文字列 デバイスのブランド(Nokia、Samsung など)。
model optional 文字列 デバイスのモデル(N70、Galaxy など)。
os_version optional OS バージョン OS のバージョン(例: Android 2.1 の場合は 2、iOS 3.3.1 の場合は 3.3)。
carrier_id optional int64 デバイスが(Wi-Fi ではなく)携帯通信会社を介してインターネットに接続している場合の、携帯通信会社の一意の識別子。運送業者 ID から運送業者の名前と国を確認するには、こちらの携帯通信会社の表をご覧ください。
screen_width optional int32 デバイス画面の幅(ピクセル単位)。
screen_height optional int32 デバイス画面の高さ(ピクセル単位)
screen_pixel_ratio_millis optional int32 高密度デバイス(iOS Retina ディスプレイなど)に使用されます。デフォルト以外の値は、公称画面サイズ(単位にピクセル)が画面上の実際のピクセル数を表していないことを示します。たとえば、640x1280 ピクセルの画面では、公平な幅と高さが 320x640 になることがあります。この場合、各軸の寸法は、そのディメンションが示す 2 倍のピクセルを持つため、screen_width=320screen_height=640screen_pixel_ratio_millis=2000 となります。

デフォルト = 0

screen_orientation optional enum 広告リクエストが送信されたときのデバイスの画面の向きです。 デフォルト = UNKNOWN_ORIENTATION

UNKNOWN_ORIENTATION = 0
PORTRAIT = 1
LANDSCAPE = 2

hardware_version optional 文字列 Apple iOS デバイスモデル(「iphone 5s」、「iphone 6+」、「ipad 4」など)
limit_ad_tracking optional ブール値 ユーザーが iOS または Android の OS レベルの設定に基づいて、インタレスト ベース広告または広告のパーソナライズを無効にしているかどうかを示します。
app_tracking_authorization_status optional enum この項目は iOS デバイスでのみご利用いただけます。アプリ トラッキングの認可ステータスを示します。この値は ATTrackingManager から取得され、そのまま提供されます。iOS のアプリ トラッキング認証ステータスの詳細については、こちらの記事をご覧ください。

NOT_DETERMINED = 0
RESTRICTED = 1
DENIED = 2
AUTHORIZED = 3

OsVersion オブジェクト

プラットフォームの OS バージョンが含まれています。たとえば、Android 2 では、major=2、マイナー=0 です。iPhone 3.3.1 では、Major=3 とマイナー=3 です。

属性 必須 / 任意 タイプ
major
minor
micro
optional int32

KeyValue オブジェクト

追加の Key-Value 属性。現在使用されていません。

属性 必須 / 任意 タイプ
key
value
optional 文字列

モバイル オブジェクト

モバイル デバイスからの広告クエリの情報です。モバイル デバイスは、スマートフォンかタブレットのいずれかです。ウェブをブラウジングするモバイル デバイスとモバイルアプリの両方の広告クエリが対象です。

属性 必須 / 任意 タイプ 実装の詳細
is_app optional ブール値 true の場合、このリクエストはモバイルアプリからのものです。app_id が設定されている場合は、常に true になります。
app_id optional 文字列 この広告クエリがモバイルアプリから送信されたときのモバイルアプリの識別子。アプリが Apple iTunes アプリストアからダウンロードされた場合は、アプリストア ID になります(例: 343200656)。Android デバイスの場合、これは完全修飾パッケージ名です(例: com.rovio.angrybirds)。Windows デバイスの場合はアプリ ID です(例: f15abcde-f6gh-47i0-j3k8-37l93817mn3o)。
is_interstitial_request optional ブール値 true の場合、モバイル 全画面広告リクエストです。
app_category_ids repeated int32 注: このフィールドの値は編集されました。このフィールドには、現在のモバイルアプリが属するカテゴリの ID が含まれます。is_app が false の場合、このフィールドは空になります。モバイルアプリとカテゴリのマッピングは、Android アプリの場合は Google Play ストア、iOS アプリの場合は Apple iTunes Store で定義されます。カテゴリ ID からカテゴリ名を確認するには、モバイルアプリ カテゴリの表をご覧ください。
is_mobile_web_optimized optional ブール値 モバイルウェブ リクエストの場合、このフィールドは、ページがハイエンド モバイル デバイスのモバイル ブラウザ向けに最適化されているかどうかを示します。デフォルト = false。
encrypted_advertising_id optional バイト このフィールドは次の目的で広告 ID に使用されます。
  1. iOS デバイス(こちらのヘルプセンター記事では、広告識別子(IDFA)と呼ばれています)
  2. Android デバイス。
  3. Roku デバイス。
  4. Microsoft Xbox デバイス。
  5. Amazon デバイス

encrypted_advertising_id が IDFA の場合、暗号テキストを復号後の平文は iOS の [ASIdentifierManager advertisingIdentifier] によって返される IDFA(16 バイトの UUID)です。encrypted_hashed_idfa の場合、平文は IDFA の 16 バイトの MD5 ハッシュです。リクエストを行う SDK のバージョンに応じて、2 つのフィールドのいずれか 1 つのみを使用できます。以降の SDK はハッシュ化されていない値を提供します。

encrypted_hashed_idfa optional バイト encrypted_advertising_id の説明もご覧ください。
advertising_id optional バイト encrypted_advertising_id の暗号化されていないバージョンこのフィールドは、SSL 接続を使用する場合にのみ設定されます。このフィールドは 16 バイトの UUID です。
hashed_idfa optional バイト encrypted_hashed_idfa の暗号化されていないバージョンこのフィールドは、SSL 接続を使用する場合にのみ設定されます。このフィールドは 16 バイトの MD5 です。
app_name optional 文字列 Android アプリのアプリ名は、Google Play ストアのものです。iOS アプリのアプリ名は App Annie から提供されています。
app_rating optional float アプリの平均ユーザー評価。ユーザー評価の範囲は 1.0 ~ 5.0 です。現時点では Google Play ストアのアプリでのみご利用いただけます。
installed_sdk optional InstalledSdk ビッダーがアクセスできるパブリッシャーのアプリにインストールされている SDK の識別情報と情報。多くの場合、ビッダーの SDK です。
skadn optional SKAdNetworkRequest iOS 14 以降でのアプリ インストール アトリビューションのサポートに関する、パブリッシャーの SKAdNetwork 情報。Apple の SKAdNetwork API を使用すると、インストール完了後に広告ネットワークにポストバックを送信して、広告によるアプリのインストールを測定できます。パブリッシャーは、広告のインプレッションにインストールを関連付けるために、アプリのプロパティ リスト(Info.plist)で、サポートされている広告ネットワークを設定する必要があります。詳しくは、こちらの記事をご覧ください。

InstalledSdk オブジェクト

ビッダーがアクセスできる SDK の識別情報と情報(多くの場合、ビッダーの SDK であるため)。

属性 必須 / 任意 タイプ 実装の詳細
id optional 文字列 インストールされている SDK の識別子。
sdk_version optional バージョン インストールされている SDK のバージョン。
adapter_version optional バージョン インストールされている SDK と通信するアダプタのバージョン。
バージョン オブジェクト

インストールされた SDK と、インストールされている SDK と Google の SDK 間の通信を行うアダプタのセマンティック バージョン。

属性 必須 / 任意 タイプ 実装の詳細
major optional int32 デフォルト = -1
minor optional int32 デフォルト = -1
micro optional int32 デフォルト = -1

SKAdNetworkRequest オブジェクト

iOS 14 以降でのアプリ インストール アトリビューションのサポートに関する、パブリッシャーの SKAdNetwork 情報。Apple の SKAdNetwork API を使用すると、インストール完了後に広告ネットワークにポストバックを送信することで、広告によるアプリのインストールを促進できます。パブリッシャーは、広告のインプレッションをアプリのインストールに関連付けることができるよう、アプリのプロパティ リスト(Info.plist)で、サポートされている広告ネットワークを設定する必要があります。詳しくは、こちらの記事をご覧ください。

属性 必須 / 任意 タイプ 実装の詳細
version optional 文字列 非推奨です。これは 2022 年 11 月に削除されます。代わりに BidRequest.mobile.skadn.versions を使用してください。

サポートされている SKAdNetwork のバージョンです。OS のバージョンと SDK のバージョンによって異なります。

versions repeated 文字列 OS バージョンと SDK バージョンに応じて、リクエストでサポートされるすべての SKAdNetwork バージョンのリスト。
sourceapp optional 文字列 Apple の App Store のパブリッシャー アプリの ID。
skadnetids repeated 文字列 パブリッシャーアプリの Info.plist にある SKAdNetworkIdentifier エントリ。
supported_fidelity_types repeated enum サポートされている忠実度タイプのリスト(オペレーティング システムと SDK でサポートされている SKAdNetwork API のバージョン、広告スロットのプロパティに基づく)。

VIEW_THROUGH_ADS = 0: 広告の表示から 24 時間以内に 3 秒以上アプリ インストールのアトリビューションが発生している。SKAdnetwork バージョン 2.2 以降でサポートされています。詳しくは、こちらの記事をご覧ください。
STOREKIT_RENDERED_ADS = 1アプリクリックのアトリビューションにより、StoreKit でレンダリングされた App Store の商品ページから発生したアプリのインストールのアトリビューション。 すべての SKAdNetwork バージョンでサポートされています。詳しくは、こちらの記事をご覧ください。

動画オブジェクト

動画内リクエストの場合は、動画に関する情報。

属性 必須 / 任意 タイプ 実装の詳細
placement optional enum 動画広告が再生される場所。デフォルト = UNKNOWN_PLACEMENT

UNKNOWN_PLACEMENT = 0.
INSTREAM = 1 - インストリーム広告は、他の動画コンテンツの前後または途中に再生されることを意味します。これは従来のテレビ コマーシャルに似ています。 ユーザーが再生している動画コンテンツが、広告の再生中に再生されない。
INTERSTITIAL = 2 - インタースティシャルは、動画以外のコンテンツ(ニュース記事やビデオゲームなど)の前に動画広告が再生されることを意味します。広告は、コンテンツが占める画面上のほぼすべての領域を覆い、ユーザーは広告が終了するまで、またはスキップされるまでコンテンツに移動できません。
IN_FEED = 3 - インフィード動画形式は、コンテンツのフィード内(通常はソーシャル アプリ フィード、編集コンテンツ アイテムのリストなど)をユーザーがスクロールしたときに表示される動画クリエイティブです。横ではなく中央にレンダリングされます。
AUDIO = 4 - オーディオは、オーディオ ストリームの広告に対するリクエストです。これは上記の INSTREAM とは異なります。これは、動画リクエスト専用です。
IN_ARTICLE = 5 - 記事内動画フォーマットは、記事の段落間をスタンドアロンの動画プレーヤーとして読み込み、再生する動画クリエイティブです。

description_url optional 文字列 パブリッシャーが動画コンテンツの説明に使用するページの URL。パラメータは削除されました。
is_embedded_offsite optional ブール値 true の場合、動画はパブリッシャーのドメイン外のページに埋め込まれます。これが設定されている場合、description_url は(通常どおり)動画の説明を指し、BidRequest の url フィールドは動画が埋め込まれているページになります。たとえば、Facebook で共有される Vimeo 動画のインストリーム広告のリクエストには is_embedded_offsite が設定されています。url フィールドは Facebook ページ用で、description_url は Vimeo 上の動画を指します。
playback_method optional enum 動画広告の再生方法を表します。再生方法は、利用可能な最適な測定に基づいて、自動再生、Click-to-Play、またはマウスオーバーであると判断されます。これには、ユーザーが最近ウェブページを操作したかどうかなどが含まれます。自動再生の場合は、広告とともに音声のオンとオフを切り替えても再生できます。一部の広告(インフィード広告など)は、ユーザーが広告を操作するまでミュートされます。

また、通常は音声がオンのときに広告が再生されても、デバイスをミュートにしていれば、値は音声オフに設定されます。デバイスがミュートされているかどうかを判別できないデバイス(パソコンなど)では、音声はオンであると想定されます。デフォルト = METHOD_UNKNOWN

METHOD_UNKNOWN = 0
AUTO_PLAY_SOUND_ON = 1
AUTO_PLAY_SOUND_OFF = 2
CLICK_TO_PLAY = 3
MOUSE_OVER = 4
INITIATE_ON_ENTERING_VIEWPORT_SOUND_ON = 5
INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF = 6

is_clickable optional ブール値 広告枠で動画広告をクリックすると、広告主のサイトに移動できるかどうか。一部のプラットフォーム、特にコネクテッド テレビは、動画広告をクリックできません。この場合、このフィールドは false に設定されています。
videoad_start_delay optional int32 動画の開始時点から広告が表示されるまでの時間(ミリ秒単位)。0 はプレロール、-1(または任意の 32 ビット int)はポストロール、1(または正の 32 ビット int)はミッドロールを意味します。この値は、このパラメータが設定されている場合にのみ有効です。設定されていない場合、表示位置は不明です。
max_ad_duration optional int32 返される広告の最大再生時間(ミリ秒)。これが設定されていない場合、または値が 0 未満の場合は、任意の継続時間が許可されます。
min_ad_duration optional int32 返される広告の最大再生時間(ミリ秒)。これが設定されていない場合、または値が 0 未満の場合、最小持続時間はありません。
max_ads_in_pod optional int32 動画連続配信広告内の広告の最大数。ゼロ以外の値は、現在の広告スロットが複数の動画広告を表示できる動画の連続配信であることを示します。 実際に表示される動画広告の数はこの値以下に設定できますが、上限を超えることはありません。
video_ad_skippable optional enum パブリッシャーはスキップ可能な動画広告を許可、必須、またはブロックしていますか?デフォルト = ALLOW_SKIPPABLE

ALLOW_SKIPPABLE = 0
REQUIRE_SKIPPABLE = 1
BLOCK_SKIPPABLE = 2

skippable_max_ad_duration optional int32 この広告がスキップ可能の場合に返される広告の最大再生時間(ミリ秒単位、通常はスキップ不可の広告の最大再生時間とは異なります)。これが設定されていない場合、または値が 0 未満の場合は、任意の継続時間が許可されます。
protocols repeated enum サポートされている動画入札レスポンス プロトコルの配列。サポートされている動画プロトコル。

VAST_1_0 = 1
VAST_2_0 = 2
VAST_3_0 = 3
VAST_1_0_WRAPPER = 4
VAST_2_0_WRAPPER = 5
VAST_3_0_WRAPPER = 6
VAST_4_0 = 7
VAST_4_0_WRAPPER = 8
DAAST_1_0 = 9
DAAST_1_0_WRAPPER = 10

allowed_video_formats repeated enum このリクエストで許可される動画ファイル形式。レスポンスは少なくとも 1 つをサポートする必要があります。

VIDEO_FLV = 0 - Flash 動画ファイルは jpeg で使用できます。
VIDEO_MP4 = 1
YT_HOSTED = 2
- youtube.com でホストされているメディア ファイルを 1 つ以上含む有効な VAST 広告。
VPAID_FLASH = 3; - Flash VPAID(SVG)
VPAID_JS = 4; - JavaScript VPAID

companion_slot repeated CompanionSlot 動画で表示できるコンパニオン広告スロットに関する情報。これは繰り返しフィールドですが、ほとんどの場合、値は 1 つだけです。利用可能なコンパニオン広告がない場合、このフィールドは設定されません。
end_cap_support optional enum エンドキャップのサポート。有効にすると、動画広告の再生が終わると、コンパニオン広告はエンディング メッセージ(情報カード)として動画スロットにレンダリングされます。複数のコンパニオン広告が返される場合、IMA SDK はデバイスの画面サイズに最適なものを選択します。エンドキャップは、モバイル動画インタースティシャル広告枠でのみサポートされます。2015 年 8 月現在、END_CAP_FORBIDDENEND_CAP_REQUIRED はサポートされていません。

END_CAP_NOT_ENABLED = 0; - コンパニオン広告はエンドキャップとしてレンダリングされません。
END_CAP_OPTIONAL = 1; - レスポンスに有効なコンパニオン バナーが含まれているが、コンパニオン バナーが必須でない場合、エンドキャップがレンダリングされます。
END_CAP_FORBIDDEN = 2; - コンパニオン広告を含むレスポンスはフィルタされます。
END_CAP_REQUIRED = 3; - コンパニオン広告のないレスポンスはフィルタされます。

content_attributes optional ContentAttributes 動画広告ではなく、ユーザーが視聴している動画の属性。 これらのフィールドは、動画パブリッシャーから提供される動画メタデータに基づいており、常に表示されるとは限りません。
DEPRECATED_inventory_type optional enum リクエストの送信元となる広告枠のタイプ。非推奨ですが、2017 年 1 月まで入力が継続されます。プレースメント フィールドを使用して、広告枠がインタースティシャルかインストリームかを判断します。Device.device_type を使用して、リクエストがモバイル デバイスから送信されているかどうかを確認し、Mobile.is_app を使用して、リクエストの送信がアプリからかどうかを確認します。WEB_VIDEO はウェブブラウザの INSTREAM プレースメントです。GAMES は、アプリとウェブブラウザの両方の INTERSTITIAL プレースメントで構成されます。 MOBILE_INTERSTITIAL はアプリのみの INTERSTITIAL プレースメントです。この広告枠ではディスプレイ広告も使用できます。adslot.excluded_attributes に 21(CreativeType: Html)が含まれていない場合、広告スロットでディスプレイ広告が許可されているかどうかを確認できます。

MOBILE_APP_VIDEO はアプリのみの INSTREAM プレースメントです。

WEB_VIDEO = 0
GAMES = 1
MOBILE_INTERSTITIAL = 2
MOBILE_APP_VIDEO = 3

is_livestream optional ブール値 広告リクエストがライブ動画ストリームから配信されているかどうかを示します(0 = ライブではない、1 = ライブ)。デフォルト = false。

CompanionSlot オブジェクト

動画で表示できるコンパニオン広告スロットに関する情報。 これは繰り返しフィールドですが、ほとんどの場合、値は 1 つだけです。利用可能なコンパニオン広告がない場合、このフィールドは設定されません。ユーザーが動画をスキップした場合は表示されません。詳しくは、動画広告のガイドをご覧ください。

属性 必須 / 任意 タイプ 実装の詳細
height repeated int32 これらのフィールドは、このスロットで使用可能な高さと幅を表します。高さと幅のフィールドは常に同じ数になります。
width repeated int32 これらのフィールドは、このスロットで使用可能な高さと幅を表します。 高さと幅のフィールドは常に同じ数になります。
creative_format repeated enum このコンパニオン広告スロットで許可されているクリエイティブの形式は次のとおりです。

IMAGE_CREATIVE = 0
FLASH_CREATIVE = 1
HTML_CREATIVE = 2

ContentAttributes オブジェクト

動画広告ではなく、ユーザーが視聴している動画の属性。

これらのフィールドは、動画パブリッシャーからの動画メタデータを利用できるかどうかに基づいており、常に表示されるわけではありません。

属性 必須 / 任意 タイプ 実装の詳細
duration_seconds optional int32 動画の再生時間(秒単位)。

AdSlot オブジェクト

ページ上の広告スロットに関する情報。

属性 必須 / 任意 タイプ 実装の詳細
id required int32 特定のページに固有で、通常は 1 から数えるスロット ID(任意)。これにより、BidResponse でどのスロットに入札するかを識別できるようになります。
ad_block_key optional uint64 パブリッシャー、広告スロット、ページの組み合わせの安定した識別子。
targetable_channel repeated 文字列 この広告スロットが属しているチャネルのセットです。チャネルとは、サイトの広告スロットのセットです。チャネル(「スポーツ セクション」や「すべてのトップバナー」など)をターゲットに設定して、広告を表示する場所をきめ細かく管理できます。チャネル名はパブリッシャーが指定します。
width
height
repeated int32 モバイル インタースティシャル広告(動画広告が配信可能なものも含む)の場合、1 つ目の幅は高さ(画面サイズ)です。これは VAST 動画広告の動画プレーヤーのサイズでもあります。それ以降のペアは、インタースティシャルのサイズ制限を満たす、推奨されるインタースティシャル広告のサイズを表します(たとえば、画面サイズより大きく、幅の 50% 以上、高さの 40% 以上)。
flexible_adslot_settings optional FlexibleAdSlotSettings 広告スロットに柔軟性がある場合は、スロットのサイズ変更方法の設定が含まれます。
excluded_attribute repeated int32 このスロットに表示される広告の許可されていない属性 ID。ID の一覧については、技術ドキュメントの publisher-excludable-creative-attributes.txt ファイルをご覧ください。
allowed_vendor_type repeated int32 許可されるベンダーのタイプ。ID のリストについては、技術ドキュメントの vendors.txt ファイルをご覧ください。このフィールドは、ブロック設定のオーバーライドがある取引には適用されません(こちらのヘルプセンター記事をご覧ください)。
consented_providers_settings optional ConsentedProvidersSettings EEA のユーザーが広告のパーソナライズに個人データを使用することに同意すると Google に伝えているプロバイダに関する情報。このフィールドは、regs_gdpr が true の場合にのみ入力されます。
regs_gdpr optional ブール値 認定バイヤーは、Google が入手可能な情報に基づいて、インプレッションを EEA ユーザーに配信するかどうかのみに基づいて、このフィールドに入力します。GDPR に関する法的ガイダンスを構成するものではありません。
regs_lgpd optional ブール値 Google が利用できる情報に基づき、このインプレッションをブラジルのユーザーに配信する場合、このフィールドは true に設定されます。LGPD が適用されるリクエストでの配信が許可されている広告テクノロジー プロバイダのリストについては、https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv をご覧ください。

LGPD について詳しくは、こちらの記事をご覧ください。

excluded_sensitive_category repeated int32 許可されていないデリケートなカテゴリ。ID の一覧については、技術ドキュメントの ad-sensitive-categories.txt ファイルをご覧ください。リストのカテゴリに広告を分類できる場合は、これらの除外を適用する必要があります。このフィールドは、ブロック設定のオーバーライドが設定されている取引には適用されません(詳しくは、こちらのヘルプセンター記事をご覧ください)。
allowed_restricted_category repeated int32 プライベート オークションと公開オークションで許可される制限付き広告カテゴリ。ID の一覧については、技術ドキュメントの ad-restricted-categories.txt ファイルをご覧ください。これはプライベート オークションと公開オークションの入札にのみ適用されます。優先取引やプログラマティック保証型取引については、allowed_restricted_category_for_deals フィールドを参照してください。
allowed_restricted_category_for_deals repeated int32 優先取引やプログラマティック保証型取引で許可される制限付き広告カテゴリ。技術ドキュメントの ad-restricted-categories.txt ファイルには、ID のリストが記載されています。これは優先取引やプログラマティック保証型取引にのみ適用されます。プライベート オークションと公開オークションの allowed_restricted_category フィールドを参照してください。場合によっては、制限付きカテゴリは優先取引またはプログラマティック保証型取引でのみ認められるため、このフィールドには、allowed_restricted_category に含まれるすべてのカテゴリと、優先取引またはプログラマティック保証型取引でのみ許可される制限付きカテゴリが一覧表示されます。
allowed_languages repeated 文字列 パブリッシャーが許可するクリエイティブの言語のリストです。順序は任意です。コードは 2 または 5 文字で、言語コードの表に記載されています。設定しない場合は、すべての言語が許可されます。
excluded_product_category repeated int32 許可されていない広告商品カテゴリ。ID のリストについては、技術ドキュメントの ad-product-categories.txt ファイルをご覧ください。記載されているカテゴリに広告を分類できる場合は、これらの除外を適用する必要があります。このフィールドは、ブロックのオーバーライドが設定されている取引には適用されません(こちらのヘルプセンター記事を参照)。
excluded_creatives repeated 除外クリエイティブ インプレッションで許可されていないクリエイティブ。このリスト内のいずれかのクリエイティブを使用して入札を送信すると、オークションに先立って入札は除外されます。この機能を有効にする場合は、アカウント マネージャーにお問い合わせください。
only_deal_bids_accepted optional ブール値 広告スロットで取引の入札のみが配信可能かどうか。このフィールドを true に設定すると、公開オークションへの入札は除外されます。ビッダーがこのフィールドを false に設定した場合、公開オークションまたは取引に入札できます。
matching_ad_data repeated MatchingAdData 一致したプレターゲティング設定に関する情報。
exchange_bidding optional エクスチェンジ入札 エクスチェンジ入札(Google アド マネージャーでリアルタイム ビッダーを行っている第三者エクスチェンジ)に関連するパラメータ。認定バイヤーのリアルタイム ビッダーの呼び出しでは、ここに値が入力されることはありません。
open_bidding optional Open Bidding すべての Open Bidding リクエストで送信されるパラメータ。
dfp_ad_unit_code optional 文字列 アド マネージャーの広告ユニットコード。 現在、これは Open Bidding リクエストでのみ設定されています。
slot_visibility optional enum スロットの公開設定情報。デフォルト = NO_DETECTION

NO_DETECTION = 0
ABOVE_THE_FOLD = 1
BELOW_THE_FOLD = 2

viewability optional int32 広告スロットの視認性の割合。これは、過去のデータと環境データに基づいて、このスロットをエンドユーザーが閲覧できる可能性の推定値です。0 ~ 100 の範囲内の割合で表されます。デフォルト値 -1 は、視認性を推定できなかったことを示します。
click_through_rate optional float 広告スロットに配信された広告の過去のクリック率。これは [0.0, 1.0] の範囲の分数で表されます。デフォルト値 -1.0 は、過去のクリック率データがないことを示します。この数字には Google 広告から集計されたデータは含まれません。
video_completion_rate optional float 広告スロットに配信された動画広告の過去の完了率。これは [0.0, 1.0] の範囲の分数で表されます。デフォルト値の 1.0 は、過去の完了率データがないことを示します。このフィールドは動画広告枠にのみ適用され、Google 広告で集計されたデータは含まれません。
iframing_state optional enum ウェブページ上に存在する広告スロットの iFraming 状態。 デフォルト = UNKNOWN_IFRAME_STATE

UNKNOWN_IFRAME_STATE = 0
NO_IFRAME = 1
SAME_DOMAIN_IFRAME = 2
CROSS_DOMAIN_IFRAME = 3

iframing_depth optional enum ウェブページ上の広告スロットの iframe 深度。 現在、動画広告リクエストに対してのみ設定されています。デフォルト = UNKNOWN_IFRAME_DEPTH

UNKNOWN_IFRAME_DEPTH = 0
NOT_IN_IFRAME = 1
ONE_IFRAME = 2
MULTIPLE_IFRAME = 3

native_ad_template repeated NativeAdTemplate ネイティブ広告は、パブリッシャーによってレンダリングされる要素で構成されています。パブリッシャーは、複数の個別のネイティブ広告テンプレートをサポートしています。リクエストでバナーや動画を許可している場合は、代わりに html_snippet または video_url を設定して、他の種類の広告で対応できます。ネイティブ テンプレートのみがある場合は、送信するレスポンスに native_ad フィールドを設定する必要があります。
native_placement_type optional enum 周囲のコンテキストに基づくネイティブ広告スロットの配置を表します。

PLACEMENT_UNKNOWN = 0
PLACEMENT_IN_FEED = 1
- コンテンツのフィード内(オーガニック フィード/グリッド/リスティング/カルーセル内のアイテムなど)。
PLACEMENT_ATOMIC_UNIT = 2 - コンテンツのアトミックな単位(記事ページ、単一画像ページなど)。
PLACEMENT_OUTSIDE = 3 - コア コンテンツの外側(右側のレールの広告セクションなど)や、コンテンツの近くのバナースタイルの配置など。
PLACEMENT_RECOMMENDATION = 4 - おすすめウィジェット。記事コンテンツの下に最も一般的に表示されます。

mediation_status optional enum 広告リクエストがパブリッシャーから直接行われたものかどうかを判断します。デフォルト = UNKNOWN

UNKNOWN = 0
DIRECT_REQUEST = 1

auto_refresh optional 自動更新
sticky_settings optional スティッキー設定
non_browser_slot_source optional enum この広告スロットをデスクトップ アプリなどのブラウザ以外の広告枠に配信することを宣言するパブリッシャーの宣言。デフォルト = UNDECLARED_SOURCE

UNDECLARED_SOURCE = 0
DESKTOP_APP = 1

renderer optional enum 広告リクエストを行い、広告をレンダリングする環境を管理するユーザーを定義します。Google が記述したコードで広告が処理されるプラットフォームでは、このフィールドは GOOGLE に設定されます。このフィールドが PUBLISHER の場合、パブリッシャーは広告再生を処理するために、独自のコードをデバイスに配置しています。リクエストの処理方法に技術的な違いはありません。技術以外の理由で、このフィールドを使用して環境を区別できます。このフィールドは、VAST 動画広告を許可するリクエストにのみ設定されます。

UNKNOWN_RENDERER = 0
GOOGLE = 1
PUBLISHER = 2

amp_ad_request_type optional enum Accelerated Mobile Page(AMP)に対するリクエストかどうかを示します。AMP HTML ページを高速に読み込むには、HTML、CSS、JavaScript の一部を制限します。AMP 広告のレンダリング方法について詳しくは、AMP 広告の README をご覧ください。デフォルト = NON_AMP_PAGE

UNKNOWN_AMP = 0 - AMP ステータスが不明です。AMP ページからのリクエストの場合もあれば、そうでない場合もあります。
NON_AMP_PAGE = 1 - AMP ページではない。通常の HTML、VAST 動画など。
AMP_PAGE_LATE_REQUEST = 2 - AMP HTML ページの遅延読み込みリクエスト。広告のレンダリングがわずかに遅れるため、ページ レンダリングのパフォーマンスに悪影響を与えることはありません。

is_amp_page optional enum AMP ページかどうか。

UNKNOWN_AMP_PAGE = 0 - AMP ページのステータスが不明です。
DIALECT_HTML = 1 - AMP ページではありません。
DIALECT_HTML_AMP = 2 - AMP ページです。

amp_ad_requirement_type optional enum AMP 広告の要件タイプは次のとおりです。

UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0 - AMP 広告の要件が不明です。
AMP_AD_NOT_ALLOWED = 1 - AMP 広告は使用できません。
AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 2 - AMP 広告または非 AMP 広告のいずれかが許可されます。AMP 広告は早期レンダリングされません。
AMP_AD_ALLOWED_AND_EARLY_RENDERED = 3 - AMP 広告または非 AMP 広告のいずれかが許可されます。AMP 広告は早期に表示されます。
AMP_AD_REQUIRED = 4 - AMP 広告は必須です。非 AMP 広告は、パブリッシャーによって拒否される場合があります。

is_rewarded optional ブール値 ユーザーが広告を見る代わりにリワードを受け取るかどうかを示します。動画広告の場合、一般的な実装では、ユーザーが追加のニュース記事を無料で読んだり、追加のライフを獲得したり、スポンサーのない広告なしで音楽を視聴したりできます。この特典は通常、動画広告の完了後に配信されます。
allowed_ad_types repeated enum 入札レスポンスで指定可能な広告タイプ。 allowed_ad_types には常に 1 つ以上の値が含まれます。インタースティシャル スロットはバナー広告にも対応しています。ALLOWED_AD_TYPE_NATIVE を含む広告スロットでは、ALLOWED_AD_TYPE_VIDEO が設定されているかどうかにかかわらず、ネイティブ動画をサポートしている場合とサポートされていない場合があります。同様に、ALLOWED_AD_TYPE_NATIVE のない広告スロットでは、ALLOWED_AD_TYPE_VIDEO が設定されているかどうかにかかわらず、ネイティブ動画はサポートされません。

ALLOWED_AD_TYPE_BANNER = 0
ALLOWED_AD_TYPE_NATIVE = 1
ALLOWED_AD_TYPE_VIDEO = 2

session_depth optional int32 このブラウジング セッションでこのユーザー(特定のサイト内またはアプリ内)に配信されたインプレッションの合計数。1. 30 分間操作がないと、セッションは終了します。デフォルト値の -1 は、セッション深度を推定できないことを示します。
publisher_settings_list_id repeated 固定 64 このスロットに適用されるパブリッシャー ID のリスト。詳しくは、RTB パブリッシャーの設定ガイドをご覧ください。
secure_signals repeated セキュアシグナル パブリッシャーから渡されたセキュア シグナル。
api repeated enum このインプレッションでサポートされている API フレームワークのリスト。明示的に指定されていない API は、サポートされていないとみなされます。値は次のいずれかになります。

UNKNOWN_FRAMEWORK = 0
MRAID_1 = 3
モバイル リッチメディア広告インターフェース定義バージョン 1.0。
MRAID_2 = 5 モバイル リッチメディア広告インターフェース定義バージョン 2.0。
MRAID_3 = 6 モバイル リッチメディア広告インターフェース定義バージョン 3.0。
OMID_1 = 7 Open Measurement Interface Definition バージョン 1.0

billable_event_rate_adjustment optional 倍精度 カスタム SDK を使用してレンダリングされた広告のみ: オークションの入札に適用される乗数。オークションで落札した場合に、他のオークションで落札した場合に請求対象のイベントが発生する可能性と比較して、入札で課金対象イベント(広告表示など)が発生する可能性が反映されます。この調整は 1 より大きくなることも小さくなることもあります。これはオークションの最終的なランキングにのみ影響します。特に、この乗数は支払いには影響しません。デフォルト = 1.0。
omidpn optional 文字列 OM SDK 統合の ID。詳しくは、Open Measurement SDK の OpenRTB Advisory をご覧ください。
omidpv optional 文字列 OM SDK 統合のバージョン。詳しくは、Open Measurement SDK の OpenRTB Advisory をご覧ください。
impression_expiration_seconds optional int32 落札した入札に対してインプレッションが発生する可能性のある秒数。インプレッションは、この期間内に配信された場合にのみ請求対象になる場合があります。インプレッションの有効期限の詳細については、https://developers.google.com/authorized-buyers/rtb/billing-event-guide をご覧ください。
frequency_capping_scope required FrequencyCappingScope 列挙型

試験運用機能。変更される場合があります。詳しくは、RTB 入札で Google がホストするフリークエンシー キャップを設定するをご覧ください。このリクエストで使用できるフリークエンシー キャップの適用範囲を示します。入札に適用されるフリークエンシー キャップは、BidResponse.ad.adslot.Frequency_cap フィールドで指定できます。

FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0。使用しないデフォルト値、またはフリークエンシー キャップの適用範囲を確実に決定できなかったことを示すデフォルト値。

FREQUENCY_CAPPING_SCOPE_NONE = 1: このリクエストでは、入札レスポンスの仕様に基づくフリークエンシー キャップを使用できません。フリークエンシー キャップのない入札リクエストのフリークエンシー キャップを設定した入札は、オークション前に除外されます。

FREQUENCY_CAPPING_SCOPE_BROWSER = 2 フリークエンシー キャップの適用は、同じブラウザ内の複数のサイトで行えます。

FREQUENCY_CAPPING_SCOPE_DEVICE = 3 フリークエンシー キャップの適用対象は、ブラウザを除くデバイス上の複数のサイトとなります。

FREQUENCY_CAPPING_SCOPE_APP = 4 フリークエンシー キャップの適用は、1 つのアプリ内で行えます。

FREQUENCY_CAPPING_SCOPE_SITE = 5 フリークエンシー キャップの適用は、1 つのサイト内で行えます。

FlexibleAdSlotSettings オブジェクト

スロットのサイズ変更方法の設定。

属性 必須 / 任意 タイプ
max_width optional int32
max_height optional int32
min_width optional int32
min_height optional int32

ConsentedProvidersSettings オブジェクト

EEA のユーザーが広告のパーソナライズに個人データを使用することに同意すると、Google に伝えているプロバイダに関する情報です。このフィールドは、regs_gdpr が true の場合にのみ入力されます。

属性 必須 / 任意 タイプ 実装の詳細
consented_providers repeated int64 EEA ユーザーが Google に法的に有効であると表明している広告テクノロジー プロバイダ(ATP)に対応する ID のセット。1)法的に義務付けられている場合に Cookie またはその他のローカル ストレージを使用すること、2)Google の EU ユーザーの同意ポリシーに従って ATP で広告をパーソナライズするために個人データを収集、共有、使用すること。

パブリッシャー様が IAB 透明性と同意に関するフレームワーク(TCF)v2 を使用してユーザーの同意を管理する場合、追加同意文字列によって同意される一連の ATP です(Google の追加同意モードの詳細についてはこちらの記事をご覧ください)。TCF v2 同意文字列を介して同意された ATP は、ConsentedProvidersSettings.tcf_consent_string フィールドに格納されます。

ATP ID と ATP 名のマッピングは、provider.csv に送信されます。

tcf_consent_string optional 文字列 ニュース メディアの IAB Consent Management Platform(CMP)から取得した、ウェブセーフな IAB 透明性と同意に関するフレームワーク(TCF)の v2 同意文字列。文字列の構造は IAB TCF v2 で定義されています。このフィールドは、パブリッシャーが TCF v2 の CMP と統合していて、CMP によって GDPR がこの広告リクエストに適用され、有効な同意文字列を提供していることを示している場合に入力されます。Google TCF v2 の統合について詳しくは、こちらの記事をご覧ください。

同意文字列にリストされているベンダーの詳細については、vendor-list.cchromiumsu.org/v2/vendor-list.json の IAB グローバル ベンダー リストをご覧ください。

ExcludedCreative オブジェクト

Google ポリシーまたはクリエイティブの不承認、除外されたクリエイティブ属性、除外された商品カテゴリまたはデリケートなカテゴリ、許可されたベンダーのタイプ、制限付きのカテゴリまたは言語によって、このインプレッションへの入札が許可されていないクリエイティブです。

属性 必須 / 任意 タイプ 実装の詳細
buyer_creative_id optional 文字列 許可されていないクリエイティブの購入者のクリエイティブ ID。

MatchingAdData オブジェクト

一致したプレターゲティング設定に対応する請求 ID。

属性 必須 / 任意 タイプ 実装の詳細
billing_id repeated int64 一致したプレターゲティング設定に対応する請求 ID。
minimum_cpm_micros optional int64 オークション前に除外しない最小 CPM 値。これはグローバル最小値か、パブリッシャーが設定した最小値の場合があります。値はアカウントの通貨のマイクロ単位です。
direct_deal repeated 直接取引
DirectDeal オブジェクト

この広告枠に一致する取引に関する情報。

属性 必須 / 任意 タイプ 実装の詳細
direct_deal_id optional int64 取引を識別する ID。
fixed_cpm_micros optional int64 取引に参加するには、fixed_cpm_micros(アカウントの通貨のマイクロ単位)以上の金額を指定してください。特典を獲得した場合、fixed_cpm_micros が請求されます。これは deal_type=PRIVATE_AUCTION には適用されません。プライベート オークションでは、fixed_cpm_micros以上で入札する必要があります。CPM を fixed_cpm_micros より高く設定すれば、deal_type=PRIVATE_AUCTION の入札で獲得できる可能性は高くなりますが、他のタイプの取引では落札できる可能性が高くなります。
deal_type optional enum 取引のタイプ。デフォルト = UNKNOWN_DEAL_TYPE

UNKNOWN_DEAL_TYPE = 0
PREFERRED_DEAL = 1
PRIVATE_AUCTION = 2
PROGRAMMATIC_GUARANTEED = 3
- 詳しくは、プログラマティック保証型取引の RTB の違いをご覧ください。
AUCTION_PACKAGE = 4 - 詳しくは、オークション パッケージのヘルプセンター記事をご覧ください。

publisher_blocks_overridden optional ブール値 パブリッシャーがこの取引をブロック対象から除外したかどうか。 この設定は、認定バイヤー ポリシーや広告レビュー センターによる決定の内容より優先されます。
creative_source optional enum 試験運用版フィールド。変更される可能性があります。クリエイティブのホストを宣言する列挙型。プログラマティック保証型取引にのみ入力されます。現在、このフィールドは CREATIVE_SOURCE_ADVERTISER にしか設定できません(デフォルト)。

CREATIVE_SOURCE_UNKNOWN = 0
CREATIVE_SOURCE_ADVERTISER = 1
- クリエイティブは広告主がホストします。つまり、ビッダーは入札レスポンスでクリエイティブを提供する必要があります。
CREATIVE_SOURCE_PUBLISHER = 2 - クリエイティブはパブリッシャーによってホストされます。したがって、ビッダーは入札レスポンスにクリエイティブを含める必要はありません。パブリッシャーがホストするクリエイティブについて詳しくは、https://support.google.com/admanager/answer/9243220 をご覧ください。 現在、この機能は RTB 入札者ではサポートされていません。

must_bid optional ブール値 このフィールドは、プログラマティック保証型取引にのみ適用されます。このフィールドが false の場合、購入者はインプレッションに対する入札をスキップできます。true の場合、購入者はこのインプレッション機会にこの取引に入札する必要があります。

ExchangeBidding オブジェクト

Open Bidding に参加しているエクスチェンジ(アド マネージャーでリアルタイム ビッダーを行っている第三者エクスチェンジ)に関連するパラメータ。認定バイヤーのリアルタイム ビッダーの呼び出しで、このフィールドが自動入力されることはありません。

属性 必須 / 任意 タイプ 実装の詳細
publisher_parameter repeated 文字列 アド マネージャー UI の対応する収益グループ設定の一部としてパブリッシャーが必要に応じて指定する UTF8 文字列。形式は任意で、パブリッシャーとエクスチェンジの入札者が合意する必要があります。
key_value repeated KeyValue パブリッシャーからエクスチェンジに送信される、繰り返しの KeyValue ペア。

OpenBidding オブジェクト

すべての Open Bidding リクエストで送信されるパラメータ。

属性 必須 / 任意 タイプ 実装の詳細
is_open_bidding optional ブール値 この広告スロットとこのビッダーをターゲットとする収益グループまたはメディエーション グループが設定されている場合、このフィールドは true に設定されます。Open Bidding と入札プロセスへの影響については、ヘルプセンターをご覧ください。

NativeAdTemplate オブジェクト

ネイティブ広告は、パブリッシャーによってレンダリングされる要素で構成されています。パブリッシャーは、複数の個別のネイティブ広告テンプレートをサポートしている場合があります。また、リクエストでバナーや動画を許可する場合は、html_snippetvideo_urlvideo_vast_xml のいずれかを設定して、他のタイプの広告を返すことができます。 ネイティブ テンプレートのみがある場合は、送信するレスポンスに native_ad フィールドを設定する必要があります。

属性 必須 / 任意 タイプ 実装の詳細
required_fields optional int64 パブリッシャーがどのフィールドを必要とするかを示すビットフィールド。これらのフィールドの値がない入札レスポンスは拒否されます。クリックと表示のトラッキング URL は常に暗黙的に必要です。

enum Fields - required_fieldsrecommended_fields で使用されるビットを定義します。BidResponse.Ad.NativeAd の各フィールドには 1 ビットあります。

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

recommended_fields optional int64 パブリッシャーが推奨するフィールドを説明するビットフィールド。すべての推奨フィールドがサポートされていますが、すべての推奨フィールドが必須ではありません。

enum Fields - required_fieldsrecommended_fields で使用されるビットを定義します。BidResponse.Ad.NativeAd の各フィールドには 1 ビットあります。

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

headline_max_safe_length
body_max_safe_length
call_to_action_max_safe_length
advertiser_max_safe_length
price_max_safe_length
省略可 int32 max_safe_length は、切り捨てされないことが保証されている Unicode 文字の最大数を示します。長い文字列はレンダリング中にパブリッシャーによって切り捨てられます。
image_width
image_height
logo_width
logo_height
app_icon_width
app_icon_height
optional int32 必要なアスペクト比を計算する幅と高さ。レスポンスでより大きな画像を指定できます。高さと幅が示す画像のアスペクト比と大きく異なる画像は、除外される場合があります。
style_id optional int32 ネイティブ広告をレンダリングする特定のスタイル、HTML、CSS のグローバルに異なる ID。
style_layout_type optional enum 各ネイティブ広告テンプレートのスタイル レイアウトの種類。デフォルト = PIXEL

PIXEL = 0
FLUID = 1

style_height
style_width
optional int32 style_layout_typePIXEL の場合、レンダリング後のネイティブ広告全体の幅と高さ。style_layout_typeFLUID の場合、style_heightstyle_width に値は入力されません。

オブジェクトの自動更新

自動更新の設定。

属性 必須 / 任意 タイプ 実装の詳細
refresh_settings repeated AutoRefreshSettings パブリッシャーがこの広告枠に適用する自動更新の設定です。この手順は、パブリッシャーが 1 つの広告枠に対して複数のタイプの自動更新を行う可能性があるため、繰り返されます。
refresh_count optional int32 前回のページの読み込み以降にこの広告スロットが更新された回数。
AutoRefreshSettings オブジェクト
属性 必須 / 任意 タイプ 実装の詳細
refresh_type optional enum 宣言された自動更新のタイプ。デフォルト = UNKNOWN_AUTO_REFRESH_TYPE

UNKNOWN_AUTO_REFRESH_TYPE = 0
USER_ACTION = 1
- スクロールなどのユーザー操作によってトリガーされる更新。
EVENT = 2 - イベント ドリブンのコンテンツの変更。たとえば、ページでサッカーの試合のスコアが変更されると、広告が更新されます。
TIME = 3 - 時間ベースの更新。広告は、ユーザーのアクティビティがなくても、事前に設定した時間で更新されます。

min_refresh_interval_seconds optional int32 最小更新間隔。これは、すべての更新の種類に適用されます。

StickySettings オブジェクト

パブリッシャーによって宣言された固定設定。

属性 必須 / 任意 タイプ 実装の詳細
vertical_stickiness optional enum 広告スロットは、ユーザーがスクロールしたときに画面に固定されるサイドバーかどうかを示します。デフォルト = UNKNOWN_STICKINESS

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

top_horizontal_stickiness optional enum 広告スロットは、ユーザーがスクロールしたときに画面の上部に表示される水平スロットです。デフォルト = UNKNOWN_STICKINESS

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

bottom_horizontal_stickiness optional enum 広告スロットは、ユーザーがスクロールしたときに画面の下部に固定される横方向のスロットかどうかを示します。デフォルト = UNKNOWN_STICKINESS

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

SecureSignal オブジェクト

パブリッシャーから渡されたセキュア シグナル。

属性 必須 / 任意 タイプ 実装の詳細
data optional 文字列 セキュア シグナル。
source_js optional SourceJs 非推奨です。これは 2023 年 2 月に廃止される予定です。代わりに BidRequest.adslot.secure_signals.source を使用してください。
source optional 文字列 シグナルのソース。このデータを生成したライブラリまたは SDK の識別子。
SourceJs オブジェクト

非推奨です。これは 2023 年 2 月に廃止される予定です。代わりに BidRequest.adslot.secure_signals.source を使用してください。

属性 必須 / 任意 タイプ 実装の詳細
id optional 文字列 このデータを生成した JavaScript ライブラリの ID。

BidResponseFeedback オブジェクト

以前の回答で送信された入札に関するフィードバック。これは、ビッダーに対してリアルタイム フィードバックが有効になっている場合にのみ設定されます。リアルタイム フィードバックを有効にする場合は、アカウント マネージャーにお問い合わせください。

属性 必須 / 任意 タイプ 実装の詳細
request_id optional バイト BidRequest.id の一意の ID
creative_index optional int32 複数の BidResponse_Ad のインデックス。インデックスは、最初のクリエイティブに対してゼロから始まります。
creative_status_code optional int32 広告のステータス コード。ID の一覧については、技術ドキュメントの creative-status-codes.txt をご覧ください。
cpm_micros optional int64 入札がオークションで勝った場合は、アカウントの通貨での支払い額になります。オークションに参加したものの、入札単価が競り負けた場合、落札するには落札できなかった CPM になります。オークションの前に入札がフィルタされている場合、パブリッシャーまたは落札者が価格フィードバックをオプトアウトしている場合、またはアカウントで他のビッダーとの落札価格の共有を無効にしている場合は、この設定されません。ファーストプライス オークションでは、BidRequest.bid_response_feedback[].minimum_bid_to_win にもデータが入力されます。
minimum_bid_to_win optional int64 オークションで落札するために必要な最低入札単価。アカウントの通貨のマイクロ単位で指定します。オークションで落札した場合は、除外されなかった 2 番目に高い入札単価(最小価格を含む)になります。お客様の入札がオークションで落札されなかった場合は、落札者の入札となります。このフィールドは、入札がファーストプライス オークションに参加した場合にのみ入力され、オークション前に入札が除外された場合は入力されません。
sampled_mediation_cpm_ahead_of_auction_winner optional int64 パブリッシャーが同じクエリ上で RTB オークションとウォーターフォール ベースの SDK メディエーションを使用している場合、リアルタイム オークションの落札者は、インプレッションを獲得するためにメディエーション ウォーターフォール(価格順)で競合する必要があります。オークションに参加した入札でウォーターフォールが存在しない場合、このフィールドの値は 0 です。入札がオークションに参加し、ウォーターフォールが行われた場合、このフィールドの値は、オークションに勝った対象のメディエーション ネットワークから提示されたサンプル入札単価(予想される広告掲載率で重み付けした値)を表します。このフィールドは、入札モデルをトレーニングするために min_bid_to_win と組み合わせて使用できます。CPM は、アカウントの通貨のマイクロ単位です。
event_notification_token optional バイト 入札レスポンスに含まれたイベント通知トークン。
buyer_creative_id optional 文字列 入札レスポンスに含まれた購入者のクリエイティブ ID。

SupplyChain オブジェクト

SupplyChain オブジェクト。詳しくは、こちらの記事をご覧ください。

属性 必須 / 任意 タイプ 実装の詳細
complete optional ブール値 サイト、アプリ、またはインベントリのその他のメディアの所有者につながる、トランザクションに関わるすべてのノードをチェーンに含めるかどうかを示すオプション。
nodes repeated SupplyChainNode SupplyChainNode オブジェクトの配列(チェーン順)。完全なサプライ チェーンでは、最初のノードはトランザクションにおける最初の広告システムと販売者 ID(サイト、アプリ、その他のメディアの所有者など)を表します。不完全なサプライ チェーンでは、最初の既知のノードを表します。最後のノードは、この入札リクエストを送信するエンティティを表します。
version optional 文字列 使用中のサプライ チェーン仕様のバージョン(major.minor 形式)。たとえば、仕様のバージョン 1.0 の場合は、文字列「1.0」を使用します。

SupplyChainNode オブジェクト

属性 必須 / 任意 タイプ 実装の詳細
advertising_system_identifier optional 文字列 ビッダーが接続している SSP、Exchange、ヘッダー ラッパーなどのシステムの正規ドメイン名。これがシステムの運用ドメインとなる場合があります(親企業ドメインと異なる場合は、委任システムの所有権を明確にするために WHOIS 検索やリバース IP ルックアップを行います)。ads.txt ファイル内に販売者が存在する場合は、この値と同じ値になります。
seller_identifier optional 文字列 広告システム内で販売者または販売パートナー アカウントに関連付けられた識別子。これには、トランザクションで使用する値と同じ値を含める必要があります(例: Google プロトコルの「publisher_id」など)。長さは 64 文字以下にしてください。
handles_payment optional ブール値 このノードがインベントリの支払いフローに含まれるかどうかを示します。true に設定すると、ads_system_identifier フィールド内の広告システムで、seller_identifier フィールドの販売者に支払いが行われます。この販売者は、チェーン内の前のノードに対する支払いを行います。false に設定すると、このノードがインベントリの支払いフローに関与しなくなります。

BidResponse オブジェクト

BidRequest に応じて返されるメッセージです。0 個以上の広告を指定できます。広告ごとに、広告を掲載できる広告スロットを用意する必要があります。広告スロットは BidRequest の AdSlot.id で識別されます。入札しない場合は、processing_time_ms のみを設定し、広告のないレスポンスを送信してください。

属性 必須 / 任意 タイプ 実装の詳細
ad repeated 広告
debug_string optional 文字列 BidRequest で is_test が設定されている場合は、このフィールドにデバッグ情報を書式なしテキストとして返すことができます。このフィールドを通常の条件下で設定したり、100 文字を超える値に設定したりしないでください。このフィールドは、特定の問題のトラブルシューティングで使用を求められた場合にのみ使用してください。
processing_time_ms optional int32 リクエストを受け取ってからレスポンスを返すまでの時間をミリ秒単位で設定します。
no_bid_reason optional int32 ビッダーが指定した、入札しない理由(省略可)。このフィールドは OpenRTB プロトコルの BidResponse.nbr と同等で、入札しない理由コードの同じ名前空間を使用します。入札理由コードの完全なセットについては、developers.google.com/authorized-buyers/rtb/downloads/no-bid-reasons.txt をご覧ください。

広告オブジェクト

属性 必須 / 任意 タイプ 実装の詳細
event_notification_token optional バイト トラブルシューティングのために、ビッダーからイベント通知トークンが認定バイヤーに送信されます。認定バイヤーの入札に対するリアルタイムのフィードバックにトークンが追加されます。トークンの内容は認定バイヤーによって記録されません。認定バイヤーでは 64 バイトを超えるトークンは無視されます。
buyer_creative_id optional 文字列 このレスポンスでクリエイティブ用に選択した一意の識別子。常に 64 バイト以下に設定し、有効な UTF8 文字列を指定する必要があります。使用する buyer_creative_id は常に同じクリエイティブに関連付けられている必要があります。このフィールドは、問題が見つかった場合に承認ステータスを伝えるために使用されます。異なるクリエイティブに同じ ID を指定しないでください。1 つのクリエイティブに関する問題が見つかった場合に、すべてのクリエイティブが不承認になります。同じクリエイティブに対して、レスポンスごとに異なる ID を指定しないでください。指定した場合は、ID ごとに承認ステータスが割り当てられるため、クリエイティブは配信されません。
html_snippet optional 文字列 ウェブページに配置され、広告が表示される HTML スニペット。 BidResponse.Ad.AdSlot.billing_id を使用して、このスニペットがどの請求 ID に関連付けられているかを示します。
video_url optional 文字列 動画広告を取得する URL。URL から VAST 2.0 または 3.0 標準に準拠した XML レスポンスが返されます。BidResponse.Ad.AdSlot.billing_id を使用して、この広告に関連付ける請求 ID を指定します。html_snippetvideo_urlnative_adsdk_rendered_adamp_ad_urlvideo_vast_xml のいずれか 1 つを設定する必要があります。このフィールドは、入札リクエストがアプリ内広告用の場合にのみ設定します(BidRequest.video がある場合)。
video_vast_xml optional 文字列 返される VAST ドキュメント。このドキュメントは VAST 2.0 または 3.0 標準に準拠している必要があります。BidResponse.Ad.AdSlot.billing_id を使用して、この広告を関連付ける請求 ID を指定します。このフィールドは、入札リクエストがインストリーム動画広告であり、レスポンスが VAST XML である場合にのみ設定します。html_snippetvideo_urlnative_adsdk_rendered_adamp_ad_urlvideo_vast_xml のいずれか 1 つのみを設定する必要があります。
amp_ad_url optional 文字列 AMP HTML 広告を取得する URL。html_snippetvideo_urlnative_adsdk_rendered_adamp_ad_urlvideo_vast_xml のいずれか 1 つのみを設定する必要があります。
native_ad optional NativeAd ネイティブ広告のコンテンツ。ネイティブ広告は複数の構成要素で構成され、パブリッシャー側でレンダリングされます。
click_through_url repeated 文字列 スニペットのリンク先 URL のセットです。これには、表示された広告をクリックしたユーザーにユーザーがリダイレクトされる URL と、レンダリングされた広告に表示される URL が含まれます。最終的なランディング ページとは関係のない、広告サーバーへの中間呼び出しは含めないでください。このデータは、パブリッシャーがブロックした URL の事後フィルタリングに使用されます。スニペットまたは動画広告を返し、click_through_url を宣言していない BidResponse は破棄されます。ネイティブ広告の場合は、最初の値のみがクリック URL として使用されますが、すべての値が分類と審査の対象となります。このフィールドは、html_snippetvideo_url、または native_ad が設定されている場合にのみ設定します。ネイティブ広告で NativeAd.click_link_url が設定されていない場合、ランディング ページへの誘導に click_through_url の最初の値が使用されます。ネイティブ広告では、このフィールドを click_link_url として使用し、ユーザーが最終的に移動するリンク先を設定することをおすすめします。動的ランディング ページの場合、このフィールドを使用する必要があります。
vendor_type repeated int32 このスニペットから表示される広告のすべてのベンダータイプです。技術ドキュメントの vendor.txt ファイルに記載されているベンダー ID のみを宣言する必要があります。宣言したベンダーが BidRequest に送信された allowed_vendor_type リストに含まれているかどうかを確認します。
attribute repeated int32 このスニペットから表示される広告のすべての属性です。ID の一覧については、技術ドキュメントの buyer-declarable-creative-attributes.txt をご覧ください。 これらの属性が BidRequest の excluded_attribute リストに含まれていないことを確認します。
category repeated int32 このスニペットから表示される可能性がある広告のすべてのデリケートなカテゴリ。ID の一覧については、技術ドキュメントの ad-sensitive-categories.txt をご覧ください。これらのカテゴリが BidRequest の excluded_sensitive_category リストに含まれていないことを確認します。
restricted_category repeated int32 このスニペットから表示されることができる広告すべての制限付きカテゴリ。ID の一覧については、技術ドキュメントの ad-restricted-categories.txt をご覧ください。これらのカテゴリが BidRequest の allowed_restricted_category リストに含まれているかどうかを確認します。
advertiser_name repeated 文字列 広告の広告主のすべての名前。
bidder_name optional 文字列 エクスチェンジの入札者(アド マネージャーでリアルタイム ビッダーを行っている第三者エクスチェンジ)の場合、エクスチェンジが広告を提供するために呼び出したビッダーの名前。これは任意の UTF8 テキストですが、ビッダーを識別するのに十分なもので、同じビッダーに対して常に同じ値に設定する必要があります。
width
height
optional int32 広告の幅と高さ(ピクセル単位)です。これらの設定は省略可能です。 ただし、bid BidRequest.AdSlot の幅と高さが複数ある場合、または BidRequest.Mobile.is_interstitial_request が true の場合は、これらは設定する必要があります。
agency_id optional int64 この広告に関連付けられている代理店です。ID のリストについては、技術ドキュメントの agencies.txt をご覧ください。この広告に交通機関が関連付けられていない場合は、このフィールドを未設定のままにするのではなく、値 NONEagency_id: 1)を使用してください。
adslot repeated 広告スロット
impression_tracking_url repeated 文字列 インプレッションのレンダリング時に呼び出す URL。これは、VAST 動画を除くすべての広告枠タイプとすべてのフォーマットでサポートされています。
click_tracking_url repeated 文字列 ユーザーが広告をクリックしたときに呼び出す URL。現在サポートされているのは、パブリッシャー管理のクリエイティブを使用したネイティブ広告とプログラマティック保証型取引のみです。パブリッシャー管理のケースでは、これらのクリック トラッカーはサーバー間でビッダーに送信されます。それ以外の場合は、ユーザーのデバイスから送信されます。パブリッシャー管理のクリエイティブについて詳しくは、パブリッシャー管理のクリエイティブをご覧ください。
ad_choices_destination_url optional 文字列 広告表示設定ページへのリンク。ネイティブ広告でのみサポートされています。存在する場合は、標準の AdChoices アイコンがネイティブ クリエイティブに追加され、この URL にリンクされます。
impression_tracking_resource repeated ImpressionTrackingResource インプレッションのレンダリング時に呼び出すリソース。これは、ネイティブ フォーマットとバナー フォーマット、および明示的に許可リストに登録されたスクリプトでのみサポートされます。
sdk_rendered_ad optional SdkRenderedAd 購入者に認知されている SDK でレンダリングされる広告。これは、BidRequest に mobile.installed_sdk サブメッセージが含まれている場合にのみ使用できます。
skadn optional SKAdNetworkResponse iOS 14 以降でのアプリ インストール アトリビューションのサポートを目的とした、広告主の SKAdNetwork 情報。Apple の SKAdNetwork API を使用すると、インストール完了後に広告ネットワークにポストバックを送信して、広告によるアプリのインストールを測定できます。インストールを広告のインプレッションに関連付けるには、広告ネットワークがネットワーク ID と署名付き広告主情報を送信する必要があります。詳しくは、こちらの記事をご覧ください。
advertised_app_id optional 文字列 アプリ インストール広告の広告対象のアプリの ID。Android では、バンドルまたはパッケージ名(com.foo.mygame など)にする必要があります。iOS では、数値 ID です。このフィールドを指定すると、ユーザーにはパブリッシャー アプリから移動することなく、広告をクリックした後にアプリストアのリスティングがオーバーレイとして表示されます。この機能は現在、動画リワード広告とインタースティシャル動画広告でのみ有効です。

NativeAd オブジェクト

ネイティブ広告のコンテンツ。ネイティブ広告は複数の構成要素で構成され、パブリッシャー側でレンダリングされます。html_snippetvideo_urlvideo_vast_xmlnative_ad のいずれか 1 つのみを設定します。このフィールドがネイティブ広告の入札リクエスト(BidRequest.adslot.native が存在する場合)の場合にのみ設定します。

属性 必須 / 任意 タイプ 実装の詳細
headline optional 文字列 広告の短いタイトル。
body optional 文字列 広告の詳しい説明。
call_to_action optional 文字列 ユーザーがクリックするボタンのラベル。
advertiser optional 文字列 広告クリエイティブに表示される広告主またはスポンサーの名前。
image optional Image 大きい画像です。
logo optional Image 広告主様のロゴ用の小さい画像。
app_icon optional Image アプリ ダウンロード広告用のアプリアイコン。
video_url optional 文字列 動画広告を取得する URL。URL から VAST 2.0 標準に準拠した XML レスポンスが返されます。このフィールドは、入札リクエストがネイティブ広告で、動画フィールドがリクエストされた場合にのみ設定します。
star_rating optional 倍精度 アプリストアでアプリの評価。0 ~ 5 の範囲内でなければなりません。
optional 文字列 ユーザーが広告をクリックしたときにブラウザ/SDK が読み込む URL。ランディング ページを直接指定する場合や、リダイレクト チェーンの最初のステップに指定して、最終的に最終的に誘導する場合もあります。下位互換性を確保するため、これが設定されていない場合は、最初の Ad.click_through_url が使用されます。ネイティブ広告の場合は、click_through_url ではなく click_link_url を使用することをおすすめします。
click_tracking_url optional 文字列 非推奨です。クリック トラッキングに使用する URL。SDK がバックグラウンド スレッドでクリック トラッキング URL に ping します。URL を解決する際、HTTP 30x リダイレクトに従います。SDK はレスポンスの内容を無視します。この URL がユーザーのランディング ページに影響することはありません。
price optional 文字列 プロモーション情報の価格(通貨情報など)。
画像オブジェクト
属性 必須 / 任意 タイプ 実装の詳細
url optional 文字列
width
height
optional int32 画像の幅と高さはピクセル単位で指定します。アスペクト比が保たれている限り、リクエストした画像よりも大きな画像を指定できます。

AdSlot オブジェクト

属性 必須 / 任意 タイプ 実装の詳細
id required int32 広告が表示される入札リクエストのスロット ID。
max_cpm_micros required int64 この広告スロットのオークションで落札した場合に請求される CPM の上限です。マイクロ単位(currency またはマイクロ秒単位)で指定します。たとえば、CPM 1.29 USD を設定するには、max_cpm_micros = 1290000 を設定します。落札単価は課金対象ユニットに切り上げられます。たとえば、米ドルでは、10,000 マイクロの倍数(1 セント)に切り上げられます。
min_cpm_micros optional int64 この広告スロットのオークションで落札した場合に請求される最小 CPM。指定された currency またはデフォルトの入札通貨のマイクロ単位で表します。max_cpm_micros を最高額として指定する場合は 2 番目の料金になる場合があり、パブリッシャーが設定した予約価格をオーバーライドする場合はなんらかの予約価格が使用されます。入札単価は max_cpm_micros 以下にする必要があります。そうしないと、入札単価は無視されます。このフィールドは省略可能で、設定する必要はありません。オークションのタイプが FIRST_PRICE に設定された入札リクエストに応答する場合、このフィールドは使用できません。
billing_id optional int64 このインプレッションを関連付ける請求 ID。この値は、BidRequest.AdSlot.matching_ad_data.billing_id で送信された、このスロットの課金 ID のセットに含まれている必要があります。BidRequest が複数の BidRequest.AdSlot.matching_ad_data.billing_id に含まれている場合は、常に設定する必要があります。
deal_id optional int64 この入札に参加する取引 ID。取引が利用可能であるものの、取引を無視して公開オークションに参加する場合は、未設定のままにするか「1」に設定します。
exchange_deal_id optional 文字列 エクスチェンジの入札者(アド マネージャーでリアルタイム ビッダーを行っている第三者エクスチェンジ)の場合、この入札に関連付けられ、パブリッシャーにレポートされるエクスチェンジの名前空間の取引 ID。関連付けられた取引がない場合は、未設定のままにします。これは任意の UTF8 テキストで、64 バイト以内である必要があります。
exchange_deal_type optional enum exchange_deal_id が設定されている場合、取引のタイプ。パブリッシャーに報告され、オークションでの取引の処理方法に影響します。

OPEN_AUCTION = 0
PRIVATE_AUCTION = 1
PREFERRED_DEAL = 2
EXCHANGE_AUCTION_PACKAGE = 3

buyer_reporting_id optional 文字列 購入者は、クエリツールの IVT 透明性レポートで費用と無効なトラフィックの指標の分類に使用する ID を宣言しました。インプレッション数が 1,000 未満の ID は、指標の分類に使用されません。64 バイトより長い ID は無視されます。
third_party_buyer_token optional 文字列 公開オークションの入札者としてのエクスチェンジが第三者事業者である場合、第三者の購入者情報の最終確認に使用されるトークン。この ID はサードパーティの購入者から取得され、入札レスポンス内で変更せずに Google に渡す必要があります。
frequency_cap repeated フリークエンシー キャップ 試験運用機能。変更される場合があります。エクスチェンジによって適用されるフリークエンシー キャップのテストについて詳しくは、github.com/google/ads-privacy/tree/master/experiments/Frequency-capping をご覧ください。

アカウントでフリークエンシー キャップを有効にするには、アカウント マネージャーにお問い合わせください。

入札単価に適用するフリークエンシー キャップを指定します。各ユーザーのインプレッションの上限は、Frequency_cap_id で指定されたレベルです。ユーザーに対する追加のインプレッション数が、指定された上限に違反すると、入札はオークションに参加しません。同じフリークエンシー キャップ ID に複数のフリークエンシー キャップを指定できます。

フリークエンシー キャップの形式が正しくない場合、オークション前に入札単価が除外されます。次のような場合は、キャップの形式が正しくありません。

  • Frequency_cap_id が空であるか非常に長い
  • max_mpressions または time_range が正数でない
  • 1 つの入札でフリークエンシー キャップが大量に設定されている
  • time_unit が指定されていない

    同じフリークエンシー キャップ ID の入札で異なる期間(time_unit と time_range で表されます)を使用すると、古いフリークエンシー キャップに対してカウントされたインプレッションは新しいフリークエンシー キャップに対してカウントされません。

  • currency optional 文字列

    max_cpm_micros と min_cpm_micros が使用する通貨(ISO-4217 アルファコードを使用)。このフィールドに値を入力すると、指定した通貨が入札の解釈に使用されます。それ以外の場合は、デフォルトの入札通貨が使用されます。通貨は次の優先度で決定されます。

    1. ビッダー レベルの通貨(RTB アカウント設定で設定されている場合)。
    2. 購入者レベルの通貨。購入者は、入札レスポンスの billing_id フィールドに指定された請求 ID(入力されている場合)によって決定されます。それ以外の場合、その入札は入札リクエストで送られた唯一の請求 ID に基づきます。

    購入者アカウントの通貨はアカウントの作成時に設定され、テクニカル アカウント マネージャーに問い合わせて確認できます。

    FrequencyCap オブジェクト
    属性 必須 / 任意 タイプ 実装の詳細
    frequency_cap_id optional 文字列 フリークエンシー キャップの入札者のユースケースを表す ID。たとえば、キャンペーン、広告、広告申込情報などを表すことができます。ユーザー固有の情報や ID を含めることはできません。
    time_unit optional enum フリークエンシー キャップを適用できます。

    UNKNOWN_TIME_UNIT = 0
    MINUTE = 1
    DAY = 2
    WEEK = 3
    MONTH = 4
    INDEFINITE = 5
    : INDEFINITE を使用すると、time_range は無視されます。INDEFINITE は、フリークエンシー キャップが長期間(1 か月以上)適用されることを意味しますが、必ずしも永続的に適用されるわけではありません。

    time_range optional int32 フリークエンシー キャップを適用する期間の長さを time_unit で指定された単位で指定します。たとえば、time_unit=WEEK と time_range=3 の場合、上限が 3 週間適用されます。time_unit=INDEFINITE を指定すると、無視されます。
    max_impressions optional int32 time_unit と time_range で表される期間内で、指定のフリークエンシー キャップに対してユーザーに表示されるインプレッション数の上限。

    ImpressionTrackingResource オブジェクト

    属性 必須 / 任意 タイプ 実装の詳細
    script_url optional 文字列 JavaScript リソースの URL。URL にスクリプトタグを含めないでください。例: 「https://mycdn.com/tracker.js」。
    context repeated enum レンダリング用に提供される追加のコンテキスト。

    UNKNOWN_CONTEXT = 0
    OMID = 1

    verification_parameters optional 文字列 読み込み時にリソースに渡されるリソースに関連付けられたパラメータ。パラメータの形式は、スクリプト ベンダーによって異なります。
    vendor_key optional 文字列 検証スクリプトのプロバイダを一意に識別するために使用されます。

    SdkRenderedAd オブジェクト

    属性 必須 / 任意 タイプ 実装の詳細
    id optional 文字列 広告を表示する SDK の ID。対応する入札リクエストで送信された mobile.installed_sdk.id と一致する必要があります。
    rendering_data optional 文字列 広告をレンダリングするために SDK に渡すデータ。このデータは、パブリッシャーと Google からは不透明です。
    declared_ad optional DelcaredAd オブジェクト カスタム SDK によりレンダリングされた広告のクリエイティブ スキャンと分類、広告ポリシーとパブリッシャーのブロックの適用をサポートするために、広告アセットを宣言しました。html_snippetvideo_urlvideo_vast_xmlnative_ad のいずれか一方のみを設定します。
    DeclaredAd オブジェクト

    カスタム SDK によりレンダリングされた広告のクリエイティブ スキャンと分類、広告ポリシーとパブリッシャーのブロックの適用をサポートするために、広告アセットを宣言しました。html_snippetvideo_urlvideo_vast_xmlnative_ad のいずれか 1 つのみを設定します。

    属性 必須/任意 タイプ 実装の詳細
    html_snippet optional 文字列 SDK でレンダリングされた広告を表す HTML スニペット。
    video_url optional 文字列 SDK でレンダリングされた広告で使用される VAST アセットの URL。
    video_vast_xml optional 文字列 SDK でレンダリングされたカスタム広告のレンダリングに使用される VAST ドキュメント。このドキュメントは VAST 2.0 または 3.0 標準に準拠している必要があります。
    native_ad optional NativeAd ネイティブ広告のコンテンツ。ネイティブ広告は複数の構成要素で構成され、購入者の SDK によってレンダリングされます。
    click_through_url optional 文字列 SDK でレンダリングされた広告の最終的なランディング ページ。

    SKAdNetworkResponse オブジェクト

    属性 必須 / 任意 タイプ 実装の詳細
    version optional 文字列 広告主がサポートする SKAdNetwork のバージョン。シグネチャの生成方法を指定するために使用されます。BidRequest.mobile.skad.version と一致する必要があります。
    network optional 文字列 署名に使用される広告ネットワーク ID。BidRequest.mobile.skad.skadnetids のいずれかの項目と一致する必要があります。
    campaign optional int64 Apple の仕様に対応するキャンペーン ID。
    itunesitem optional 文字列 Apple のアプリストアの広告主のアプリの ID。
    fidelities repeated 忠実度 バージョン 2.2 以降の SKAdNetwork API では、SKAdNetwork シグネチャの fidelity-type パラメータで指定された複数の広告の表示オプションがサポートされています。これにより、サポートされている忠実度タイプごとに異なる署名の生成に使用されるパラメータを保持します。詳しくは、こちらの記事をご覧ください。
    nonce optional 文字列 署名を生成するために広告主が生成した一意の小文字の UUID。 注: このフィールドは、複数の忠実度タイプをサポートする BidResponse.ad.skadn.fidelities.nonce フィールドを優先してサポートが終了します。
    sourceapp optional 文字列 Apple のアプリストア内のパブリッシャーのアプリ ID。BidRequest.mobile.skad.sourceapp の ID と一致する必要があります。
    timestamp optional int64 署名の生成時に使用された Unix 時間(ミリ秒単位)。 注: このフィールドは、複数の忠実度タイプをサポートするため、BidResponse.ad.skadn.fidelities.timestamp フィールドに代わって推奨されます。
    signature optional 文字列 Apple が指定する SKAdNetwork 署名。注: このフィールドは、複数の忠実度タイプをサポートするため、BidResponse.ad.skadn.fidelities.signature フィールドに代わって非推奨となります。
    忠実度オブジェクト

    バージョン 2.2 以降の SKAdNetwork API では、SKAdNetwork シグネチャの fidelity-type パラメータで指定された複数の広告の表示オプションがサポートされています。これにより、サポートされている忠実度タイプごとに異なる署名の生成に使用されるパラメータを保持します。詳しくは、こちらの記事をご覧ください。

    属性 必須 / 任意 タイプ 実装の詳細
    fidelity_type optional enum トラッキングするアトリビューションの忠実度タイプ。デフォルト = STOREKIT_RENDERED_ADS

    VIEW_THROUGH_ADS = 0: 広告の表示から 24 時間以内に 3 秒以上アプリ インストールのアトリビューションが発生している。SKAdnetwork バージョン 2.2 以降でサポートされています。詳しくは、こちらの記事をご覧ください。
    STOREKIT_RENDERED_ADS = 1アプリクリックのアトリビューションにより、StoreKit でレンダリングされた App Store の商品ページから発生したアプリのインストールのアトリビューション。 すべての SKAdNetwork バージョンでサポートされています。詳しくは、こちらの記事をご覧ください。

    nonce optional 文字列 署名を生成するために広告主が生成した一意の小文字の UUID。
    timestamp optional int64 署名の生成時に使用された Unix 時間(ミリ秒単位)。
    signature optional 文字列 Apple が指定する SKAdNetwork 署名。