OpenRTB の統合

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

このガイドでは、OpenRTB 2.5(マクロを含む)とネイティブ広告と認定バイヤーの統合について説明します。また、認定バイヤーの OpenRTB 拡張機能の proto に含まれる各フィールドについても説明します。

OpenRTB プロトコルについて詳しくは、OpenRTB プロトコル ファイルをご覧ください。 認定バイヤーの拡張機能については、OpenRTB 拡張機能のプロトコル バッファ ファイルをご覧ください。

認定バイヤーでの OpenRTB 実装には、同様の 2 つの形式が用意されています。

  • JSON
  • Protobuf: .proto 定義ファイルはメッセージのデコード用に参照できます。

このページは、両方のリファレンスとしてご利用いただけます。

統合に関する考慮事項

このドキュメントの構成

以下の表に、オブジェクトの名前、入札リクエストまたは入札レスポンスで必要なかどうか、認定バイヤーのリアルタイム ビッダーの protobuf の同等のオブジェクト、実装の詳細など、オブジェクトの定義を示します。

また、次の点に注意してください。

  • cid フィールドは、プレターゲティング設定で指定された請求 ID を表します。このフィールドは、入札リクエストで送信された billing_id に入札をリンクするために使用されます。リクエストに cid / billing_id が複数ある場合や、アクティブな子シートがある場合は、レスポンスで目的の cid を指定する必要があります。リクエストに子が 1 つしかなく、アクティブな子シートもない場合は、レスポンスで想定された値となります。
  • 以下のセクション名は、わかりやすくするために OpenRTB に準じています。
  • 可能な場合は、すべてのフィールドにリクエストが入力されます。null 値や空の文字列が渡されることはありません。
  • OpenRTB の型と説明は、以下の表に含まれていません。OpenRTB proto ファイルをご覧ください。
  • JSON エンコードの入札リクエストでは、以下に int64 または fixed64 タイプのすべてのフィールドが文字列として送信され、64 ビット整数値の精度の損失を防ぎます。
  • OpenRTB JSON プロトコルは、リクエスト内のすべての bool フィールドを整数として表します。ここで、0false1true を表します。これは OpenRTB の仕様で必須です。

インプレッションのカウントとマクロの使用

差異を制限するには、ネイティブを含むすべての広告枠に BidResponse.seatbid[].bid[].ext.impression_tracking_url フィールドを使用することをおすすめします。

購入者は、クリエイティブ(広告マークアップ)からインプレッション トラッキング ピクセルを削除し、代わりに入札のフィールドに impression_tracking_url フィールド(文字列配列)を含めます。OpenRTB 2.5 では BidResponse.seatbid[].bid[].burl も使用できます。impression_tracking_url は、インプレッションが課金対象であるとみなされる場合に発生します。これにより、プリフェッチによりアプリが取得したもののレンダリングされなかったインプレッションをトラッキングできるトラッキング ピクセルよりも精度が高くなります。このフィールドには、暗号化された %%WINNING_PRICE%% マクロまたは ${AUCTION_PRICE} マクロを使用します。

impression_tracking_urlburl でサポートされているマクロのリストを以下に示します。

  • ${AUCTION_ID} - 入札リクエストの ID。BidRequest.id 属性から取得します。
  • ${AUCTION_BID_ID} - 入札単価の ID。BidResponse.bidid 属性で指定します。
  • ${AUCTION_IMP_ID} - BidRequest.imp[].id 属性から取得したばかりの、インプレッションの ID。
  • ${AUCTION_SEAT_ID} - 入札が行われたビッダー シートの ID。BidResponse.seatbid[].seat 属性で指定します。
  • ${AUCTION_AD_ID} - ビッダーが配信したい広告マークアップの ID。BidResponse.seatbid[].bid[].adid 属性から取得されます。
  • ${AUCTION_PRICE} - 入札と同じ通貨と単位を使用して価格をクリアします。なお、このマクロは現在、AMP 広告ではサポートされていません。

Google の OpenRTB 実装は、認定バイヤー プロトコルの WINNING_PRICE マクロと同様に AUCTION_PRICE を暗号化します。価格を復号する方法について詳しくは、価格確認の復号ガイドをご覧ください。

Protobuf への移行

Protobuf のエンコードは帯域幅と処理の点で効率性が高いため、使用することをおすすめします。Protobuf への移行は、どちらの形式にも一致するフィールドがあるため、簡単です。

JSON から Protobuf に移行する場合は、フィールド cid が入札レスポンスの文字列として設定されていることを確認します。このフィールドを使用して、プレターゲティング内の入札単価が billing_id にリンクされます。読み取れない場合、入札単価は承認されません。

VAST と動画のサポート

デフォルトでは、VAST 広告には完全な XML ではなく SSL URL がサポートされています。 ただし、エクスチェンジ ビッダーは完全な VAST をインラインで返すことができます。この機能を有効にするには、アカウント サポートチームにご連絡ください。

OpenRTB 2.4 以降では、購入者がスキップ不可またはスキップ可能な動画のクリエイティブで入札できます。video.skip=1OpenRTB では ALLOW_SKIPPABLEREQUIRE_SKIPPABLE の間に区別はないため、アカウント設定で [修正をスキップ] を有効にすることをおすすめします。

サポートされていないフィールド

Nurl フィールドは現在サポートされていませんが、impression_tracking_url はサポートされています。OpenRTB 2.5 の Bid.burl については、上記のコメントをご覧ください。

入札単価なし

クライアントが入札をしたくない場合、クライアントは 204 コードで応答する必要があります。

列挙型

すべての列挙型は、OpenRTB 2.5ネイティブ広告の公式ドキュメントで確認できます。

MRAID-1 は、MRAID-2 のサブセットです。OpenRTB 2.1 以前では、3 の値は MRAID でした。ただし、MRAID 対応 API の中には MRAID-2 機能を認識しないものもあります。そのため、値 3 の安全な解釈は MRAID-1 のみとなります。OpenRTB 2.2 では、この動作が明示的になり、MRAID-2 が値 5 として追加されました。

OpenRTB バージョンの確認

OpenRTB/JSON
x-openrtb-version が存在し、2.2、2.3、2.4、2.5 のいずれかが含まれている。Content-Typeapplication/json です。charset = utf-8
OpenRTB/Protobuf
x-openrtb-version が存在し、2.3、2.4、2.5 のいずれかが含まれている。Content-Typeapplication/octet-stream です。

入札リクエストの変数と定義

このページを参照する際は、OpenRTB 2.5 仕様ガイドをご覧ください。

入札リクエスト

トップレベルの入札リクエスト オブジェクトには、グローバルに一意の入札リクエストまたはオークション ID が含まれます。この ID 属性と、1 つ以上の Imp(impression)オブジェクトが必要です。このトップレベル オブジェクトのその他の属性では、提供されるすべてのインプレッションに適用されるルールと制限が確立されます。

見込み顧客に詳細なデータを提供する下位オブジェクトもあります。その中には SiteApp オブジェクトがあります。これらは、インプレッションが表示される公開メディアの種類を記述します。これらのオブジェクトを使用することを強くおすすめします。ただし、メディアがブラウザベースのウェブ コンテンツとブラウザ以外のアプリケーションのどちらであるかによって、特定の入札リクエストに適用されるのは 1 つだけです。

属性 常に合格 認定バイヤー
購入者の
サポート対象 実装の詳細
バージョン Google が提供
id string BidRequest.id 2.3
2.4
2.5


エクスチェンジによって提供される入札リクエストの一意の ID。

OpenRTB は、ウェブセーフな base64 です(パディングなし)。

imp Imp オブジェクトの配列。 BidRequest.AdSlot 2.3
2.4
2.5


提示されたインプレッション数を表します。

少なくとも 1 つの Imp オブジェクトが必要です。

site なし Site オブジェクト 入札リクエスト 2.3
2.4
2.5


出版社のウェブサイトの詳細。

ウェブサイトにのみ適用され、推奨されます。

1 回限りの特典: app

app なし App オブジェクト BidRequest
BidRequest.Mobile
2.3
2.4
2.5


パブリッシャーのアプリに関する詳細。

(ブラウザ以外のアプリケーション)。これはアプリのみに適用され、推奨されます。

1 回限りの特典: site

device なし Device オブジェクト BidRequest.Mobile、BidRequest.Device 2.3
2.4
2.5


インプレッションの配信先となるユーザーのデバイスに関する詳細。
regs なし Regs オブジェクト 2.3
2.4
2.5


このリクエストに適用される業界、法律、行政機関の規制を指定します。
user なし User オブジェクト 入札リクエスト 2.3
2.4
2.5


デバイスのユーザー(広告オーディエンス)に関する詳細情報。
at なし AuctionType オブジェクト BidRequest.auction_type 2.3
2.4
2.5


ここで、1 = 1 つ目の価格、2 = 2 つ目の価格プラスです。

エクスチェンジ固有のオークションの種類は、500 件以上の値を使用して定義できます。デフォルトは SECOND_PRICE です。

tmax なし int32 80 ~ 1,000 ミリ秒 2.3
2.4
2.5


タイムアウトを回避するために入札を送信する最大時間(ミリ秒)。通常、この値はオフラインで通知されます。
wseat × string サポート対象外 2.3
2.4
2.5


このインプレッションへの入札が許可された購入者のシート(広告主、代理店など)の許可リスト。シートの ID と、購入者が参照する購入者の知識は、ビッダーとエクスチェンジの間で調整する必要があります。省略した場合はシート数の上限がないことを意味します。
allimps × ブール値 サポート対象外 2.3
2.4
2.5


Exchange で、コンテキスト内の利用可能なすべてのインプレッション(ウェブページ上のすべてのインプレッション、プレロール/ミッド/ポストロールなどのすべての動画スポット)が表示可能であることを確認できるかどうかを示すオプションです。0 = いいえ、または不明。1 = はい。使用可能なインプレッションは利用可能なすべてのものを表します。
cur なし 文字列の配列 サポート対象外 2.3
2.4
2.5


ISO-4217 アルファ コードを使用した、この入札リクエストの入札で許可される通貨の配列。 エクスチェンジで複数の通貨に対応している場合にのみ推奨されます。
bcat なし 文字列の配列 BidRequest.AdSlot.
excluded_sensitive
_category、BidRequest.AdSlot.
excluded_product
_category
2.3
2.4
2.5


IAB コンテンツ カテゴリを使用して、ブロックされた広告主カテゴリContentCategory の列挙型をご覧ください。
badv なし 文字列の配列 サポート対象外 2.3
2.4
2.5


広告主のリストをドメインごとにブロックする(例: 「addomain.com」)
bapp なし 文字列の配列 サポート対象外 2.4
2.5

プラットフォーム固有のエクスチェンジに依存しないアプリケーション識別子でアプリケーションのリストをブロックします。Android では、バンドルまたはパッケージ名にする必要があります(例: com.foo.mygame)。iOS では、これらは数値 ID です。
test なし ブール値 BidRequest.is_test 2.3
2.4
2.5


オークションが請求対象外であるテストモードを示します。0 = ライブモード、1 = テストモードです。デフォルト : 1
bseat なし 文字列 サポート対象外 2.5 インプレッションに対する入札が制限されている購入者のシート(広告主、代理店など)のリストをブロックします。シートの ID と、購入者が参照する購入者の知識が、ビッダーとエクスチェンジの間で調整されている必要があります。同じリクエストで使用できるのは wseatbseat のいずれか一方だけです。どちらも省略した場合、シートの制限はありません。
wlang なし 文字列 BidRequest
.AdSlot
.allowed
_languages
2.5 ISO-639-1-alpha-2 を使用するクリエイティブの言語のリスト。省略されることは特定の制限を意味しませんが、利用可能な場合はデバイス オブジェクトやコンテンツ オブジェクトで言語属性を検討することをおすすめします。
source なし Source オブジェクト 拡張機能でのみ使用 2.5 インベントリ ソースと最終的な意思決定に関するデータを提供する Source オブジェクト。
ext × BidRequestExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB / Protobuf の場合、[com.google.doubleclick.bid_request] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合、BidRequest メッセージの ext フィールドを使用してアクセスします。

入札リクエストのリクエスト

詳細については、リアルタイム フィードバックをご覧ください。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
bid_feedback × BidFeedback オブジェクトの配列 BidRequest.bid_response_feedback 以前の回答で送信された入札に関するフィードバック。これは、ビッダーのリアルタイム フィードバックが有効になっている場合にのみ設定されます。リアルタイム フィードバックを有効にする場合は、アカウント マネージャーにお問い合わせください。
google_query_id × 文字列 BidRequest.google_query_id これは、クエリ全体の一意の ID を表します。1 つのクエリに複数のコールアウトがある場合、そのクエリのすべてのコールアウト リクエストに同じ google_query_id が含められます。
fcap_scope FrequencyCappingScope 列挙型 BidRequest.AdSlot.FrequencyCappingScope

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

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 つのサイト内で行えます。

privacy_treatments × PrivacyTreatments オブジェクト BidRequest.privacy_treatments プライバシーに関する扱い。入札リクエストの一部のフィールドは、ユーザーのプライバシーを保護するために加工したり削除したりすることがあります。このメッセージでは、このリクエストを通じて提供される広告配信予想に適用される、プライバシーの取り扱いについて説明します。
入札に関するフィードバック

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

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
request_id × 文字列 BidRequest.BidResponseFeedback.request_id BidRequest.id の一意の ID。
creative_status_code × int32 BidRequest.BidResponseFeedback.creative_status_code 広告のステータス コード。ID のリストについては、Protos とリファレンス データのページにあるクリエイティブのステータス コードをご覧ください。
price × 倍精度 BidRequest.BidResponseFeedback.cpm_micros 入札がオークションで勝った場合は、アカウントの通貨での支払い額になります。オークションに参加したが、入札単価が競り負けた場合、落札するには落札できなかった CPM になります。オークションの前に入札がフィルタされた場合、またはパブリッシャーまたは落札者が価格フィードバックをオプトアウトしている場合、またはアカウントで他のビッダーとの落札価格の共有を無効にしている場合は、この設定されません。ファーストプライス オークションでは、このフィールドではなく min_bid_to_win が入力されます。
minimum_bid_to_win × 倍精度 BidRequest.BidResponseFeedback.minimum_bid_to_win オークションで落札するために必要な最低入札単価。アカウントの通貨で表示されます。入札がオークションで勝った場合は、除外されなかった 2 番目に高い入札単価(最小価格を含む)になります。入札がオークションで落札されなかった場合は、落札者の入札単価になります。このフィールドは、入札がファーストプライス オークションに参加した場合にのみ入力され、オークション前に入札がフィルタされた場合には入力されません。
sampled_mediation_cpm_ahead_of_auction_winner × 倍精度 BidRequest.BidResponseFeedback.sampled_devguides_cpm_ahead_of_auction_winner パブリッシャーが同じクエリ上で RTB オークションとウォーターフォール ベースの SDK メディエーションを使用している場合、リアルタイム オークションの落札者は、インプレッションを獲得するためにメディエーション ウォーターフォール(価格順)で競合する必要があります。オークションに参加した入札でウォーターフォールが存在しない場合、このフィールドの値は 0 です。入札がオークションに参加し、ウォーターフォールが行われた場合、このフィールドの値は、オークションに勝った対象のメディエーション ネットワークから提示されたサンプル入札単価(予想される広告掲載率で重み付けした値)を表します。このフィールドは、入札モデルをトレーニングするために min_bid_to_win と組み合わせて使用できます。CPM はアカウントの通貨で計算されます。
event_notification_token × EventNotificationToken オブジェクト BidRequest.BidResponseFeedback.event_notification_token 対応する入札単価に含まれるトークン。
buyer_creative_id × 文字列 BidRequest.BidResponseFeedback.buyer_creative_id 対応する入札単価に含まれるクリエイティブ ID。
イベント通知トークン

対応する入札単価に含まれるトークン。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
event_notification_token.payload × 文字列 BidRequest.BidResponseFeedback.event_notification_token トークンの内容。
PrivacyTreatments オブジェクト

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

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
non_personalized_ads_reason × NonPersonalizedAdsReason 列挙型 BidRequest.privacy_treatments.non_パーソナライズ_ads_reason

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

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

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

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

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

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

ソース

このオブジェクトは、エクスチェンジの上流の入札リクエストのソースとなるエンティティの性質と動作を説明します。このオブジェクトの主な目的は、エクスチェンジ自体が最終決定を管理していない場合に、オークション後の決定、つまりアップストリームの決定を定義することです。たとえば、ヘッダー入札を使用できますが、別の RTB エクスチェンジ、メディエーション プラットフォーム、広告サーバーなどのアップストリーム サーバー エンティティに適用することもできます。その場合は、ダイレクト キャンペーンと第三者のデマンドを組み合わせて意思決定を行います。

属性 常に合格 認定バイヤー
購入者の
サポート対象 実装の詳細
バージョン Google が提供
fd なし ブール値 サポート対象外 2.5 最終的なインプレッションの販売判断を行うエンティティ。0 = 交換、1 = アップストリーム ソース。OpenRTB 仕様で推奨されます。
tid なし 文字列 サポート対象外 2.5 この入札リクエストのすべての参加者に共通している必要がある取引 ID(複数のエクスチェンジなど)。OpenRTB 仕様で推奨されます。
pchain なし 文字列 サポート対象外 2.5 TAG Payment ID Protocol v1.0 に記載されている埋め込み構文を含む支払い ID チェーン文字列。OpenRTB 仕様で推奨されます。
ext × SourceExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB/Protobuf の場合、[com.google.doubleclick.source] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合は、ソース メッセージの ext フィールドを使用してアクセスします。

SourceExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
omidpn × 文字列 BidRequest.AdSlot.omidpn OM SDK 統合の ID。詳しくは、Open Measurement SDK の OpenRTB Advisory をご覧ください。
omidpv × 文字列 BidRequest.AdSlot.omidpv OM SDK 統合のバージョン。詳しくは、Open Measurement SDK の OpenRTB Advisory をご覧ください。
schain × SupplyChain オブジェクト BidRequest.supply_chain OpenRTB SupplyChain オブジェクト。詳しくは、こちらの記事をご覧ください。
サプライ チェーン

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

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
complete × int32 BidRequest.supply_chain.complete サイト、アプリ、またはその他の広告枠メディアのオーナーとの取引につながるすべてのノードがチェーンに含まれているかどうかを示すオプション(0 = なし、1 = あり)。
nodes × SupplyChainNode オブジェクトの配列 BidRequest.supply_chain.nodes チェーンの順序の SupplyChainNode オブジェクトの配列。サプライ チェーン全体において、最初のノードは取引における最初の広告システムと販売者 ID(サイト、アプリ、その他のメディアの所有者など)を表します。不完全なサプライ チェーンでは、最初の既知のノードを表します。最後のノードは、この入札リクエストを送信するエンティティを表します。
ver × 文字列 BidRequest.supply_chain.version 使用中のサプライ チェーン仕様のバージョン(major.minor 形式)。たとえば、仕様のバージョン 1.0 の場合は、文字列「1.0」を使用します。
SupplyChain ノード
属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
asi × 文字列 BidRequest.supply_chain.nodes.Advertising_system_identifier ビッダーが接続している SSP、Exchange、ヘッダー ラッパーなどのシステムの正規ドメイン名。これがシステムの運用ドメインとなる場合があります(親企業ドメインと異なる場合は、委任システムの明確な所有権を確立するために WHOIS 検索やリバース IP ルックアップを行います)。ads.txt ファイル内に販売者が存在する場合は、この値と同じ値になります。
sid × 文字列 BidRequest.supply_chain.nodes.seller_identifier 広告システム内で販売者または販売パートナー アカウントに関連付けられた識別子。これには、SSP/エクスチェンジが指定するフィールドのトランザクション(OpenRTB 入札リクエストなど)で使用される値と同じ値を指定する必要があります。OpenRTB の場合、通常は publisher.id です。OpenDirect の場合は通常、パブリッシャーの組織 ID です。 長さは 64 文字以下にしてください。
rid × 文字列 非対応 この販売者によって発行されたリクエストの OpenRTB RequestId。
name × 文字列 非対応 指定された販売者 ID で取引された在庫の支払いを受ける企業(法人)の名前。この値はオプションであり、広告システムの sellers.json ファイルに含まれている場合はこの値を含めないでください。
domain × 文字列 非対応 このノードによって表されるエンティティのビジネス ドメイン名。 この値はオプションであり、広告システムの sellers.json ファイルに含まれている場合はこの値を含めないでください。
hp × int32 BidRequest.supply_chain.nodes.handles_payment このノードがインベントリの支払いフローに含まれるかどうかを示します。1 に設定した場合、ASI フィールドの広告システムは、チェーン内の前のノードに対する支払いを担当する sid フィールドで販売者に支払います。0 に設定すると、このノードはインベントリの支払いフローに関与しません。SupplyChain バージョン 1.0 では、このプロパティは常に 1 になります。今後のバージョンで非支払い処理ノードが導入されることを想定しているため、明示的に追加する必要があります。実装者はダウンストリーム広告システムに送信される入札リクエストに SupplyChain オブジェクトを作成する際、このフィールドをサポートし、それを伝達する必要があります。

悪魔

このオブジェクトは、オークション対象の広告プレースメントまたはインプレッションを表します。1 つの入札リクエストに複数の Imp オブジェクトを含めることができます。そのユースケースは、あるページのすべての広告位置の販売をサポートするエクスチェンジの場合もあります。各 Imp オブジェクトには、入札が個別に参照できるように必要な ID があります。

BannerVideo、または Native オブジェクトが Imp オブジェクトに依存すると、表示されるインプレッションの種類が示されます。パブリッシャーは、典型的なケースとして選択できるか、自らの判断で組み合わせることができます。インプレッションの入札単価は、指定したタイプのいずれかに従う必要があります。

属性 常に合格 タイプ 認定バイヤー サポート対象 実装の詳細
バージョン Google が提供
id 文字列 入札リクエスト
.Adslot.id
2.3
2.4
2.5


入札リクエストのコンテキスト内でこのインプレッションに固有の識別子です(通常、値は 1 から始まり、n インプレッションの場合は n まで増えます)。
banner × Banner オブジェクト 入札リクエスト
.広告スロット
2.3
2.4
2.5


Banner オブジェクト。このインプレッションがバナー広告として配信される場合は必須。
video × Video オブジェクト BidRequest
.AdSlot
BidRequest
.Video
2.3
2.4
2.5


このインプレッションを動画広告の機会として提供する場合は必須。
audio × Audio オブジェクト BidRequest
.AdSlot
BidRequest
.Video
2.3
2.4
2.5


このインプレッションがオーディオ広告配信の機会として提供される場合は必須です。
displaymanager × 文字列 BidRequest
.AdSlot
.renderer
2.3
2.4
2.5


広告メディエーション パートナー、SDK 技術、または広告のレンダリングを担当するプレーヤー(通常は動画またはモバイル)の名前。一部の広告サーバーで、パートナーによって広告コードをカスタマイズするために使用されます。動画やアプリに適しています。

文字列の例:
UNKNOWN_RENDERER
GOOGLE
PUBLISHER

displaymanagerver × 文字列 非対応 2.3
2.4
2.5


広告メディエーション パートナー、SDK 技術、または広告のレンダリングを担当するプレーヤー(通常は動画またはモバイル)のバージョン。一部の広告サーバーで、パートナーによって広告コードをカスタマイズするために使用されます。動画やアプリに適しています。
instl × ブール値 BidRequest
.AdSlot
.Mobile.
is_interstitial
_request
2.3
2.4
2.5


1 = 広告がインタースティシャルまたは全画面表示、0 = インタースティシャルではない。
tagid × 文字列 BidRequest
.AdSlot
.ad_block_key
2.3
2.4
2.5


オークションの開始に使用された特定の広告プレースメントまたは広告タグの ID。これは、問題のデバッグや購入者による最適化に役立ちます。
bidfloor × 倍精度 min(BidRequest
.AdSlot.
matching
_ad_data
.minimum_cpm
_micros) * 1,000,000
2.3
2.4
2.5


このインプレッションの最小入札単価。CPM で表されます。
bidfloorcur × 文字列 billing_id から
取得
しました
2.3
2.4
2.5


ISO-4217 アルファ コードを使用して指定された通貨。エクスチェンジで許可されている場合は、ビッダーが返す入札通貨と異なる場合があります。

含まれている billing_id から取得した単一の通貨。

clickbrowser × ブール値 非対応 2.4
2.5

アプリでクリエイティブをクリックしたときに開いたブラウザの種類を示します。0 = 埋め込み、1 = ネイティブ。

iOS 9.x デバイスの Safari ビュー コントローラは、この属性においてネイティブ ブラウザであると見なされます。

secure × ブール値 BidRequest
.ad_slot
.excluded_attribute
48:Rich
CapabilitiesNonSSL
2.3
2.4
2.5


インプレッションにセキュアな HTTPS URL クリエイティブ アセットとマークアップが必要かどうかを示します。ここで、0 はセキュアでない、1 はセキュア、ということになります。省略した場合、セキュア状態は不明ですが、セキュアでない HTTP サポートと見なされます。
iframebuster × 文字列の配列 サポート対象外 2.3
2.4
2.5


サポートされている iframe バスターのエクスチェンジ固有の名前の配列。
pmp × Pmp オブジェクト BidRequest
.AdSlot
.MatchingAdData
2.3
2.4
2.5


このインプレッションに有効なプライベート マーケットプレイス取引を含む Pmp オブジェクト。
native × ネイティブ BidRequest
.AdSlot
.NativeAdTemplate
2.3
2.4
2.5


Native オブジェクト。このインプレッションがネイティブ広告として表示される場合は必須です。
exp × int32 BidRequest
.AdSlot
.impression_expiration
_seconds
2.4
2.5

オークションから実際のインプレッションまでの経過時間(秒)に関するアドバイザリ。
metric × Metric オブジェクトの配列 BidRequest
.AdSlot
.viewability
BidRequest
.AdSlot
.click_through
_rate

BidRequest
.AdSlot
.video_completion
_rate
BidRequest
.AdSlot
.session_depth.
2.5 Metric オブジェクトの配列。AdX では、このフィールドに click_through_rateviewabilitycompletion_ratesession_depth の指標が提供されます。viewability 指標は OpenRTB 指標では 0.00 ~ 1.00 の割合ですが、AdX プロトコルでは割合 [0 ~ 100] で表します。これらの指標の説明については、リアルタイム ビッダー ガイドの AdSlot オブジェクト テーブルをご覧ください。session_depth は整数値です。
ext × ImpExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB / Protobuf の場合、[com.google.doubleclick.imp] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合は、Imp メッセージの ext フィールドを使用してアクセスします。

インプレッション

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
billing_id int64 の配列 BidRequest.AdSlot.MatchingAdData.billing_id 一致したプレターゲティング設定に対応する請求 ID。
publisher_settings_list_id 修正済み 64 の配列 BidRequest.publisher_settings_list_id
BidRequest.AdSlot.publisher_settings_list_id
このページに適用されるパブリッシャー設定リスト ID。詳しくは、RTB パブリッシャーの設定ガイドをご覧ください。
allowed_vendor_type × int32 の配列 BidRequest.AdSlot.allowed_vendor_type 許可されるベンダーのタイプ。ID のリストについては、vendors.txt ファイルをご覧ください。
excluded_creatives × ExcludedCreative オブジェクトの配列 BidRequest.AdSlot.excluded_creatives インプレッションで許可されていないクリエイティブ。このリスト内のいずれかのクリエイティブを使用して入札を送信すると、オークションに先立って入札は除外されます。この機能を有効にする場合は、アカウント マネージャーにお問い合わせください。
publisher_parameter × 文字列の配列 BidRequest.AdSlot.ExchangeBidding.publisher_parameter アド マネージャー UI の対応する収益グループ設定の一部としてパブリッシャーが必要に応じて指定する UTF8 文字列。形式は任意で、パブリッシャーと認定バイヤーの合意が必要です。
dfp_ad_unit_code × 文字列 BidRequest.AdSlot.dfp_ad_unit_code アド マネージャー広告ユニットコード。現在、この機能は Open Bidding のリクエストにのみ設定できます。
is_rewarded_inventory × ブール値 BidRequest.AdSlot.is_rewarded ユーザーが広告を見る代わりにリワードを受け取るかどうかを示します。動画広告の場合、一般的な実装では、ユーザーが追加のニュース記事を無料で読んだり、追加のライフを獲得したり、スポンサーのない広告なしで音楽を視聴したりできます。この特典は通常、動画広告の完了後に配信されます。
ampad × 列挙型 AmpAdRequirementType BidRequest.AdSlot.amp_ad_request_type AMP 広告の要件タイプは次のとおりです。

UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1;(デフォルト)AMP 広告の要件は不明です。

AMP_AD_NOT_ALLOWED = 2; AMP 広告は許可されていません。

AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3。AMP 広告または非 AMP 広告のいずれかが許可されていますが、AMP 広告は早期レンダリングされません。

AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4。AMP 広告または非 AMP 広告のいずれかが許可され、AMP 広告は早期レンダリングされます。

AMP_AD_REQUIRED = 5; AMP 広告は必須です。非 AMP 広告はパブリッシャーが拒否する場合があります。

buyer_generated_request_data × BuyerGeneratedRequestData オブジェクトの配列。 BidRequest.AdSlot.secure_signals パブリッシャーから渡されたセキュア シグナル。
billable_event_rate_adjustment × 倍精度 BidRequest.AdSlot.billable_event_rate_adjustment カスタム SDK を使用してレンダリングされた広告のみ: オークションの入札に適用される乗数。オークションで落札した場合に、他のオークションで落札した場合に請求対象のイベントが発生する可能性と比較して、入札で課金対象イベント(広告表示など)が発生する可能性が反映されます。この調整は 1 より大きくなることも小さくなることもあります。これはオークションの最終的なランキングにのみ影響します。特に、この乗数は支払いには影響しません。デフォルト = 1.0。
open_bidding × OpenBidding オブジェクト BidRequest.AdSlot.open_bidding Open Bidding に関連するパラメータです。
allowed_restricted_category × int32 BidRequest.AdSlot.allowed_restricted_category 許可されている制限付き広告のカテゴリ。ID のリストについては、ad-restricted-categories.txt をご覧ください。
skadn × SKAdNetworkRequest オブジェクト BidRequest.Mobile.skadn iOS 14 以降でのアプリ インストール アトリビューションのサポートに関する、パブリッシャーの SKAdNetwork 情報。Apple の SKAdNetwork API を使用すると、インストール完了後に広告ネットワークにポストバックを送信して、広告によるアプリのインストールを測定できます。パブリッシャーは、広告のインプレッションにインストールを関連付けるために、アプリのプロパティ リスト(Info.plist)で、サポートされている広告ネットワークを設定する必要があります。詳細については、Apple のドキュメントをご覧ください。
除外クリエイティブ
buyer_creative_id × 文字列 BidRequest.AdSlot.ExcludedCreative.buyer_creative_id 許可されていないクリエイティブの購入者のクリエイティブ ID。
BuyerGeneratedRequestData
data × 文字列 BidRequest.AdSlot.SecureSignal.data セキュア シグナル
source_app × ソースアプリ BidRequest.AdSlot.SecureSignal.source データのソース。
ソースアプリ
id × 文字列 BidRequest.AdSlot.SecureSignal.source このデータを生成した SDK の識別子。これは BidRequest.AppExt.InstalledSdk.id の ID と一致します。
OpenBidding
is_open_bidding × ブール値 BidRequest.AdSlot.OpenBidding.is_open_bidding この広告スロットとこのビッダーをターゲットとする収益グループまたはメディエーション グループが設定されている場合、このフィールドは true に設定されます。Open Bidding と入札プロセスへの影響について詳しくは、ヘルプセンターをご覧ください。
SKAdNetworkRequest
version × 文字列 BidRequest.Mobile.skadn.version 非推奨です。これは 2022 年 11 月に削除されます。代わりに BidRequest.imp.ext.skadn.versions を使用してください。

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

versions × 文字列の配列 BidRequest.Mobile.skadn.versions OS バージョンと SDK バージョンに応じて、リクエストでサポートされるすべての SKAdNetwork バージョンのリスト。
sourceapp × 文字列 BidRequest.Mobile.skadn.sourceapp Apple の App Store のパブリッシャー アプリの ID。
skadnetids × 文字列の配列 BidRequest.Mobile.skadn.skadnetids パブリッシャーアプリの Info.plist にある SKAdNetworkIdentifier エントリ。
fidelities × SKAdNetworkFidelityType オブジェクトの配列 BidRequest.Mobile.skadn.supported_fidelity_types サポートされている忠実度タイプのリストです。オペレーティング システムと SDK でサポートされている SKAdNetwork API のバージョンと広告スロットのプロパティに応じて表示されます。

指標

このオブジェクトは、指標の配列としてインプレッションに関連付けられています。これらの指標からは、最近の視認率やクリック率など、インプレッションに関する分析情報を得られます。各指標はタイプ別に識別され、指標の値が表示され、必要に応じてその値を測定しているソースまたはベンダーを確認できます。

属性 常に合格 認定バイヤー
購入者の
サポート対象 実装の詳細
バージョン Google が提供
type なし 文字列 次のいずれか:
BidRequest
.AdSlot
.viewability

BidRequest
.AdSlot
.click_
through_rate

BidRequest
.AdSlot
.video_
completion_rate

BidRequest
.AdSlot
.session_depth.
2.5 エクスチェンジのキュレートされた文字列名を使用して表示される指標のタイプ。ビッダーに事前に公開する必要があります。OpenRTB 仕様で要求されます。サポートされるタイプは、click_through_rateviewabilitycompletion_ratesession_depth です。
value なし 倍精度 0 ~ 1 の値。 2.5 指標の値を表す数値。確率は 0.00 ~ 1.00 の範囲内で指定する必要があります。OpenRTB 仕様で要求されています。viewability 指標は OpenRTB 指標では 0.00 ~ 1.00 の割合ですが、AdX プロトコルでは 0 ~ 100 の割合で表されます。
vendor なし 文字列 エクスチェンジ 2.5 エクスチェンジのキュレートされた文字列名を使用する値のソース。ビッダーに事前に公開する必要があります。エクスチェンジ自体がソースか第三者の場合は、「EXCHANGE」をおすすめします。OpenRTB 仕様で推奨されます。

このオブジェクトは、最も一般的なタイプのインプレッションを表します。「バナー」という用語は、その他のコンテキストではかなり具体的である場合がありますが、ここでは単なる静止画像、エキスパンド広告ユニット、さらにはインバナー動画など、より一般化されたフル機能の動画広告ユニットについて Video オブジェクトを参照できます。動画内に Banner オブジェクトの配列を追加して、VAST 仕様で定義されているオプションのコンパニオン広告を記述することもできます。

