DSP向けOpenRTB入札レスポンスフィールドの対応一覧

入札APIは、この後解説されるパラメータで応答します。入札レスポンス SSPまたはアドエクスチェンジの入札リクエストに対してDSPが送信するOpenRTBレスポンス。販売リクエストと販売条件に対する査定をセラーに返すイベントである。には、1つの広告インプレッションに対応する複数の入札が含まれる場合があります。

入札レスポンスオブジェクト

トップレベルの入札レスポンスオブジェクトとそれに付随するフィールド、および中に含まれる下位レベルの各オブジェクトを以下に示します。

フィールドタイプ詳細

フィールド	タイプ	詳細
`id`	文字列：必須	入札リクエストオブジェクトの`id`フィールドに示されている、このリクエストの一意の識別子。注意：入札リクエストで受け取る数値と同じである必要があります。
`seatbid`	オブジェクトの配列：必須	シート入札オブジェクト
`ext`	オブジェクト：任意	SSL SSL (Secure Sockets Layer).実装に関する情報を含む、カスタムIndexレスポンス拡張オブジェクト。

id

文字列：必須

入札リクエストオブジェクトのidフィールドに示されている、このリクエストの一意の識別子。

注意：入札リクエストで受け取る数値と同じである必要があります。

seatbid

オブジェクトの配列：必須

シート入札オブジェクト

ext

オブジェクト：任意

SSL SSL (Secure Sockets Layer).実装に関する情報を含む、カスタムIndexレスポンス拡張オブジェクト。

入札オブジェクト

フィールド	タイプ	詳細
`adm`	文字列：必須	実際の広告マークアップ：バナーオブジェクトに応答する場合はXHTML、動画オブジェクトに応答する場合はVAST 動画広告掲出テンプレート（VAST）。広告配信サーバーと動画プレイヤー間で、XML形式で行うデータの受け渡し方法を定義したものです。 XML、ネイティブオブジェクトに応答する場合はJSON。ネイティブ広告の場合、`adm`のコンテンツが外部ネイティブラッパーオブジェクトとして送信されます。対応する入札レスポンスフィールドに関する詳細については、DSP向け：ネイティブ広告のOpenRTB入札リクエストフィールドの対応一覧を参照してください。注意：入札リクエスト SSPまたはアドエクスチェンジからDSPに送信され、入札可能なインプレッションに対する入札レスポンスをリクエストするOpenRTBリクエスト。入札リクエストには、DSPがそのインプレッションに入札するかどうかを決定するためのインプレッションに関する情報が含まれる。が安全であれば、Indexはこのフィールドをチェックして、不確かなアイテムがないか確認します。セキュアでないアイテムが見つかった場合、Indexはその広告インプレッションを破棄します。
`adomain`	文字列配列：必須	広告主を識別するためのドメイン／ランディングページ／ブランド：最大128文字。注意：広告インプレッションが渡される場合は不要です。
`id`	文字列：必須	この入札を表す一意の識別子。
`impid`	文字列：必須	この広告インプレッションのための一意の識別子（広告インプレッションオブジェクトのidフィールドで示される）。入札リクエストで受け取った値と同じである必要があります。
`price`	フロート：必須	CPM 1000インプレッション毎に発生するコスト。インプレッションを購入するための料金体系で、広告を1,000回表示するためにかかる費用。Cost Per Mille（Mはローマ数字で1,000を表す）またはCents Per Milleとも呼ばれます。（広告インプレッション1,000回あたりのコスト）で表される入札価格。デフォルトでは、入札は浮動小数点数で表されるドルで行われます（例：`2.71828`）。オプションとして、入札価格をセント単位で送信し、1桁以上の数字を入力するように設定できます。例えば、`68`でCPM $0.68を示します。
`attr`	整数配列：任意	標準クリエイティブ 300x250pxなど、ピクセル単位で定義された様々なクリエイティブタイプのデジタル広告。属性のリストによるクリエイティブのタイプ。500オーバーレイに追加マッピングを提供します。注意：可能な際は、属性を1つだけ渡します（推奨）。
`bundle`	文字列：任意	該当する場合は広告されるアプリ名またはバンドル（例：「`com.foo.mygame`」）：エクスチェンジ間で一意のID。
`dealid`	文字列：任意	この入札に関連する直接ディールパブリッシャーがディールIDによって限定されたバイヤーに特定のインベントリを直接販売できるプライベートオークション。条件はオークション開催前の交渉によって合意されます。の一意の識別子。リクエストに示されている場合、直接ディールオブジェクトで提供されるidと等しくなければなりません。注意：これは、入札拡張オブジェクトで示されるディールよりも常に優先されます。
`burl`	文字列：任意	支払請求通知URLは、パブリッシャー広告が表示される、ウェブサイトまたはアプリの所有者。の基準に基づいて落札価格が支払請求可能になったときに取引によって呼び出されます（例：ウェブではレンダリングの開始、アプリでは1ピクセルの表示）。注意： `${AUCTION_PRICE}`通知マクロを含み、有効なURLの一部である必要があります。 `burl`と`adm`の両フィールドに`${AUCTION_PRICE}` 通知マクロを含めることができます。ただし、`burl`から追跡される広告インプレッションのみが課金対象となります。オプションで、`burl`と`adm`の両フィールドに`${SUPPLY_FEE}` 通知マクロを含めることができます。デフォルトでは、すべてのパートナーに対して有効になっていません。`burl`を有効にするには、Index担当者の担当者にお問い合わせください。 Indexにおける`burl`のワークフローについては、課金通知をご覧ください。
`w`	整数、任意	デバイス依存ピクセルのクリエイティブの幅。フォーマットのフィールドを含むマルチサイズ入札リクエストに応答する場合、この`format` フィールドは必須です。
`h`	整数：任意	クリエイティブのデバイス依存ピクセルの高さ。フォーマットのフィールドを含むマルチサイズ入札リクエストに応答する場合、この`format` フィールドは必須です。
`ext`	オブジェクト：任意	この入札の情報を含む可能性のあるカスタムIndex Exchange入札拡張オブジェクト。
`exp`	整数：任意	オークションと実際のインプレション間で入札者が待機していいと思う時間（秒）。

