次の方法で共有

OpenRTB 入札要求の要件

Xandr 供給パートナーは、買い手がインテリジェントに入札するために必要な情報を持っていることを確認するために、 受信入札要求 に十分なオークション メタデータを提供する必要があります。 このページでは、必要な OpenRTB フィールドと、満たす必要がある対応するボリュームしきい値について説明します。 たとえば、バナーの高さフィールドの 95% のしきい値は、ランダムにサンプリングされた要求の 95% にバナーの高さに関する情報が含まれている必要があることを示します。 トラフィック サンプルは、すべての関連フィールドのしきい値を満たす必要があります。 以下に示す要件を満たしていない在庫は、取引を通じた販売の対象となりますが、オープンエクスチェンジでは利用できません。

現時点では、次の形式の資格が決定されます。

  • Web バナー
  • Web ビデオ
  • Web オーディオ
  • Web ネイティブ
  • アプリ バナー
  • アプリ ビデオ
  • App Audio
  • アプリ ネイティブ

"Web" の指定には、デスクトップ Web とモバイル Web の両方が含まれます。"app" はアプリ内インベントリとして定義されます。 今後、ネイティブやオーディオなどの他のメディアの種類に対して、追加のしきい値が追加される可能性があります。

入札要求の条件としきい値

以下のセクションでは、各形式に必要な OpenRTB 入札要求フィールドの概要を説明します。 [必須 OpenRTB フィールド] 列は、最初の列の "オークション属性" に対応する IAB OpenRTB フィールドを表します。 特定のオークション属性に対して複数の OpenRTB フィールドが一覧表示されている場合は、これらのフィールドの 1 つだけが必要です。 たとえば、要求が "Web バナー条件" の "タグ ID" 条件を渡すには、site.id または imp.tagid を渡す必要があります。

Web バナーの条件

オークション属性 必須の OpenRTB フィールド 型 説明 しきい値
Height imp.banner.h integer バナーの正確な高さをピクセル単位で指定します。 95%
Width imp.banner.w integer バナーの正確な幅をピクセル単位で指定します。 95%
ユーザー ID user.buyeruid integer このユーザーの Xandr 一意 ID。 設定すると、この値によって値が customdata 上書きされます。 95%
タグ ID site.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID site.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
ドメイン site.domain string インプレッションが表示されるサイトのドメイン ( publishersite.com など) を指定します。 インプレッションの参照元ドメイン (使用可能な場合) として設定するか、フィールドから抽出します page 。 95%
ドメイン site.page インプレッションが表示されるページの完全な URL を指定します ( たとえば、page.publishersite.com/path/to/page)。 これは参照元 URL である必要があり、フィールドよりも domain 優先されます。 95%
IP device.ip string デバイスに最も近い IPv4 アドレスを指定します。 販売者の可視性設定で共有が禁止されている場合、購入者に送信されるときに省略されます。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合、Xandr はデバイス make を設定し、 devicetype 渡されたフィールドではなくモデルに基づいて設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介して ua サポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%

Web ビデオの条件