BannerImp オブジェクトの下位に存在する場合、このインプレッションはバナータイプのインプレッションとして提供されます。パブリッシャーの裁量では、同じインプレッションを VideoNative のオブジェクトを Imp の下位に配置して、動画またはネイティブ広告として配信することもできます。ただし、インプレッションの入札単価は、指定されたタイプのいずれかに従う必要があります。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
w なし int32 BidRequest.AdSlot.width[0] 2.3
2.4
2.5


デバイス非依存ピクセル(DIPS)の幅。Format オブジェクトを指定しない場合は、正確な幅の要件です。それ以外の場合は、推奨される幅です。
h なし int32 BidRequest.AdSlot.height[0] 2.3
2.4
2.5


デバイス非依存ピクセル(DIPS)の高さ。Format オブジェクトが指定されていない場合、正確な高さの要件があります。それ以外の場合は、推奨の高さです。
format なし Format オブジェクトの配列。 サポート対象外 2.4
2.5
使用できるバナーサイズを表す Format オブジェクトの配列。何も指定しない場合は、h 属性と w 属性を使用することを強くおすすめします。
id なし 文字列 BidRequest.AdSlot.id 2.3
2.4
2.5


この Banner オブジェクトの一意の識別子。Banner オブジェクトが Video オブジェクトとともに使用され、コンパニオン広告の配列を表す場合に推奨されます。値は通常 1 から始まり、オブジェクトごとに増加します。インプレッション内では一意でなければなりません。
pos なし 列挙型 AdPosition BidRequest.AdSlot.slot_visibility
BidRequest.StickySettings
2.3
2.4
2.5


この OpenRTB のテーブルは、IAB 品質保証ガイドライン(QAG)から派生した値を含みます。IAB.net で公開されている QAG 値の最新情報とあわせて実務担当者と確認してください。値「4」~「7」は、QAG バージョン 1.5 のモバイル追加条項に沿ってアプリに適用されます。

Banner.pos は 1 つの値のみをサポートします。is_sticky の場合、Banner.pos はスティッキーで入力されます。unknown_stickiness の場合、slot_visibility が使用されます。追尾表示はバナーが常に画面上に表示されるのに対し、スクロールしなければ見えない範囲またはスクロールしなければ見えない範囲は、ユーザーのスクロール操作によって変化する可能性があります。

次のいずれかの値です。

ABOVE_THE_FOLD = 1;

BELOW_THE_FOLD = 3;

HEADER = 4;
認定バイヤーの RTB プロトコルの sticky_settings.top_horizontal_stickiness と同じです。

FOOTER = 5;
認定バイヤーの RTB プロトコルの sticky_settings.bottom_horizontal_stickiness と同じです。

SIDEBAR = 6;
認定バイヤーの RTB プロトコルの sticky_settings.vertical_stickiness と同じです。

btype なし 列挙型 BannerAdType の配列 サポート対象外 2.5 ブロックするバナー広告の種類

例:
XHTML_TEXT_AD = 1; // "通常モバイル"。
XHTML_BANNER_AD = 2; // "通常モバイル"。
JAVASCRIPT_AD = 3; // JavaScript は有効な xhtml である必要があります
IFRAME = 4; // iframe です。

battr なし CreativeAttribute 列挙型の配列 BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5


ブロックされているクリエイティブ属性

例:
AUDIO_AUTO_PLAY = 1;
AUDIO_USER_INITIATED = 2;

mimes なし 文字列の配列 BidRequest.Video.companionad のみにマッピング: BidRequest.Video.companionad.creative_format
BidRequest.AdSlot.excluded_attribute / VPAID
2.3
2.4
2.5


サポートされているコンテンツの MIME タイプの許可リスト。一般的な MIME タイプには、「image/jpg」、「image/gif」、「application/x-shockwave-flash」などがありますが、これらに限定されません。
topframe なし ブール値 BidRequest.AdSlot.iframing_state

NO_IFRAME: false
SAME_DOMAIN_IFRAME、CROSS_DOMAIN_IFRAME: true

2.3
2.4
2.5


バナーをトップフレームで配信するか(true)、iframe で配信するか(false)を指定します。
expdir なし ExpandableDirection 列挙型の配列 BidRequest.AdSlot.excluded_attribute / EXPANDING_* 2.3
2.4
2.5


バナーがエキスパンドする方向。
api なし APIFramework オブジェクトの配列。 BidRequest.AdSlot.excluded_attribute / MRAID_1_0 2.3
2.4
2.5


このインプレッションでサポートされている API フレームワークのリスト。明示的に指定されていない API は、サポートされていないとみなされます。
vcm なし ブール値 BidRequest.Video.end_cap_support 2.5 コンパニオン広告の配列で動画オブジェクトとともに使用されるバナー オブジェクトにのみ適用されます。関連する動画を基準にしたコンパニオン バナーのレンダリング モードを示します。0 = 同時、1 = エンディング メッセージ。現在のところ、モバイルアプリ インタースティシャルではエンディング メッセージのみがサポートされています。
wmax × int32 BidRequest.AdSlot.flexible_ad_slot_settings.max_width 2.3
2.4
2.5


インプレッションの最大幅(ピクセル単位)。
hmax × int32 BidRequest.AdSlot.flexible_ad_slot_settings.max_height 2.3
2.4
2.5


インプレッションの最大高さ(ピクセル単位)
wmin × int32 BidRequest.AdSlot.flexible_ad_slot_settings.min_width 2.3
2.4
2.5


インプレッションの最小幅(ピクセル単位)。
hmin × int32 BidRequest.AdSlot.flexible_ad_slot_settings.min_height 2.3
2.4
2.5


インプレッションの最小の高さ(ピクセル単位)。

形式

このオブジェクトは、バナー インプレッションの許容サイズ(高さと幅の組み合わせ)を表します。これらは通常、複数サイズが許可されているインプレッションの配列で使用されます。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
w なし int32 BidRequest.AdSlot.width 2.4
2.5

デバイス非依存ピクセル(DIPS)の幅。
h なし int32 BidRequest.AdSlot.height 2.4
2.5

デバイス非依存ピクセル(DIPS)の高さ。
wratio なし int32 サポート対象外 2.5 サイズを比率で表した場合の相対的な幅。
hratio なし int32 サポート対象外 2.5 サイズを比率で表す場合の相対的な高さ。
wmin なし int32 サポート対象外 2.5 サイズが比率で表される際に広告が表示されるデバイス独立ピクセル(DIPS)の最小幅。

動画

このオブジェクトはインストリーム動画のインプレッションを表します。多くのフィールドは、実行可能な最小限のトランザクションに不可欠ではありませんが、必要に応じて細かく制御するために含まれています。OpenRTB の動画は通常、VAST 標準に準拠していることを前提としています。そのため、コンパニオン広告の概念は、必要に応じてコンパニオン広告を定義する Banner オブジェクトの配列を含めることでサポートされています。

VideoImp オブジェクトの下位に存在する場合、このインプレッションは動画タイプのインプレッションとして提供されます。パブリッシャーの裁量により、同じインプレッションをバナーやネイティブとして表示することもできます。その場合、Imp に、それぞれ Banner または Native、あるいはその両方を Imp の子孫として指定します。ただし、インプレッションの入札単価は、指定されたタイプのいずれかに従う必要があります。

詳しくは、OpenRTB 動画広告のガイドをご覧ください。

属性 常に合格 タイプ 認定バイヤーの同等機能 バージョン Google からの支援 実装の詳細
mimes 文字列の配列 BidRequest.Video.allowed_video_formats、
BidRequest.AdSlot.excluded_attribute / VPAID
2.3
2.4
2.5


サポートされているコンテンツの MIME タイプの許可リスト。一般的な MIME タイプには、「image/jpg」、「image/gif」、「application/x-shockwave-flash」などがありますが、これらに限定されません。

OpenRTB 仕様で必須(1 個以上の要素)。

linearity × int32 2.3
2.4
2.5


インプレッションが線形かノンリニアかを示します。指定しない場合は、すべてが許可されると想定されます。

LINEAR = 1: 線形/インストリーム
NON_LINEAR = 2: 非線形/オーバーレイ

minduration × int32 BidRequest.Video.min_ad_duration 2.3
2.4
2.5


動画広告の最小再生時間(秒)。

OpenRTB 仕様で推奨されます。

maxduration × int32 BidRequest.Video.max_ad_duration 2.3
2.4
2.5


動画広告の最大再生時間(秒)。

OpenRTB 仕様で推奨されます。

protocols × Protocol オブジェクトの配列 BidRequest.Video.protocols 2.3
2.4
2.5


サポートされている動画入札レスポンス プロトコルの配列。

サポートされているプロトコルを少なくとも 1 つ指定する必要があります。

例:
VAST_1_0 = 1;
VAST_2_0 = 2;
VAST_3_0 = 3;

w × int32 BidRequest.AdSlot.width[0] 2.3
2.4
2.5
動画プレーヤーの幅(デバイス独立ピクセル(DIPS)単位)。

OpenRTB 仕様で推奨されます。

h × int32 BidRequest.AdSlot.height[0] 2.3
2.4
2.5


動画プレーヤーの高さ(デバイス非依存ピクセル(DIPS))。

OpenRTB 仕様で推奨されます。

startdelay × int32 BidRequest.Video.videoad_start_delay

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

その他の値:
videoad_start_delay / 1,000

2.3
2.4
2.5


プレロール、ミッドロール、ポストロールの各広告の開始遅延時間を秒単位で示します。汎用値については、列挙型 StartDelay をご覧ください。

OpenRTB 仕様で推奨されます。

skip × ブール値 BidRequest.Video.video_ad_skippable 2.4
2.5

プレーヤーが動画をスキップできるようにするかどうかを指定します。0 = いいえ、1 = はい。ビッダー自体がスキップ可能なマークアップやクリエイティブを送信している場合、Bid オブジェクトには、スキップ可能な動画を示す 16 の要素を含む Attr 配列を含める必要があります。
skipmin × int32 非対応 2.4
2.5

この合計秒数を超える動画がスキップ可能になるのは、広告がスキップ可能の場合に限られます。
skipafter × int32 非対応 2.4
2.5

スキップが有効になるまでの動画の再生時間(秒)。広告がスキップ可能の場合にのみ適用されます。
sequence × int32 非対応 2.3
2.4
2.5


同じ入札リクエストで複数の広告インプレッションが割り当てられている場合、シーケンス番号を使って、複数のクリエイティブを組織的に配信できます。[デフォルト = 1]
battr ×
クリエイティブ属性の配列
BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5


ブロックされているクリエイティブ属性
maxextended × int32 非対応 2.3
2.4
2.5


延長可能な動画広告の最大再生時間。空白または 0 の場合、拡張機能は使用できません。-1 の場合は延長が許可され、時間制限はありません。0 より大きい場合、値は maxduration 値を超えてサポートされる延長再生の秒数を表します。
minbitrate × int32 非対応 2.3
2.4
2.5


最小ビットレート(Kbps)。
maxbitrate × int32 非対応 2.3
2.4
2.5


最大ビットレート(Kbps)。
boxingallowed × ブール値 非対応 2.3
2.4
2.5


16:9 のウィンドウに 4:3 のコンテンツをレターボックス表示するかを指定します(0 = いいえ、1 = あり)。
デフォルト = true
playbackmethod ×
再生メソッドの配列
BidRequest.Video.playback_method

AdX:
VideoPlaybackMethod.AUTO_PLAY_SOUND_ON
VideoPlaybackMethod.AUTO_PLAY_SOUND_OFF
VideoPlaybackMethod.CLICK_TO_PLAY
VideoPlaybackMethod.MOUSE_OVER
VideoPlaybackMethod.ENTER_SOUND_ON
VideoPlaybackMethod.ENTER_SOUND_OFF

2.3
2.4
2.5


使用中の再生方法。指定しない場合は、どのメソッドも使用できます。通常、実際に使用される方法は 1 つだけです。その結果、この配列は将来の仕様の仕様で整数に変換される可能性があります。この変更に備えて、この配列の最初の要素のみを使用することを強くおすすめします。

AUTO_PLAY_SOUND_ON = 1: 音声をオンにしてページ読み込みを開始します。
AUTO_PLAY_SOUND_OFF = 2: デフォルトで音声オフの状態でページ読み込みを開始します。
CLICK_TO_PLAY = 3: サウンドオンでクリック時に開始します。
MOUSE_OVER = 4: マウスオーバーで音声をオンに切り替えます。
ENTER_SOUND_ON = 5: サウンドオンでビューポートに入ると開始します。
ENTER_SOUND_OFF = 6: デフォルトでサウンドをオフにしてビューポートに入ると開始。

delivery ×
ContentDelivery
Method
の配列
非対応 2.3
2.4
2.5


サポートされている配信方法(ストリーミング、プログレッシブなど)。指定しない場合は、すべてがサポートされています。
ストリーミング = 1;
プログレッシブ = 2;
pos × AdPosition BidRequest.AdSlot.slot_visibility 2.3
2.4
2.5


画面上の位置。
companionad × Banner オブジェクトの配列 BidRequest.Video.companion_slot 2.3
2.4
2.5


コンパニオン広告を利用できる場合、Banner オブジェクトの配列。
api × APIFramework オブジェクトの配列 BidRequest.AdSlot.excluded_attribute
/ MRAID_1_0
2.3
2.4
2.5


このインプレッションでサポートされている API フレームワークのリスト。明示的に指定されていない API は、サポートされていないとみなされます。
companiontype × CompanionType オブジェクトの配列 BidRequest.Video.companion_slot.creative_format 2.3
2.4
2.5


サポートされている VAST コンパニオン広告のタイプ。コンパニオン Banner オブジェクトが companionad 配列を通じて含まれている場合に推奨されます。
placement × VideoPlacementType BidRequest.Video.Placement

INSTREAM -> IN_STREAM_PLACEMENT
INTERSTITIAL -> FLOATING_PLACEMENT
IN_FEED -> IN_FEED_PLACEMENT IN_ARTICLE -> IN_ARTICLE_PLACEMENT
UNKNOWN_PLACEMENT -> UNDEFINED_VIDEO_PLACEMENT
AUDIO -> UNDEFINED_VIDEO_PLACEMENT
(未設定)-> IN_BANNER_PLACEMENT

2.5

インプレッションのプレースメント タイプ。

UNDEFINED_VIDEO_PLACEMENT: 動画プレースメントが定義されていません。デフォルト値。
IN_STREAM_PLACEMENT: コンシューマがリクエストしたストリーミング動画コンテンツの前、途中、後に再生されます。たとえば、プレロール、ミッドロール、ポストロールなどがあります。
IN_BANNER_PLACEMENT: 静的またはリッチメディアという別のフォーマットとは対照的に、バナースペースを利用する動画体験を提供するウェブバナー内に存在します。フォーマットは、ページ上に配信されるディスプレイ広告枠に依存します。
IN_ARTICLE_PLACEMENT: 記事コンテンツの段落と記事の間は、単独でブランド メッセージとして読み込まれ、動的に再生されます。
IN_FEED_PLACEMENT: インフィード - コンテンツ、ソーシャル、商品フィードに表示されます。
FLOATING_PLACEMENT: インタースティシャル、スライダー、フローティング。画面領域全体または一部をカバーしますが、表示中は常に画面上に表示されます(たとえば、スクロールして表示を解除することはできません)。フルスクリーンのインタースティシャル(モバイルなど)は、imp.instl フィールドでフローティング/スライダー ユニットと区別できます。

playbackend × PlaybackCessationMode 非対応 2.5 再生を終了するイベント。

オーディオ

このオブジェクトはオーディオ タイプのインプレッションを表します。項目の多くが最小限の実行トランザクションに必須ではないものの、必要に応じて細かく制御できるようになっています。OpenRTB のオーディオは通常、DAAST 規格に準拠していることを前提としています。そのため、コンパニオン広告の概念は、必要に応じてコンパニオン広告を定義する Banner オブジェクトの配列を含めることでサポートされています。Audio オブジェクトが Imp オブジェクトの下位に存在する場合、このインプレッションはオーディオ タイプのインプレッションとして提供されます。パブリッシャーの裁量により、同じインプレッションがバナー、動画、ネイティブとして表示される場合もあります(その場合も、これらのタイプのオブジェクトを Imp の下位オブジェクトとして含める必要があります)。ただし、インプレッションの入札単価は、指定されたタイプのいずれかに従う必要があります。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
mimes なし 文字列の配列 BidRequest.Video.allowed_video_formats、BidRequest.AdSlot.excluded_attribute / VPAID 2.4
2.5

サポートされているコンテンツの MIME タイプ(「audio/mp4」など)

OpenRTB 仕様で必須(1 個以上の要素)。

minduration なし int32 BidRequest.Video.min_ad_duration 2.4
2.5

動画広告の最小再生時間(秒)。

OpenRTB 仕様で推奨されます。

maxduration なし int32 BidRequest.Video.max_ad_duration 2.4
2.5

動画広告の最大再生時間(秒)。

OpenRTB 仕様で推奨されます。

protocols なし Protocol オブジェクトの配列。 BidRequest.Video.protocols 2.4
2.5

サポートされている動画入札レスポンス プロトコルの配列。 サポートされているプロトコルを少なくとも 1 つ指定する必要があります。

例:
DAAST_1_0 = 9;
DAAST_1_0_WRAPPER = 10;