入札拡張オブジェクト

アトリビュートタイプ詳細

アトリビュート	タイプ	詳細
`dsa`	オブジェクト：任意	DSAオブジェクト入札リクエストでリクエストされた、デジタルサービス法（DSA）の透明性に関する情報。デジタルサービス法に関する詳細は、デジタルサービス法（DSA）の資料をご確認ください。 IndexがどのようにDSAをサポートしているかに関しては、ポリシーと規制をご確認ください。
`skadn`	オブジェクト：時々送信	DSP デマンドサイドプラットフォーム（DSP）。リアルタイムで入札の意思決定を自動化し、アドエクスチェンジやSSPを通じてバイヤーとオーディエンスを効率的につなぐソフトウェアプラットフォーム。バイサイド・プラットフォームとも呼ばれます。から受信したとして渡される`skadn`オブジェクト。以下のSKAdNetwork拡張オブジェクトを参照してください。

dsa

オブジェクト：任意

DSAオブジェクト入札リクエストでリクエストされた、デジタルサービス法（DSA）の透明性に関する情報。

デジタルサービス法に関する詳細は、デジタルサービス法（DSA）の資料をご確認ください。

IndexがどのようにDSAをサポートしているかに関しては、ポリシーと規制をご確認ください。

skadn

オブジェクト：時々送信

DSP デマンドサイドプラットフォーム（DSP）。リアルタイムで入札の意思決定を自動化し、アドエクスチェンジやSSPを通じてバイヤーとオーディエンスを効率的につなぐソフトウェアプラットフォーム。バイサイド・プラットフォームとも呼ばれます。から受信したとして渡されるskadnオブジェクト。以下のSKAdNetwork拡張オブジェクトを参照してください。

DSAオブジェクト

アトリビュート	タイプ	詳細
`adrender`	整数：任意	バイヤー／広告主が自社のDSA透明性に関する情報をクリエイティブ内で提供しているかどうか示すフラグ： `0` ⁼ バイヤー／広告主がDSA情報を提供しない `1` ⁼ バイヤー／広告主がDSA情報を提供する
`behalf`	文字列：任意	UNICODEテキストを使用した、広告を配信する広告主／バイヤー名（最大100文字）例えば、`"Advertiser1"`。
`paid`	文字列：任意	UNICODEテキストを使用した、広告費を支払った広告主／バイヤー名（最大100文字）例えば、`"Advertiser1"`。注意：このフィールドは、`behalf`フィールドに含まれている値と同じ場合でも、DSA関連のレスポンスに必ず含めてください。
`transparency`	オブジェクトの配列：任意	透明性に関するオブジェクトの配列は、ユーザーパラメータに適用されるエンティティおよび適用したパラメータに含まれます。

透明性に関するオブジェクト

フィールドタイプ詳細

