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

入札APIは、この後解説されるパラメータで応答します。入札レスポンスには、1つの広告インプレッションに対応する複数の入札が含まれる場合があります。

…

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

The top-level Bid Response Object and accompanying fields are below, followed by each lower level object contained within it.

フィールド	タイプ	詳細
`id`	文字列：必須	リクエストのためにIndexが生成した固有のID。この値は、Bid Request Objectの`id`フィールドで受け取った値と同等である必要があります。
`seatbid`	Array of objects; required	シート入札オブジェクト
`ext`	オブジェクト：任意	SSL実装に関する情報を含む、カスタムIndexレスポンス拡張オブジェクト。

入札オブジェクト

フィールド	タイプ	詳細
`adm`	文字列：必須	The actual ad markup: XHTML if responding to a Banner Object; VAST XML if responding to a Video Object, and JSON if responding to a Native Object. ネイティブ広告の場合、`adm`のコンテンツが外部ネイティブラッパーオブジェクトとして送信されます。対応する入札レスポンスフィールドに関する詳細については、DSP向け：ネイティブ広告のOpenRTB入札リクエストフィールドの対応一覧を参照してください。 Note: If the bid request is secure, Index will check this field to ensure there are no insecure items. セキュアでないアイテムが見つかった場合、Indexはその広告インプレッションを破棄します。
`adomain`	文字列配列：必須	広告主を識別するためのドメイン／ランディングページ／ブランド：最大128文字。 Note: Not required if the impression is passed on.
`id`	文字列：必須	この入札を表す一意の識別子。
`impid`	文字列：必須	A unique identifier for this impression (indicated in the id field of the Impression Object); must be equal to the value received in the bid request.
`price`	フロート：必須	CPM（広告インプレッション1,000回あたりのコスト）で表される入札価格。デフォルトでは、入札は浮動小数点数で表されるドルで行われます（例：`2.71828`）。オプションとして、入札価格をセント単位で送信し、1桁以上の数字を入力するように設定できます。例えば、`68`でCPM $0.68を示します。
`attr`	整数配列：任意	標準クリエイティブ属性のリストによるクリエイティブのタイプ。500オーバーレイに追加マッピングを提供します。 Note: Pass only one attribute when possible (preferred).
`bundle`	文字列：任意	該当する場合は広告されるアプリ名またはバンドル（例：「`com.foo.mygame`」）：エクスチェンジ間で一意のID。
`dealid`	文字列：任意	A unique identifier for the direct deal associated with this bid; must be equal to the id provided in the Direct Deals Object if indicated in the request. Note: This is always prioritized over a deal indicated in the Bid Extension Object.
`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から受信したとして渡される`skadn`オブジェクト。以下のSKAdNetwork拡張オブジェクトを参照してください。

dsa

オブジェクト：任意

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

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

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

skadn

オブジェクト：時々送信

DSPから受信したとして渡される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は入札レスポンスに以下のオブジェクトを含めることができます。For more information on submitting the correctly formatted values, see Apple's documentation. このオブジェクトがレスポンス内にある場合、SSPはクリックデータと署名をloadProduct()に送信して帰属を求めます。

アトリビュート	タイプ	詳細
`version`	文字列：時々送信	SKAdNetworkのバージョンが必要です。2.0以上である必要があります。
`network`	文字列：時々送信	署名に使用される広告ネットワークID。リクエストの`skadnetids`配列のいずれかの項目と一致する必要があります。
`campaign`	文字列：時々送信	The campaign ID compatible with Apple's spec. バージョン2.0では、1～100までの整数を文字列で表します。
`itunesitem`	文字列：時々送信	The ID of advertiser's app in Apple's app store. `BidResponse.seatbid.bid.bundle`と一致する必要があります。
`fidelities`	オブジェクト配列：任意	SKAdNetwork v2で導入された複数のフィデリティタイプを含むオブジェクト。フィデリティオブジェクトの表をご確認ください。
`nonce`	文字列：時々送信	各広告レスポンスに対する固有のID。To learn more, see Apple's documentation for the proper UUID format requirements.
`sourceapp`	文字列：時々送信	The ID of publisher's app in Apple's app store. `BidRequest.imp.ext.skad.sourceapp`と一致する必要があります。
`timestamp`	文字列：時々送信	署名時に使用される、ミリ秒単位のUNIX時間の文字列。
`signature`	文字列：時々送信	Appleで指定されたSKAdNetwork署名。

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

fidelity、noncesignature

アトリビュート	タイプ	詳細
`fidelity`	整数：任意	管理するためのアトリビューションのフィデリティタイプ。 Example: `"fidelity": 0`
`nonce`	文字列：任意	各広告レスポンスに対する個別のIDFor more information, see Apple's documentation for the proper UUID format requirements.
`timestamp`	文字列：任意	署名時に使用される、ミリ秒単位でのUnix時間の文字列。 Example: `"timestamp": "1594406341"`
`signature`	文字列：任意	Appleが指定するSKAdNetwork 署名。 Example: `"signature": "MEQCIEQlmZRNfYzK…"`
`ext`	オブジェクト、任意	Index専用のプレースホルダー

SeatBidオブジェクト

フィールドタイプ詳細

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

bid

Array of objects; required

入札オブジェクト

seat

文字列：必須

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

Mediumint unsigned
0から16777215

注意：

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

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

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

アトリビュート	タイプ	詳細
`igbid`	オブジェクトの配列：任意	注意：2025年6月より、IndexはProtected Audience APIへの対応を一時的に停止します。入札レスポンスのこのフィールドを含める場合、Indexはデバイス上のオークションでは処理されません。 Protected Audience APIを使用している場合、これはブラウザ内でインタレストグループオークションを実行するための情報を含むオブジェクトフィールドのインタレストグループ入札配列です。以下の`igbid`に含まれるフィールドに関しては、インタレストグループ拡張フィールドを参照してください。 For more information about Interest Groups, see Google's Protected Audience API documentation.

igbid

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

注意：2025年6月より、IndexはProtected Audience APIへの対応を一時的に停止します。入札レスポンスのこのフィールドを含める場合、Indexはデバイス上のオークションでは処理されません。

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

For more information about Interest Groups, see Google's Protected Audience API documentation.

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

注意：2025年6月より、IndexはProtected Audience APIへの対応を一時的に停止します。入札レスポンスのこのフィールドを含める場合、デバイス上のオークションでは処理されません。

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

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

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

アトリビュート	タイプ	詳細
`origin`	文字列：必須	Protected Audience APIを使用している場合、このフィールドは、インタレストグループ・バイヤーがブラウザ上のオークションに参加するためのオリジン（ドメイン）です。
`buyerdata`	配列：任意	If you are using the Protected Audience API, this field is the buyer-specific signals to use in the `protectedAudienceAuctionConfigs.perBuyerSignals` in the bid response to the Media Owner. これは、バイヤーのインタレストグループ入札機能により使用されます。バイヤー入札機能で`perBuyerSignals`が必須でない場合、このフィールドは、空欄にできます。注意：このフィールドは、JSONシリアライズ可能である必要があります。例：オブジェクトまたは、オブジェクトの配列。

origin

文字列：必須

Protected Audience APIを使用している場合、このフィールドは、インタレストグループ・バイヤーがブラウザ上のオークションに参加するためのオリジン（ドメイン）です。

buyerdata

配列：任意

If you are using the Protected Audience API, this field is the buyer-specific signals to use in the protectedAudienceAuctionConfigs.perBuyerSignals in the bid response to the Media Owner. これは、バイヤーのインタレストグループ入札機能により使用されます。バイヤー入札機能でperBuyerSignalsが必須でない場合、このフィールドは、空欄にできます。

注意：このフィールドは、JSONシリアライズ可能である必要があります。例：オブジェクトまたは、オブジェクトの配列。

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

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

入札オブジェクト

入札拡張オブジェクト

DSAオブジェクト

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

SKAdNetwork拡張オブジェクト

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

SeatBidオブジェクト

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

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

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

Was this page helpful?