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

当社のOpenRTB リアルタイム入札オークションにおけるオンライン広告のバイヤーとセラー間の通信のためのオープンな業界標準。IABにより制定されました。 bidding APIはリアルタイム入札を容易にします。入札リクエスト SSPまたはアドエクスチェンジからDSPに送信され、入札可能なインプレッションに対する入札レスポンスをリクエストするOpenRTBリクエスト。入札リクエストには、DSPがそのインプレッションに入札するかどうかを決定するためのインプレッションに関する情報が含まれる。のデータは、JSON RFC 4627フォーマットで送信され、すべてのフィールドで大文字と小文字が区別されます。

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

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

フィールド タイプ 詳細

id

文字列:必須

リクエストのIndex固有IDこのIDは36文字の英数字文字列です。

imp

オブジェクト配列; 必須

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

注意:

device

オブジェクト; 必須

デバイスオブジェクト。

tmax

整数:必須

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

注意:必要に応じて、tmaxを渡す時に遅延を減算できます。詳細は、Index担当者担当者までお問い合わせください。

cur

文字配列:任意

パブリッシャーが許可する入札レスポンス SSPまたはアドエクスチェンジの入札リクエストに対してDSPが送信するOpenRTBレスポンス。販売リクエストと販売条件に対する査定をセラーに返すイベントである。の通貨。通貨は、 ISO-4217基準で指定され、Indexで対応するものにしてください。より詳しい情報に関してはこちらDSP向け:対応通貨リストを参照してください。

ext

必須

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

app

オブジェクト:任意

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

bcat

文字列配列:任意

標準IAB Interactive Advertising Bureau (IAB).オンライン広告業界の業界標準の作成、調査、法的支援を行う広告ビジネス団体。コンテンツカテゴリに基づきブロックされた広告主のカテゴリの配列。完全なリストは、OpenRTB仕様(第2.5版)の第5.1節でご確認ください。

badv

文字列配列:任意

パブリッシャーが自身のプロパティ 個人または企業などの組織の資産であり、ブランド、個人、またはその他のアイデンティティを表す目的で使用される、ウェブサイト、ソーシャルメディア・アカウント、ブログなどのポイントオブプレゼンス(POP)。で配信をブロックした広告主ドメイン 広告主ドメイン(adomain)。OpenRTBの入札レスポンスで提供される、企業や広告主の識別子。のリスト。例:“ford.com”
注意:この項目は、当社が最適化を行っている間、一時的に利用できなくなります。

regs

オブジェクト:任意

規制オブジェクト。

site

オブジェクト:任意

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

user

オブジェクト:任意

ユーザーオブジェクト。

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

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

フィールド タイプ 詳細

placement

オブジェクト; 任意

配置オブジェクト。

tz

整数; 任意

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

配置オブジェクト

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

フィールド タイプ 詳細

name

文字列:任意

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

private

ブール値:任意

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

ソースオブジェクト

フィールド タイプ 詳細

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

整数:必須

 

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

sourceOrigin

整数:必須

 

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

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。

注意:このドメイン名を介して、各ノードのsellers.json Sellers.jsonは、Index Exchangeが提携している様々なパブリッシャーや仲介販売者を含む、当社のウェブサイトに保存されているファイルです。ファイルを確認できます。パブリッシャー向けのads.txtファイルでも同じドメインが使われています(例:indexexchange.com)。

rid

文字列:任意

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

注意:同じ情報はbidrequest.idからも見つけられます。

sid

 

文字列:必須

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

注意:同じ情報はsite.publisher.idからも見つけられます。

hp

整数:必須

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

規制オブジェクト

フィールド タイプ 詳細

coppa

整数:任意

このリクエストが米国児童オンラインプライバシー保護法(COPPA)の対象かどうかを指定します。

  • 0 = いいえ
  • 1 = はい

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

注意:COPPA関連のリクエストでは、次のフィールドは自動的に空白となります:lat、lon、metro、city、zip(ジオオブジェクト内)。

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= はい
    • -= 該当しない
  • 4文字目: パブリッシャーが、IAB Limited Service Provider Agreement(LSPA)に署名した当事者であるかどうかを明示します。パブリッシャーは、その取引が対象となるオプトアウト取引であるのか、非対象のオプトアウト取引であるかを明示します。
    • N = いいえ
    • Y= はい
    • -= 該当しない

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