属性 必須の OpenRTB フィールド 型 説明 しきい値
Height imp.video.h integer ビデオ プレーヤーの高さをピクセル単位で指定します。 95%
Width imp.video.w integer ビデオ プレーヤーの幅をピクセル単位で指定します。 95%
Mime の種類 imp.video.mimes 文字列の配列 サポートされるビデオ コンテンツ MIME の種類を指定します。たとえば、 video/x-ms-wmv と video/x-flvです。 指定しない場合は、任意の MIME の種類が許可されます。 95%
API の種類 imp.video.api 整数の配列 このインプレッションでサポートされている API フレームワークを指定します。 API が明示的に一覧表示されていない場合は、サポートされていないと見なされます。 現在サポートされている値は次のとおりです。
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2		 95%
ユーザー ID user.buyeruid integer このユーザーの Xandr 一意 ID。 設定すると、この値によって値が customdata 上書きされます。
タグ ID site.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID site.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
最小ビットレート imp.video.minbitrate integer 最小ビット レートをキロバイト/秒で指定します。 指定した場合は、少なくとも 1 つのメディア ファイルが適切なビット範囲内にあるクリエイティブのみを返します。 95%
最大ビットレート imp.video.maxbitrate integer 最大ビット レートを 1 秒あたりキロバイト単位で指定します。 指定した場合は、少なくとも 1 つのメディア ファイルが適切なビット範囲内にあるクリエイティブのみを返します。 95%
再生方法 imp.video.playbackmethod 整数の配列 許可される再生方法を指定します。 指定しない場合、すべてが許可されるものと見なされます。 現在サポートされている値は次のとおりです。
- 1: 自動再生、サウンドオン
- 2: 自動再生、サウンドオフ
- 3: クリックして再生します。
- 4:マウスオーバーで再生		 95%
最小期間 imp.video.minduration integer ビデオ広告の最大再生時間を秒単位で指定します。 95%
最大期間 imp.video.maxduration integer ビデオ広告の最大再生時間を秒単位で指定します。 95%
開始遅延 imp.video.startdelay integer ビデオの開始遅延を指定します。
- >0: 0 より大きい値の場合、ビデオ開始前の遅延 (秒単位)。
- 0: プリロール
- -1: 汎用ミッドロール
- -2: 汎用ポストロール		 95%
プロトコル imp.video.protocols 整数の配列 サポートされているビデオ入札応答プロトコルの配列。 95%
ドメイン site.domain string インプレッションが表示されるサイトのドメイン ( publishersite.com など) を指定します。 インプレッションの参照元ドメイン (使用可能な場合) として設定するか、フィールドから抽出します page 。 95%
ドメイン site.page インプレッションが表示されるページの完全な URL を指定します ( たとえば、page.publishersite.com/path/to/page)。 これは参照元 URL である必要があり、フィールドよりも domain 優先されます。 95%
IP device.ip string デバイスに最も近い IPv4 アドレスを指定します。 販売者の可視性設定で共有が禁止されている場合、購入者に送信されるときに省略されます。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合は、渡されたフィールドではなく、モデルに基づいてデバイスmakedevicetypeを設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介して ua サポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%

入札要求の次のフィールド値は、内部的に一貫性がある必要があります。

条件 必須の OpenRTB フィールド 説明 しきい値
VPAID1 imp.video.mimes
imp.video.api		 imp.video.mimes 配列に VPAID1 の値 "1" が含まれている場合、imp.video.mimes 配列には値 "application/x-shockwave-flash" が含まれているか、空である必要があります。この場合、すべての MIME 型がサポートされていると見なされます 95%
VPAID2 imp.video.mimes
imp.video.api		 imp.video.mimes 配列に VPAID2 の値 "2" が含まれている場合、imp.video.mimes 配列には値 "application/x-shockwave-flash" または "application/javascript" が含まれているか、空である必要があります。この場合、すべての MIME 型がサポートされていると見なされます 95%

Web オーディオ条件

オークション属性 必須の OpenRTB フィールド 型 説明 しきい値
Mime の種類 imp.audio.mimes 文字列の配列 サポートされるオーディオ コンテンツ MIME の種類を指定します。たとえば、、、audio/vnd.wavaudio/mpeg、audio/mp4、audio/oggまたはaudio/mp2.. 95%
API の種類 imp.audio.api 整数の配列 このインプレッションでサポートされている API フレームワークを指定します。 API が明示的に一覧表示されていない場合は、サポートされていないと見なされます。 現在サポートされている値は次のとおりです。
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2		 95%
ユーザー ID user.buyeruid integer このユーザーの Xandr 一意 ID。 設定すると、この値によって値が customdata 上書きされます。 95%
タグ ID site.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID site.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
最小ビットレート imp.audio.minbitrate integer 最小ビット レート (キロバイト/秒)。 95%
最大ビットレート imp.audio.maxbitrate integer 最大ビット レート (キロバイト/秒)。 95%
最小期間 imp.audio.maxduration integer オーディオ広告の最大再生時間を秒単位で指定します。 95%
最大期間 imp.audio.maxduration integer オーディオ広告の最大再生時間を秒単位で指定します。 95%
開始遅延 imp.audio.startdelay integer ビデオの開始遅延を指定します。
- >0: 0 より大きい値の場合、ビデオ開始前の遅延 (秒単位)。
- 0: プリロール
- -1: 汎用ミッドロール
- -2: 汎用ポストロール		 95%
プロトコル imp.audio.protocols 整数の配列 サポートされているビデオ入札応答プロトコルの配列。 95%
ドメイン site.domain string インプレッションが表示されるサイトのドメイン ( publishersite.com など) を指定します。 インプレッションの参照元ドメイン (使用可能な場合) として設定するか、フィールドから抽出します page 。 95%
ドメイン site.page string インプレッションが表示されるページの完全な URL を指定します ( たとえば、page.publishersite.com/path/to/page)。 これは参照元 URL である必要があり、フィールドよりも domain 優先されます。 95%
IP device.ip string デバイスに最も近い IPv4 アドレスを指定します。 販売者の可視性設定で共有が禁止されている場合、購入者に送信されるときに省略されます。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合は、渡されたフィールドではなく、モデルに基づいてデバイスmakedevicetypeを設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介して ua サポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%