startdelay なし int32 BidRequest.Video.videoad_start_delay

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

その他の値:
videoad_start_delay / 1,000

2.4
2.5

プレロール、ミッドロール、ポストロールの各広告の開始遅延時間を秒単位で示します。一般的な値については、列挙型 StartDelay をご覧ください。

OpenRTB 仕様で推奨されます。

sequence なし int32 サポート対象外 2.4
2.5
同じ入札リクエストで複数の広告インプレッションが割り当てられている場合、シーケンス番号を使って、複数のクリエイティブを組織的に配信できます。[デフォルト = 1]
battr なし CreativeAttribute オブジェクトの配列。 BidRequest.AdSlot.excluded_attribute 2.4
2.5

ブロックされているクリエイティブ属性
maxextended なし int32 サポート対象外 2.4
2.5

延長可能な動画広告の最大再生時間。空白または 0 の場合、拡張機能は使用できません。-1 の場合は延長が許可され、時間制限はありません。0 より大きい場合、値は maxduration 値を超える拡張プレイの秒数を表します。
minbitrate なし int32 サポート対象外 2.4
2.5

最小ビットレート(Kbps)。
maxbitrate なし int32 サポート対象外 2.4
2.5

最大ビットレート(Kbps)。
delivery なし ContentDeliveryMethod オブジェクトの配列。 サポート対象外 2.4
2.5

サポートされている配信方法(ストリーミング、プログレッシブなど)。指定しない場合は、すべてがサポートされています。

Streaming = 1、
PROGRESSIVE = 2;

companionad なし Banner オブジェクトの配列。 BidRequest.Video.companion_slot 2.4
2.5

コンパニオン広告がある場合、Banner オブジェクトの配列。
api なし APIFramework オブジェクトの配列。 BidRequest.AdSlot.excluded_attribute/MRAID_1_0 2.4
2.5

このインプレッションでサポートされている API フレームワークのリスト。明示的に指定されていない API は、サポートされていないとみなされます。
companiontype なし CompanionType オブジェクトの配列。 BidRequest.Video.companion_slot.creative_format 2.4
2.5

サポートされている DAAST コンパニオン広告タイプ。
maxseq なし int32 サポート対象外 2.4
2.5

連続配信広告内で再生できる広告の最大数。
feed なし フィードタイプ サポート対象外 2.4
2.5

音声フィードのタイプ。
stitched なし ブール値 サポート対象外 2.4
2.5

広告を音声コンテンツとともに合成するか、個別に配信するかを示します。0 は「いいえ」、1 は「はい」となります。
nvol なし VolumeNormalizationMode サポート対象外 2.4
2.5

ボリューム正規化モード。

ネイティブ

このオブジェクトはネイティブ タイプのインプレッションを表します。ネイティブ広告ユニットは、周囲のコンテンツ(Twitter や Facebook のスポンサー記事など)にシームレスに溶け込むことを目的としています。そのため、パブリッシャーがレンダリングをきめ細かく制御できるように、レスポンスは適切に構造化する必要があります。

Native 1.1 は OpenRTB 2.4 と OpenRTB 2.5 でサポートされています。

Native Subcommittee は、Native Ad Specification という OpenRTB のコンパニオン仕様を作成しました。ネイティブ広告ユニットのリクエスト パラメータとレスポンスのマークアップ構造を定義します。

このオブジェクトは、リクエスト パラメータを不透明な文字列として転送する手段を提供し、ネイティブ広告仕様の後継の下で特定のパラメータが別途進化できるようにします。同様に、配信される広告マークアップはその仕様に沿って構造化されます。NativeImp オブジェクトの下位に存在する場合、このインプレッションはネイティブ タイプのインプレッションとして提供されます。パブリッシャーの判断では、同じインプレッションをバナーや動画として表示することもでき、その場合は、それぞれ ImpBannerVideo のオブジェクトも配置されます。ただし、インプレッションの入札単価は、指定されたタイプのいずれかに従う必要があります。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
request なし 文字列 BidRequest.AdSlot.NativeAdテンプレート 2.3
2.4
2.5


ネイティブ広告の仕様に準拠したペイロードをリクエストします。

{request, request_native} のいずれか 1 つのみを使用する必要があります。

request_native なし NativeRequest BidRequest.AdSlot.NativeAdテンプレート 2.3
2.4
2.5


ネイティブ広告の仕様に準拠したペイロードをリクエストします。{request, request_native} のいずれか 1 つのみを使用する必要があります。これは Protobuf のシリアル化に適した代替フィールドです。
ver なし 文字列 OpenRTB 仕様で推奨されます。 2.3
2.4
2.5


リクエストに準拠するネイティブ広告の仕様の仕様。OpenRTB 仕様で推奨されます。
api APIFramework オブジェクトの配列。 BidRequest.AdSlot.excluded_attribute / MRAID_1_0 2.3
2.4
2.5


このインプレッションでサポートされている API フレームワークのリスト。明示的に指定されていない API は、サポートされていないとみなされます。
battr CreativeAttribute オブジェクトの配列。 BidRequest.AdSlot.excluded_attribute 2.3
2.4
2.5


ブロックされているクリエイティブ属性

ポンプ

このオブジェクトは、このインプレッションに関連する購入者と販売者の間の直接取引用のプライベート マーケットプレイス コンテナです。実際の取引は、Deal オブジェクトのコレクションで表されます。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
private_auction なし ブール値 BidRequest.AdSlot.only_deal_bids_accepted 2.3
2.4
2.5


直接取引オブジェクトに指定された座席に対するオークションの利用資格を示します。0 = すべての入札が承認され、1 = 指定された取引とその条件によって入札単価が制限されます。
deals なし Deal オブジェクトの配列。 BidRequest.AdSlot.MatchingAdData.DirectDeal 2.3
2.4
2.5


このインプレッションに適用される特定の取引を伝える Deal オブジェクトの配列。

取引

このオブジェクトは、購入者と販売者の間で事前に取引された特定の取引を構成します。Pmp コレクションがある場合、そのインプレッションはこの取引の条件下で使用可能になっています。

属性 常に合格 タイプ 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id 文字列 BidRequest.AdSlot.MatchingAdData.DirectDeal.direct_deal_id 2.3
2.4
2.5


直接取引の一意の識別子。OpenRTB 仕様で要求されています。
bidfloor × 倍精度 BidRequest.AdSlot.MatchingAdData.DirectDeal.fixed_cpm _micros *1,000,000 2.3
2.4
2.5


このインプレッションの最小入札単価。CPM で表されます。
bidfloorcur × 文字列 単一の通貨(付属の billing_id から取得) 2.3
2.4
2.5


ISO-4217 アルファ コードを使用して指定された通貨。Exchange で許可されている場合は、ビッダーが返す入札単価の通貨と異なる場合があります。default = "USD"
wseat × 文字列の配列 非対応 2.3
2.4
2.5


この取引への入札を許可された購入者のシート(広告主、代理店など)の許可リスト。シート ID と購入者の知識

参照する顧客は、ビッダーとエクスチェンジの間で調整を行う必要があります。省略した場合、シートの制限はありません。

wadomain × 文字列の配列 非対応 2.3
2.4
2.5


この取引への入札が許可された広告主のドメイン(例: Advertisers.com)の配列。省略した場合は、広告主様による制限を受けません。
at × オークション タイプ BidRequest.auction_type 2.3
2.4
2.5


入札リクエストの全体的なオークション タイプをオーバーライドします。ここで 1 はファーストプライス価格、2 はセカンドプライス価格プラス、3 は入札単価で渡される値が合意済みの取引価格となります。エクスチェンジによって、追加のオークション タイプを定義できます。
ext × DealExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB/Protobuf の場合、[com.google.doubleclick.deal] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合、取引メッセージの ext フィールドを使用してアクセスします。

DealExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
deal_type × 列挙型 DealType BidRequest.AdSlot.MatchingAdData.DirectDeal.deal_type 取引のタイプ。認定バイヤー ポリシーのオーバーライドは、プログラマティック保証型取引と優先取引のすべての入札単価に適用され、他の取引タイプの入札単価には適用されません。

UNKNOWN_DEAL_TYPE = 0; デフォルト。

PREFERRED_DEAL = 1; 入札単価は固定価格で、公開オークションの前に評価されます。ビッダーは、入札リクエストに含まれていても優先取引で入札する必要はありません。詳しくは、こちらの記事をご覧ください。

PRIVATE_AUCTION = 2; 最小価格を設定した特定の購入者リストのプライベート オークションに入札します。詳しくは、こちらの記事をご覧ください。

PROGRAMMATIC_GUARANTEED = 3; 入札単価は固定価格で、公開オークションの前に評価されます。ビッダーは、入札リクエストで指定されている場合にプログラマティック保証型取引で入札することが求められています。これは、特定の取引で合意されたインプレッション数を確実に配信できるようにするため、must_bid フィールドが true になっているためです。詳しくは、こちらの記事をご覧ください。

AUCTION_PACKAGE = 4; 取引 ID は、指定したターゲティング条件に一致する公開オークション広告枠のコレクションの識別子です。詳しくは、こちらの記事をご覧ください。

must_bid × ブール値 BidRequest.AdSlot.MatchingAdData.DirectDeal.must_bid このフィールドは、プログラマティック保証型取引にのみ適用されます。このフィールドが false の場合、インプレッションに対する入札をスキップできます。true の場合、購入者はこのインプレッション機会にこの取引に入札する必要があります。このフィールドは、JSON 転送形式で常に明示的に入力されます。デフォルト = true。
publisher_blocks_overridden × ブール値 BidRequest.AdSlot.MatchingAdData.DirectDeal.publisher_blocks_overridden パブリッシャーがこの取引をブロック対象から除外したかどうか。 この設定は、認定バイヤー ポリシーや広告レビュー センターによる決定の内容より優先されます。詳しくは、こちらの記事をご覧ください。
creative_source × 列挙型 CreativeSourceType BidRequest.AdSlot.MatchingAdData.DirectDeal.creative_source 試験運用版フィールド。変更される可能性があります。クリエイティブのホストを宣言する列挙型。プログラマティック保証型取引にのみ入力されます。現在、このフィールドは CREATIVE_SOURCE_ADVERTISER でのみ設定する必要があります。

CREATIVE_SOURCE_UNKNOWN = 0;

CREATIVE_SOURCE_ADVERTISER = 1; (デフォルト) クリエイティブは広告主によってホストされます。したがって、ビッダーは入札レスポンスでクリエイティブを提供する必要があります。

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

サイト

このオブジェクトは、広告でサポートされるコンテンツがブラウザ以外のアプリケーションではなくウェブサイトである場合は、含める必要があります。入札リクエストに Site オブジェクトと App オブジェクトの両方を含めることはできません。少なくともサイト ID またはページ URL を指定することは有用ですが、必須ではありません。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 サポート対象外 2.3
2.4
2.5


エクスチェンジのサイト ID。OpenRTB 仕様で推奨されます。
name なし 文字列 サポート対象外 2.3
2.4
2.5


サイト名(パブリッシャーの要請に応じてマスキングされる場合があります)
domain なし 文字列 サポート対象外 2.3
2.4
2.5


広告主のドメインによるブロックに使用されるサイトのドメイン。例: 「foo.com」。
cat なし 文字列の配列 サポート対象外 2.3
2.4
2.5


サイトの IAB コンテンツ カテゴリの配列です。列挙型 ContentCategory を参照してください。
sectioncat なし 文字列の配列 サポート対象外 2.3
2.4
2.5


サイトの現在のセクションを説明する IAB コンテンツ カテゴリの配列。列挙型 ContentCategory を参照してください。
pagecat なし 文字列の配列 サポート対象外 2.3
2.4
2.5


サイトの現在のページまたはビューを記述する IAB コンテンツ カテゴリの配列。列挙型 ContentCategory を参照してください。
page なし 文字列 BidRequest .url 2.3
2.4
2.5


インプレッションが表示されるページの URL
privacypolicy なし ブール値 サポート対象外 2.3
2.4
2.5


サイトでプライバシー ポリシーが設定されているかどうかを示します。0 は「いいえ」、1 は「はい」となります。
ref なし 文字列 サポート対象外 2.3
2.4
2.5


現在のページへの移動につながった参照元 URL。
search なし 文字列 サポート対象外 2.3
2.4
2.5


現在のページに移動する検索文字列。
publisher なし Publisher オブジェクト 入札リクエスト 2.3
2.4
2.5


サイトの Publisher オブジェクトに関する詳細。
content なし Content オブジェクト 入札リクエスト 2.3
2.4
2.5


サイト内の Content に関する詳細。
keywords なし 文字列 サポート対象外 2.3
2.4
2.5


このサイトに関するカンマ区切りのリスト。注: OpenRTB 2.2 では代替実装として文字列の配列が許可されていましたが、2.3 以降で修正されました。再び CSV コンテンツで単一の文字列になりました。代替表現を採用した一部の OpenRTB 2.2 エクスチェンジとの互換性は、JSON のカスタム処理を必要とする場合があります。
mobile なし ブール値 BidRequest.Mobile.is_mobile_web_optimized 2.3
2.4
2.5


サイトがモバイル デバイスで表示されるときにレイアウトを最適化するようプログラムされているかどうかを示します(0 = いいえ、1 = あり)。
ext × SiteExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB / Protobuf の場合、[com.google.doubleclick.site] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合は、サイト メッセージの ext フィールドを使用してアクセスします。

SiteExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
amp × 列挙型 AmpPage BidRequest.AdSlot
.is_amp_page

AMP ページかどうか。不明な場合は省略します。

DIALECT_HTML = 0。これは AMP ページではありません。

DIALECT_HTML_AMP = 1。これは AMP ページです。

page_visibility × 列挙型 VisibilityState 入札リクエスト.page_visibility

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

VISIBILITY_STATE_UNKNOWN = 0

VISIBILITY_STATE_VISIBLE = 1; ページは少なくとも部分的に表示されている。 たとえば、最小化されていないウィンドウの [フォアグラウンド] タブに表示されます。

VISIBILITY_STATE_HIDDEN = 2; ページがユーザーに表示されません。 たとえば、ページがバックグラウンドのブラウザタブにある場合や、最小化されたウィンドウに表示されている場合などです。

is_semi_transparent_request × ブール値 入札リクエスト.is_Semi_transparency_request リクエストで半匿名が使用されていることを示します。つまり、リクエスト URL の短縮バージョンのみが提供されます。この決定はニュース メディアが決定します。support.google.com/admanager/answer/4584891 をご覧ください。

アプリ

このオブジェクトは、広告をサポートするコンテンツがウェブサイトではなく、ブラウザ以外のアプリケーション(通常はモバイル)である場合に含める必要があります。入札リクエストに App オブジェクトと Site オブジェクトの両方を含めることはできません。少なくとも、アプリ ID またはバンドルを指定することは有用ですが、必須ではありません。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 サポート対象外 2.3
2.4
2.5


エクスチェンジのアプリケーション ID。OpenRTB 仕様で推奨されます。
name なし 文字列 BidRequest.Mobile.app_name 2.3
2.4
2.5


アプリケーション名(パブリッシャーの要求に応じてエイリアス化可能)
domain なし 文字列 サポート対象外 2.3
2.4
2.5
広告主のドメインによるブロックに使用されるアプリケーションのドメイン。例: "mygame.foo.com"。
cat なし 文字列の配列 BidRequest.Mobile.app_category_ids 2.3
2.4
2.5


注: このフィールドの値は編集されました。アプリの IAB コンテンツ カテゴリの配列です。列挙型 ContentCategory を参照してください。
sectioncat なし 文字列の配列 サポート対象外 2.3
2.4
2.5
アプリの現在のセクションを説明する IAB コンテンツ カテゴリの配列です。列挙型 ContentCategory を参照してください。
pagecat なし 文字列の配列 サポート対象外 2.3
2.4
2.5
アプリの現在のページまたはビューを表す IAB コンテンツ カテゴリの配列です。列挙型 ContentCategory を参照してください。
ver なし 文字列 サポート対象外 2.3
2.4
2.5
アプリのバージョン。
bundle なし 文字列 BidRequest.Mobile.app_id 2.3
2.4
2.5


アプリに固有の、エクスチェンジとは無関係な、プラットフォーム固有のアプリケーション識別子。Android の場合は、バンドルまたはパッケージ名(com.foo.mygame など)にする必要があります。iOS では、数値 ID です。
privacypolicy なし ブール値 サポート対象外 2.3
2.4
2.5
サイトでプライバシー ポリシーが設定されているかどうかを示します。0 は「いいえ」、1 は「はい」となります。
paid なし ブール値 サポート対象外 2.3
2.4
2.5
0 = 無料、1 = 有料バージョン。
publisher なし Publisher オブジェクト 入札リクエスト 2.3
2.4
2.5


アプリの Publisher オブジェクトに関する詳細。
content なし Content オブジェクト 入札リクエスト 2.3
2.4
2.5


アプリ内の Content に関する詳細。
keywords なし 文字列 サポート対象外 2.3
2.4
2.5


このアプリに関するキーワードのカンマ区切りのリスト。注: OpenRTB 2.2 では代替配列として文字列の配列が許可されていましたが、2.3 以降で修正されました。再び CSV コンテンツで単一の文字列となります。代替表現を採用した一部の OpenRTB 2.2 エクスチェンジとの互換性は、JSON のカスタム処理を必要とする場合があります。
storeurl なし 文字列 BidRequest .url 2.3
2.4
2.5