注意:消費者が個人情報の販売を拒否した場合、以下の入札リクエスト項目は自動的に調整されます。

  • ip(デバイスオブジェクト):ユーザーのIPアドレスの最後のオクテットは0に置き換えられます。
  • latおよびlon(Geoオブジェクト):緯度座標と経度座標は小数点以下2桁になり、3分の1マイル以上の精度になります。
  • deviceuserオブジェクトの入札リクエストで、間接的にユーザーを識別する一意のIDは削除されます。
  • dealsPMPオブジェクト):オーディエンスセグメントを対象とするディールIDが入札リクエストに追加されなくなります。

規制拡張オブジェクト

フィールド タイプ 詳細

dsa

オブジェクト; 任意

パブリッシャーから受け取る、デジタルサービス法(DSA)の透明性に関する情報を含むDSAオブジェクト

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

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

gdpr

整数:任意

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

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

us_privacy

オブジェクト; 任意

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

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

  • 1文字目:文字列のエンコーディングに使用されたUSプライバシー文字列仕様のバージョン番号。
  • 2文字目:ユーザーが個人情報の販売について明確な通知とオプトアウトする選択肢を与えられたかどうかを明示します:。
    • N = いいえ
    • Y= はい
    • -= 該当しない
  • 3文字目: ユーザーが自身の個人情報の販売を拒否したかどうかを明示します。
    • N = いいえ
    • Y= はい
    • -= 該当しない
  • 4文字目: パブリッシャーが、IAB Limited Service Provider Agreement(LSPA)に署名した当事者であるかどうかを明示します。パブリッシャーは、その取引が対象となるオプトアウト取引であるのか、非対象のオプトアウト取引であるかを明示します。
    • N = いいえ
    • Y= はい
    • -= 該当しない

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

注意:消費者が個人情報の販売を拒否した場合、以下の入札リクエスト項目は自動的に調整されます。

  • ip(デバイスオブジェクト):ユーザーのIPアドレスの最後のオクテットは0に置き換えられます。
  • latおよびlon(Geoオブジェクト):緯度座標と経度座標は小数点以下2桁になり、3分の1マイル以上の精度になります。
  • deviceuserオブジェクトの入札リクエストで、間接的にユーザーを識別する一意のIDは削除されます。
  • dealsPMPオブジェクト):オーディエンスセグメントを対象とするディールIDが入札リクエストに追加されなくなります。

DSAオブジェクト

フィールド タイプ 詳細

datatopub

整数:任意

パブリッシャーが監査目的でDSA透明性に関するデータを必要とするかどうかを指定するフラグ:

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

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

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

pubrender

整数:任意

パブリッシャーが入札レスポンスで受け取ったDSA透明性に関する情報を提示できるかどうか、また提示する意図があるかどうかを指定するフラグ。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つの入札リクエストには、単一または複数のインプレッション機会に対して、1つ以上のimpオブジェクトを含む可能性があります。

注意:デフォルトでは、Indexはセラーからの複数フォーマットの適格なリクエストを、DSPへの複数の個別入札リクエストに分け、フォーマットごとに1つのリクエストとする。Indexは、マルチフォーマットのリクエストを許可し、1つのインプレッション機会で複数のクリエイティブタイプを受けとれます。例えば、1つのインプレッション機会において、bannervideonativeクリエイティブに対応するリクエストを受け取れます。マルチフォーマットリクエストを有効にするには、Index担当者にお問い合わせください。

フィールド タイプ 詳細

id

文字列:必須

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

tagid

文字列:任意

パブリッシャーのサイト上の広告配置または広告タグ 広告サーバーから広告を呼び出すのに使用されるHTML/JavaScriptコード。の固有IDが、オークションを始動するために使用されました。DSPは、広告がウェブページまたはアプリのどこに掲載されているかを示す、このパブリッシャーインベントリの詳細な内訳を利用して、広告バイヤーキャンペーン 様々なフォーマットの複数の広告のまとめ。の最適化とトラブルシューティングを行うことができます。

注意:tagidが指定されていない場合、Indexが、インベントリとして自社のサイトID サイトIDは、パブリッシャーのニーズに基づいた特定のインベントリとアトリビューションを表す、Index Exchange独自の識別子です。サイトIDはIndex UI(管理画面)で作成され、これらのIDはパブリッシャーがリアルタイムの入札リクエストを行うために使用されます。をDSPに渡します。