Web ネイティブ条件

オークション属性 必須の OpenRTB フィールド 型 説明 しきい値
ユーザー ID user.buyeruid integer このユーザーの Xandr 一意 ID。 設定すると、この値によって値が customdata 上書きされます。 95%
タグ ID site.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID site.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
ドメイン site.domain string インプレッションが表示されるサイトのドメイン ( publishersite.com など) を指定します。 インプレッションの参照元ドメイン (使用可能な場合) として設定するか、フィールドから抽出します page 。 95%
ドメイン site.page string インプレッションが表示されるページの完全な URL を指定します ( たとえば、page.publishersite.com/path/to/page)。 これは参照元 URL である必要があり、フィールドよりも domain 優先されます。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合、Xandr はデバイス make を設定し、 devicetype 渡されたフィールドではなくモデルに基づいて設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介して ua サポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%
IP device.ip string デバイスに最も近い IPv4 アドレスを指定します。 販売者の可視性設定で共有が禁止されている場合、購入者に送信されるときに省略されます。 95%
バージョン native.ver string 使用中のネイティブ マークアップ バージョンのバージョン。
Xandr では現在、次のネイティブ バージョンがサポートされています。
- 1.0
- 1.1
注: 1.1 を使用する場合は必須です。 送信されたバージョンがない場合、既定では 1.0 になります。		 95%
要求 native.request string 配信されるレンダリングされたクリエイティブ マークアップ。ネイティブ クリエイティブは、このフィールドで JSON でエンコードされた文字列として返すことができます。
ネイティブ 1.0 の例:
"native": { "request": "{\"native\":{\"ver\":\"1.0\",\"assets\":[{\"id\":3}}]}" }
ネイティブ 1.1 の例:
注: 2 つのバージョンのメイン違いは、要求オブジェクト内の "native" の削除です。
"native": { "request": "{\"ver\":\"1.1\",\"assets\":[{\"id\":3}}]}" }		 95%
資産 ID native.request.native.assets.id integer 交換によって割り当てられた一意の資産 ID。 通常、配列のカウンター。 すべての資産オブジェクトには、一意の資産 ID が含まれている必要があります。 ネイティブ バージョン 1.0 には native.request.native.assets.id を使用し、ネイティブ バージョン 1.1 には native.request.assets.id を使用します。 95%
資産 ID native.request.assets.id integer 交換によって割り当てられた一意の資産 ID。 通常、配列のカウンター。 すべての資産オブジェクトには、一意の資産 ID が含まれている必要があります。 ネイティブ バージョン 1.0 には native.request.native.assets.id を使用し、ネイティブ バージョン 1.1 には native.request.assets.id を使用します。 95%
タイトル アセット native.request.assets.title object Title オブジェクトは、Native 広告の title 要素に使用されます。 95%

アプリ バナーの条件

オークション属性 OpenRTB フィールド 型 説明 しきい値
Height imp.banner.h integer バナーの正確な高さをピクセル単位で指定します。 95%
Width imp.banner.w integer バナーの正確な幅をピクセル単位で指定します。 95%
デバイス ID device.ifa string "広告の識別子" は、広告主の使用に対して承認されたハッシュされていないデバイス ID です。 これは iOS の IDFA と Android の AAID です。 95%
タグ ID app.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID app.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
ドメイン app.domain string インプレッションが表示されるアプリのドメイン ( たとえば、mygame.publishersite.com) を指定します。 インプレッションの参照元ドメイン (使用可能な場合) として設定します。 95%
バンドル ID app.bundle string アプリケーション バンドルまたはパッケージ名 (例: ) を指定します com.foo.mygame。 これは、複数の交換で一意の ID を使用することを目的としています。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合、Xandr はデバイス make を設定し、 devicetype 渡されたフィールドではなくモデルに基づいて設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
ua フィールドを介してサポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%

アプリのビデオの条件

