DSP向けOpenRTB入札リクエストフィールド対応一覧

DSP
Last Updated: 4月 23, 2026

当社のOpenRTB bidding APIはリアルタイム入札を容易にします。入札リクエストのデータは、JSON RFC 4627フォーマットで送信され、すべてのフィールドで大文字と小文字が区別されます。

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

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

フィールドタイプ詳細

id

文字列:必須

リクエストのためにIndexが生成した固有のID。Indexと複数のOpenRTB接続を有しているDSPについては、各接続ごとに、リクエストごとに固有のIDが付与されます。id

imp

オブジェクト配列; 必須

インプレッションオブジェクトは、1つ以上のバナーオブジェクト動画オブジェクトまたはネイティブオブジェクトを含みます。

注意:

  • デフォルトでは、Indexがセラーからのマルチフォーマットの入札リクエストは、DSPへの複数の個別の入札リクエストに分けられ、各フォーマットごとに1つのリクエストとなります。Indexは、マルチフォーマットのリクエストを許可し、1つのインプレッション機会で複数のクリエイティブタイプを受けとれます。例えば、1つのインプレッション機会において、bannervideonativeクリエイティブに対応するリクエストを受け取れます。マルチフォーマットリクエストを有効にするには、Index担当者にお問い合わせください。
  • For video requests, by default Index separates multi-impression structured podded and dynamic podded video requests from Media Owners into individual single-impression video requests for DSPs. これにより、OpenRTB 2.6に対応していないDSPが非広告ポッドの単一インプレッション動画リクエストとしてインプレッション機会を受け取ることができます。広告ポッドリクエストを受け取れる、もしくは、Indexから既定またはダイナミック広告ポッドリクエストを受け取れる場合は、Index担当者にお問い合わせください。

device

オブジェクト; 必須

デバイスオブジェクト。

tmax

整数:必須

Indexが入札の受け取りに割り当てる最大の時間(ミリ秒)。タイムアウトを回避するため、tmaxフィールドはIndexとDSPとの間のインターネット遅延を減算しません。

Note: If required, we can subtract latency when passing tmax. 詳細は、Index担当者までお問い合わせください。

cur

文字列配列:任意

The currencies that Media Owners will accept in bid responses, which must always be USD.

ext

必須

入札リクエストに関する追加情報を含むカスタムのIndex Request Extension Object。

app

オブジェクト:任意

アプリオブジェクト; 広告インプレッションがアプリケーションから生じた場合に含まれます。

bcat

文字列配列:任意

標準IABコンテンツカテゴリに基づきブロックされた広告主のカテゴリの配列。全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。

cattax整数、任意

The taxonomy in use for the bcat field, where the taxonomy used determines the meaning of a category code like ["IAB3-7"]. 全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。If the cattax field is not sent, IAB Content Category Taxonomy 1.0 is assumed.

badv

文字列配列:任意

A list of advertiser domains that have been blocked by the Media Owner from serving on their properties, for example “ford.com”.

注意:この項目は、当社が最適化を行っている間、一時的に利用できなくなります。

regs

オブジェクト:任意

規制オブジェクト。

site

オブジェクト:任意

サイトオブジェクト; 広告インプレッションがウェブサイトから生じた場合に含まれます。

user

オブジェクト:任意

ユーザーオブジェクト。

sourceオブジェクト:任意インベントリソースに関するデータを提供するソースオブジェクト。
wlang文字列配列:任意

ISO-639-1-alpha-2を使用したクリエイティブの言語リスト。このフィールドを省略した場合、特に言語の制限がないとみなされます。一方、DSPは、デバイスおよびコンテンツオブジェクトのlanguageフィールドを考慮するように推奨されます。

入札拡張(BidRequest )オブジェクト

フィールドタイプ詳細

placement

オブジェクト; 任意

配置オブジェクト。

tz

整数; 任意

JavaScript getTimezoneOffset()関数から得られるユーザーのタイムゾーン。

配置オブジェクト

配置オブジェクトは、プライベートエクスチェンジの広告インプレッションのために常に存在しています。

フィールドタイプ詳細

name

文字列:任意

広告インプレッションがプライベートである理由を説明する名前(例:"Homepage")。

private

ブール値:任意

この広告インプレッションのDSP入札資格の範囲。

  • 1 = プライベートと有資格入札は、指定されたディールに限定されます

ソースオブジェクト

フィールドタイプ詳細

pchain

文字列:任意

Payment IDのチェーン文字列は、広告インプレッションのサプライパスを可視化します。Indexから直接発信された入札リクエストは、pchainが次のように表示されます。

  • 50b1c356f2c5c8fcのIndexのTAG ID

  • パブリッシャーID2167など

例えば、50b1c356f2c5c8fc:2167

サプライヤーから発信された入札リクエストの場合、pchainフィールドにはサプライヤーとIndexの両方のTAG IDとパブリッシャーIDが表示されます。例えば、<Supplier ID>:<Publisher ID>-50b1c356f2c5c8fc:2167。詳細やpchainのサプライヤーIDのリストについては、TAGinfo@tagtoday.net)までお問い合わせください。

schain

オブジェクト; 任意

サプライチェーン(SupplyChain)オブジェクトschainpchainと同様、入札リクエストの販売や再販に関わるすべての関係者をバイヤーに開示します。詳細は、以下のSupply Chainオブジェクトをご覧ください。

schainオブジェクトを解釈するには、当社のすべてのサプライパートナーのリストを記載したsellers.jsonファイルを参照してください(www.indexexchange.com/sellers.json)。

ext

文字列; 任意

ソース拡張オブジェクトは、入札リクエストのソースの追加情報を記載するために使用されます。詳細については、以下のソース拡張オブジェクトをご確認ください。

ソース拡張オブジェクト

フィールドタイプ詳細

sourceType

整数:必須

オークションで使用されるヘッダー入札タイプ:

  • 1=ヘッダービディングオークションからのリクエストでない

  • 2=クライアントサイドのヘッダービディングオークションからのリクエスト

  • 3=サーバーサイドのヘッダービディングオークションからのリクエスト

sourceOrigin

整数:必須

どこから生成されたかを示すインプレッション機会のソース

  • 1 = ダイレクト(タグべース)

  • 2 = その他SSP

  • 3 = Amazon TAM

  • 4 = Google Open Bidding

  • 5 = Prebid

  • 6 = IX Wrapper Library

  • 7 = その他のヘッダービディング・ソリューション

omidpn

文字列; 任意

OM SDKインテグレーションのための識別子。これは、OMID Partnerオブジェクトのnameパラメータと同じです。

omidpv

文字列:任意

OM SDKインテグレーションの1バージョン。これは、OMID PartnerオブジェクトのversionStringパラメータと同じです。

サプライチェーン(SupplyChain)オブジェクト

フィールドタイプ詳細

complete

整数:必須

インベントリのサプライソースに遡る取引に関わるすべてのノードが、チェーンに含まれているかどうかを指定するフラグです。

  • 0 = いいえ
  • 1 = はい

nodes

オブジェクト配列:必須

チェーンの順番に並ぶSupplyChainNodeオブジェクト配列。各ノードは、広告インプレッションに接触した様々な売り手やエクスチェンジシステムを表しています。配列の最後のノードは、入札リクエストを送信する売り手を表します。詳細については、以下のノードオブジェクトを参照してください。

ver

文字列:必須

使用中のサプライチェーン仕様のバージョン(“major.minor”)。Indexでは、現在sellers.json仕様バージョン1.0を使用しています。

ソースオブジェクト

フィールドタイプ詳細

asi

文字列:必須

入札者が接続するシステムのドメイン名。例:SSP、exchange。

Note: You can find the sellers.json file for each node through this domain name. The same domain is also used in ads.txt files for Media Owners (for example, indexexchange.com).

rid

文字列:任意

売り手が発行した、リクエストのOpenRTB RequestId

Note: The same information can also be found in bidrequest.id.

sid

文字列:必須

売り手または再販業者のアカウントID。

Note: The same information can also be found in site.publisher.id.

hp

整数:必須

ノードをインベントリの支払いフローに含めるか否かを指定します。hpフィールドは、アップストリームチェーンに含まれている場合に送信されます。Indexのノードには、常にhp=1が含まれます。SupplyChainのバージョン1.0では、このプロパティは常に1となります。

規制オブジェクト

フィールドタイプ詳細

coppa

整数、任意

Specifies whether this request is subject to the United States Children's Online Privacy Protection Act (COPPA), where:

  • 0 = いいえ
  • 1 = はい

このフラグがリクエストから削除されている場合、Indexはこの情報が利用できないものとみなします。

Note: The following fields are automatically blanked in COPPA-related requests: lat, lon, metro, city, and zip (in the Geo Object).

ext