banner

オブジェクト:必須

バナーオブジェクト。

注意:すべてのリクエストには、バナーオブジェクトまたは動画オブジェクトを少なくとも1つ含める必要があります。

bidfloor

整数:必須

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

bidfloorcur

1 = セキュアなアセットが必須です

オブジェクト:必須

secure

動画オブジェクト。

注意:全てのリクエストは、最低1つ以上の動画オブジェクト、バナーオブジェクト、ネイティブオブジェクトを含む必要があります。

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

video

浮動小数点; 任意

CPM 1000インプレッション毎に発生するコスト。インプレッションを購入するための料金体系で、広告を1,000回表示するためにかかる費用。Cost Per Mille(Mはローマ数字で1,000を表す)またはCents Per Milleとも呼ばれます。におけるこの広告インプレッションの最低入札価格。

For more information about the bidfloor value that is sent to DSPs, see Indexオークションでのフロアプライスの仕組み.

native 文字列:任意 フロアプライス パブリッシャーとエクスチェンジで使用される、インベントリの最低販売価格。の通貨について通貨は、 ISO-4217基準で指定され、Indexで対応するものにしてください。より詳しい情報に関してはこちらDSP向け:対応通貨リストを参照してください。

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 プライべートマーケットプレイス(PMP)招待制のリアルタイム入札オークションで、1社または複数のパブリッシャーが、限られた数の広告主を招待し、在庫を販売します。オブジェクト。

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

このカスタム拡張オブジェクトは、ディールとヘッダータグ パブリッシャーのサイト上の各広告スロットにマッピングされるタグ。入札に関する情報を伝達します。

フィールド タイプ 詳細

bcrid

文字列配列:必須

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

注意:

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

floor

整数配列; 任意

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

注意:この配列インデックスは、入札リクエストオブジェクトのwseatフィールドに対応するインデックスを持つシートの入札フロアを識別します。

hb

整数:任意

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

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

注意:これはデフォルトでは含まれていないため、DSPによってリクエストされる必要があります。

wopv

文字列:任意

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

skadn

オブジェクト:任意

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

gpid 文字列:任意 広告スロット 広告が表示される、パブリッシャーのウェブサイト上の場所。インベントリとも呼ばれる。または広告配置のグローバルプレースメント識別子(GPID)。GPIDの詳細については、グローバルプレースメント識別子(GPID)をIndexへ送信をご確認ください。

tid

文字列:任意

各インプレッションの一意の取引IDで、このインプレッション機会に入札しているすべてのエクスチェンジで共通です。この項目は、Per-Impression Transaction IDのOpenRTBコミュニティ拡張の実装です。
注意:この項目は、現在サポートしていませんが、近日中にDSPが利用できるようになります。

data

オブジェクト:任意

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

ae

整数:任意

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

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

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

  • 文字列; 任意

sid

セラーの接続データは、Indexに渡されます。このフィールドを使い、貴社のクライアント監査ログ(CAL クライアント監査ログ(CAL)APIIndex Exchangeのクライアントがインプレッションや入札イベントデータのログファイルを取得できるAPI。)で受け取りたい、いずれかのカスタムデータを渡してください。

メトリックオブジェクト

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

フィールド

タイプ 詳細 文字列:必須
type

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

浮動小数点; 必須

  • click_through_rate

  • session_depth

  • video_completion_rate

  • viewability

value

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

文字列:任意

vendor

エクスチェンジ・キュレーション文字列名を使用した値のソースです。Indexがこの値をパスします。Indexにより生成された全ての値は、ベンダーが"INDEXEXCHANGE"です。

バナーオブジェクト

このオブジェクトは、バナー広告インプレッションを記述するインプレッションオブジェクトのサブセットです。オークションにかけられた広告インプレッションがバナーかリッチメディアの場合は、バナーオブジェクトインプレッションオブジェクトに直接含めてください。また、動画オブジェクトに埋め込むことで、リニア/非リニアの動画広告に利用できるコンパニオンバナーを記述することもできます。バナーインプレッションで利用可能な広告サイズの詳細は対応広告サイズの一覧をご確認ください。

フィールド

タイプ 詳細 オブジェクトの配列:任意

format

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

注意:デフォルトでは、すべてのパートナーに対して有効になっていません。format オブジェクトを有効にするには、Index担当者までお問い合わせください。