インストールされたアプリのアプリストアの URL。
ext × AppExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB / Protobuf の場合、[com.google.doubleclick.app] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合は、アプリ メッセージの ext フィールドを使用してアクセスします。

AppExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
installed_sdk × インストール済み SDK BidRequest.Mobile.installed_sdk パブリッシャーのアプリにインストールされた SDK の識別情報と情報(多くの場合、ビッダーの SDK であるため)。
インストール済み SDK
id 文字列 BidRequest.Mobile.InstalledSdk.id インストールされている SDK の識別子。
sdk_version バージョン BidRequest.Mobile.InstalledSdk.sdk_version インストールされている SDK のバージョン。
adapter_version バージョン BidRequest.Mobile.InstalledSdk.adapter_version インストールされている SDK と通信するアダプタのバージョン。
バージョン
major × int32 非対応 デフォルトは -1 です。
minor × int32 非対応 デフォルトは -1 です。
micro × int32 非対応 デフォルトは -1 です。

パブリッシャー

このオブジェクトは、広告が表示されるメディアのパブリッシャーを表します。パブリッシャーは通常、OpenRTB トランザクションの販売者です。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 BidRequest .publisher_id 2.3
2.4
2.5


ウェブ プロパティ コードのパブリッシャー コードのサフィックスで定義されたエクスチェンジ固有のパブリッシャー ID。たとえば、pub-123 はウェブ プロパティ コード ca-pub-123 のパブリッシャー コードです。
name なし 文字列 サポート対象外 2.3
2.4
2.5
出版社名(出版社の要請に応じてエイリアス化される場合があります)
cat なし 文字列の配列 サポート対象外 2.3
2.4
2.5
アプリの IAB コンテンツ カテゴリの配列です。列挙型 ContentCategory を参照してください。
domain なし 文字列 サポート対象外 2.3
2.4
2.5
パブリッシャーの最上位のドメイン(「publisher.com」など)
ext × PublisherExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB / Protobuf の場合、[com.google.doubleclick.publisher] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合は、パブリッシャー メッセージの ext フィールドを使用してアクセスします。

パブリッシャー エクステンション

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
country × 文字列 入札リクエスト
.publisher_country
パブリッシャーの請求先住所の国。geo_criteria_id で検出されたユーザーの国や、ウェブサイトのホスティング国とは異なる場合があります。国コードの全リストもご覧ください。
host_publisher_id × 文字列 入札リクエスト.host_publisher_id ホスト パブリッシャーの ID。入力されている場合は、ホスト パブリッシャーが収益分配に参加し、この ID を使用して ads.txt を承認できることを示します。

コンテンツ

このオブジェクトは、インプレッションが表示されるコンテンツ(シンジケート コンテンツまたはシンジケートされていないコンテンツ)を記述します。このオブジェクトは、シンジケート コンテンツにインプレッションが含まれていて、必ずしもパブリッシャーの一般的なコンテンツと一致しない場合に役立つことがあります。シンジケーションメソッドの結果として、コンテンツが実行されているページについて、エクスチェンジが把握している場合もあります。たとえば、不明なウェブ プロパティやデバイスの iframe に埋め込まれた動画のインプレッションなどです。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 サポート対象外 2.3
2.4
2.5
コンテンツを一意に識別する ID。
episode なし int32 サポート対象外 2.3
2.4
2.5
コンテンツのエピソード番号(通常は動画コンテンツに適用されます)。
title なし 文字列 サポート対象外 2.3
2.4
2.5


コンテンツのタイトル。動画の例: 「検索委員会」(テレビ)、「ニュー 希望」(映画)、「エンドゲーム」(ウェブ用に作成)。動画以外の例: 「Antarctic Glacier Is Melting So fasting」(南極氷河がすぐに溶け込む理由)(時間の雑誌記事)。
series なし 文字列 サポート対象外 2.3
2.4
2.5
コンテンツ シリーズ。動画の例: 「The Office」(テレビ)、「Star Wars」(映画)、「Arby 'N' The Leader」(ウェブ制作)

動画以外の例: 「エコエコ」(Time Magazine ブログ)

season なし 文字列 サポート対象外 2.3
2.4
2.5
コンテンツのシーズン。通常は動画コンテンツ用です(「シーズン 3」など)。
artist なし 文字列 サポート対象外 2.3
2.4
2.5
コンテンツのクレジットが含まれるアーティスト
genre なし 文字列 サポート対象外 2.3
2.4
2.5
コンテンツを説明するのに最適なジャンル(ロック、ポップなど)。
album なし 文字列 サポート対象外 2.3
2.4
2.5
コンテンツが属するアルバム(通常はオーディオ用)。
isrc なし 文字列 サポート対象外 2.3
2.4
2.5
ISO-3901 に準拠した国際標準記録コード。
url なし 文字列 (App.content のみ)BidRequest.url 2.3
2.4
2.5


バイサイドのコンテキスト化またはレビューのためのコンテンツの URL。
cat なし 文字列の配列 サポート対象外 2.3
2.4
2.5
コンテンツを表す IAB コンテンツ カテゴリの配列です。列挙型 ContentCategory を参照してください。
prodq なし 本番環境の品質 サポート対象外 2.4
2.5
制作品質
keywords なし サポート対象外 2.3
2.4
2.5


コンテンツを説明するキーワードのカンマ区切りのリスト。

注: OpenRTB 2.2 では代替配列として文字列の配列が許可されていましたが、2.3 以降で修正されました。もう一度 CSV コンテンツが含まれる単一の文字列になりました。代替表現を採用した一部の OpenRTB 2.2 エクスチェンジとの互換性は、JSON のカスタム処理を必要とする場合があります。

contentrating なし 文字列 BidRequest.detected_content_label 39:
"DV_G"、40: "DV_PG"、41: "DV_T"、42: "DV_MA"、43:
"DV_UNRATED"
2.3
2.4
2.5


注: このフィールドの値は編集されました。コンテンツのレーティング(例: MPAA)。
userrating なし 文字列 (App.content のみ)
BidRequest.Mobile.app_rating
2.3
2.4
2.5


コンテンツに対するユーザーの評価(星の数、高評価数など)。
context なし ContentContext サポート対象外 2.3
2.4
2.5


コンテンツの種類(ゲーム、動画、テキストなど)。
context_22 なし 文字列 サポート対象外 2.3
2.4
2.5


OpenRTB 2.2 以前の互換性。2.3 以上のコンテキストを使用してください。
livestream × ブール値 BidRequest.Video.is_livestream 2.3
2.4
2.5


0 = ライブではない、1 = コンテンツが有効である(ストリーム、ライブブログなど)。
sourcerelationship なし ブール値 サポート対象外 2.3
2.4
2.5


0 = 間接、1 = 直接。
producer なし 文字列 BidRequest.Video 2.3
2.4
2.5


コンテンツ プロデューサーの詳細。
len なし int32 BidRequest.Video.ContentAttributes.duration_seconds 2.3
2.4
2.5


コンテンツの長さ(秒単位)。動画またはオーディオに適しています。
qagmediarating なし QAGMediaRating サポート対象外 2.3
2.4
2.5


QAG ガイドラインに基づくメディア レーティング。
embeddable なし ブール値 サポート対象外 2.3
2.4
2.5


コンテンツが埋め込み可能かどうか(埋め込み可能な動画プレーヤーなど)を示す指標(0 = いいえ、1 = あり)。
language なし 文字列 BidRequest.detected_language 2.3
2.4
2.5


ISO-639-1-alpha-2 を使用したコンテンツの言語。

プロデューサー

このオブジェクトにより、広告が表示されるコンテンツのプロデューサーが定義されます。これは特に、コンテンツがシンジケートされていて、異なるパブリッシャーを介して配信できるため、プロデューサーとパブリッシャーが必ずしも同じエンティティではない場合に便利です。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 サポート対象外 2.3
2.4
2.5


コンテンツ プロデューサーまたはオリジン ID。コンテンツがシンジケートされ、埋め込みタグを使用してサイトに投稿される場合に便利です。
name なし 文字列 サポート対象外 2.3
2.4
2.5


コンテンツ プロデューサーまたはオリジンの名前(「Warner Bros」など)。
cat なし 文字列の配列 サポート対象外 2.3
2.4
2.5


コンテンツ プロデューサーを記述する IAB コンテンツ カテゴリの配列。列挙型 ContentCategory を参照してください。
domain なし 文字列 BidRequest.Video.description_url 2.3
2.4
2.5


コンテンツ プロデューサーの最上位のドメイン(例: Producer.com)。

デバイス

このオブジェクトは、ユーザーが操作しているデバイスに関する情報を提供します。デバイス情報には、ハードウェア、プラットフォーム、位置情報、携帯通信会社のデータが含まれます。モバイル ハンドセット、デスクトップ パソコン、セットトップ ボックス、その他のデジタル デバイスを指しています。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
dnt なし ブール値 サポートされていません。Cookie ガイド、google_error=1 をご覧ください。 2.3
2.4
2.5


ブラウザでヘッダーに設定されている標準の「トラッキング拒否」オプション。0 はトラッキングの制限なし、1 はトラッキングしない。OpenRTB 仕様で推奨されます。
ua なし 文字列 BidRequest.user_agent 2.3
2.4
2.5


ブラウザのユーザー エージェント文字列。OpenRTB 仕様で推奨されます。
ip なし 文字列 BidRequest.ip(AdX は最初の 3 オクテットで切り捨てられます。)
OpenRTB は「X.X.X.0」です
2.3
2.4
2.5


デバイスに最も近い IPv4 アドレス。OpenRTB 仕様で推奨されます
geo なし Geo オブジェクト 入札リクエスト 2.3
2.4
2.5


デバイスの位置情報。Geo オブジェクトで定義されたユーザーの現在の位置情報と見なされます。

OpenRTB 仕様で推奨されます。

didsha1 なし 文字列 サポート対象外 2.3
2.4
2.5


ハードウェア デバイス ID(IMEI など)。SHA1 でハッシュ化されます。
didmd5 なし 文字列 サポート対象外 2.3
2.4
2.5


ハードウェア デバイス ID(IMEI など)。MD5 でハッシュ化されます。
dpidsha1 なし 文字列 サポート対象外 2.3
2.4
2.5


プラットフォームのデバイス ID(Android ID など)。SHA1 でハッシュされます。
dpidmd5 なし 文字列 BidRequest.Mobile.hashed_idfa -
AdX はバイナリ、OpenRTB は Base16(16 進数の小文字)
ifa のハッシュ化バージョンです。
モバイル SDK のバージョンによっては、dpidmd5 または <a class="ph-2-0"> が使用可能かどうか
2.3
2.4
2.5


プラットフォーム デバイス ID(Android ID など)。MD5 でハッシュされます。
ipv6 なし 文字列 BidRequest.ip

- AdX では最初の 6 オクテットに従って切り捨てられます。OpenRTB は「X:X:X:::::」です。

2.3
2.4
2.5


デバイスに最も近い IPv6 アドレス。
carrier なし 文字列 BidRequest.Device.carrier_id
ID は、認定バイヤー プロトコルと同じ条件 ID になります。携帯通信会社のリストをご覧ください。
2.3
2.4
2.5


運送業者または ISP(「VERIZON」など)。エクスチェンジがキュレートされた文字列名を使用して、事前にビッダーに公開する必要があります。
language なし 文字列 サポート対象外 2.3
2.4
2.5


ISO-639-1-alpha-2 を使用したブラウザの言語
make なし 文字列 BidRequest.Device.brand 2.3
2.4
2.5


デバイスのメーカー(「Apple」など)。
model なし 文字列 BidRequest.Device.model 2.3
2.4
2.5


デバイスのモデル(「iPhone」など)
os なし 文字列 BidRequest.Device.platform 2.3
2.4
2.5


デバイスのオペレーティング システム(「iOS」など)
osv なし 文字列 BidRequest.Device.os_version 2.3
2.4
2.5


デバイスのオペレーティング システムのバージョン
hwv なし 文字列 BidRequest.Device.hardware_version 2.3
2.4
2.5


デバイスのハードウェア バージョン(例: iPhone 5S の場合は「5S」)
w なし int32 BidRequest.Device.screen_width 2.3
2.4
2.5


画面の物理幅(ピクセル単位)です。
h なし int32 BidRequest.Device.screen_height 2.3
2.4
2.5


画面の物理的な高さ(ピクセル単位)。
ppi なし int32 サポート対象外 2.3
2.4
2.5


画面サイズ(線形インチあたりのピクセル数)。
pxratio なし 倍精度 BidRequest.Device.screen_pixel_ratio_millis/1,000 2.3
2.4
2.5


デバイス非依存ピクセルに対する物理ピクセルの比率。
js なし ブール値 サポート対象外 2.3
2.4
2.5


JavaScript のサポート。0 = いいえ、1 = あり。
geofetch なし ブール値 サポート対象外 2.4
2.5

バナー内で実行している JavaScript コードで Geolocation API を利用できるかどうかを指定します(0 = いいえ、1 = あり)。
connectiontype なし ConnectionType サポート対象外 2.3
2.4
2.5


ネットワーク接続の種類
devicetype なし DeviceType BidRequest.Device.device_type 2.3
2.4
2.5


デバイスの一般的なタイプ。
flashver なし 文字列 サポート対象外 2.3
2.4
2.5


ブラウザでサポートされている Flash のバージョン。
ifa なし 文字列 BidRequest .Mobile.billing_id -
AdX はバイナリです。OpenRTB は 36 文字 UUID(Android ID: すべて小文字、IDFA: すべて大文字)です。
ifa は Android ID または Apple の IDFA、モバイル SDK のバージョンによっては dpidmd5 または
を使用できます。
2.3
2.4
2.5


広告主様が ID の用途として承認している(ハッシュ化されていないなど)
macsha1 なし 文字列 サポート対象外 2.3
2.4
2.5


デバイスの MAC アドレス。SHA1 でハッシュされます。
macmd5 なし 文字列 サポート対象外 2.3
2.4
2.5


デバイスの MAC アドレス。MD5 でハッシュ化されます。
lmt なし ブール値 BidRequest.Device.limit_ad_tracking 2.3
2.4
2.5


「広告のトラッキングを制限する」シグナル(例: iOS、Android)に関して、0 = トラッキングの制限なし、1 = 商業的なガイドラインに沿ってトラッキングを制限する必要がある。

OpenRTB 仕様で推奨されます。

mccmnc なし 文字列 サポート対象外 2.5 携帯通信会社の MCC-MNC コードを連結したもの(例: 「310-005」は米国の Verizon Wireless CDMA を示します)。詳細な例については、https://en.wikipedia.org/wiki/Mobile_country_code をご覧ください。解析の曖昧さを解消するには、MCC と MNC の部分の間にダッシュが必要です。
ext × DeviceExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB/Protobuf の場合、[com.google.doubleclick.device] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合は、デバイス メッセージの ext フィールドを使用してアクセスします。

DeviceExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
session_id × 文字列 BidRequest.session_id CTV/OTT デバイス上の有効期間が短いユーザー セッションで、最大セッション時間は 6 時間です。 広告のパーソナライズに session_id の使用は許可されません。 session_id は、フリークエンシー キャップ、競合相手の除外、または関連する目的にのみ使用できます。このフィールドには、ウェブセーフな base64 アルファベットが入力されます。
atts × int32 BidRequest.Device.app_tracking_authorization_status (iOS のみ)アプリのアプリ トラッキング権限のステータスを示す整数。0 = 未決定 1 = 制限付き 2 = 拒否 3 = 承認済み。この値は ATTrackingManager から取得され、そのまま提供されます。iOS のアプリ トラッキング認証ステータスの詳細については、こちらの記事をご覧ください。
user_agent_data × UserAgent オブジェクト BidRequest.user_agent_data ユーザー エージェント情報。
UserAgent

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

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

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

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
brand × 文字列 BidRequest.user_agent_data.brand ブランド識別子(「Chrome」や「Windows」など)。
version × 文字列 BidRequest.user_agent_data.version バージョン。必要に応じてコンポーネントに分割します(例: {"85", "1"} = v85.1)。

Geo

このオブジェクトは、地理的位置を指定するためのさまざまなメソッドをカプセル化します。Device オブジェクト配属の場合は、デバイスの位置を示し、ユーザーの現在位置として解釈することもできます。User オブジェクトに従属する場合、これはユーザーのホームベースの場所を示します(たとえば、ユーザーの現在地ではありません)。lat/lon 属性は、型属性に示されている精度に適合する場合にのみ渡す必要があります。たとえば、郵便番号などの地域領域の重心は渡さないでください。

認定バイヤーのリアルタイム ビッダー プロトコルについては、細かい位置情報は、認定バイヤーの Hyperlocal オブジェクトに適用される制約と同じ制約を受ける必要があります。すべてのリクエストにこの情報があるわけではなく、lat / lon は領域の任意の地点(必ずしも中心ではない)を表し、その面積は人口密度に反比例します。ターゲティングには十分ですが、個々のトラッキングには適していません。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
lat なし 倍精度 BidRequest.[encrypted_]hyperlocal_set.
center_point.latitude
2.3
2.4
2.5


緯度は -90.0 ~+90.0 で、負は南です。
lon なし 倍精度 BidRequest.[encrypted_]hyperlocal_set.center_point.longitude 2.3
2.4
2.5


経度は -180.0 ~+180.0 で、マイナスは西です。
country なし 文字列 BidRequest.geo_criteria_id(geo-table.csv を使用) 2.3
2.4
2.5