オブジェクト、任意

規制の対象であるリクエストを示すのに使用される規制拡張オブジェクト。以下の表を参照してください。

gpp

文字列:任意

Global Privacy Platform (GPP)文字列を含み、ユーザーが選択したプライバシーを伝達します。

GPPフレームワークの詳細については、IABのグローバルプライバシープラットフォームをご確認ください。

gpp_sid

整数配列:任意

入札リクエストに適用するGlobal Privacy Platform (GPP)セクションIDか、個別のプライバシーフレームワークを指定してください。

GPPに認証されている項目IDの現行リストについては、IABのセクション情報のページをご確認ください。

us_privacy

文字列; 任意

入札リクエスト内のユーザーに米国プライバシー法(CCPAなど)が適用されるかどうかを指定します。このフィールドには4文字が含まれています。例えば、1YYN。各文字の意味は、文字列内の位置によって以下に定義されます。

  • 1文字目:文字列のエンコーディングに使用されたUSプライバシー文字列仕様のバージョン番号。
  • 2文字目:ユーザーが個人情報の販売について明確な通知とオプトアウトする選択肢を与えられたかどうかを示します。
    • N = いいえ
    • Y= はい
    • -= 該当しない
  • 3文字目: ユーザーが自身の個人情報の販売を拒否したかどうかを明示します。
    • N = いいえ
    • Y= はい
    • -= 該当しない
  • 4th character: Specifies whether the Media Owner is a signed party to the IAB Limited Service Provider Agreement (LSPA). the Media Owner specifies whether the transaction is either a Covered Opt Out Transaction or a Non Opt Out Transaction.
    • N = いいえ
    • Y= はい
    • -= 該当しない

例えば、1---として渡された文字列は、米国のプライバシー規制が入札リクエストに適用されないことを指定します。

Note: When a consumer chooses to opt-out of the sale of their personal information, the following bid request fields are automatically adjusted:

  • ip (device object): The last octet of the user's IP address is replaced with a zero.
  • latおよびlon(Geoオブジェクト):緯度座標と経度座標は小数点以下2桁になり、3分の1マイル以上の精度になります。
  • deviceuserオブジェクトの入札リクエストで、間接的にユーザーを識別する一意のIDは削除されます。
  • dealsPMPオブジェクト):オーディエンスセグメントを対象とするディールIDが入札リクエストに追加されなくなります。

規制拡張オブジェクト

フィールドタイプ詳細

dsa

オブジェクト、任意

A DSA object that contains Digital Services Act (DSA) transparency information, as received from the Media Owner.

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

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

gdpr

整数:任意

リクエストが規制の対象かどうかを指定します。

  • 0 = リクエストは規制の対象ではありません。
  • 1 = リクエストは規制の対象です

us_privacy

オブジェクト; 任意

注意:このフィールドは、今後廃止される予定です。この情報は、代わりにRegs object (上記)の us_privacyフィールドに送られると捉えてください。

入札リクエスト内のユーザーに米国プライバシー法(CCPAなど)が適用されるかどうかを指定します。このフィールドには4文字が含まれています。例えば、1YYN。各文字の意味は、文字列内の位置によって以下に定義されます。

  • 1文字目:文字列のエンコーディングに使用されたUSプライバシー文字列仕様のバージョン番号。
  • 2文字目:ユーザーが個人情報の販売について明確な通知とオプトアウトする選択肢を与えられたかどうかを明示します:。
    • N = いいえ
    • Y= はい
    • -= 該当しない
  • 3文字目: ユーザーが自身の個人情報の販売を拒否したかどうかを明示します。
    • N = いいえ
    • Y= はい
    • -= 該当しない
  • 4th character: Specifies whether the Media Owner is a signed party to the IAB Limited Service Provider Agreement (LSPA). the Media Owner specifies whether the transaction is either a Covered Opt Out Transaction or a Non Opt Out Transaction.
    • N = いいえ
    • Y= はい
    • -= 該当しない

例えば、1---として渡された文字列は、米国のプライバシー規制が入札リクエストに適用されないことを指定します。

Note: When a consumer chooses to opt-out of the sale of their personal information, the following bid request fields are automatically adjusted:

  • ip (device object): The last octet of the user's IP address is replaced with a zero.
  • latおよびlon(Geoオブジェクト):緯度座標と経度座標は小数点以下2桁になり、3分の1マイル以上の精度になります。
  • deviceuserオブジェクトの入札リクエストで、間接的にユーザーを識別する一意のIDは削除されます。
  • dealsPMPオブジェクト):オーディエンスセグメントを対象とするディールIDが入札リクエストに追加されなくなります。

DSAオブジェクト

フィールドタイプ詳細

datatopub

整数、任意

A flag that specifies if the Media Owner requires DSA transparency data for audit purposes, where:

  • 0 ⁼ 透明性に関するデータを送信しない

  • 1 ⁼ 透明性に関するデータを送信するのは任意

  • 2 ⁼ 透明性に関するデータを送信しない

pubrender

整数、任意

A flag that specifies if the Media Owner is able to and intends to render the DSA transparency information received in the bid response. DSAの透明性情報は、アイコンまたは他の適切なユーザー向けシンボルによって、提示できる:

  • 0 ⁼ パブリッシャーはDSP情報を提示できない

  • 1 ⁼ 広告レンダラーによって、パブリッシャーはDSA情報を提示できる場合がある

  • 2 ⁼ パブリッシャーはDSA情報を提示する

transparency

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

透明性に関するオブジェクトの配列は、ユーザーパラメータに適用されるエンティティおよび適用したパラメータに含まれます。

dsarequired

整数:任意

入札レスポンスのDSAオブジェクトの中で、このリクエストに対して DSA情報を利用可能にすべきかどうかを指定するフラグ。これは入札リクエストがオンラインプラットフォーム/VLOP(超大規模オンラインプラットフォーム)に属することを示すもので、バイヤーのpubrender値に基づいてDSAの透明性情報でレスポンスする必要がある:

  • 0 ⁼ 必須ではない

  • 1 ⁼ 対応しているDSAオブジェクトの有無に関わらず、入札レスポンスが許可されます。

  • 2 ⁼ 必須。パブリッシャーがオンラインプラットフォーム上でDSAとして分類されていない可能性があるDSAオブジェクトのない入札レスポンスは拒否されます。

  • 3 ⁼ 必須。パブリッシャーがオンラインプラットフォーム上でDSAとして分類されているDSAオブジェクトのない入札レスポンスは拒否されます。

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

フィールドタイプ詳細

domain

文字列; 任意

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

dsaparams

整数配列; 任意

このユーザーをターゲットにする際に使用されたユーザーパラメータの配列:

  • 1 ⁼ プロファイリングユーザーの活動、興味、デモグラフィック、またはその他の特性に関する、コンテクストを横断して収集され使用されるユーザーに関する情報を含みます。

  • 2 ⁼ 基本的な広告デバイスの種類や機能、ユーザーエージェント、URL、IPアドレス、非精密な位置情報など、コンテンツやデバイスに関する情報を含む、広告が表示されるコンテキストに関するリアルタイムの情報の使用を含みます。さらに、ユーザー行動やユーザーの特徴に基づかない、基本的なクロスコンテキスト情報の使用は、フリクエンシー設定、順序付け、ブランドセーフティ、不正防止などの用途に使用されます。

  • 3 ⁼ 正確な位置情報ユーザーの正確なリアルタイム位置情報GPSは半径500メートル以内の精度。

広告インプレッションオブジェクト

このオブジェクトでは、オークション対象の広告配置や広告インプレッションの機会を説明します。1つの入札リクエストには、単一または複数のインプレッション機会に対して、1つ以上のimpオブジェクトを含む可能性があります。

Note: By default, Index separates multi-format eligible requests from our sellers into multiple discrete bid requests to DSPs, with one request per format. Indexは、マルチフォーマットのリクエストを許可し、1つのインプレッション機会で複数のクリエイティブタイプを受けとれます。例えば、1つのインプレッション機会において、bannervideonativeクリエイティブに対応するリクエストを受け取れます。マルチフォーマットリクエストを有効にするには、Index担当者にお問い合わせください。

フィールドタイプ詳細

id

文字列:必須

この広告インプレッションの一意の識別子。

tagid

文字列:任意

オークションを開始するために使用した、パブリッシャーのウェブサイト上の広告配置または広告タグの一意の識別子。DSPは、広告がウェブページまたはアプリのどこに掲載されているかを示す、このパブリッシャーインベントリの詳細な内訳を利用して、広告バイヤーキャンペーンの最適化とトラブルシューティングを行うことができます。

Note: If no tagid is specified, Index will pass its own site ID for the inventory to DSPs.

banner

オブジェクト:必須

バナーオブジェクト。