フィールド	タイプ	詳細
`domain`	文字列; 任意	ターゲティングのために`dsaparams`フィールドのユーザーパラメータに適用したエンティティのドメイン。例えば、`"platform1domain.com"`。
`dsaparams`	整数配列：任意	このユーザーをターゲットにする際に使用された、バイサイドで適用するユーザーパラメータの配列： `1` ⁼ プロファイリングユーザーの活動、興味、デモグラフィック、またはその他の特性に関する、コンテクストを横断して収集され使用されるユーザーに関する情報を含みます。 `2` ⁼ 基本的な広告デバイスの種類や機能、ユーザーエージェント、URL、IPアドレス、非精密な位置情報など、コンテンツやデバイスに関する情報を含む、広告が表示されるコンテキストに関するリアルタイムの情報の使用を含みます。さらに、ユーザー行動やユーザーの特徴に基づかない、基本的なクロスコンテキスト情報の使用は、フリクエンシー設定、順序付け、ブランドセーフティ広告の安全な環境。ブランドセーフティとは、見ているユーザーに関わらず、論争を招く可能性がある、または過剰なコンテンツを含むサイト上にブランドを表示しません。、不正防止などの用途に使用されます。 `3` ⁼ 正確な位置情報ユーザーの正確なリアルタイム位置情報GPSは半径500メートル以内の精度。

domain

文字列; 任意

ターゲティングのためにdsaparamsフィールドのユーザーパラメータに適用したエンティティのドメイン。例えば、"platform1domain.com"。

dsaparams

整数配列：任意

このユーザーをターゲットにする際に使用された、バイサイドで適用するユーザーパラメータの配列：

1 ⁼ プロファイリングユーザーの活動、興味、デモグラフィック、またはその他の特性に関する、コンテクストを横断して収集され使用されるユーザーに関する情報を含みます。
2 ⁼ 基本的な広告デバイスの種類や機能、ユーザーエージェント、URL、IPアドレス、非精密な位置情報など、コンテンツやデバイスに関する情報を含む、広告が表示されるコンテキストに関するリアルタイムの情報の使用を含みます。さらに、ユーザー行動やユーザーの特徴に基づかない、基本的なクロスコンテキスト情報の使用は、フリクエンシー設定、順序付け、ブランドセーフティ広告の安全な環境。ブランドセーフティとは、見ているユーザーに関わらず、論争を招く可能性がある、または過剰なコンテンツを含むサイト上にブランドを表示しません。、不正防止などの用途に使用されます。
3 ⁼ 正確な位置情報ユーザーの正確なリアルタイム位置情報GPSは半径500メートル以内の精度。

SKAdNetwork拡張オブジェクト

入札リクエストにBidRequest.imp.ext.skadnオブジェクトが含まれている場合、DSPは入札レスポンスに以下のオブジェクトを含めることができます。正しくフォーマットされた値を送信するための詳細については、Appleのドキュメントを参照してください。このオブジェクトがレスポンス内にある場合、SSP サプライサイドプラットフォーム（SSP）。パブリッシャーがアドエクスチェンジやDSPを通じて広告主への在庫販売をリアルタイムで自動化するために使用するソフトウェアプラットフォーム。セルサイドとも呼ばれます。はクリックデータと署名をloadProduct()に送信して帰属を求めます。

アトリビュート	タイプ	詳細
`version`	文字列：時々送信	SKAdNetworkのバージョンが必要です。2.0以上である必要があります。
`network`	文字列：時々送信	署名に使用される広告ネットワークID。リクエストの`skadnetids`配列のいずれかの項目と一致する必要があります。
`campaign`	文字列：時々送信	Appleの仕様に対応したキャンペーンID。バージョン2.0では、1～100までの整数を文字列で表します。
`itunesitem`	文字列：時々送信	AppleのApp Store内で入手可能な広告主のアプリのID。`BidResponse.seatbid.bid.bundle`と一致する必要があります。
`fidelities`	オブジェクト配列：任意	SKAdNetwork v2で導入された複数のフィデリティタイプを含むオブジェクト。フィデリティオブジェクトの表をご確認ください。
`nonce`	文字列：時々送信	各広告レスポンスに対する固有のID。詳細についてはAppleのドキュメントから、適切なUUIDフォーマットの要件を参照してください。
`sourceapp`	文字列：時々送信	AppleのApp Storeで入手できるパブリッシャーのアプリのID。`BidRequest.imp.ext.skad.sourceapp`と一致する必要があります。
`timestamp`	文字列：時々送信	署名時に使用される、ミリ秒単位のUNIX時間の文字列。
`signature`	文字列：時々送信	Appleで指定されたSKAdNetwork署名。