ISO-3166-1 Alpha-3 を使用する国。
region なし 文字列 BidRequest.geo_criteria_id(geo-table.csv を使用) 2.3
2.4
2.5


ISO-3166-2 を使用した地域コード。米国の場合は 2 文字の州コード。
regionfips104 なし 文字列 2.3
2.4
2.5


FIPS 10-4 表記を使用した国の地域。OpenRTB はこの属性をサポートしていますが、2008 年に NIST によって取り消されました。
metro なし 文字列 BidRequest.geo_criteria_id(geo-table.csv、cities-dma-regions.csv を使用) 2.3
2.4
2.5


Google 大都市圏コード(Nielsen の DMA に類似しているわけではありません)。

コードへのリンクについては、地域ターゲティングのページをご覧ください。

city なし 文字列 BidRequest.geo_criteria_id(geo-table.csv を使用) 2.3
2.4
2.5


国際連合の貿易、運輸に関する国家コードを使用している都市の形式。"city": "San Antonio" コードへのリンクについては、付録 A をご覧ください。
zip なし 文字列 BidRequest.postal_code
BidRequest.postal_code_Prefix
2.3
2.4
2.5


郵便番号。
type なし ロケーション タイプ 2.3
2.4
2.5


位置情報のソース。lat/lon を渡すときに推奨されます。
accuracy なし int32 サポート対象外 2.4
2.5

メートル法での推定位置情報の精度(緯度/経度を指定し、デバイスの位置情報サービスから取得する場合に使用します(例: タイプ = 1)。これはデバイスから報告される精度です。正確な解釈については、OS 固有のドキュメント(Android、iOS など)をご覧ください。
lastfix なし int32 サポート対象外 2.4
2.5

この位置情報の修正が確定してからの経過秒数。

デバイスは、複数の取得にわたって位置情報データをキャッシュに保存する場合があります。この値は、実際の修正が行われた時点の値であることが理想的です。

ipservice なし LocationService サポート対象外 2.4
2.5

該当する場合、IP アドレスから位置情報を判断するために使用されるサービスまたはプロバイダ(たとえば、type = 2)。
utcoffset なし int32 BidRequest.timezone_offset 2.3
2.4
2.5


UTC からのローカル時間(+/- 分)。

ユーザー

このオブジェクトには、デバイスのユーザー(既知のオーディエンスなど)について既知の情報または派生した情報が含まれます。ユーザー ID はエクスチェンジ アーティファクトであり、ローテーションやその他のプライバシー ポリシーの対象となる場合があります。ただし、このユーザー ID は、フリークエンシー キャップとリターゲティングのベースとして合理的に機能するのに十分な長さである必要があります。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 BidRequest.[restricted_usage_]google_user_id 2.3
2.4
2.5


ユーザーの Exchange 固有の ID。id または buyerid のうち少なくとも 1 つが推奨されます。
buyeruid なし 文字列 BidRequest[restricted_usage_]Hosted_match_data - AdX はバイナリです。OpenRTB は websafe base64 です(パディングなし) 2.3
2.4
2.5


購入者のエクスチェンジによってマッピングされた、ユーザー固有の購入者 ID。 buyerid または id のうち少なくとも 1 つが推奨されます。
gender なし 文字列 サポート対象外 2.3
2.4
2.5


性別: "M" 男性、"F" 女性、"O" その他。(Null は不明)
keywords なし 文字列 サポート対象外 2.3
2.4
2.5


キーワード、興味 / 関心、インテントのカンマ区切りのリスト。注: OpenRTB 2.2 では代替実装として文字列の配列が許可されていましたが、2.3 以降で修正されました。再び CSV コンテンツで単一の文字列になりました。代替表現を採用した一部の OpenRTB 2.2 エクスチェンジとの互換性は、JSON のカスタム処理を必要とする場合があります。
customdata なし 文字列 BidRequest[restricted_usage_]Hosted_match_data - AdX はバイナリです。OpenRTB は websafe base64 です(パディングなし) 2.3
2.4
2.5


エクスチェンジの Cookie に保存されているビッダー データを渡すためのオプション機能。文字列は、Base85 の Cookie セーフ文字で、任意の形式にする必要があります。エスケープ処理された引用符を使用するには、適切な JSON エンコードを使用する必要があります。
geo なし Geo オブジェクト サポート対象外 2.3
2.4
2.5


Geo オブジェクトで定義された、ユーザーのホームベースの場所。必ずしも現在地とは限りません。
data なし Data オブジェクトの配列。 BidRequest.detected_vertical 2.3
2.4
2.5


注: このフィールドの値は編集されました。追加のコンテキスト データ。各 Data オブジェクトは、異なるデータソースを表します。

segment.id は、エクスチェンジが検出したページのカテゴリを参照します。

segment.value は検出された垂直方向の重みを表します。重みが大きいほど、検出された垂直方向の関連性が高くなります。

ext × UserExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB/Protobuf の場合、[com.google.doubleclick.user] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合は、ユーザー メッセージの ext フィールドを使用してアクセスします。

ユーザー拡張

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
consented_providers_settings × ConsentedProvidersSettings オブジェクト BidRequest.AdSlot.consented_providers_settings EEA ユーザーが Google の EU ユーザーの同意ポリシーに従って広告のパーソナライズに個人データを使用することに同意すると、Google が表明した広告テクノロジー プロバイダに関する情報。このフィールドは、RegsExt.gdpr が true の場合にのみ入力されます。
consent × 文字列 BidRequest.AdSlot.ConsentedProvidersSettings.tcf_consent_string ニュース メディアの IAB Consent Management Platform(CMP)から取得した、ウェブセーフな IAB 透明性と同意に関するフレームワーク(TCF)の v2 同意文字列。文字列の構造は IAB TCF v2 に定義されています。パブリッシャーが TCF v2 の CMP と統合している場合にこのフィールドが入力されます。また、CMP では、GDPR がこの広告リクエストに適用され、有効な同意文字列を提供していることが示されています。Google TCF v2 の統合について詳しくは、こちらの記事をご覧ください。

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

eids × ExtendedId オブジェクトの配列。 BidRequest.AdSlot.secure_signals パブリッシャーが選択したセキュア シグナルを渡すために使用される標準の拡張機能。
ConsentedProviderSettings

EEA ユーザーが Google の EU ユーザーの同意ポリシーに従って広告のパーソナライズに個人データを使用することに同意すると、Google が表明した広告テクノロジー プロバイダに関する情報。このフィールドは、RegsExt.gdpr が true の場合にのみ入力されます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
consented_providers × int64 の配列 BidRequest.AdSlot.consented_providers EEA ユーザーが Google に法的に有効であると表明している広告技術プロバイダ(ATP)に対応する ID のセット。1)法的に義務付けられている場合に Cookie またはその他のローカル ストレージを使用すること、2)Google の EU ユーザーの同意ポリシーに従って ATP で広告をパーソナライズするために個人データを収集、共有、使用すること。

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

ATP ID と ATP 名のマッピングは provider.csv に投稿されています。

拡張 ID

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

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
source × 文字列 BidRequest.AdSlot.SecureSignal.source シグナルの送信元(プロバイダ)。
uids × 1 つの ExtendedIdUid オブジェクトを含む配列 なし セキュア シグナル
ExtendedIdUid
属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
id × 文字列 BidRequest.AdSlot.SecureSignal.data セキュア シグナル

データ

data オブジェクトと segment オブジェクトを使用すると、追加のコンテキスト データを指定できます。このデータは、エクスチェンジ自体またはサードパーティ プロバイダ(id フィールドで指定されているソース)のものです。入札リクエストでは、複数のプロバイダのデータ オブジェクトを組み合わせることができます。使用中のデータ プロバイダは、エクスチェンジによって事前にビッダーに公開する必要があります。

検出されたカテゴリを購入者に送信するために使用します。Open Bidding の場合、パブリッシャーから購入者に Key-Value ペアを送信する際にも使用されます。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 サポート対象 2.3
2.4
2.5


データ プロバイダの Exchange 固有の ID。
name なし 文字列 サポート対象 2.3
2.4
2.5


データ プロバイダのエクスチェンジ名。
segment Segment オブジェクトの配列。 サポート対象 2.3
2.4
2.5


実際のデータ値を含む Segment オブジェクトの配列。

分類して表示

data オブジェクトと segment オブジェクトを使用すると、追加のコンテキスト データを指定できます。このデータは、エクスチェンジ自体またはサードパーティ プロバイダ(id フィールドで指定されているソース)のものです。入札リクエストでは、複数のプロバイダの Data オブジェクトを組み合わせることができます。使用中のデータ プロバイダは、エクスチェンジによって事前にビッダーに公開されている必要があります。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id なし 文字列 サポート対象 2.3
2.4
2.5


データ プロバイダに固有のデータ セグメントの ID。
name なし 文字列 サポート対象 2.3
2.4
2.5


データ プロバイダに固有のデータ セグメントの名前。
value 文字列 サポート対象 2.3
2.4
2.5


データ セグメント値の文字列表現。

登録

このオブジェクトには、リクエストに適用される法的、政府、または業界の規制が含まれています。coppa オプションは、リクエストが米国児童オンライン プライバシー保護法(COPPA)に関する米国連邦取引委員会の規制の対象となるかどうかを示します。詳細については、セクション 7.1 をご覧ください。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
coppa なし 文字列 BidRequest.user_data_treatment / TAG_FOR_CHILD_DIRECTED_TREATMENT 2.3
2.4
2.5


このリクエストが USA FTC によって確立された COPPA 規制の対象かどうかを示すオプション(0 = いいえ、1 = はい)。
ext × RegsExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB/Protobuf の場合、[com.google.doubleclick.regs] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合は、Regs メッセージの ext フィールドを使用してアクセスします。

正規表現

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
gdpr × ブール値 BidRequest.AdSlot.regs_gdpr このフィールドは、次の 2 つのケースの両方で true に設定されます。
  1. Google は有効な IAB 透明性と同意に関するフレームワーク(TCF)の v2 同意文字列を受け取り、同意管理プラットフォームはこの広告リクエストに GDPR が適用されることを示します。
  2. Google は IAB TCF v2 の同意文字列を受け取っていません。Google が入手可能な情報に基づいて、このインプレッションは EEA ユーザーに配信されます。
GDPR の法的ガイダンスを構成するものではありません。
lgpd × ブール値 BidRequest.AdSlot.regs_lgpd Google が利用できる情報に基づき、このインプレッションをブラジルのユーザーに配信する場合、このフィールドは true に設定されます。LGPD が適用されるリクエストでの配信が許可されている広告テクノロジー プロバイダのリストについては、https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv をご覧ください。

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

入札レスポンスの変数と定義

このセクションでは、入札レスポンスの変数と定義について説明します。

入札レスポンス

このオブジェクトは、トップレベルの入札レスポンス オブジェクト(名前のない外部 JSON オブジェクトなど)です。id 属性は、ロギングの目的で入札リクエスト ID を表します。同様に、bidid は、入札者向けのオプションのレスポンス トラッキング ID です。指定すると、ビッダーが勝った場合に、後続の落札通知の呼び出しに含めることができます。少なくとも 1 つの seatbid オブジェクトが必要です。このオブジェクトには、インプレッションに対する入札が少なくとも 1 つ含まれています。その他の属性は省略可能です。「no-bid」を表すには、HTTP 204 で空のレスポンスを返します。または、ビッダーが入札しない理由をエクスチェンジに伝える場合、nbr 属性に理由コードとともに BidResponse オブジェクトだけが返されます。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id 文字列 どのフィールドにもマッピングされていませんが、BidRequest.id に対して検証されています。 2.3
2.4
2.5


レスポンスとなる入札リクエストの ID。

OpenRTB 仕様で要求されています。

seatbid なし Seatbid オブジェクトの配列。 BidResponse.Ad 2.3
2.4
2.5


Seatbid オブジェクトの配列です。入札が行われる場合は 1 以上が必要です。
bidid なし 文字列 BidResponse.debug_string 2.3
2.4
2.5


ビッダーが生成するレスポンス ID。記録やトラッキングに役立ちます。
cur × 文字列 BidResponse.Ad.AdSlot.currency 2.3
2.4
2.5


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

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

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

customdata なし 文字列 サポート対象外 2.3
2.4
2.5


ビッダーがエクスチェンジの Cookie にデータを設定できるようにするオプション機能。文字列は、Base85 の Cookie セーフ文字で、任意の形式にする必要があります。エスケープ処理された引用符を使用するには、適切な JSON エンコードを使用する必要があります。
nbr なし NoBidReason サポート対象外 2.3
2.4
2.5


入札しない理由。
ext × BidResponseExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB / Protobuf の場合、[com.google.doubleclick.bid_response] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合は、BidResponse メッセージの ext フィールドを使用してアクセスします。

BidResponseExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
processing_time_ms × int32 入札レスポンスの .processing_time_ms リクエストを受け取ってからレスポンスを返すまでの時間をミリ秒単位で設定します。

シートビッド

入札レスポンスには複数の SeatBid オブジェクトを含めることができます。各オブジェクトは異なるビッダーの座席を表し、各オブジェクトには 1 つ以上の個別の入札が含まれます。リクエストで複数のインプレッションが指定されている場合、そのグループの属性は、座席が獲得可能なインプレッションを受け入れるかどうか(デフォルト)か、全員でグループとして勝てる場合にのみ勝つことが必要かを指定できます。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
bid なし Bid オブジェクトの配列。 BidResponse.Ad 2.3
2.4
2.5


それぞれがインプレッションに関連する 1 つ以上の Bid オブジェクトの配列。 同じインプレッションに複数の入札単価を関連付けることができます。
seat × 文字列 BidResponse.Ad.
AdSlot.buyer_reporting_id
2.3
2.4
2.5


この入札の代理を務める購入者のシート(広告主、代理店など)。
group なし ブール値 サポート対象外 2.3
2.4
2.5


0 = インプレッションは個別に獲得できます。1 = インプレッションはグループとして獲得または獲得できません。デフォルト = false

入札単価

SeatBid オブジェクトには 1 つ以上の Bid オブジェクトが含まれ、それぞれが impid 属性で入札リクエストの特定のインプレッションに関連付けられ、所定の価格でインプレッションを購入する特典を構成します。

属性 常に合格 認定バイヤーの同等機能 サポート対象 実装の詳細
バージョン Google が提供
id 文字列 どのフィールドにもマッピングされていませんが、BidRequest.id に対して検証されています。 2.3
2.4
2.5


レスポンスとなる入札リクエストの ID。

OpenRTB 仕様で要求されています。

impid 文字列 BidResponse.Ad.AdSlot.id 2.3
2.4
2.5


関連する入札リクエストの Imp オブジェクトの ID。OpenRTB 仕様で要求されます。
price 倍精度 BidResponse.Ad.AdSlot.max_cpm_micros * 1,000,000 2.3
2.4
2.5


入札価格は CPM で表されますが、実際のトランザクションはユニット インプレッションのみを対象としています。型は浮動小数点数ですが、通貨を扱う際には整数による計算を行うことを強くおすすめします(Java では BigDecimal など)。OpenRTB 仕様で要求されています。
adid なし 文字列 サポート対象外 2.3
2.4
2.5


落札した場合に配信されるプリロードされた広告の ID。
nurl なし 文字列 サポート対象外 2.3
2.4
2.5


入札が落札された場合にエクスチェンジから呼び出される落札通知 URL。広告マークアップを配信するオプションの手段です。

DoubleClick では落札通知をサポートしていません。スニペットのインプレッション URL には %%WINNING_PRICE%% または ${AUCTION_PRICE} を使用してください。

adm なし 文字列 BidResponse.Ad.html_snippet, BidResponse.Ad.video_url、BidResponse.Ad.video_vast_xml、または BidResponse.Ad.native_ad 2.3
2.4
2.5


省略可ネイティブ広告の場合は、{adm, adm_native} のいずれか 1 つのみを使用する必要があります。これは、JSON シリアル化用の OpenRTB 準拠のフィールドです。
adm_native なし NativeResponse BidResponse.Ad.native_ad 2.3
2.4
2.5


ネイティブ広告のレスポンス。ネイティブ広告の場合は、{adm, adm_native} を 1 つだけ使用します。これは Protobuf のシリアル化に使用されるフィールドです。
adomain なし 文字列の配列 BidResponse.Ad.click_through_url 2.3
2.4
2.5


ブロックリスト チェック用の広告主のドメイン(「addomain.com」など)。クリエイティブをローテーションする場合には、配列を使用できます。エクスチェンジは 1 つのドメインのみを許可するよう強制できます。OpenRTB の仕様では、adomain でドメイン名のみが許可されます。認定バイヤーは完全な URL もサポートしています。 これはクロール可能なドメインまたは URL である必要があります。ネイティブ広告の場合は、adomain ではなく BidResponse.seatbid[].bid[].adm_native.link.url を使用することをおすすめします。
bundle なし 文字列 BidResponse.Ad.advertised_app_id 2.3
2.4
2.5


Apple App Store や Google Play などのアプリストアでのアプリのストア ID。CTV アプリストアで想定される文字列の詳細については、「OTT/CTV ストア割り当てのアプリ識別子に関するガイドライン」をご覧ください。Google Play ストアのモバイルアプリの場合は、バンドルまたはパッケージ名(com.foo.mygame など)である必要があります。Apple App Store のアプリの場合、数値 ID を指定します。このフィールドを指定した場合、広告をクリックすると、アプリストアのリスティングがオーバーレイとして表示され、パブリッシャー アプリから離れることはありません。現在、この機能は動画広告とインタースティシャル動画広告でのみ有効です。
iurl なし 文字列 サポート対象外 2.3
2.4
2.5