Note: All requests must include at least one Banner Object or Video Object.

bidfloor

フロート:任意

CPMにおけるこの広告インプレッションの最低入札価格。

bidfloorcur

文字列:任意

入札フロアプライスに使用される通貨で、常にUSDが指定されます。

secure

整数; 必須

広告インプレッションが、セキュアなHTTPS URLクリエイティブアセットとマークアップを必須とするかどうかを指定します。ここで:

  • 0 = セキュアなアセットは必須ではありません
  • 1 = セキュアなアセットが必須です

video

オブジェクト:必須

動画オブジェクト。

Note: All requests must include at least one Video object, Banner object, or native object.

native

オブジェクト; 必須

ネイティブオブジェクト。このフィールドは、この広告インプレッションがネイティブ広告機会として提供されている場合、必須です。

ext

オブジェクト:任意

この広告インプレッションのすべてのディールに関する追加情報を含む、カスタムのIndex Impression Extension Object。

instl

整数:任意

広告がインタースティシャル型であるかどうかを指定します。

  • 0=広告はインタースティシャル型ではありません
  • 1=広告はインタースティシャル型またはフルスクリーンです

metric

オブジェクト:任意

メトリックオブジェクトには、このインプレッションに関連する追加情報が含まれます。

rwdd

整数:任意

このインプレッションがリワードプレースメントと関連している場合は、次のように記載してください。

  • 0 = ad is not a rewarded placement
  • 1 = ad is a rewarded placement

pmp

オブジェクト:任意

この広告インプレッションのディールに関する情報を含むPMPオブジェクト。

インプレッション拡張オブジェクト

このカスタム拡張オブジェクトは、ディールとヘッダータグ入札に関する情報を伝達します。

フィールドタイプ詳細

bcrid

Array of strings; required

レビュー待ちのためブロックされているDSPクリエイティブIDや、Indexでブロックされているためオークションに参加できないDSPクリエイティブID。

注意:

  • 表示するクリエイティブIDの数は、DSPごとに設定可能です。
  • このフィールドは、当社が最適化改善を行っている間、一時的に利用できなくなります。

floor

整数配列:任意

入札フロア値の配列(単位:セント)。

Note: The array index identifies the bid floor of a seat with corresponding index in the wseat field of the Bid Request Object.

hb

整数:任意

ヘッダータグインベントリ入札リクエストを使用するかどうかを指定します。ここで:

  • 0 = 従来の広告タグリクエスト
  • 1 = ヘッダータグ広告リクエスト

Note: This is not included by default and DSPs must request it.

wopv

文字列:任意

The HUMAN, Inc.(Human; 旧社名White Ops)lookupID入札リクエストのlookupIDは、MediaGuardが広告リクエストをスキャンし、不正ではないと判断したことを示します。無効なトラフィック(IVT)のモニタリングについては、インベントリの品質を参照してください。

skadn

オブジェクト:任意

AppleのSKAdNetworkアプリインストール属性のパブリッシャーサポートを指定します。以下のSKAdNetwork拡張オブジェクトを参照してください。

gpid

文字列:任意

広告スロットまたは広告配置のグローバルプレースメント識別子(GPID)。GPIDの詳細については、グローバルプレースメント識別子(GPID)をIndexへ送信をご確認ください。

tid

文字列:任意

各インプレッションの一意の取引IDで、このインプレッション機会に入札しているすべてのエクスチェンジで共通です。この項目は、Per-Impression Transaction IDのOpenRTBコミュニティ拡張の実装です。

注意:このフィールドは、現在サポートしていませんが、近日中にDSPが利用できるようになります。

data

オブジェクト:任意

広告ユニットのコンテクスト情報を提供するパブリッシャーにより渡されたカスタムキーバリューが組み合わせられます。詳細は、インベントリグループ(ベータ)を利用したディールのカスタムキーバリューをターゲティングするをご確認ください。

ae

整数:任意

注意:2025年6月より、IndexはProtected Audience APIへの対応を一時的に停止します。その結果、このフィールドはIndexから送信されなくなります。

Protected Audience APIを利用している場合は、このフィールドがリクエストのオークション環境を指定します:

  • 0 ⁼ Protected Audience APIに対応せず、ブラウザで最終的なオークションが実施される(デフォルト)

  • 1 ⁼ Protected Audience APIに対応し、ブラウザ上で最終的なオークションが実施される

sid

文字列; 任意

セラーの接続データは、Indexに渡されます。このフィールドを使い、貴社のクライアント監査ログ(CAL)で受け取りたい、いずれかのカスタムデータを渡してください。

メトリックオブジェクト

メトリックオブジェクトは、メトリック配列のインプレッションと関連しています。このメトリックは、最新のビューアビリティや達成率、クリックスルー率などのインプレッションのインサイトも提供します。各メトリックはタイプ、メトリックの数値、また任意によるソースまたはベンダーが測定した数値により識別されます。

フィールドタイプ詳細
type

文字列:必須

このタイプのメトリックは、表示されます。Indexでは、以下のメトリックタイプに対応しています。

  • click_through_rate

  • session_depth

  • video_completion_rate

  • viewability

value

フロート:必須

数字は、メトリックの数値を表しています。確率は、0.0 - 1.0の範囲内です。

vendor

文字列:任意

エクスチェンジ・キュレーション文字列名を使用した値のソースです。Index passes through this value from the media owner if provided. Indexにより生成された全ての値は、ベンダーが"INDEXEXCHANGE"です。

バナーオブジェクト

このオブジェクトは、バナー広告インプレッションを記述するインプレッションオブジェクトのサブセットです。オークションにかけられた広告インプレッションがバナーかリッチメディアの場合は、バナーオブジェクトインプレッションオブジェクトに直接含めてください。Optionally, Media Owners could embed it in the Video object to describe companion banners available for linear or non-linear video ads. バナーインプレッションで利用可能な広告サイズの詳細は対応広告サイズの一覧をご確認ください。

フィールドタイプ詳細

format

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

インプレッション機会で指定されたバナーサイズのformat オブジェクト配列。

注意:

  • デフォルトでは、すべてのパートナーに対して有効になっていません。format オブジェクトを有効にするには、Index担当者までお問い合わせください。
  • Partners who are enabled to receive the format object must include the w and h values in the bid object of the bid response.
  • For partners that do not support the format object, Index by default includes the maximum size supported by you in the bid request.

h

整数; 必須

この広告インプレッションの高さ(ピクセル)。

topframe

ブール値:必須

バナー広告がトップフレーム配信かiframeで配信されるのかを指定します。ここで:

  • 0 = 広告はiframeで表示されます
  • 1 = 広告はiframeで表示されません

w

整数:必須

この広告インプレッションの幅(ピクセル)。

battr

配列; 任意

ブロック対象のクリエイティブ属性を示します。空欄の場合は、すべてのタイプが許可されているものと見なされます。値の全一覧については、AdCOM 1.0のList: Creative Attributesを参照してください。

expdir

整数配列:任意

拡張可能な広告の方向を指定します。ここで:

  • 1 = 左
  • 2 = 右
  • 3 = 上
  • 4 = 下
  • 5 = フルスクリーン

api

整数配列:任意

対応APIフレームワークを指定します。

  • 1 = VPAID 1.0
  • 2 = VPAID 2.0
  • 3 = MRAID 1.0
  • 4 = ORMMA
  • 5 = MRAID 2.0
  • 6 = MRAID 3.0
  • 7 = OMID 1.0

デフォルトでは、カスタムAPIは非対応であるとみなされます。

hmax

文字列:任意

広告インプレッションの最大高(ピクセル)。これが含まれている場合、この最大高であらゆるサイズが許可されていることが示され、hが推奨サイズであると考えられます。含まれていない場合、hのみが要件であると考えられます。

hmin

文字列:任意

広告インプレッションの最小高(ピクセル)。これが含まれている場合、この最小高であらゆるサイズが許可されていることが示され、hが推奨サイズであると考えられます。含まれていない場合、hのみが要件であると考えられます。

id

文字列:任意

このバナーオブジェクトの一意の識別子; 特に、複数のバナーオブジェクトを追跡する場合に便利です(例、コンパニオンバナー配列で)。通常は1で始まり、オブジェクトごとに増えていきます。

mimes

文字列配列:任意

対応している許可されたコンテンツMIMEタイプ。一般的なMIMEタイプにはimage/jpgimage/gifが含まれていますが、これに限定されません。

pos

整数:任意

広告の位置を、可視性や優位性の相対的な尺度で指定します。

  • 0 = 不明
  • 1 =アバブザフォールド(デフォルト)
  • 2 = 非推奨(解像度に依存)
  • 3 = ビロウザフォールド
  • 4 = ヘッダー
  • 5 = フッター
  • 6 = サイドバー
  • 7 = フルスクリーン