フィデリティオブジェクト

fidelity、noncesignature

アトリビュート	タイプ	詳細
`fidelity`	整数：任意	管理するためのアトリビューションのフィデリティタイプ。例： "fidelity": 0
`nonce`	文字列：任意	各広告レスポンスに対する個別のID詳細は、Appleの適切なUUIDフォーマット条件をご確認ください。
`timestamp`	文字列：任意	署名時に使用される、ミリ秒単位でのUnix時間の文字列。例："timestamp": "1594406341"
`signature`	文字列：任意	Appleが指定するSKAdNetwork 署名。例："signature": "MEQCIEQlmZRNfYzK…"
`ext`	オブジェクト：任意	Index専用のプレースホルダー

SeatBidオブジェクト

フィールドタイプ詳細

フィールド	タイプ	詳細
`bid`	オブジェクトの配列：必須	入札オブジェクト
`seat`	文字列：必須	代理店の一意の識別子（複数の代理店または、独立した直接クライアントがDSPを利用する場合）の値は次のとおりです。 Mediumint unsigned `0`から`16777215` 注意：デフォルトでは必須ですが、要望に応じてDSPごとに無効にできます。シートフィールドに英数字値を渡す必要がある場合は、Index担当者の担当者にお問い合わせください。

bid

オブジェクトの配列：必須

入札オブジェクト

seat

文字列：必須

代理店の一意の識別子（複数の代理店または、独立した直接クライアントがDSPを利用する場合）の値は次のとおりです。

Mediumint unsigned
0から16777215

注意：

デフォルトでは必須ですが、要望に応じてDSPごとに無効にできます。
シートフィールドに英数字値を渡す必要がある場合は、Index担当者の担当者にお問い合わせください。

レスポンス拡張オブジェクト

アトリビュート タイプ 詳細

アトリビュート	タイプ	詳細
`igbid`	オブジェクトの配列：任意	Info: Starting June 2025, Index is pausing support for the Protected Audience API. If you include this field in the bid response, Index will not process it for an on-device auction. Protected Audience APIを使用している場合、これはブラウザ内でインタレストグループオークションを実行するための情報を含むオブジェクトフィールドのインタレストグループ入札配列です。以下の`igbid`に含まれるフィールドに関しては、インタレストグループ拡張フィールドを参照してください。 Googleの詳細については、Protected Audience APIをご確認ください。

igbid

オブジェクトの配列：任意

Info: Starting June 2025, Index is pausing support for the Protected Audience API. If you include this field in the bid response, Index will not process it for an on-device auction.

Protected Audience APIを使用している場合、これはブラウザ内でインタレストグループオークションを実行するための情報を含むオブジェクトフィールドのインタレストグループ入札配列です。以下のigbidに含まれるフィールドに関しては、インタレストグループ拡張フィールドを参照してください。

Googleの詳細については、Protected Audience APIをご確認ください。

インタレストグループ拡張オブジェクト

Info: Starting June 2025, Index is pausing support for the Protected Audience API. If you include these fields in the bid response, they won't be processed for an on-device auction.

アトリビュート	タイプ	詳細
`impid`	文字列：必須	Protected Audience APIを使用している場合、このフィールドが、インタレストグループ入札シグナルが適用されるImpオブジェクトのIDです。
`igbuyer`	オブジェクトの配列：必須	Protected Audience APIを使用している場合、これは、ブラウザ上のオークションのためのDSP情報を含むインタレストグループ・バイヤー配列です。詳細は、インタレストグループ・バイヤー拡張オブジェクトをご確認ください。

インタレストグループ・バイヤー拡張オブジェクト

Info: Starting June 2025, Index is pausing support for the Protected Audience API. If you include these fields in the bid response, they won't be processed for an on-device auction.

アトリビュート	タイプ	詳細
`origin`	文字列：必須	Protected Audience APIを使用している場合、このフィールドは、インタレストグループ・バイヤーがブラウザ上のオークションに参加するためのオリジン（ドメイン）です。
`buyerdata`	配列：任意	Protected Audience APIを使用している場合、このフィールドは、パブリッシャーへの入札レスポンスの`protectedAudienceAuctionConfigs.perBuyerSignals`で使用するバイヤー固有のシグナルです。これは、バイヤーのインタレストグループ入札機能により使用されます。バイヤー入札機能で`perBuyerSignals`が必須でない場合、このフィールドは、空欄にできます。注意：このフィールドは、JSONシリアライズ可能である必要があります。例：オブジェクトまたは、オブジェクトの配列。