オークション属性 必須の OpenRTB フィールド 型 説明 しきい値
Height imp.video.h integer ビデオ プレーヤーの高さをピクセル単位で指定します。 95%
Width imp.video.w integer ビデオ プレーヤーの幅をピクセル単位で指定します。 95%
Mime の種類 imp.video.mimes 文字列の配列 サポートされるビデオ コンテンツ MIME の種類を指定します。たとえば、 video/x-ms-wmv と video/x-flvです。 指定しない場合は、任意の MIME の種類が許可されます。 95%
API の種類 imp.video.api 整数の配列 このインプレッションでサポートされている API フレームワークを指定します。 API が明示的に一覧表示されていない場合は、サポートされていないと見なされます。 現在サポートされている値は次のとおりです。
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2		 95%
デバイス ID device.ifa string "広告の識別子" は、広告主の使用に対して承認されたハッシュされていないデバイス ID です。 これは、iOS の IDFA または Android の AAID になります。 95%
タグ ID app.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID app.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
最小ビットレート imp.video.minbitrate integer 最小ビット レートをキロバイト/秒で指定します。 指定した場合は、少なくとも 1 つのメディア ファイルが適切なビット範囲内にあるクリエイティブのみを返します。 95%
最大ビットレート imp.video.maxbitrate integer 最大ビット レートを 1 秒あたりキロバイト単位で指定します。 指定した場合は、少なくとも 1 つのメディア ファイルが適切なビット範囲内にあるクリエイティブのみを返します。 95%
再生方法 imp.video.playbackmethod 整数の配列 許可される再生方法を指定します。 指定しない場合、すべてが許可されるものと見なされます。 現在サポートされている値は次のとおりです。
- 1: 自動再生、サウンドオン
- 2: 自動再生、サウンドオフ
- 3: クリックして再生します。
- 4:マウスオーバーで再生		 95%
最大期間 imp.video.maxduration integer ビデオ広告の最大再生時間を秒単位で指定します。 95%
開始遅延 imp.video.startdelay integer ビデオの開始遅延を指定します。
- >0: 0 より大きい値の場合、ビデオ開始前の遅延 (秒単位)。
- 0: プリロール
- -1: 汎用ミッドロール
- -2: 汎用ポストロール		 95%
プロトコル imp.video.protocols integer サポートされているビデオ入札応答プロトコルの配列。 95%
ドメイン app.domain string インプレッションが表示されるアプリのドメイン ( たとえば、mygame.publishersite.com ) を指定します。 インプレッションの参照元ドメイン (使用可能な場合) として設定します。 95%
バンドル ID app.bundle string アプリケーション バンドルまたはパッケージ名 (例: ) を指定します com.foo.mygame。 これは、複数の交換で一意の ID を使用することを目的としています。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合は、渡されたフィールドではなく、モデルに基づいてデバイスmakedevicetypeを設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されている作成を表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介してサポートされていない場合にのみ使用されますua		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%

入札要求の次のフィールド値は、内部的に一貫性がある必要があります。

条件 必須の OpenRTB フィールド 説明 しきい値
VPAID1 imp.video.mimes
imp.video.api		 imp.video.mimes 配列に VPAID1 の値 "1" が含まれている場合、imp.video.mimes 配列には値 "application/x-shockwave-flash" が含まれているか、空である必要があります。この場合、すべての MIME 型がサポートされていると見なされます 95%
VPAID2 imp.video.mimes
imp.video.api		 imp.video.mimes 配列に VPAID2 の値 "2" が含まれている場合、imp.video.mimes 配列には値 "application/x-shockwave-flash" または "application/javascript" が含まれているか、空である必要があります。この場合、すべての MIME 型がサポートされていると見なされます 95%

アプリのオーディオ条件