広告の品質や安全確認のために、キャンペーンのコンテンツを表す画像に対してキャッシュ無効化が行われていない URL。
cid なし 文字列 BidResponse.Ad.AdSlot.billing_id 2.3
2.4
2.5


広告品質チェックをサポートするキャンペーン ID。iurl を代表するクリエイティブの集合です。

プレターゲティングの請求 ID と一致します。購入者の billing_id に設定されていない場合、入札レスポンスは無効とみなされます。

クリエイティブを送信する場合、複数の billing_id がリクエストで指定されている場合、またはビッダーの有効な子シートがある場合は、レスポンスに cid が必要です。

crid なし 文字列 BidResponse.Ad.buyer_creative_id 2.3
2.4
2.5


広告品質のチェックに役立つクリエイティブ ID。
cat なし 文字列の配列 BidResponse.Ad.category 2.3
2.4
2.5


クリエイティブの IAB コンテンツ カテゴリ
attr なし CreativeAttribute オブジェクトの配列。 BidResponse.Ad.attribute 2.3
2.4
2.5


クリエイティブを説明する属性のセットです。 OpenRTB では、bid.attr(OpenRTB)または bid.ext.attribute(AdX)として宣言できます。
api なし APIFramework Bid.api では、VPAID と MRAID のバージョンに対応した属性 1、2、3、5 の宣言がサポートされています。 2.3
2.4
2.5


マークアップに必要な API(該当する場合)。
protocol なし プロトコル サポート対象外 2.3
2.4
2.5


マークアップの動画レスポンス プロトコル(該当する場合)。
qagmediarating なし QAGMediaRating サポート対象外 2.3
2.4
2.5


QAG ガイドラインに基づくクリエイティブのメディア評価。
dealid なし 文字列 BidResponse.Ad.AdSlot.deal_id(または、ビッダーが第三者のエクスチェンジの場合は、BidResponse.Ad.AdSlot.exchange_deal_id) 2.3
2.4
2.5


この入札がプライベート マーケットプレイスの直接取引に関連する場合は、入札リクエストの deal.id を参照します。
w なし int32 BidResponse.Ad.width - インプレッションが複数サイズの場合にのみ必須 2.3
2.4
2.5


デバイス非依存ピクセル(DIPS)によるクリエイティブの幅。
h なし int32 BidResponse.Ad.height - インプレッションが複数サイズの場合にのみ必須 2.3
2.4
2.5