wmax

整数:任意

広告インプレッションの最大幅(ピクセル)。これが含まれている場合、この最大幅であらゆるサイズが許可されていることが示され、wが推奨サイズであると考えられます。含まれていない場合、wのみが要件であると考えられます。

wmin

整数:任意

広告インプレッションの最小幅(ピクセル)。これが含まれている場合、この最小幅であらゆるサイズが許可されていることが示され、wが推奨サイズであると考えられます。含まれていない場合、wのみが要件であると考えられます。

バナー拡張オブジェクト

フィールドタイプ詳細

bidfloor

フロート:任意

このバナーインプレッションの最低入札価格(CPM)。

動画オブジェクト

このオブジェクトは、バナー広告インプレッションを記述するインプレッションオブジェクトのサブセットです。imp配列は、一つの動画インプレッションまたは複数の動画インプレッションを含みます。以下に基づいて、広告ポッドまたは非広告ポッドであることを示します。

  • 単一の動画インプレッションの入札リクエストで、podidpoddurmaxseqフィールドを含み、ダイナミック広告ポッドリクエストであることを示します。それ以外の場合は、非広告ポッドの単一インプレッションリクエストとして示されます。

  • 複数の動画インプレッションがある入札リクエストは、既定の広告ポッドリクエストとして示され、リクエスト内の全てのインプレション機会は同じpodidが存在します。

Note: By default, Index sends single-impression video requests for a video pod to DSPs. ストリーミングTVインベントリにおいて、OpenRTB 2.6広告ポッドを有効にしたい場合は、Index担当者にお問い合わせください。

フィールドタイプ詳細

maxduration

整数:必須

動画広告の最大継続時間(秒)。

minduration

整数; 必須

動画広告の最小継続時間(秒)。

mimes

Array of strings; required

サポート対象のコンテンツMIMEタイプのリスト。HTML5プレーヤー対応の一般的なMIMEタイプに含まれるもの:

  • video/mp4
  • video/webm
  • video/ogg

VPAIDサポートのためには、必ずapplication/javascriptを指定してください。

protocols

Array of integers; required

対応する動画プロトコルの配列。対応可能なプロトコルを少なくとも1つ指定する必要があります。

  • 2 = VAST 2.0
  • 3 = VAST 3.0
  • 5 = VAST 2.0ラッパー
  • 6 = VAST 3.0ラッパー
  • 7 = VAST 4.0
  • 8 = VAST 4.0 Wrapper
  • 11 = VAST 4.1
  • 12 = VAST 4.1 Wrapper
  • 13 = VAST 4.2
  • 14 = VAST 4.2ラッパー

api

整数配列:任意

対応APIフレームワークのリスト。

  • 1 = VPAID 1.0
  • 2 = VPAID 2.0
  • 3 = MRAID 1.0
  • 4 = ORMMA
  • 5 = MRAID 2.0
  • 6 = MRAID 3.0
  • 7 = OMID 1.0

デフォルトでは、カスタムAPIは非対応であるとみなされます。

boxingallowed

整数:任意

4:3コンテンツの16:9枠のレターボックス化が許可されているかどうかを指定します。

  • 0 = ボックス化は許可されていません
  • 1 = ボックス化が許可されています(デフォルト設定)

battr

配列; 任意

ブロックされたクリエイティブ属性を指定します。空欄の場合、すべてのタイプが許可されているとみなされます。

companionad

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

利用可能なコンパニオン広告は、バナーオブジェクトの配列として表示されます。

companiontype

整数配列:任意

サポート対象のVASTコンパニオン広告タイプのリスト。ここで:

  • 1 = 静的リソース
  • 2 = HTMLリソース
  • 3 = iframeリソース

delivery

整数配列:任意

対応する配信方法のリスト。空欄の場合、すべてがサポート対象であるとみなされます。ここで:

  • 1 = ストリーミング
  • 2 = プログレッシブ

ext

オブジェクト:任意

この広告インプレッションに関する追加情報を含むカスタムのIndex Video Extension Object。

h

整数:任意

プレーヤーの高さ(ピクセル)。

linearity

整数:任意

広告インプレッションがリニアか、非リニアかを指定します。このフィールドが空欄の場合、広告インプレッションはどのタイプでも可能です。

  • 1 = リニア/インストリーム
  • 2 = 非リニア/オーバーレイ

maxextended

整数:任意

拡張が許可されている場合の、拡張広告の最長期間。

  • 空欄または0 = 拡張は許可されていません。
  • -1 = 拡張は許可されており、時間制限は課されていません。
  • 0より大きい場合 = 最長期間の値を超えてサポートされている拡張再生の秒数を表します。

maxbitrate

整数:任意

最大ビットレート(Kbps)。

minbitrate

整数:任意

最小ビットレート(Kbps)。

placement

整数:任意

動画の配置タイプ。

  • 1 = インストリーム
  • 2 = インバナー
  • 3 = インアーティクル
  • 4 = インフィード
  • 5 = インタースティシャル/スライダー/スローティング

注意:OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

plcmt

整数:任意

更新された IAB Digital Video Guidelinesに従った動画プレースメントのタイプ

  • 1 = インストリーム
  • 2 = コンテンツ連動型
  • 3 =インタースティシャル
  • 4 = コンテンツ非連動型

skip

整数:任意

プレーヤーが動画のスキップを許可するかどうかを指定します。

  • 0 = いいえ
  • 1 = はい

skipmin

整数:任意

動画の合計再生時間は、こちらの時間(秒)より長い

スキップ可能:広告がスキップ可能な場合のみ適用できます。

skipafter

整数:任意

スキップするまでに必要な動画の再生時間

:広告がスキップ可能な場合のみ適用できます。

playbackmethod

整数配列:任意

許可されている再生方法のリスト。

  • 1 = ページロード時に自動で音声オンの動画を再生
  • 2 = ページロード時に自動で音声オフの動画を再生
  • 3 = クリック再生
  • 4 = マウスオーバー
  • 5 = ビューポートに入る時のみ音声オンの動画を再生
  • 6 = ビューポートに入る時のみ音声オフの動画を再生

空欄の場合、Indexでは、すべての方法が許可されていると考えられます。

pos

整数:任意

広告の位置を、可視性や優位性の相対的な尺度で指定します。

  • 0 = 不明
  • 1 =アバブザフォールド(デフォルト)
  • 2 = 非推奨(解像度に依存)
  • 3 = ビロウザフォールド
  • 4 = ヘッダー
  • 5 = フッター
  • 6はサイドバー
  • 7はフルスクリーン

sequence

整数:任意

複数の広告インプレッションが同じ入札リクエストで提供された場合、シーケンス番号によって複数のクリエイティブの同時配信が可能になります。

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

startdelay

整数:任意

プレロール、ミッドロール、またはポストロールの広告プレースメントにおいて、開始遅延(秒)を指定します。

  • >0 = ミッドロール(秒単位で再生の遅延を示す数値)
  • 0 = プレロール
  • -1 = 一般的なミッドロール
  • -2 = 一般的なポストロール

w

整数:任意

プレーヤーの幅(ピクセル)。

動画拡張オブジェクト

このカスタム拡張オブジェクトは、アウトストリーム動画の広告インプレッションに関連するプレーヤータイプを指定します。

フィールドタイプ詳細

bidfloor

フロート:任意

この動画インプレッションの最低入札価格(CPM)。

playertype

整数:任意

このアウトストリーム動画広告インプレッションに関連するプレーヤータイプを指定します。

  • 1 = インニュースフィード
  • 2 = インアーティクル

空欄の場合、従来のインスチーム型のプレーヤーであるとみなされます。

renderedBy

整数:任意

誰がビデオ広告をレンダリングするかを明示します。

  • 1 = the Media Owner will render the video ad
  • 2 ⁼ Indexがビデオ広告をレンダリングする

If blank, it is assumed that the Media Owner will render the video ad.

rewarded

整数、任意

広告が、成果報酬型動画広告体験の一環としてレンダリングされるかどうかを指定します。

  • 0 = レンダリングしない
  • 1 = レンダリングする

ネイティブオブジェクト

impressionオブジェクトの下位にnativeオブジェクトが存在する場合、この広告インプレッションがネイティブタイプの広告インプレッションとして提供されていることを指定します。At the Media Owner's discretion, that same impression may also be offered as banner or video by also including them as imp subordinate objects of those types.

フィールドタイプ詳細

request

文字列:必須

OpenRTB Dynamic Native Ads API仕様書 Version 1.2に従うリクエストペイロード。native.requestオブジェクトに関する詳細については、DSP向け:ネイティブ広告のOpenRTB入札リクエストフィールドの対応一覧を参照してください。

ver