注意:format オブジェクトの受信を有効にしたパートナーは、入札レスポンスの入札オブジェクトに、必ずw hを含めてください。

注意formatオブジェクトに対応していないパートナーは、Indexでは、入札リクエストで貴社が対応する最大サイズを既定として含めています。

整数:必須

h

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

ブール値:必須

topframe

バナー広告がトップフレーム配信かiframe 現在のウィンドウ内に、指定されたサイズのミニブラウザウィンドウを開くように、ブラウザに指示するHTMLタグ。こうすることで、広告コンテンツは指定されたサイズ以上に拡大できず、画面を占領することもありません。で配信されるのかを指定します。ここで:

0 = 広告はiframeで表示されます

  • 1 = 広告はiframeで表示されません
  • 整数:必須

w

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

配列; 任意

battr

ブロックされたクリエイティブ属性を指定します。空欄の場合は、すべてのタイプが許可されたとみなされます。値の完全なリストはOpenRTB API仕様第2.5版を参照してください。

整数:任意

btype

ブロックされたクリエイティブタイプのリスト。ここで:

1 = XHTMLテキスト広告

  • 2 = XHTMLバナー広告
  • 3 = JavaScript広告
  • 4 = iframe
  • 空欄の場合、Indexでは、すべてのタイプが許可されているとみなします。

整数配列; 任意

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が存在します。

  • 注意:デフォルトでは、Indexが、動画広告ポッドに対して単一インプレッション動画リクエストをDSPに送信します。ストリーミングTVインベントリにおいて、OpenRTB 2.6広告ポッドを有効にしたい場合は、Index担当者にお問い合わせください。

フィールド

タイプ 詳細 整数:必須

maxduration

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

整数; 必須

minduration

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

文字列配列:必須

mimes

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

video/mp4

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

整数配列; 必須

protocols

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

2 = VAST 動画広告掲出テンプレート(VAST)。広告配信サーバーと動画プレイヤー間で、XML形式で行うデータの受け渡し方法を定義したものです。 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 = リニア/インストリーム ユーザーが視聴している動画コンテンツの直前(プレロール)、途中(ミッドロール)、直後(ポストロール)に表示される動画広告。動画広告は、動画コンテンツ内で再生されます。TV視聴時のコマーシャルと似ています。

  • 2 = 非リニア/オーバーレイ
  • 整数:任意

maxextended

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

空欄または0 = 拡張は許可されていません。

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

maxbitrate

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

整数:任意

minbitrate

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

整数:任意

placement

動画の配置タイプ。

1 = インストリーム

  • 2 = インバナー
  • 3 = インアーティクル
  • 4 = インフィード
  • 5 = インタースティシャル/スライダー/スローティング
  • 詳細については、OpenRTB API仕様第2.5版の表5.9を参照してください。

整数:任意

plcmt

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

1 = インストリーム

skip

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

 

0 = いいえ

  • 1 = はい
  • 整数:任意

skipmin

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

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

整数:任意

skipafter

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

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

整数配列; 任意

playbackmethod

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

1 = ページロード時に自動で音声オンの動画を再生

  • 2 = ページロード時に自動で音声オフの動画を再生
  • 3 = クリック再生
  • 4 = マウスオーバー
  • 5 = ビューポートに入る時のみ音声オンの動画を再生
  • 6 = ビューポートに入る時のみ音声オフの動画を再生
  • 空欄の場合、Indexでは、すべての方法が許可されていると考えられます。

整数:任意

pos

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

0 = 不明

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

sequence

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

整数:任意

startdelay

プレロール パブリッシャーの動画コンテンツ開始前に再生される動画広告。ミッドロール パブリッシャーの動画コンテンツの途中に再生される動画広告。、またはポストロール パブリッシャーの動画コンテンツが終了した後に再生される動画広告。の広告プレースメントにおいて、開始遅延(秒)を指定します。

>0 = ミッドロール(秒単位で再生の遅延を示す数値)

  • 0 = プレロール
  • -1 = 一般的なミッドロール
  • -2 = 一般的なポストロール
  • 整数:任意

w

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

動画拡張オブジェクト

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

フィールド

タイプ 詳細 フロート:任意

bidfloor

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

整数:任意

playertype