クリエイティブの高さ(デバイス非依存ピクセル(DIPS)。
exp なし int32 サポート対象外 2.4
2.5

ビッダーがオークションと実際のインプレッションの間で待機する秒数に関するアドバイザリ。
burl なし 文字列 インプレッション_tracking_url 2.5 エクスチェンジ固有のビジネス ポリシー(通常、配信、視聴など)に基づいて落札者が請求対象となったときに、エクスチェンジから呼び出される請求通知 URL。置換マクロを使用できます。BidExt.impression_tracking_url は請求通知 URL の繰り返しリストを受け入れます。ユースケースで複数の請求 URL が必要な場合は、burl ではなくその拡張機能を使用します。
lurl なし 文字列 サポート対象外 2.5 落札できなかったことが通知されたときにエクスチェンジから呼び出される損失通知 URL。置換マクロを使用できます。 エクスチェンジ固有のポリシーでは、損失通知のサポートや、落札価格の開示が回避され、その結果、${AUCTION_PRICE} マクロが削除されることがあります(たとえば、長さがゼロの文字列に置換されます)。
tactic なし 文字列 サポート対象外 2.5 エクスチェンジ ID は、購入者が入札の送信に使用した戦術に対してエクスチェンジへの入札をラベル付けできるようにする戦術 ID です。 戦術 ID の具体的な使用方法と意味は、事前に把握し、購入者とエクスチェンジの間で伝える必要があります。
language なし 文字列 サポート対象外 2.5 ISO-639-1-alpha-2 を使用したクリエイティブの言語。非言語コード「xx」は、クリエイティブに言語コンテンツがない場合(たとえば、会社のロゴのみを含むバナー)にも使用できます。
wratio なし int32 サポート対象外 2.5 サイズを比率で表した場合のクリエイティブの相対幅。 Flex 広告に必要です。
hratio なし int32 サポート対象外 2.5 サイズを比率で表した場合のクリエイティブの相対高さ。 Flex 広告に必要です。
ext × BidExt オブジェクト 非対応 2.3
2.4
2.5


OpenRTB/Protobuf の場合、[com.google.doubleclick.bid] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB/JSON の場合は、入札メッセージの ext フィールドを使用してアクセスします。

入札単価設定

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
impression_tracking_url × 文字列の配列 BidResponse.Ad.impression_tracking_url インプレッションのレンダリング時に呼び出す URL。この機能は、すべての広告枠タイプとフォーマットでサポートされています。OpenRTB 2.5 では、Bid.burl は類似の標準フィールドです。
ad_choices_destination_url × 文字列 BidResponse.Ad.ad_choices_destination_url 広告表示設定またはオプトアウト ページへのリンク。存在する場合、標準の AdChoices アイコンがネイティブ クリエイティブに追加され、この URL にリンクされます。これはネイティブ広告ではサポートされていますが、入札レスポンスのネイティブ メッセージの一部ではありません。
click_tracking_url × 文字列 BidResponse.Ad.click_tracking_url ユーザーが広告をクリックしたときに呼び出す URL。現在サポートされているのは、パブリッシャー管理のクリエイティブを使用したネイティブ広告とプログラマティック保証型取引のみです。パブリッシャー管理のケースでは、これらのクリック トラッカーはサーバー間でビッダーに送信されます。それ以外の場合は、ユーザーのデバイスから送信されます。パブリッシャー管理のクリエイティブについて詳しくは、パブリッシャー管理のクリエイティブをご覧ください。
bidder_name × 文字列 BidResponse.Ad.bidder_name 認定バイヤーのビッダー(アド マネージャーでリアルタイム ビッダーを行っている第三者エクスチェンジ)の場合、広告を配信するためにエクスチェンジから呼び出されたビッダーの名前。これは任意の UTF8 テキストですが、ビッダーを識別するのに十分なもので、同じビッダーに対して常に同じ値を設定する必要があります。
exchange_deal_type × 列挙型 ExchangeDealType BidResponse.Ad.AdSlot.exchange_deal_type OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;
デフォルト = OPEN_AUCTION
attribute × int32 の配列 BidResponse.Ad. 属性 ID の一覧については、buyer-declarable-creative-attributes.txt をご覧ください。なお、宣言可能な属性の中には、battr フィールドの BidRequest で渡されるわけではないものもあります。ビッダーの多くは、画面全体の幅と高さに合わせて動的にサイズ変更される「流動」インタースティシャル(「レスポンシブ」または「サイズレス」とも呼ばれます)の属性を宣言しています。詳しくは、インタースティシャル広告ガイドをご覧ください。
amp_ad_url × 文字列 BidResponse.Ad.amp_ad_url AMP HTML 広告を取得する URL。html_snippet、video_url、amp_ad_url、native_ad のいずれか 1 つのみを設定する必要があります。
sdk_rendered_ad × SdkRenderedAd オブジェクト BidResponse.Ad.sdk_rendered_ad 購入者に認知されている SDK でレンダリングされる広告。これは、BidRequest に AppExt.InstalledSdk サブメッセージが含まれている場合にのみ使用できます。
event_notification_token × EventNotificationToken オブジェクト BidResponse.Ad.event_notification_token トラブルシューティングのためにビッダーが設定したトークン。送信された入札に関するリアルタイム フィードバックに含まれます。トークンの内容はログに記録されません。
restricted_category × int32 の配列 BidResponse.Ad.restricted_category このスニペットから表示されることができる広告すべての制限付きカテゴリ。ID のリストについては、ad-restricted-categories.txt をご覧ください。
billing_id × int64 BidResponse.Ad.AdSlot.billing_id このインプレッションを関連付ける請求 ID。この値は、このインプレッションに対して送信された BidRequest.ImpEx.ImpExt.billing_id 繰り返しフィールドに挿入する必要があります。BidRequest.ImpEx.ImpExt.billing_id の長さがちょうど 1 で、ビッダーに有効な子シートがない場合、このフィールドは必須ではなく、その内容は無視されます。
third_party_buyer_token × 文字列 BidResponse.Ad.Adslot.third_party_buyer_token Open Bidding の入札者としてのエクスチェンジが第三者事業者である場合、第三者の購入者情報を識別するために使用されるトークンです。この ID はサードパーティの購入者から取得され、入札レスポンス内で変更せずに Google に渡す必要があります。
buyer_reporting_id × 文字列 BidResponse.Ad.Slot.buyer_reporting_id 購入者は、クエリツールの IVT 透明性レポートで費用と無効なトラフィックの指標の分類に使用する ID を宣言しました。インプレッション数が 1,000 未満の ID は、指標の分類に使用されません。64 バイトより長い ID は無視されます。
skadn × SKAdNetworkResponse オブジェクト BidResponse.Ad.skadn iOS 14 以降でのアプリ インストール アトリビューションのサポートを目的とした、広告主の SKAdNetwork 情報。Apple の SKAdNetwork API を使用すると、インストール完了後に広告ネットワークにポストバックを送信して、広告によるアプリのインストールを測定できます。インストールを広告のインプレッションに関連付けるには、広告ネットワークがネットワーク ID と署名付き広告主情報を送信する必要があります。詳しくは、こちらの記事をご覧ください。
SDK レンダリング広告
id × 文字列 BidResponse.ad[].sdk_rendered_ad.id 広告を表示する SDK の ID。対応する入札リクエストで送信された BidRequest.app.ext.installed_sdk.id と一致する必要があります。
rendering_data × 文字列 BidResponse.ad[].sdk_rendered_ad.rendering_data 広告をレンダリングするために SDK に渡すデータ。このデータは、パブリッシャーと Google からは不透明です。
declared_ad × DelcaredAd BidResponse.ad[].sdk_rendered_ad.declared_ad カスタム SDK によりレンダリングされた広告のクリエイティブ スキャンと分類、広告ポリシーとパブリッシャーのブロックの適用をサポートするために、広告アセットを宣言しました。html_snippetvideo_urlvideo_vast_xmlnative_response のいずれか一方のみを設定します。
イベント通知トークン
payload × 文字列 BidResponse.ad[].event_notification_token トークンの内容。64 バイトを超える場合は無視されます。
SKAdNetworkResponse
version × 文字列 BidResponse.ad[].skadn.version 広告主がサポートする SKAdNetwork のバージョン。シグネチャの生成方法を指定するために使用されます。BidRequest.imp.ext.skad.version と一致する必要があります。
network × 文字列 BidResponse.ad[].skadn.network 署名に使用される広告ネットワーク ID。BidRequest.imp.ext.skad.skadnetids の項目のいずれかと一致する必要があります。
campaign × 文字列 BidResponse.ad[].skadn.campaign Apple の仕様に対応するキャンペーン ID。
itunesitem × 文字列 BidResponse.ad[].skadn.itunesitem Apple のアプリストアの広告主のアプリの ID。
fidelities × Fidelity オブジェクトの配列 BidResponse.ad[].skadn.fidelities バージョン 2.2 以降の SKAdNetwork API では、SKAdNetwork シグネチャの fidelity-type パラメータで指定された複数の広告の表示オプションがサポートされています。これにより、サポートされている忠実度タイプごとに異なる署名の生成に使用されるパラメータを保持します。詳しくは、こちらの記事をご覧ください。
nonce × 文字列 BidResponse.ad[].skadn.nonce 署名を生成するために広告主が生成した一意の小文字の UUID。 注: このフィールドは、複数の忠実度タイプをサポートする BidBid.bid.ext.skadn.fidelities.nonce フィールドを優先して、サポートが終了します。
sourceapp × 文字列 BidResponse.ad[].skadn.sourceapp Apple のアプリストア内のパブリッシャーのアプリ ID。BidRequest.imp.ext.skad.sourceapp の ID と一致する必要があります。
timestamp × 文字列 BidResponse.ad[].skadn.timestamp 署名の生成時に使用された Unix 時間(ミリ秒単位)。 注: このフィールドは、複数の忠実度タイプをサポートする BidBid.bid.ext.skadn.fidelities.timestamp のフィールドを優先して、サポートが終了します。
signature × 文字列 BidResponse.ad[].skadn.signature Apple が指定する SKAdNetwork 署名。注: このフィールドは、複数の忠実度タイプをサポートするため、BidResponse.bid.ext.skadn.fidelities.signature フィールドのサポートが終了します。
DeclaredAd オブジェクト

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

html_snippetvideo_urlvideo_vast_xmlnative_response のいずれか 1 つのみを設定します。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
html_snippet × 文字列 BidResponse.ad[].sdk_rendered_ad.declared_ad.html_snippet SDK でレンダリングされた広告を表す HTML スニペット。
video_url × 文字列 BidResponse.ad[].sdk_rendered_ad.declared_ad.video_url SDK でレンダリングされた広告で使用される VAST アセットの URL。
video_vast_xml × 文字列 BidResponse.ad[].sdk_rendered_ad.declared_ad.video_vast_xml SDK でレンダリングされたカスタム広告のレンダリングに使用される VAST ドキュメント。このドキュメントは VAST 2.0 または 3.0 標準に準拠している必要があります。
native_response × NativeResponse BidResponse.ad[].sdk_rendered_ad.declared_ad.native_response ネイティブ広告のコンテンツ。ネイティブ広告は複数の構成要素で構成され、購入者の SDK によってレンダリングされます。OpenRTB Native 1.2 の標準 NativeResponse 定義と一致する必要があります。 NativeResponse.assets.img.type は必須です。
click_through_url × 文字列 BidResponse.ad[].sdk_rendered_ad.declared_ad.click_through_url SDK でレンダリングされた広告の最終的なランディング ページ。
忠実度
属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
fidelity × 列挙型 SKAdNetworkFidelityType BidResponse.ad[].skadn.fidelity_type トラッキングするアトリビューションの忠実度タイプ。デフォルト = STOREKIT_RENDERED_ADS

VIEW_THROUGH_ADS = 0; 広告を表示してから 24 時間以内に 3 秒以上アプリ インストールのアトリビューションを行いました。SKAdnetwork バージョン 2.2 以降でサポートされています。詳しくは、こちらの記事をご覧ください。

STOREKIT_RENDERED_ADS = 1; StoreKit でレンダリングされた App Store の商品ページから開始された、広告クリックに起因するアプリのインストールのアトリビューション。 すべての SKAdNetwork バージョンでサポートされています。詳しくは、こちらの記事をご覧ください。

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

ネイティブの入札変数、定義、拡張機能

ネイティブ リクエスト

Native オブジェクトは、この入札リクエストで入札できるネイティブ広告の機会を定義します。オークションに提供されるインプレッションがネイティブ広告フォーマットである場合、インプレッション オブジェクトに直接組み込む必要があります。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
ver × 文字列 OpenRTB 2.3 の場合は「1.0」、OpenRTB 2.4 の場合は「1.1」 使用中のネイティブ マークアップ バージョンの数。
layout × レイアウト ID 非対応 ネイティブ広告ユニットのレイアウト ID。OpenRTB Native 1.0 で推奨されます(1.1 では任意で非推奨です)。
adunit × VelostrataId 非対応 ネイティブ広告ユニットの広告ユニット ID。IAB Core-6 のネイティブ広告ユニットに対応します。OpenRTB Native 1.0 で推奨されます(1.1 では任意で非推奨です)。
context × ContextType 非対応 広告が表示されるコンテキスト。
contextsubtype × コンテキストのサブタイプ 非対応 広告を表示する詳しいコンテキスト情報。
plcmttype × プレースメント タイプ NativeAdTemplate.native_placement_type 提供している広告ユニットのデザイン、フォーマット、レイアウト
plcmtcnt × int32 非対応 このレイアウト内の同一プレースメントの数。
seq × int32 非対応 最初の広告には 0、2 番目の広告には 1 というように続きます。通常、plcmtcnt と併用することはできません。つまり、同一のプレースメントを複数オークションの対象にしている場合(この場合は plcmtcnt>1, seq=0)は、フィード内の個別のアイテムに個別のオークションを開催している(この場合は plcmtcnt=1, seq>=1)。
assets × Asset オブジェクトの配列 非対応 どのような入札単価でも、エクスチェンジによって示される要素の配列に準拠する必要があります。OpenRTB ネイティブ仕様では必須です(少なくとも 1 つの要素)。
aurlsupport なし bool 非対応 サプライソースまたはインプレッションで、アセット オブジェクトではなく assetsurl が返されるかどうか。0 であるか、フィールドが存在しない場合は、そのようなサポートがないことを示します。 1.2 で実装
durlsupport なし bool 非対応 サプライソースまたはインプレッションで、アセット オブジェクトの代わりに DCO URL を返すことができるかどうか。0 であるか、フィールドが存在しない場合は、そのようなサポートがないことを示します。1.2 で実装。ベータ版機能。
eventtrackers なし EventTrackers 非対応 サポートされるイベント トラッキングのタイプを指定します。1.2 で実装
privacy なし bool 非対応 ネイティブ広告が購入者固有のプライバシーに関するお知らせをサポートしている場合は、1 に設定します。ネイティブ広告でカスタム プライバシー リンクがサポートされていない場合、またはサポートが不明な場合は、0(またはフィールドなし)を設定します。 1.2 で推奨され、実装されています。送信するすべてのネイティブ リクエストはプライバシー URL をサポートするため、ネイティブ リクエストの場合は暗黙的に常に「1」となります。
ext × NativeRequestExt オブジェクト 非対応 OpenRTB/Protobuf の場合、[com.google.doubleclick.native_ext] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合は、NativeRequest メッセージの ext フィールドを使用してアクセスします。

NativeRequestExt

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
style_id × int32 BidRequest.AdSlot.
native_ad_template[0].style_id
ネイティブ広告をレンダリングする特定のスタイル、HTML、CSS のグローバルに異なる ID。
style_height × int32 BidRequest.AdSlot.
native_ad_template[0]
.style_height
style_layout_typePixel の場合、これはレンダリング後のネイティブ広告全体の高さです。
style_width × int32 BidRequest.AdSlot.
native_ad_template[0]
.style_width
style_layout_typePixel の場合、これはレンダリング後のネイティブ広告全体の幅です。
style_layout_type × 列挙型 LayoutType BidRequest.AdSlot.
native_ad_template[0]
.style_layout_type
列挙型 LayoutType:
PIXEL = 0;(デフォルト)
FLUID = 1;

アセット

レンダリング クライアントに代わって Exchange がリクエストまたはサポートしている各アセットのメイン コンテナ オブジェクト。必要なオブジェクトは、フラグを設定する必要があります。各オブジェクトに含まれる {title,img,video,data} オブジェクトは 1 つだけです。それ以外はすべて null/不在にします。id は、レスポンスの配置を調整できるように、Asset 配列内で一意である必要があります。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
id int32 N アセットが不特定の順序で存在する場合、1.N。最初の NativeAdTemplate の推奨フィールドまたは必須フィールドに対応します。 エクスチェンジによって割り当てられた一意のアセット ID。通常、配列のカウンタ。OpenRTB ネイティブ仕様では必須です。
required なし ブール値 BidRequest.AdSlot.native_ad_template[0].
required_fields
アセットが必要な場合は true に設定します。
title なし RequestTitle BidRequest.AdSlot.native_ad_template[0] タイプ: HEADLINE タイトル アセットの Title オブジェクト。

OpenRTB ネイティブ仕様で推奨されます。TitleImageDataVideo のいずれか。

img なし RequestImage BidRequest.AdSlot.native_ad_template[0] タイプ MAIN/IMAGE、ICON/APP_ICON、LOGO/LOGO 画像アセットの Image オブジェクト。

OpenRTB ネイティブ仕様で推奨されます。TitleImageDataVideo のいずれか。

video なし 動画 BidRequest.AdSlot.NativeAdTemplate.required_fields 動画アセットの Video オブジェクト。インストリーム動画広告はネイティブ広告には含まれません。ネイティブ広告には、広告クリエイティブ自体として動画を含めることができます。入札リクエストでは、NativeRequest.assets[].requiredtrue に設定し、NativeRequest.assets[].video を指定することで、NativeResponse で動画が必要であることを示せます。OpenRTB ネイティブ仕様で推奨されます。TitleImageDataVideo のいずれか。
data なし データ BidRequest.AdSlot.native_ad_template[0] タイプ CTATEXT/CALL_TO_ACTION、DESC/Body、

SPONSORED/ADVERTISER、PRICE/PRICE、RATING/STAR_RATING

評価や価格などの Data オブジェクト。

OpenRTB ネイティブ仕様で推奨されます。TitleImageDataVideo のいずれか。

役職

Title オブジェクトは、ネイティブ広告のタイトル要素に使用されます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
len なし int32 BidRequest.AdSlot.native_ad_template[0].headline_max_safe_length タイトル要素内のテキストの最大長。値は 25、90、140 のいずれかであることが推奨されます。OpenRTB ネイティブ仕様では必須です。

画像

Image オブジェクトは、ネイティブ広告の画像要素に使用されます。

サポート対象外
属性 常に合格 認定バイヤーの同等機能 実装の詳細
type なし ImageAssetType BidRequest.AdSlot.native_ad_template[0] フィールド タイプ パブリッシャーでサポートされている画像要素のタイプ ID。パブリッシャーは、この情報を適切な形式で表示できます。
w なし int32 サポート対象外 画像の幅(ピクセル単位)。
h なし int32 サポート対象外 画像の高さ(ピクセル単位)。
wmin なし int32 BidRequest.AdSlot.native_ad_template[0] タイプ: MAIN/IMAGE:image_width LOGO/LOGO: logo_width

アイコン/APP_ICON: app_icon_width

画像の最小幅(ピクセル単位)です。このオプションは、クライアントが画像のサイズを変更するときに使用します。w または wmin のいずれかを送信する必要があります。w のみが含まれている場合は、厳密な要件とみなされます。OpenRTB ネイティブ仕様で推奨されます。
hmin なし int32 BidRequest.AdSlot.native_ad_template[0] タイプ: MAIN/IMAGE:image_height LOGO/LOGO: logo_height ICON/APP_ICON: app_icon_height 画像の高さの最小値(ピクセル単位)。このオプションは、クライアントが画像のサイズを変更するときに使用します。h または hmin のいずれかを送信する必要があります。h のみが含まれている場合は、厳密な要件とみなされます。OpenRTB ネイティブ仕様で推奨されます。
mimes なし 文字列 サポートされているコンテンツの MIME タイプの許可リスト。一般的な MIME タイプには、「image/jpg」と「image/gif」などがありますが、これらに限定されません。Exchange を実装するたびに、統合ドキュメントにサポート対象のタイプのリストを用意する必要があります。詳細と、すべての IETF RFC へのリンクについては、Wikipedia の MIME ページを参照してください。空白の場合、すべての型が許可されると想定します。

動画

Video オブジェクトは、ネイティブ広告の動画要素に使用されます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
mimes 文字列の配列 BidRequest.Video.allowed_video_formats コンテンツの MIME タイプがサポートされています。一般的な MIME タイプには、Windows Media の場合は「video/x-mswmv」、Flash 動画の場合は「video/x-flv」、動画/mp4 などがありますが、これらに限定されません。多くの場合、ネイティブは Flash をサポートしていません。

OpenRTB ネイティブ仕様では必須です(少なくとも 1 つの要素)。

minduration int32 BidRequest.Video.min_ad_duration 動画広告の最小再生時間(秒)。

OpenRTB ネイティブ仕様では必須です。

maxduration int32 BidRequest.Video.max_ad_duration 動画広告の最大再生時間(秒)。

OpenRTB ネイティブ仕様では必須です。

protocols Protocol 列挙型の配列 BidRequest.Video.protocols パブリッシャーが入札レスポンスで承認できる動画プロトコルの配列。

OpenRTB ネイティブ仕様では必須です(少なくとも 1 つの要素)。

例:
VAST_1_0 = 1;
VAST_2_0 = 2;
VAST_3_0 = 3;

データ

Data オブジェクトは、評価、レビュー数、スター、ダウンロード数、説明など、ネイティブ ユニットのコア以外の要素すべてに使用されます。また、このドキュメントの作成時点では考慮されていないネイティブ要素の将来の場合でも使用します。

属性 常に合格 認定バイヤーの同等機能 実装の詳細
type DataAssetType BidRequest.AdSlot.native_ad_template[0] フィールド タイプ パブリッシャーがサポートする要素のタイプ ID。パブリッシャーは、この情報を適切な形式で表示できます。OpenRTB ネイティブ仕様では必須です。
len なし int32 BidRequest.AdSlot.native_ad_template[0] タイプ:

降順/本文: body_max_safe_length

CTATEXT/CALL_TO_ACTION: call_to_action_max_safe_length

スポンサー/広告主: advertiser_max_safe_length

価格/価格: price_max_safe_length

要素のレスポンス内のテキストの最大長。

注: RATING/STAR_RATING には使用していません。AdX には倍の 0.5 が必要です。

イベント トラッカー

EventTrackers オブジェクトは、ビッダーが入札レスポンスでトラッキングをリクエストできるイベントのタイプと、各イベントタイプで利用できるトラッキングのタイプを指定します。これにより、リクエストには配列が含まれます。
属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
event イベントタイプ サポート対象外 トラッキングに使用できるイベントの種類。OpenRTB ネイティブ仕様では必須です。
methods EventTrackingMethod サポート対象外 指定したイベントで使用できるトラッキング タイプの配列。 OpenRTB ネイティブ仕様では必須です。

ネイティブ レスポンス

ネイティブ レスポンス オブジェクトは、ネイティブ レスポンスを識別する最上位の JSON オブジェクトです。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
ver なし 文字列 OpenRTB 2.3 の場合は「1.0」、OpenRTB 2.4 の場合は「1.1」です。 使用中のネイティブ マークアップのバージョン。
assets なし アセットの配列 BidResponse.Ad.native_ad[0]すべてのアセットは 1 つの NativeAd フィールドにマッピングされます。 ネイティブ広告のアセットのリスト。
link リンク BidResponse.Ad.native_ad[0] OpenRTB ネイティブ仕様の宛先リンク。必須。
imptrackers なし 文字列の配列 BidResponse.Ad.impression_tracking_url 1x1 の画像または 204 レスポンスを返すことが期待されるインプレッション トラッキング URL の配列。通常は、サードパーティのトラッキング ツールを使用する場合にのみ渡されます。マクロ %%WINNING_PRICE%% または ${AUCTION_PRICE} を使用してください。
jstracker なし 文字列 サポート対象外 オプションの JavaScript インプレッション トラッカー。サポート時に、インプレッション時に実行される script タグが含まれます。
eventtrackers なし EventTracker オブジェクトの配列。 BidResponse.Ad.impression_tracking_url と BidResponse.Ad.impression_tracking_resource NativeRequest で宣言されたサポートされているメソッドに応じて、広告とともに実行するレスポンス イベント トラッカーの配列。imptracker と jstracker を置き換えます。1.2 で実装しました。

イベント トラッカー

イベント トラッカー レスポンスは、オブジェクトの配列で、ビッダーがトラッキングするイベントの種類と、トラッキングする URL/情報を指定します。ビッダーは、リクエスト可能であると示されているメソッドのみを返す必要があります。ほとんどの JavaScript トラッカーはインプレッション時に読み込まれることを想定しているため、購入者が他のイベントで JavaScript トラッカーを使用して応答することは一般的に推奨されませんが、これが適切かどうかを各購入者が決定できます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
event Integer サポート対象外 トラッキングするイベントのタイプ。
method Integer サポート対象外 リクエストされたトラッキングのタイプ。
url なし テキスト BidResponse.Ad.impression_tracking_url と BidResponse.Ad.ImpressionTrackingResource.script_url 画像または js の URL。イメージまたは js の場合は必須、カスタムの場合は任意です。
customdata なし Key-Value ペアを含むオブジェクト。 サポート対象外 エクスチェンジと個別に合意するため、カスタム トラッキング用の Key-Value オブジェクトの配列(例: トラッキング会社との DSP のアカウント番号。例: {"accountnumber":"123"})
ext × EventTrackerExt オブジェクト 非対応 OpenRTB/Protobuf の場合、[com.google.doubleclick.eventtrackers] 拡張キーを使用してこのオブジェクトにアクセスできます(正確なパスは、proto ライブラリを生成するために使用される言語によって異なります)。OpenRTB / JSON の場合は、EventTracker メッセージの ext フィールドを使用してアクセスします。

イベント トラッカー外部
属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
context × 列挙型 Context の配列 BidResponse.Ad.ImpressionTrackingResource.context レンダリング用に追加のコンテキストが提供されます。
UNKNOWN = 0;
OMID = 1、現在サポートされていません。
verification_parameters × 文字列 BidResponse.Ad.ImpressionTrackingResource.verification_parameters 読み込み時にリソースに渡されるリソースに関連付けられたパラメータ。パラメータの形式は、スクリプト ベンダーによって異なります。
vendor_key × 文字列 BidResponse.Ad.ImpressionTrackingResource.vendor_key 検証スクリプトのプロバイダを一意に識別するために使用されます。

行動を促すフレーズのアセットや、ネイティブ広告からのその他のリンクに使用します。このオブジェクトは、親 Asset オブジェクトでピア オブジェクトに関連付ける必要があります。類似アプリを有効化(クリック)すると、リンクの場所に移動できます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
url なし 文字列 BidResponse.ad[].native_ad.click_link_url クリック可能なリンクのランディング URL。
clicktrackers なし 文字列の配列 (NativeResponse.link)BidResponse.Ad.NativeAd.click_tracking_url[0] URL のクリック時に配信される第三者トラッカー URL。Google クリック トラッカーは、HTTP 30x をビッダーのトラッカーにリダイレクトします。複数のクリック トラッカーを使用できます。
fallback なし 文字列 サポート対象外 ディープリンクのフォールバック URL。url で指定された URL がデバイスでサポートされていない場合に使用します。

アセット

リクエスト内の Asset オブジェクトに対応します。レンダリング クライアントに代わって Exchange がリクエストまたはサポートしている各アセットのメイン コンテナ オブジェクト。必要なオブジェクトは、フラグを設定する必要があります。各オブジェクトには、1 つの {title,img,video,data} オブジェクトのみが存在する必要があります。それ以外は null または不在となります。レスポンスを整列できるように、ID はアセット配列内で一意である必要があります。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
id int32 サポート対象外 エクスチェンジによって割り当てられた一意のアセット ID は、リクエスト内のいずれかのアセット ID と一致する必要があります。

OpenRTB ネイティブ仕様では必須です。

required なし ブール値 サポート対象外 アセットが必要な場合は 1 に設定します。(入札者はこれを表示する必要があります)
title なし Title AdX: BidResponse.Ad.native_ad[0] / HEADLINE TitleImageDataVideo のいずれか

タイトル アセットのタイトル オブジェクト。

img なし 画像 BidResponse.Ad.native_ad[0] / 画像|ロゴ|APP_ICON TitleImageDataVideo のいずれか

画像アセットの Image オブジェクト。

video なし 動画 BidResponse.Ad.NativeAd.video_url または BidResponse.Ad.NativeAd.video_vast_xml

VAST XML を含む文字列、または NativeResponse.assets[].video.vasttag 属性を使用した VAST ドキュメントの URL のいずれかです。

動画アセットの Video オブジェクト。インストリーム動画広告はネイティブ広告には含まれません。ネイティブ広告には、広告クリエイティブ自体として動画を含めることができます。

data なし データ BidResponse.Ad.native_ad[0] /
本文|CALL_TO_ACTION|広告主|STAR_RATING_PRICE_STORE
TitleImageDataVideo のいずれか。

Data オブジェクト(評価、価格など)。

link なし リンク BidResponse.Ad.native_ad[0] 行動を促すフレーズのリンク オブジェクト。このリンクは、オブジェクト内の他の入力フィールドに関連付けられます。

役職

リクエスト値が入力されたリクエスト内の Title オブジェクトに対応します。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
text 文字列 BidResponse.Ad.native_ad[0].headline テキスト要素に関連付けられたテキスト。OpenRTB ネイティブ仕様では必須です。

画像

リクエスト内の Image オブジェクトに対応します。アイコン、メイン画像など、ネイティブ広告のすべての画像要素に使用される Image オブジェクト。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
url 文字列 BidResponse.Ad.native_ad[0] リクエスト アセット タイプ:

メイン/画像: image.url

アイコン/APP_ICON: app_icon.url

ロゴ/ロゴ: logo.url

画像アセットの URL。OpenRTB ネイティブ仕様では必須です。
w なし int32 BidResponse.Ad.native_ad[0] リクエスト アセット タイプ:

メイン/画像: image.url

アイコン/APP_ICON: app_icon.url

ロゴ/ロゴ: logo.url

画像の幅(ピクセル単位)。OpenRTB ネイティブ仕様で推奨されます。
h なし int32 BidResponse.Ad.native_ad[0] リクエスト アセット タイプ:

メイン/画像: image.url

アイコン/APP_ICON: app_icon.url

ロゴ/ロゴ: logo.url

画像の高さ(ピクセル単位)。

動画

リクエスト内の Video オブジェクトに対応しますが、準拠している VAST タグの値を値として含んでいます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
vasttag 文字列 サポート対象外 VAST XML。OpenRTB ネイティブ仕様では必須です。

データ

リクエスト値が入力されたリクエスト内の Data オブジェクトに対応します。Data オブジェクトは、評価、レビュー数、星数、ダウンロード数、価格数など、ネイティブ ユニットのその他のすべての要素で使用されます。また、このドキュメントの作成時点では考慮されていない将来のネイティブ要素にも使用されます。

属性 常に合格 タイプ 認定バイヤーの同等機能 実装の詳細
label なし 文字列 サポート対象外 表示されるデータ型の書式設定された文字列名(省略可)。
value 文字列 リクエスト アセット タイプ OpenRTB/AdX の BidResponse.Ad.native_ad[0]:

CTATEXT/CALL_TO_ACTION: 行動を促すフレーズ

DESC/本文: 本文

スポンサー/広告主: 広告主

価格/価格: 価格

RATING/STAR_RATING: star_rating(AdX には 0.5 の 2 倍の単位が必要です)

表示されるデータの文字列。「5 つ星」、「$10」、または「5 つ星中 3.4 つ星」などの書式化された値を含めることができます。OpenRTB ネイティブ仕様では必須です。