文字列:任意

使用中のネイティブマークアップのバージョン。

api

整数配列:任意

この広告インプレッションの対応APIフレームワークのリスト。APIがリストにない場合は、対応していないものとみなされます。

battr

整数配列:任意

ブロックされたクリエイティブ属性。詳細については、クリエイティブのアトリビュート一覧を参照してください。

ネイティブ拡張オブジェクト

フィールドタイプ詳細

bidfloor

フロート:任意

このネイティブインプレッションの最低入札価格(CPM)。

renderedBy

整数:任意

誰がネイティブ広告をレンダリングするかを明示します。

  • 1 = the Media Owner will render the native ad
  • 2 ⁼ Indexがネイティブ広告をレンダリングする

If blank, it is assumed that the Media Owner will render the native ad.

フォーマットオブジェクト

format オブジェクト仕様は、バナーインプレッション機会の許可されたサイズ、高さと幅の組み合わせ。複数のサイズが許可されている場合に、配列で使用されます。

フィールドタイプ詳細

h

整数:任意

デバイスに依存すつピクセルの高さ

w

整数:任意

デバイスに依存するピクセルの幅

PMPとディールオブジェクト

PMPオブジェクト

フィールドタイプ詳細

private_auction

整数:任意

この広告インプレッションのDSP入札資格の範囲。

1は非公開です(有資格入札は、指定されたディールに限定されます)。

deals

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

この広告インプレッションに対して適切な一切の直接ディールを含む、直接ディールオブジェクトの集まり。

ext

オブジェクト:任意

このディールに関する追加情報を含むカスタムのIndexPMP Extension Object。

ディールオブジェクト

PMPオブジェクトには、1つ以上の追加のディールオブジェクトが含まれ、それぞれがこの広告インプレッションに対する異なる直接ディールを表します。

フィールドタイプ詳細

id

文字列:必須

ダイレクトディール用の一意の識別子。

at

整数:任意

この直接ディールのためのオークションタイプ。

  • 1 = ファーストプライスオークション
  • 3 = 固定価格オークション

注意: セカンドプライスオークションのタイプは、非推奨でサポートは終了しました。

bidfloor

Integer (if sent as cents, like 134) or Float (if sent as dollars, like 1.34); optional

米国におけるこの直接ディールの指定フロアプライス(既定ではセントで送信されます)。

Note: It can be sent in dollars if requested, but the price in the response Bid Object must also be sent in dollars.

bidfloorcur

文字列:任意

入札フロアプライスに使用される通貨で、常にUSDが指定されます。

wseat

文字列:任意

ディールにおける入札の許可を受けたバイヤーシート(広告主、代理店など)のホワイトリスト。

PMPエクステンションオブジェクト

PMPオブジェクトには、ダイレクトディールに関する追加情報を含むIndexカスタムPMP拡張オブジェクトtが含まれる場合があります。

フィールドタイプ詳細

name

文字列:任意

プライベートマーケットで作動するすべての広告インプレッションの配置名。:"The Daily Times"。

ディール拡張オブジェクト

フィールドタイプ詳細

disc

Float

オークション開催中にDSPに透明性を提供し、オークション終了後の割引機会を特定するため、IndexがDSPへの入札リクエストでこのフィールドを渡す。パブリッシャーとバイヤーとの間で交渉された割引を表す0.01~1.0の数値。この値は落札インプレッションの${AUCTION_PRICE}落札通知マクロに適用されます。Indexでは、割引は小数点以下1桁の値に対応しています(例:15.5%)。

Example: A 25% discount is sent as disc = 0.25. For a $10.00 winning bid, the 25% discount is applied and passed as $7.50 in the ${AUCTION_PRICE} macro.

ディールの割引の詳細については、ディールの割引交渉を参照してください。

guaranteed

整数:任意

このディールは、パブリッシャーとバイヤーが固定価格で正確なインプレッション数を交渉する保証された取引です。

  • 1 = ギャランティードディール

SKAdNetwork拡張オブジェクト

skadnオブジェクトには拡張オブジェクトが含まれている場合があります。詳細については、OpenRTBのSKAdNetworkの拡張を参照してください。

フィールドタイプ詳細

version

文字列:任意

対応しているSKAdNetworkのバージョン。このフィールドは常に「2.0」以上で、OSのバージョンとSDKのバージョンの両方に依存しています。

Note: With the release of SKAdNetwork 2.1, this field is deprecated in favor of the versions field to support an array of version numbers.

versions

文字列配列:任意

対応しているSKAdNetworkのバージョンを含む文字配列。このフィールドは常に「2.0」以上で、OSのバージョンとSDKのバージョンの両方に依存しています。

Example: "versions": ["2.0", "2.1", "2.2"]

sourceapp

文字列:任意

The ID of the Media Owner app in Apple's app store. OpenRTB 2.xのapp.bundleとAdCOM 1.xのapp.storeidと一致していなければいけません。

Example: "sourceapp": "880047117"

skadnetids

文字列配列:任意

A subset of SKAdNetworkItem entries in the Media Owner app's Info.plist, expressed as lowercase strings, that are relevant to the bid request. このリストが10を超えないようにしてください。

Note: BidRequest.imp.ext.skadn.skadnetlist.addl is the preferred method to express raw SKAdNetwork IDs.
skadnetlistオブジェクト:任意IABのリスト定義を含むオブジェクト。以下のSKAdNetworkオブジェクトを参照してください。

Example: "skadnetlist": {"max": 306, "excl": [2,8,10,123], "addl": ["cdkw7geqsh.skadnetwork", "qyJfv329m4.skadnetwork"]}

SKAdNetworkオブジェクト

このオブジェクトは、IABのskadnetworkオブジェクトリストフィールドを提供します。

フィールドタイプ詳細

max

整数:任意

A list containing the max entry ID of SKAdNetwork ID.

"max":306

excl

整数配列:任意

IAB共有リストから除外される、IAB登録IDのカンマ区切りのリスト。

Example: "excl": [44,14,18]

addl

文字列配列:任意

A comma-separated list of string SKAdNetwork IDs, expressed as lowercase strings, not included in the IAB shared list. このリストのIDは、10以下であることを推奨します。

Example: "addl": ["cdkw7geqsh.skadnetwork", "qyjfv329m4.skadnetwork"]

サイトオブジェクト

フィールドタイプ詳細

id

文字列:必須

Indexが、そのウェブサイトに割り当てた一意の識別子。

cat

文字列配列:任意

サイト全体の標準IABコンテンツカテゴリを表す単一エレメントの配列。例えば、 ["IAB3-7"]。完全なリストについては、OpenRTB仕様(第2.2版)第6.1節を参照してください。

content

オブジェクト:任意

コンテンツオブジェクト。contentオブジェクトに関する詳細については、以下のcontentオブジェクトを参照してください。

domain

文字列:任意

A static value that represents the site's domain.

inventorypartnerdomain

文字列:任意

A pointer to the domain of a partner that is explicitly authorized to monetize ads within this site's content. パートナーの対応するapp-ads.txtまたはads.txtファイルは、このドメインにホストされ、サプライチェーンの認証に使用されます。

このフィールドの実装方法については、IABの ads.txt仕様をご確認ください。

mobile

整数、任意

サイトが、モバイルデバイスで閲覧した場合にレイアウトが最適化されるようプログラムされているかどうかを指定します。

  • 0 = いいえ
  • 1 = はい

page

文字列:任意

この広告インプレッションが表示されるページのURL。

producer

オブジェクト:任意

コンテンツの制作者に関する詳細が提供されます。producerオブジェクトに関する詳細については、以下のproducerオブジェクトを参照してください。

publisher

オブジェクト:任意

パブリッシャーオブジェクト。

ref

文字列:任意

この広告インプレッションをホストしているページへ飛ぶ要因となった参照URL。512文字を超える部分は切り捨てられます。

サイト拡張オブジェクト

フィールドタイプ詳細

data

オブジェクト:任意

サイトのコンテクスト情報を提供するパブリッシャーにより渡されたカスタムキーバリューが組み合わせられます。詳細は、インベントリグループ(ベータ)を利用したディールのカスタムキーバリューをターゲティングするをご確認ください。

inventorypartnerdomain

文字列:任意

A pointer to the domain of a partner that is explicitly authorized to monetize ads within this site's content. パートナーの対応するapp-ads.txtまたはads.txtファイルは、このドメインにホストされ、サプライチェーンの認証に使用されます。

このフィールドの実装方法については、IABの ads.txt仕様をご確認ください。

アプリオブジェクト

フィールドタイプ詳細

id

文字列; 必須

Indexが割り当てた、アプリのための固有の数字識別子

bundle

文字列:任意

The App name or bundle (for example, "com.foo.mygame"), used as a unique identifier across exchanges.