オークション属性 必須の OpenRTB フィールド 型 説明 しきい値
Mime の種類 imp.audio.mimes 文字列の配列 サポートされるオーディオ コンテンツ MIME の種類を指定します。たとえば、、、audio/vnd.wavaudio/mpeg、audio/mp4、audio/oggまたはaudio/mp2.. 95%
API の種類 imp.audio.api 整数の配列 このインプレッションでサポートされている API フレームワークを指定します。 API が明示的に一覧表示されていない場合は、サポートされていないと見なされます。 現在サポートされている値は次のとおりです。
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2		 95%
ユーザー ID user.buyeruid integer このユーザーの Xandr 一意 ID。 設定すると、この値によって値が customdata 上書きされます。 95%
タグ ID app.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID app.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
最小ビットレート imp.audio.minbitrate integer 最小ビット レート (キロバイト/秒)。 95%
最大ビットレート imp.audio.maxbitrate integer 最大ビット レート (キロバイト/秒)。 95%
最大期間 imp.audio.maxduration integer オーディオ広告の最大再生時間を秒単位で指定します。 95%
開始遅延 imp.audio.startdelay integer ビデオの開始遅延を指定します。
- >0: 0 より大きい値の場合、ビデオ開始前の遅延 (秒単位)。
- 0: プリロール
- -1: 汎用ミッドロール
- -2: 汎用ポストロール		 95%
プロトコル imp.audio.protocols 整数の配列 サポートされているビデオ入札応答プロトコルの配列。 95%
バンドル ID app.bundle string アプリケーション バンドルまたはパッケージ名 (例: ) を指定します com.foo.mygame。 これは、複数の交換で一意の ID を使用することを目的としています。 95%
IP device.ip string デバイスに最も近い IPv4 アドレスを指定します。 販売者の可視性設定で共有が禁止されている場合、購入者に送信されるときに省略されます。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合は、渡されたフィールドではなく、モデルに基づいてデバイスmakedevicetypeを設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介して ua サポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%

アプリのネイティブ条件

オークション属性 必須の OpenRTB フィールド 型 説明 しきい値
ユーザー ID user.buyeruid integer このユーザーの Xandr 一意 ID。 設定すると、この値によって値が customdata 上書きされます。 95%
タグ ID app.id string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
タグ ID imp.tagid string オークションの開始に使用された特定の広告の配置または広告タグの識別子を指定します。 これは Xandr 配置コードです。 95%
パブリッシャー ID site.publisher.id string Xandr パブリッシャー ID を検索するために使用される販売者の発行元 ID を指定します。 95%
バンドル ID app.bundle string アプリケーション バンドルまたはパッケージ名 (例: ) を指定します com.foo.mygame。 これは、複数の交換で一意の ID を使用することを目的としています。 95%
デバイス データ
 device.model string デバイスのモデルを指定します。 渡された場合、Xandr はデバイス make を設定し、 devicetype 渡されたフィールドではなくモデルに基づいて設定します。 この値は、渡された場合に解析された ua フィールドをオーバーライドします。 デバイス モデル サービスを使用して、Xandr システムに登録されているモデルを表示します。 95%
デバイス データ device.ua string ブラウザーからのユーザー エージェント文字列を指定します。 ユーザー エージェントは、多くの場合、ユーザーに代わって動作するアプリケーション、オペレーティング システム、ソフトウェア ベンダーなどの情報 (例 "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4": ) を識別します。 95%
デバイス データ device.devicetype string IAB 値を使用して、デバイスの種類を指定します。
- 1: モバイル/タブレット
- 2: パーソナル コンピューター
- 3: 接続されたテレビ
- 4：電話
- 5：タブレット
- 6: 接続されたデバイス
- 7: トップボックスの設定
フィールドを介して ua サポートされていない場合にのみ使用されます。		 95%
デバイス データ device.make string デバイスのメイクを指定します。 モデルが渡されていない場合、無効な場合、またはフィールドの ua 解析によって使用できない場合にのみ使用されます。 Device Make Service を使用して、Xandr システムに登録されているメイクを表示します。 95%
IP device.ip string デバイスに最も近い IPv4 アドレスを指定します。 販売者の可視性設定で共有が禁止されている場合、購入者に送信されるときに省略されます。 95%
バージョン native.ver string 使用中のネイティブ マークアップ バージョンのバージョン。
Xandr では現在、次のネイティブ バージョンがサポートされています。
- 1.0
- 1.1
注: 1.1 を使用する場合は必須です。 送信されたバージョンがない場合、既定では 1.0 になります。		 95%
要求 native.request string 配信されるレンダリングされたクリエイティブ マークアップ。ネイティブ クリエイティブは、このフィールドで JSON でエンコードされた文字列として返すことができます。
ネイティブ 1.0 の例:
"native": "request": "{\"native\":{\"ver\":\"1.0\",\"assets\":[{\"id\":3}}]}" }
ネイティブ 1.1 の例:
注: 2 つのバージョンのメイン違いは、要求オブジェクト内の "native" の削除です。
"native": { "request": "{\"ver\":\"1.1\",\"assets\":[{\"id\":3}}]}" }		 95%
資産 ID native.request.native.assets.id integer 交換によって割り当てられた一意の資産 ID。 通常、配列のカウンター。 すべての資産オブジェクトには、一意の資産 ID が含まれている必要があります。 ネイティブ バージョン 1.0 には native.request.native.assets.id を使用し、ネイティブ バージョン 1.1 には native.request.assets.id を使用します。 95%
資産 ID native.request.assets.id integer 交換によって割り当てられた一意の資産 ID。 通常、配列のカウンター。 すべての資産オブジェクトには、一意の資産 ID が含まれている必要があります。 ネイティブ バージョン 1.0 には native.request.native.assets.id を使用し、ネイティブ バージョン 1.1 には native.request.assets.id を使用します。 95%
タイトル アセット native.request.assets.title object Title オブジェクトは、Native 広告の title 要素に使用されます。 95%