このアウトストリーム 動画が画面の中心ではなく、デフォルトで音声は再生されない広告プレースメント。テキストの前、間、後に表示したり、ストリーミングコンテンツに付随させたり(プレロール、ミッドロール、ポストロール広告)、インタースティシャル広告として表示したり、スライドショーやネイティブフィードのような単独の広告として表示したりすることができmasu.動画広告インプレッションに関連するプレーヤータイプを指定します。

1 = インニュースフィード

  • 2 = インアーティクル
  • 空欄の場合、従来のインスチーム型のプレーヤーであるとみなされます。

整数:任意

renderedBy

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

1 ⁼ パブリッシャーがビデオ広告をレンダリングする

  • 2 ⁼ Indexがビデオ広告をレンダリングする
    • 空欄の場合は、パブリッシャーがビデオ広告をレンダリングするとみなされます。

    整数:任意

    rewarded

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

    0 = レンダリングしない

    • 1 = レンダリングする
    • ネイティブオブジェクト

    impressionオブジェクトの下位にnativeオブジェクトが存在する場合、この広告インプレッションがネイティブタイプの広告インプレッションとして提供されていることを指定します。パブリッシャーの判断により、広告インプレッションを同タイプのimp下位オブジェクトとしても含めることで、バナーまたは動画として同じインプレッションを提供できます。

    フィールド

    タイプ 詳細 文字列:必須

    request

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

    文字列:任意

    ver

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

    整数配列:任意

    api

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

    整数配列:任意

    battr

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

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

    フィールド

    タイプ 詳細 フロート:任意

    bidfloor

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

    整数:任意

    renderedBy

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

    1 ⁼ パブリッシャーがネイティブ広告をレンダリングする

  • 2 ⁼ Indexがネイティブ広告をレンダリングする
    • 空欄の場合は、パブリッシャーがネイティブ広告をレンダリングするとみなされます。

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

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

    フィールド

    タイプ 詳細 整数:任意

    h

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

    整数:任意

    w

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

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

    PMPオブジェクト

    フィールド

    タイプ 詳細 整数:任意

    private_auction

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

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

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

    deals

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

    オブジェクト:任意

    ext

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

    ディールオブジェクト

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

    フィールド

    タイプ 詳細 文字列:必須

    id

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

    整数:任意

    at

    この直接ディールのためのオークションタイプ RTBオークションのタイプは、ファーストプライスオークション(最高入札額が落札され、落札者は最高入札額を全額支払うオークション)または固定価格オークション(他のすべてのオークション入札タイプよりも優先され、入札はあらかじめ決められた固定価格以上でなければならないオークション)のいずれかです。

    1 = ファーストプライス 最高入札額が落札されるオークション。落札者は最高入札額を全額支払います。オークション

    整数(134のようにセントで送信される場合)または浮動小数点(1.34のようにドルで送信される場合):任意

    bidfloor

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

    For more information about the bidfloor value that is sent to DSPs, see Indexオークションでのフロアプライスの仕組み.

    文字列:任意

    bidfloorcur

    フロアプライスの通貨について通貨は、 ISO-4217基準で指定され、Indexで対応するものにしてください。より詳しい情報に関してはこちらDSP向け:対応通貨リストを参照してください。

    文字列:任意

    wseat

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

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

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

    フィールド

    タイプ 詳細 文字列:任意

    name

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

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

    フィールド

    タイプ 詳細 浮動小数点

    disc

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

    25%の割引は、disc=0.25として送信されます。$10.00の落札の場合、25%の割引が適用され、${AUCTION_PRICE}マクロで$7.50として渡されます。

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

    整数:任意

    guaranteed

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

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

    • SKAdNetwork拡張オブジェクト

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

    フィールド

    タイプ 詳細 文字列:任意

    version

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

    :SKAdNetwork 2.1のリリースに伴いこのフィールドは非推奨となり、バージョン番号の配列をサポートするversionsフィールドが使用されます。

    文字配列:任意

    versions

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

    :「バージョン」:[2.0、2.1、2.2]

    文字列:任意

    sourceapp

    AppleのApp StoreにあるパブリッシャーのアプリID。app.bundle 2.xのOpenRTBおよびAdCOM 1.xのapp.storeidと一致する必要があります。

    :"sourceapp": "880047117"

    文字配列:任意

    skadnetids

    小文字の文字列で表され、入札リクエストに関連する、パブリッシャーアプリのInfo.plistSKAdNetworkItemエントリのサブセット。このリストが10を超えないようにしてください。

    :生のSKAdNetwork IDを表す方法としては、BidRequest.imp.ext.skadn.skadnetlist.addlが推奨されます。

    オブジェクト:任意
    skadnetlist IABのリスト定義を含むオブジェクト。以下のSKAdNetworkオブジェクトを参照してください。

    :"skadnetlist": {"max": 306, "excl": [2,8,10,123], "addl": ["cdkw7geqsh.skadnetwork", "qyJfv329m4.skadnetwork"]}
    SKAdNetworkオブジェクト

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

    フィールド

    タイプ 詳細 整数:任意

    max

    SKAdNetwork IDの最大入力IDを含むリスト。
    :"max":306.

    整数配列:任意

    excl

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

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

    文字配列:任意

    addl

    小文字の文字列として表示され、IAB共有リストに含まれていない、文字列SKAdNetwork IDのカンマ区切りのリスト。このリストのIDは10以下であることを推奨します。
    :"addl": ["cdkw7geqsh.skadnetwork", "qyjfv329m4.skadnetwork"]

    サイトオブジェクト

    フィールド

    タイプ 詳細 文字列:必須

    id

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

    文字列配列; 任意

    cat

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

    オブジェクト:任意

    content

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

    文字列:任意

    domain

    サイトのドメインを表わす静的値。

    String; optional

    mobile

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

    0 = いいえ

    • 1 = はい
    • 文字列:任意

    page

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

    Array of strings; optional

    producer

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

    オブジェクト:任意

    publisher

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

    文字列:任意

    ref

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

    Array of strings; optional

    フィールド

    タイプ 詳細 オブジェクト:任意

    data

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

    アプリオブジェクト

    フィールド

    タイプ 詳細 文字列; 必須

    id

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

    文字列; 任意

    bundle

    アプリ名またはバンドル(例:"com.foo.mygame")。複数のエクスチェンジにまたがる一意の識別子として使用されます。

    文字列配列; 任意

    cat

    サイト全体のスタンダードIABコンテンツカテゴリ(例: ["IAB3-7"])。完全なリストは、OpenRTB 2.5の仕様セクション5.1からご確認ください。

    オブジェクト:任意

    content

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

    オプション

    domain

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

    文字列:任意

    keywords

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

    文字列:任意

    name

    アプリ名。パブリッシャーからの要望によってマスキングされることがあります。

    Array of strings; optional

    paid

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

    0 = アプリは無料です

    • 1 = アプリは有料です
    • 整数:任意

    privacypolicy

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

    0 = いいえ

    • 1 = はい
    • オブジェクト:任意

    producer

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

    オブジェクト:任意

    publisher

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

    Array of strings; optional

    storeurl

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

    文字列:任意

    ver

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

    オブジェクト:任意

    ext

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

    アプリ拡張オブジェクト

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

    フィールド

    タイプ 詳細 文字列:任意

    inventorypartnerdomain

    パートナーのドメインへのポインタで、アプリケーションのコンテンツ内広告で明確に収益化が許可されたもの。パートナーの対応するapp-ads.txt パブリッシャーがサイト上で提供するファイルで、在庫の販売を許可されているセラーをすべてリストアップしています。App-ads.txtは、IAB Tech LabのAuthorized Digital Sellers標準に準拠しており、サプライチェーンの透明性を提供し、ドメインのなりすましを防止し、在庫の不正転売を禁止しています。またはads.txt パブリッシャーがサイト上で提供するファイルで、在庫の販売を許可されているセラーをすべてリストアップしています。Ads.txtは、IAB Tech LabのAuthorized Digital Sellers標準に準拠しており、サプライチェーンの透明性を提供し、ドメインのなりすましを防止して、在庫の不正転売を禁止します。ファイルは、このドメインにホストされ、サプライチェーンの認証に使用されます。

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

    オブジェクト:任意

    data

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

    コンテンツ、プロデューサー、パブリッシャーオブジェクト

    コンテンツオブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    album

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

    文字列:任意

    artist

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

    文字配列:任意

    cat

    サイト全体の標準IABコンテンツカテゴリを表す単一エレメントの配列。例:["IAB3-7"]完全なリストは、OpenRTB 2.5の仕様セクション5.1からご確認ください。

    オブジェクト:任意

    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

    パブリッシャーが提供するコンテンツの代替名。

    チャネルオブジェクト

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

    フィールド

    タイプ 詳細 文字列:任意

    id

    パブリッシャーにより割り当てられた固有の識別子。これは、すべてのサプライソースの中で固有の識別子です。

    文字列:任意

    name

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

    文字列:任意

    domain

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

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

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

    このオブジェクトは、広告が表示されるネットワークを示しています。チャネルオブジェクトのペアレント実体として定義されたネットワークで、チャネルを整理する目的で使用されます。ネットワークの例は、Discoveryのようなコンテンツチャネルのコレクションを所有または使用許可を与えている会社です。

    フィールド

    タイプ 詳細 文字列:任意

    id

    パブリッシャーにより割り当てられた固有の識別子。これは、すべてのサプライソースの中で固有の識別子です。

    文字列:任意

    name

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

    文字列:任意

    domain

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

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

    制作者オブジェクト

    フィールド

    タイプ 詳細 文字配列:任意

    cat

    サイト全体の標準IABコンテンツカテゴリを表す単一エレメントの配列。例:["IAB3-7"]完全なリストは、OpenRTB 2.5の仕様セクション5.1からご確認ください。

    文字列:任意

    domain

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

    オブジェクト:任意

    ext

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

    文字列:任意

    id

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

    文字列:任意

    name

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

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

    フィールド

    タイプ 詳細 文字列:必須

    id

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

     

    文字列:任意

    name

    パブリッシャーを表す名前で、要望によってマスキングできます。

    注意:このフィールドは、ディールが存在する場合、常に存在します。

    デバイスオブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    carrier

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

    整数:任意

    devicetype

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

    1 = モバイルまたはタブレット

    didmd5

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

    文字列:任意

    didsha1

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

    文字列:任意

    dpidmd5

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

    文字列:任意

    dpidsha1

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

    オブジェクト:任意

    geo

    フィールド

    整数:任意

    h

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

    注意:OpenRTB 2.3のみで対応。

    文字列:任意

    hwv

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

    注意:OpenRTB 2.3のみで対応。

    整数:任意

    connectiontype

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

    0 = 不明

    • 1 = イーサネット

    • 2 = WiFi

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

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

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

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

    • 文字列:任意

    ifa

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

    文字列:任意

    ip

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

    注意:入札リクエストにipv6フィールドが含まれていない場合は、このフィールドは必須です。以下のipv6フィールドを参照してください。

    文字列:任意

    ipv6

    デバイスに最も近いIPアドレス(IPv6フォーマット、例: "fe80:0:0:0:200:f8ff:fe21:67cf")。Indexは、お客様がIPv6トラフィックに対応している場合にのみ、入札リクエストを送信します。IPv6リクエストの受信を開始したい場合は、Index担当者の担当者までお問い合わせください。

    注意:Indexは、すべての入札リクエストに、常にdevice.ipまたはdevice.ipv6のいずれかを送信します。

    文字列:任意

    language

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

    整数:任意

    lmt

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

    0 = 追跡は無制限

    • 1 = 追跡は商用利用ガイドラインに沿って制限されること
    • 注意:OpenRTB 2.3のみで対応。

    文字列:任意

    macmd5

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

    文字列:任意

    macsha1

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

    文字列:任意

    make

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

    文字列:任意

    model

    デバイスのモデル。例えば、「iPhone」。

    文字列:任意

    os

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

    文字列:任意

    osv

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

    整数:任意

    ppi

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

    注意:OpenRTB 2.3のみで対応。

    フロート:任意

    pxratio

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

    注意:OpenRTB 2.3のみで対応。

    文字列:任意

    ua

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

    オブジェクト:任意

    sua

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

    整数:任意

    w

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

    注意:OpenRTB 2.3のみで対応。

    整数:任意

    ext

    デバイスオブジェクト向けIndex専用拡張子のプレースホルダー。以下のデバイス拡張オブジェクトを参照してください。

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

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

    フィールド

    タイプ 詳細 整数; 任意

    atts

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

    0 = 未定

    • 1 = 制限あり

    • 2 = 却下

    • 3 = 許可

    • 文字列; 任意

    cdep

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

    Mode 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 Acontrol_1.*ラベルを受信する場合:

    • Protected Audience APIae=1フィールドは、DSPへの入札リクエストに送信されません。

    • Protected Audience APIae=1フィールドは、入札リクエストとしてDSPに送信されます。

      • Topics API情報は、入札リクエストでDSPに送信されます。
      • トラフィックはバイヤートラフィック最適化(BTO)の対象になりません。DSPに送信される、トラフィックを最適化するIndexのソリューション。これは、スロットリングすることなく、アドテクベンダー全体でテストを実施します。
      • IndexがMode Alabel_only_1label_only_2またはlabel_only_3ラベルを受信する場合:

        • Protected Audience APIae=1項目はDSPへの入札リクエストに送信されます。
        • 全てのTopics API情報は、入札リクエストでDSPに送信されます。
        • トラフィックはバイヤートラフィック最適化(BTO)の対象になりません。DSPに送信される、トラフィックを最適化するIndexのソリューション。

    • IndexがMode B、treatment_1.*ラベルを受信する場合:
      • Protected Audience APIae=1項目はDSPへの入札リクエストに送信されます。
      • 全てのTopics API情報は、入札リクエストでDSPに送信されます。
      • トラフィックはバイヤートラフィック最適化(BTO)の対象になりません。DSPに送信される、トラフィックを最適化するIndexのソリューション。これは、スロットリングすることなく、アドテクベンダー全体でテストを実施します。

      • このトラフィックは、サードパーティクッキーが無効になっているためbuyeruid項目は、DSPへの入札リクエストに送信されません。

    • Chrome主導のテストでIndexが、プライバシーサンドボックスAPIが無効にされたMode B、control_2ラベルを受信する場合:
      • Protected Audience APIae=1項目は、DSPへの入札リクエストに送信されます。
      • Topics API情報は、入札リクエストでDSPに送信されません。
      • このトラフィックは、サードパーティクッキーが無効になっているためbuyeruid項目は、DSPへの入札リクエストに送信されません。
    • 文字列; 任意

    ifv

    パブリッシャーのデバイスのIDFV。

    文字列; 任意

    ifa_type

    デバイス生成、パブリッシャーから提供された、または一時的なIFAセッションであるか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 = パブリッシャーが提供するID。

    • sspid = SSPが提供するID。

    • sessionid = 一時的なIFAのID。例えば、パブリッシャーまたはSSPは、パブリッシャーやデバイスからのIFAがない場合に一時的なIFAを生成する場合があります。この数値は、ユーザーがトラッキング(device.lmt=1)を許可しなかった場合、デバイスのIFAの代理で使われる場合もあります。

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

    Geoオブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    city

    国際連合貿易輸送地点コード(UN/LOCODE)に基づく都市。UN/LOCODEコードリストを参照してください。

    文字列:任意

    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を基準とする+/-分数の現地時間。

    注意:OpenRTB 2.3のみで対応。

    ユーザーオブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    buyeruid

    このユーザーに対するDSPのUID アドテク・プロバイダー向けの、無料のクッキーベース識別子。(フォーマットについてはユーザー照合を参照してください)。

    注意:このフィールドは、デフォルトのユーザー照合設定では常に存在します。

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

    data

    このオブジェクトで、パブリッシャーはユーザーまたはコンテンツについての追加の属性を渡せるようになります。データオブジェクトをご確認ください。

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

    eids

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

    オブジェクト; 任意

    ext

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

    Object; optional

    id

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

    注意:このフィールドは、デフォルトのユーザー照合設定では常に存在します。

    String; optional

    フィールド

    タイプ 詳細 文字列:任意

    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 Extended Identifier(EID)。ユーザーIDをやりとりするのためのOpenRTBデータモデル。入札リクエストで受信され、オークション中にユーザーIDデータをDSPに伝達するために使用される。オブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    source

    IDのソース。例: adserver.org

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

    uids

    UIDオブジェクトの配列

    文字列:任意

    id

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

    オブジェクト:任意

    ext

    EID拡張オブジェクト

    EID拡張オブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    rtipartner

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

    UIDオブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    id

    ユーザーID。例:uid123

    オブジェクト:任意

    ext

    UID拡張オブジェクト

    UID拡張オブジェクト

    フィールド

    タイプ 詳細 文字列:任意

    rtipartner

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

    データオブジェクト

    フィールド

    タイプ 詳細 オブジェクト:任意

    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。

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