cat

文字列配列:任意

サイト全体の標準IABコンテンツカテゴリ(例: ["IAB3-7"])。全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。

cattax整数、任意The taxonomy in use for the cat field , where the taxonomy used determines the meaning of a category code like ["IAB3-7"]. 全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。If the cattax field is not sent, IAB Content Category Taxonomy 1.0 is assumed.

content

オブジェクト、任意

アプリ内のコンテンツに関する詳細。contentオブジェクトに関する詳細については、以下のcontentオブジェクトを参照してください。

domain

オプション

アプリのドメインを表す静的値。

inventorypartnerdomain

文字列:任意

パートナーのドメインへのポインタで、アプリケーションのコンテンツ内広告で明確に収益化が許可されたもの。パートナーの対応するapp-ads.txtまたはads.txtファイルは、このドメインにホストされ、サプライチェーンの認証に使用されます。

このフィールドの実装方法については、IABの ads.txt仕様をご確認ください。

keywords

文字列:任意

アプリに関連するキーワードのカンマ区切りのリスト。最大255文字

name

文字列:任意

アプリ名。It may be masked if requested by the Media Owner.

paid

整数、任意

アプリが有料版であるのか無料版であるのかを指定します。

  • 0 = アプリは無料です
  • 1 = アプリは有料です

privacypolicy

整数:任意

アプリにプライバシーポリシーが存在するかどうかを指定します。

  • 0 = いいえ
  • 1 = はい

producer

オブジェクト:任意

コンテンツの制作者に関する詳細が提供されます。producerオブジェクトに関する詳細については、以下のproducerオブジェクトを参照してください。

publisher

オブジェクト:任意

パブリッシャーオブジェクト。

storeurl

文字列:任意

QAG 1.5準拠のインストール済アプリのApp Store URL。

ver

文字列:任意

アプリケーションのバージョン。

ext

オブジェクト:任意

アプリインプレッション機会の詳細情報を提供するために使用されるアプリ拡張オブジェクト。

アプリ拡張オブジェクト

appオブジェクトには、拡張オブジェクトが含まれている場合があります。アプリインプレッション機会に関する追加情報を提供します。

フィールドタイプ詳細

inventorypartnerdomain

文字列:任意

パートナーのドメインへのポインタで、アプリケーションのコンテンツ内広告で明確に収益化が許可されたもの。パートナーの対応するapp-ads.txtまたはads.txtファイルは、このドメインにホストされ、サプライチェーンの認証に使用されます。

このフィールドの実装方法については、IABの ads.txt仕様をご確認ください。

data

オブジェクト:任意

アプリのコンテクスト情報を提供するパブリッシャーにより渡されたカスタムキーバリューが組み合わせられます。詳細は、インベントリグループ(ベータ)を利用したディールのカスタムキーバリューをターゲティングするをご確認ください。

Content, Producer, and Publisher objects

コンテンツオブジェクト

フィールドタイプ詳細

album

文字列:任意

コンテンツが帰属するアルバム(通常、オーディオ用)。

artist

文字列:任意

コンテンツにクレジットされているアーティスト。

cat

文字列配列:任意

サイト全体の標準IABコンテンツカテゴリを表す単一エレメントの配列。例えば、["IAB3-7"]。全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。

cattax整数、任意The taxonomy in use for the cat field , where the taxonomy used determines the meaning of a category code like ["IAB3-7"]. 全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。If the cattax field is not sent, IAB Content Category Taxonomy 1.0 is assumed.

channel

オブジェクト、任意

チャネルオブジェクト

contentrating

文字列:任意

コンテンツの評価(例えば、MPAA)。

context

整数:任意

コンテンツのタイプを指定します。

  • 1 = 動画(動画ファイルまたはインターネットTV放送)

  • 2 = ゲーム(インタラクティブソフトウェアゲーム)

  • 3 = 音楽(オーディオファイルまたはインターネットラジオ放送)

  • 4 = アプリケーション(インタラクティブソフトウェアアプリケーション)

  • 5 = テキスト(ウェブページ、eBook、ニュース記事)

  • 6 = その他

  • 7 = 不明

data

オブジェクト配列:任意

追加のコンテンツデータが提供されます。

embeddable

整数:任意

コンテンツが埋込可能かどうかを示すインジケータ。

  • 0 = いいえ

  • 1 = はい

episode

文字列:任意

動画コンテンツに適用されるエピソード番号。

ext

オブジェクト:任意

コンテンツオブジェクトのIndex専用拡張プレースホルダーコンテンツ拡張オブジェクト表をご確認ください。

genre

文字列:任意

コンテンツを最も良く表現するジャンル。例えば、ロック、ポップスなど。

id

文字列:任意

コンテンツを一意に識別するID。

isrc

文字列:任意

ISO-3901に準拠した、国際標準レコーディングコード(ISRC)。

keywords

文字列:任意

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

language

文字列:任意

ISO-639-1-alpha-2に準拠した、最初の2文字(大文字)。例えば、"EN"

len

整数:任意

動画とオーディオに使用され、コンテンツの長さ(秒)を指定します。

livestream

整数:任意

コンテンツがライブ配信かどうか(例えば、ストリーミングまたはライブブログ)を指定します。ここで:

  • 0 = ライブ配信ではない

  • 1 = コンテンツはライブ配信

network

オブジェクト:任意

ネットワークオブジェクト

prodq

整数:任意

制作の品質を指定します。

  • 0 = 不明

  • 1 = プロ制作

  • 2 = プロシューマー(生産消費者)

  • 3 = ユーザー生成コンテンツ(UGC)

producer

オブジェクト:任意

コンテンツ制作者に関する詳細。詳細については、以下のproducerオブジェクト表を参照してください。

qagmediarating

整数:任意

品質保証ガイドライン(QAG)に基づくメディア評価。

  • 1 = すべてのオーディエンス

  • 2 = 12歳以上のすべての人

  • 3 = 成人向け

season

文字列:任意

コンテンツのシーズン(例えば、 "Season 3")。

series

文字列:任意

コンテンツのシリーズ。

sourcerelationship

整数:任意

ソースとの関係を指定します。

  • 0 = 間接的

  • 1 = 直接的

title

文字列:任意

コンテンツのタイトル。

url

文字列:任意

コンテンツのURL、バイサイドのコンテキスト化またはレビューに使われます。

userrating

文字列:任意

ユーザーがコンテンツをどう評価したか。例えば、星の数、「いいね」の数。

videoquality

整数:任意

画質を指定します。

コンテンツ拡張オブジェクト

contentオブジェクトには、インプレッションコンテンツを表すIndex専用拡張オブジェクトを含む可能性があります。

フィールドタイプ詳細

channel

文字列:任意

コンテンツが再生されている特定のチャネル。

content_channel

文字列:任意

コンテンツが再生されている特定のチャネル。

network

文字列:任意

ペアレントコンテンツネットワークには複数のチャネルが含まれます。

content_network

文字列:任意

ペアレントコンテンツネットワークには複数のチャネルが含まれます。

distrib_name

文字列:任意

The alternate name under which the Media Owner distributes the content.

チャネルオブジェクト

このオブジェクトは、広告が表示されるチャネルを示しています。チャネルは、MTVなどの視聴者向けのブランド名内で、コンテンツライブラリまたはストリームを厳選する実体として定義されます。

フィールドタイプ詳細

id

文字列:任意

A unique identifier assigned by the Media Owner. これは、すべてのサプライソースの中で固有の識別子です。

name

文字列:任意

コンテンツが有効になっているチャネル。例:"MTV"

domain

文字列:任意

チャネルのプライマリドメイン。例:"mtv.com"

トップレベルのドメインを含ませることを推奨します。それにより、DSPがターゲットしやすくなります。

ネットワークオブジェクト

このオブジェクトは、広告が表示されるネットワークを示しています。A network is defined as the parent entity of the Channel object's entity, and is used for the purposes of organizing channels. ネットワークの例は、Discoveryのようなコンテンツチャネルのコレクションを所有または使用許可を与えている会社です。

フィールドタイプ詳細

id

文字列:任意

A unique identifier assigned by the Media Owner. これは、すべてのサプライソースの中で固有の識別子です。

name

文字列:任意

コンテンツが有効なネットワーク。例:"Discovery"

domain

文字列:任意

チャネルのプライマリドメイン。例:"discovery.com"

It's recommended to include the top-level domain so it's easier for DSPs to target.

制作者オブジェクト

フィールドタイプDescription

cat

文字列配列:任意

サイト全体の標準IABコンテンツカテゴリを表す単一エレメントの配列。例えば、["IAB3-7"]。全ての値の一覧は、AdCOM 1.0のList: Category Taxonomiesをご覧ください。

domain

文字列:任意