入札要求の例

Web バナー要求

{
    "site": {
        "publisher": {
            "id": "534561625"
        },
        "domain": "publishersite.com",
        "id": "537123178",
        "page": "https://page.publishersite.com/path/to/page"
    },
    "imp": [
        {
            "banner": {
                "h": 250,
                "w": 300
            },
            "id": "7bbab3f3-83db-4b00-a82d-faa69fcbb5c5"
        }
    ],
    "device": {
        "os": "Windows",
        "make": "desktop",
        "dnt": 0,
        "ua": "Mozilla/5.0 (Windows NT 6.0; rv:50.0) Gecko/20100101 Firefox/50.0",
        "devicetype": 2,
        "model": "browser",
        "user": {
            "buyeruid": "8320715123477372344"
        },
        "id": "7bbab3f3-83db-4b00-a82d-faa69fcbb5c5"
    }
}

アプリ バナー要求

{
    "app": {
        "publisher": {
            "id": "537133097"
        },
        "bundle": "com.publisher.app",
                "domain": "publisher.com",
                "id": "537252150"
    },
    "imp": [
        {
            "banner": {
                "h": 250,
                "w": 300
            },
            "id": "a4d94cdc-3999-4708-9a6d-6ac01f6c07d4"
        }
    ],
    "device": {
        "os": "Android",
        "language": "en",
        "make": "generic",
        "dnt": 0,
        "ua": "Mozilla/5.0 (Linux; Android 4.4.2; GT-I9301I Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36",
        "devicetype": 4,
        "ifa": "ffab2dd1-c6eb-4be9-b88b-1c24e431766d",
        "ip": "5.90.222.251",
        "model": "android phone"
    },
    "id": "a4d94cdc-3999-4708-9a6d-6ac01f6c07d4"
}

Web ビデオ要求

 {
    "site": {
        "publisher": {
            "id": "74964"
        },
        "domain": "publishersite.com",
        "id": "123456",
        "page": "page.publishersite.com/path"
    },
    "imp": [
        {
            "video": {
                "mimes": [
                    "video/x-flv",
                    "video/mp4",
                    "application/x-shockwave-flash"
                ],
                "api": [
                    1
                ],
                                "minbitrate": 1,
                                "maxbitrate": 2000,
                                "playbackmethod": [2],
                                "maxduration": 30,
                                "startdelay":0,
                                "protocols": [2, 5],
                "h": 360,
                "w": 480
            },
            "id": "1"
        }
    ],
    "device": {
        "language": "en",
        "os": "Windows 10",
        "make": "Google",
        "devicetype": 2,
        "ip": "24.171.153.60",
        "model": "Chrome - Windows",
        "ua": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.99 Safari/537.36"
    },
    "id": "32683827af9b11e6b43212a6e39f0001",
    "user": {
        "buyeruid": "6415517486677292084"
    }
}

アプリ ビデオ要求

 {
    "app": {
        "publisher": {
            "id": "1100001685"
        },
        "bundle": "com.publisher.app",
        "domain": "publishersite.com",
        "id": "123456",
        "page": "page.publishersite.com/path"
    },
    "imp": [
        {
            "tagid": "130200094",
            "video": {
                                "mimes": [
                    "video/x-flv",
                    "video/mp4",
                    "application/x-shockwave-flash"
                ],
                "api": [
                    1
                ],
                                "minbitrate": 1,
                                "maxbitrate": 2000,
                                "playbackmethod": [2],
                                "maxduration": 30,
                                "startdelay":0,
                                "protocols": [2, 5],
                "h": 480,
                "w": 320
            }
        }
    ],
    "device": {
        "os": "Android",
        "ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-N920V Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/54.0.2840.85 Mobile Safari/537.36",
        "make": "Samsung",
        "devicetype": 1,
        "ifa": "C8A53AB8-D371-4955-BFDA-7805FA931E44",
        "model": "SM-N920V"
    },
    "id": "Nr4EZZiP5z"
}