コンテンツ制作者の最高レベルのドメイン。例:producer.com

ext

オブジェクト:任意

制作者オブジェクトへのIndex専用拡張子のプレースホルダ。

id

文字列:任意

コンテンツの制作者または発信者を表すID。コンテンツが多数の相手に同時に配給されており、埋込タグを使ってサイトに投稿されている場合、このフィールドが役立ちます。

name

文字列:任意

コンテンツの制作者や発信者名。例: Warner Bros

パブリッシャーオブジェクト

フィールドタイプ詳細

id

文字列:必須

Index固有のパブリッシャーID。

name

文字列:任意

A name that represents the Media Owner that can be masked if requested.

Note: This field is always present when a deal exists.

デバイスオブジェクト

フィールドタイプ詳細

carrier

文字列:任意

通信事業者またはISP。例えば、「VERIZON」。モバイルでは、高帯域幅(例:セル方式と比較して動画を再生しやすい)を示すために「WIFI」がよく使用されます。

devicetype

整数:任意

入手可能な場合、この広告インプレッションに対して使用されているデバイスタイプ。

  • 1 = モバイルまたはタブレット
  • 2 = パソコン
  • 3 = コネクテッドTV
  • 4 = 電話
  • 5 = タブレット
  • 6 = コネクテッドデバイス
  • 7 = セットトップボックス

didmd5

文字列:任意

MD5でハッシュ化されたハードウェアデバイスID。例えば、IMEI

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

didsha1

文字列:任意

SHA1でハッシュ化されたハードウェアデバイスID。例えば、IMEI

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

dpidmd5

文字列:任意

MD5でハッシュ化されたプラットフォームデバイスID。例えば、Android ID

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

dpidsha1

文字列:任意

SHA1でハッシュ化されたプラットフォームデバイスID。例えば、Android ID

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

geo

オブジェクト:任意

Geoオブジェクト

h

整数:任意

デバイスの画面の物理的な高さ(ピクセル)。

Note: Only supported in OpenRTB 2.3.

hwv

文字列:任意

デバイスのハードウェアバージョンを表します。例えば、「5S」はiPhone 5Sを表します。

Note: Only supported in OpenRTB 2.3.

connectiontype

整数:任意

デバイスが使用するネットワークの接続タイプ。

  • 0 = 不明

  • 1 = イーサネット

  • 2 = WiFi

  • 3 = 携帯電話ネットワーク - 世代不明

  • 4 = 携帯電話ネットワーク - 2G

  • 5 = 携帯電話ネットワーク - 3G

  • 6 = 携帯電話ネットワーク - 4G

ifa

文字列:任意

クリアテキスト(ハッシュ化されていない)で広告主が使用できるよう許可されたID。プライバシーサポート有りの広告識別子で、device.lmtdevice.ext.ifa_typeフィールドと共に使用されています。

ip

文字列:任意

ユーザーのIPv4アドレスのドットオクテット表記。

Note: This field is required if the bid request does not contain the ipv6 field. 以下のipv6フィールドを参照してください。

ipv6

文字列:任意

The IP address closest to the device, specified in IPv6 format (for example, "fe80:0:0:0:200:f8ff:fe21:67cf"). Indexは、お客様がIPv6トラフィックに対応している場合にのみ、入札リクエストを送信します。IPv6リクエストの受信を開始したい場合は、Index担当者の担当者までお問い合わせください。

Note: Index always sends one of either device.ip or device.ipv6 in all bid requests.

language

文字列:任意

ヘッダーの最初の2文字(大文字)。例えば、HTTP_ACCEPT_LANGUAGE "EN"

lmt

整数:任意

この広告インプレッションに関連する追跡範囲を指定します。このシグナルは、標準トラッキング拒否(DNT)機能の商用化されたバージョン(iOSやAndroidによって承認される)を表します。

  • 0 = 追跡は無制限
  • 1 = 追跡は商用利用ガイドラインに沿って制限されること

Note: Only supported in OpenRTB 2.3.

macmd5

文字列:任意

デバイスのMACアドレス:MD5によりハッシュ化。

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

macsha1

文字列:任意

デバイスのMACアドレス:SHA1によりハッシュ化。

注意: OpenRTB 2.6でこのフィールドは廃止されましたが、Indexではサポートを継続します。

make

文字列:任意

デバイスのメーカー。例えば、"Apple"

model

文字列:任意

デバイスのモデル。例:"iPhone"

os

文字列:任意

デバイスのオペレーティングシステム。例えば、"iOS"

osv

文字列:任意

デバイスのオペレーティングシステムのバージョン。例えば、“3.1.2"

ppi

整数、任意

リニアインチあたりのピクセル。

Note: Only supported in OpenRTB 2.3.

pxratio

フロート:任意

デバイスに依存しないピクセル数に対する物理ピクセルの比率。

Note: Only supported in OpenRTB 2.3.

ua

文字列:任意

このユーザーのHTTP_USER_AGENTヘッダーのコンテンツ。512文字を超える部分は切り捨てられます。

sua

オブジェクト:任意

UserAgentオブジェクトで指定された、構成されたユーザーエージェントの情報uasuaフィールドに数値が含まれている場合、suaには停止または減少されたユーザーエージェント文字列が含まれているのでuaはより正確だと考えられます。

w

整数:任意

デバイス画面の物理的な幅(ピクセル)。

Note: Only supported in OpenRTB 2.3.

ext

整数、任意

A placeholder for Index-specific extensions to the device object. 以下のデバイス拡張オブジェクトを参照してください。

デバイス拡張オブジェクト

deviceオブジェクトには、アプリのアプリ追跡許可ステータスとIDFVを示す拡張オブジェクトが含まれる場合があります。IABテックラボのCTV/OTTプラットフォーム上の広告主向け識別子ガイドラインに沿った広告識別子(IFA)のソース値も含まれている可能性があります。

フィールドタイプ詳細

atts

整数; 任意

アプリのアプリ追跡許可ステータスを表すために渡される、iOS専用フィールド。

  • 0 = 未定

  • 1 = 制限あり

  • 2 = 却下

  • 3 = 許可

cdep

文字列:任意

備考:2025年6月より、IndexはProtected Audience APIへの対応を一時的に停止します。As a result, the ae = 1 field won't be sent in bid requests to DSPs. その一方、Topics APIデータは送信されます。

このフィールドは、Protected Audience APIおよびTopics APIを含むプライバシーサンドボックスAPIのパフォーマンスを測定するためにChromeによって使用されます。サードパーティクッキーの廃止に備え、Chromeがサードパーティクッキー不要でサイトの動作や機能がどのように作動するかをプレビューできるよう、Chromeによるテストモードを提供する予定です。ブラウザはテストのためにオプトインされるか、ブラウザから受け取ったトラフィックに対して1%のサードパーティ・クッキーが非推奨となる可能性があります。cdepフィールドには、この情報がラベルの形で含まれている。Chrome主導のテストモードやラベルに関する詳細は、GoogleのChrome主導テストをご確認ください。

モードAトラフィックのラベル:control_1.*label_only_1label_only_2label_only_3label_only_4label_only_5

Mode Bトラフィックのラベル:treatment_1.*control_2

注意:

  • Indexが2023年12月にDSPにこのフィールドの送信を開始する。

  • Indexが、Mode Aのcontrol_1.*ラベルを受信した場合、DSPへの入札リクエストにはTopics APIの情報は送信されません。

  • IndexがMode Alabel_only_4またはlabel_only_5ラベルを受信する場合:

    • Topics API情報は、入札リクエストでDSPに送信されます。
    • The traffic will not be subject to Buyer Traffic Optimization (BTO), which is Index's solution to optimize traffic that is sent to DSPs. これは、スロットリングすることなく、アドテクベンダー全体でテストを実施します。

  • IndexがMode Alabel_only_1label_only_2またはlabel_only_3ラベルを受信する場合:
    • 全てのTopics API情報は、入札リクエストでDSPに送信されます。
    • The traffic will be subject to Buyer Traffic Optimization (BTO), which is Index's solution to optimize traffic that is sent to DSPs.

  • IndexがMode B、treatment_1.*ラベルを受信する場合:
    • 全てのTopics API情報は、入札リクエストでDSPに送信されます。
    • The traffic will not be subject to Buyer Traffic Optimization (BTO), which is Index's solution to optimize traffic that is sent to DSPs. これは、スロットリングすることなく、アドテクベンダー全体でテストを実施します。

  • IndexがMode Bのcontrol_2ラベルを受信した場合(このラベルはChromeにより Privacy Sandbox API がテスト目的で無効化されている状態を示します)、DSPへの入札リクエストにはTopics APIの情報は送信されません。

ifv

文字列:任意

The IDFV of the device with the Media Owner.

ifa_type

文字列:任意

A value indicating the source of the IFA value, whether it is device-generated, provided by the Media Owner, or is a temporary session IFA. 対応されている数値:

  • dpid = 一般的なデバイスが提供するID。

  • rida = Roku ID。

  • aaid = Android ID。

  • idfa = Apple ID。

  • afai = Amazon Fire ID。

  • msai = Microsoft ID。

  • tifa = Samsung Tizen ID。

  • vida = Vizio ID。

  • ppid = the Media Owner provided ID.

  • sspid = SSPが提供するID。

  • sessionid = 一時的なIFAのID。For example, Media Owners or SSPs might generate a temporary IFA in the absence of an IFA from the Media Owner or device, so that tasks like frequency capping can be supported. この数値は、ユーザーがトラッキング(device.lmt=1)を許可しなかった場合、デバイスのIFAの代理で使われる場合もあります。

ifa_typeの詳細については、IABテックラボのCTV/OTTプラットフォーム上の広告識別子(IFA)ガイドラインをご確認ください。

Geoオブジェクト

フィールドタイプ詳細

city

文字列:任意

The city, either free form text of the city name or from the UN/LOCODE Code List.

country

文字列:任意

ISO-3166-1-alpha-3を用いた国コード。

ipservice

整数; 任意

地理情報を特定するのに利用されたサービスまたはプロバイダー。全ての値の一覧は、AdCOM 1.0のList: IP Location Servicesをご覧ください。

lat

フロート:任意

-90.0から+90.0までの緯度(マイナスが南を示す)。

lon

フロート:任意

-180.0から+180.0までの経度(マイナスが西を示す)。

metro

文字列:任意

NielsenのDMAコード、あるいは同類のタクソノミーなど、地域別マーケティングは、事前にベンダーと利用するための合意が必要です。

region

文字列:任意

ISO-3166-2を用いた地域コード:米国の場合、2文字の州コード(「US」)。

regionfips104

文字列:任意

FIPS 10-4表記を用いた国の地域。OpenRTBはこのフィールドに対応していますが、2008年にNISTによって廃止されました。

type

整数:任意

位置データのソース:Iat(緯度)とIon(経度)を渡す際に推奨されます。ロケーションタイプのリスト参照。

zip

文字列:任意

ZIPコードまたは郵便番号。

utcoffset

整数:任意

UTCを基準とする+/-分数の現地時間。

Note: Only supported in OpenRTB 2.3.

ユーザーオブジェクト

フィールドタイプ詳細

buyeruid

文字列:任意

このユーザーに対するDSPのUID(フォーマットについてはユーザー照合を参照してください)。

Note: This field is always present in default user match configuration.

data

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

This object is used by Media Owners to pass additional attributes about the user or content. データオブジェクトをご確認ください。

eids

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

このオブジェクトは、ユーザーのサードパーティIDを含みます。詳細は、以下のEIDオブジェクトをご確認ください。

ext

オブジェクト; 任意

特定のユーザー識別子を含み、GDPR規制の対象となるリクエストであることを示すために使用されますUser extension object

id

文字列:任意

このユーザーのIndex静的識別子(英数字または@ - . _のみを含む)。

Note: This field is always present in default user match configuration.

ユーザー拡張オブジェクト

フィールドタイプ詳細

consent

文字列:任意

GDPR規制が有効な場合に、ユーザーの同意を明示します。同意がある場合、GDPR同意ワーキンググループが作成したデータ構造が含まれます。詳細については、IABが発表したOpenRTB GDPR Advisoryを参照してください。

data

オブジェクト; 任意

サイトのコンテクスト情報を提供するパブリッシャーにより渡されたカスタムキーバリューが組み合わせられます。詳細は、インベントリグループ(ベータ)を利用したディールのカスタムキーバリューをターゲティングするをご確認ください。

ユーザーエージェントオブジェクト

フィールドタイプ詳細

browsers

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

ブラウザまたは似たソフトウェアコンポーネントを識別するBrandVersionオブジェクト配列brandversionフィールドは、Sec-CH-UA-Full-Version-Listヘッダーから取得されます。詳細については、BrandVersionオブジェクトをご確認ください。

platform

オブジェクト:任意

ユーザーエージェントのOSを識別するBrandVersionオブジェクト。brand値はSec-CH-UA-Platformヘッダーから取得され、version値はSec-CH-UAPlatform-Versionヘッダーから取得されます。詳細については、BrandVersionオブジェクトをご確認ください。

mobile整数:任意

ユーザーエージェントの優先傾向:

  • 1 = コンテンツのモバイルバージョンを優先するユーザーエージェント。

  • 0 = コンテンツのデスクトップバージョンを優先するユーザーエージェント。

Sec-CH-UAMobileヘッダーから取得される数値。

architecture文字列:任意デバイスの主なバイナリアーキテクチャ(CPU)例:x86またはarmSec-CH-UA-Archヘッダーから取得される数値。
bitness文字列:任意デバイスビットネス例:64ビットアーキテクチャ向け64Sec-CH-UA-Bitnessヘッダーから取得される数値。
model文字列:任意デバイスのモデル。例:"iPhone"Sec-CH-UA-Modelヘッダーから取得される数値。
source

整数:任意

このオブジェクトを作成するために使用されたデータのソース:

  • 0 = 不特定/不明

  • 1 = ユーザーエージェントクライアントのヒント低エントロピーヘッダーのみ利用可能でした。

  • 2 = ユーザーエージェントクライアントのヒント高エントロピーヘッダーは利用可能でした。

  • 3 = ユーザーエージェントヘッダーからの解析。uaフィールド内と同じ数値。

このフィールドの既定値は0

BrandVersionオブジェクト

フィールドタイプ詳細

brand

文字列:必須

ブランド識別子例:WindowsまたはChrome数値は、User-Agent Client Hintsヘッダーから供給される場合があります。ユーザーエージェントブランド(Sec-CH-UA-Full-Versionヘッダー)またはプラットフォームブランド(Sec-CH-UA-Platformヘッダー)を示しています。

version

文字列配列:任意

バージョンコンポーネントの順序は、降下順(メジャー、マイナー、マイクロ…)です。例:14.0.0

EIDオブジェクト

フィールドタイプ詳細

source

文字列:任意

IDのソース。例: adserver.org

uids

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

UIDオブジェクトの配列

id

文字列:任意

リクエストで受けたユーザーID。

ext

オブジェクト:任意

EID拡張オブジェクト

EID拡張オブジェクト

フィールドタイプ詳細

rtipartner

文字列:任意

ユニバーサルIDプロバイダー名例:tradedesk

UIDオブジェクト

フィールドタイプ詳細

id

文字列:任意

ユーザーID。例:uid123

ext

オブジェクト:任意

UID拡張オブジェクト

UID拡張オブジェクト

フィールドタイプ詳細

rtipartner

文字列:任意

ユニバーサルIDプロバイダー名例:appnexus

データオブジェクト

フィールドタイプ詳細

cids

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

An array of Extended Content IDs, representing one or more identifiers for the video or audio content from the ID source specified in the name field of the data object.

ext

オブジェクト、任意

コミュニティ拡張を含むデータ拡張オブジェクト。データ拡張オブジェクトをご確認ください。

name

文字列:任意

ユーザーまたはコンテンツについて詳細情報を示している事業体の個別ドメイン。

プライバシーサンドボックスのTopics APIで、この項目には、トピックIDを記録したデータプロバイダのエクスチェンジ固有の名前が含まれます。IndexがTopics IDを確認した場合、nameは常にtopics.indexexchange.comです。

segment

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

ユーザー、サイトまたはアプリオブジェクトなどを指定した関連オブジェクトについての詳細情報を含みます。セグメントオブジェクトをご確認ください。

注意:Topics API for Privacy Sandboxについては、Indexが2023年12月にDSPにこのフィールドの送信を開始。

データ拡張オブジェクト

フィールドタイプ詳細

segclass

文字列; 任意

例えば "taxonomy_v2 "のように、segtaxで指定されたタクソノミーのバージョンを指定します。

注意:Topics API for Privacy Sandboxについては、Indexが2023年12月にDSPにこのフィールドの送信を開始。

segtax

整数; 任意

Enumeration of TaxonomiesのIABテックラボで一元的に登録されているタクソノミーに関連するID。

プライバシーサンドボックスのTopics APIでは、当社は以下のタクソノミーに対応しています:

Taxonomy V1: https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v1.md

Taxonomy V2: https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v2.md

注意:Topics API for Privacy Sandboxについては、Indexが2023年12月にDSPにこのフィールドの送信を開始。

セグメントオブジェクト

フィールドタイプ詳細

id

文字列:任意

このデータセグメントに関連し、データプロバイダーに特化したID。