このページを参照する際は、OpenRTB 2.6 仕様を参照してください。
ディスプレイ&ビデオ 360 では、OpenRTB 仕様のすべてのフィールドがサポートされているわけではありません。また、細かい違いが生じる場合があります。このドキュメントのセクションには、ディスプレイ&ビデオ 360 の実装に固有の情報と推奨事項が記載されています。特に指示がない限り、OpenRTB 仕様に記載されているガイドラインにも従う必要があります。
一部のフィールドはサポートされていませんが、解析されます。これらのフィールドの形式は正しくする必要がありますが、入札結果には影響しません。
入札リクエストの仕様
入札リクエストは、入札リクエスト オブジェクトの本文を含む HTTP POST リクエストです。本文の形式は Content-Type
ヘッダーで定義されます。
対応するレスポンスは、非入札の本文のない HTTP 204 か、入札レスポンスの本文を含む HTTP 200 です。
入札リクエストの形式が正しくない場合、nbr
フィールドが入力された入札レスポンスの本文を含む HTTP 200 が返されることがあります。
レスポンスの形式は Accept
ヘッダーによって制御されます。
JSON 形式
承認された MIME タイプが指定されていない場合は、デフォルトの形式が使用されます。
JSON リクエストとレスポンスは、IAB の OpenRTB 2.6 仕様に準拠しています。次のドキュメントでは、拡張機能とフィールドのサポートについて説明します。
ヘッダー Content-Type
: application/json
は JSON 入札リクエストを示し、Accept
: application/json
は入札レスポンスが JSON 形式である必要があることを示します。
Protobuf 形式
注: Protobuf のサポートはベータ版です。ご興味をお持ちの場合は、DV360 までお問い合わせください。
JSON リクエストとレスポンスは、IAB の OpenRTB 2.6 Protobuf 仕様に準拠しています。
拡張機能のサポートは限定的です。ご興味をお持ちの場合は、DV360 にお問い合わせください。
ヘッダー Content-Type
: application/x-protobuf
を送信して Protobuf 入札リクエストを通知し、Accept
: application/x-protobuf
を設定して Protobuf 入札レスポンスを受信します。
入札リクエスト オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 必須。 入札リクエストの一意の ID。これは、リクエストが処理された後、非常に限られた時間に個々のリクエストを識別するために使用できます。 |
imp |
インプレッション数の配列 | imp オブジェクトが 1 つ以上必要です。
オーディオ Pod の場合、複数の |
site |
サイト | ウェブサイトのリクエストで必須です。site と app は相互に排他的です。 |
app |
アプリ | アプリのリクエストに必須です。app と site は相互に排他的です。 |
device |
デバイス | 必須。 |
user |
ユーザー | 必須。 |
test |
Integer | サポート対象外。 |
at |
Integer |
1 : 広告主が入札額を支払うファーストプライス オークション。2 (デフォルト): セカンドプライス オークション。広告主は 2 番目に高い入札額の少し上を支払います。3 : 最小価格はリクエストに含まれており、競合する入札単価とは関係ありません。
|
tmax |
Integer | 省略可。デフォルトは統合ごとにカスタムです。 |
wseat |
文字列配列 | 許可された購入者のシートのリスト。 すべての広告主が入札を許可されている場合を除き、推奨されます。 未設定の場合、制限なしを意味します。 |
bseat |
文字列配列 | 入札をブロックする必要がある購入者シートのリスト。リストに登録された購入者は、取引と公開オークションへの入札がブロックされます。 |
allimps |
Integer | サポート対象外。 |
cur |
文字列配列 | 省略可ですが、使用することを強くおすすめします。 デフォルトはインテグレーションごとです。 入札リクエストの通貨は、統合時に登録した通貨のいずれかと一致している必要があります。 交換ごとに単一の通貨をサポートすることを強くおすすめします。 |
wlang |
文字列配列 | サポート対象外。 |
bcat |
文字列配列 | IAB コンテンツ カテゴリを使用してブロックされた広告主のカテゴリ。 未設定の場合、ブロックされるカテゴリはありません。 |
badv |
文字列配列 | 広告主から提供されたドメインに基づいて、ブロックする広告主を指定します。 未設定の場合、ブロック中の広告主はありません。 |
bapp |
文字列配列 | サポート対象外。 |
source |
ソース | schain では準必須です。 |
regs |
Regs | 省略可。 |
ext |
入札リクエストの拡張機能 | 省略可。 |
入札リクエスト拡張機能オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
schain |
サプライ チェーン |
新しい統合では、代わりに [ソース] の BidRequest.source.schain フィールドを使用する必要があります。 |
purch |
Integer |
購入したトラフィック パラメータは、所有、獲得、または報酬提供型のアクティビティ以外のプロパティからリダイレクトされたトラフィックです。 これは、新しい MRC IVT 2.0 仕様に基づいています。
これは、購入者向けレポートでは「パブリッシャー トラフィック ソース」と呼ばれ、次のいずれかの値になります。 |
gdemsignals |
文字列 | GMA SDK の SCAR API シグナル ブローバ。 GMA SDK トラフィックの場合は推奨、それ以外の場合は禁止。 |
disable_gma_format |
int |
gdemsignals が指定されている場合は省略可。それ以外の場合は使用できません。0 (デフォルト): gdemsignals が入力されている場合、入札レスポンスの adm は JSON blob です。1 : JSON の blob の代わりに広告タグも提供されます。 |
ソース オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
fd |
Integer | 最終的なインプレッション販売の決定を行うエンティティ0 (デフォルト): エクスチェンジが決定します。1 : アップストリーム ソースが決定します。
|
tid |
文字列 | サポート対象外。 |
pchain |
文字列 | サポート対象外。 |
schain |
サプライ チェーン |
ほとんどの場合に必須です。
このフィールドは、入札リクエスト拡張機能またはソース拡張機能を介して |
ext |
ソース拡張機能 | 省略可。 |
ソース拡張機能オブジェクト
この拡張機能は、DV3 で視認性の測定結果がお客様に報告される方法に影響するため、強くおすすめします。OMID パートナー名が IAB 認定リストにない場合、Google は MRC の要請により、視認性指標を MRC 認定指標とは別に報告する必要があります。詳細
フィールド | タイプ | 詳細 |
---|---|---|
omidpn |
文字列 | OM SDK 統合の ID。これは、OMID パートナー オブジェクトの「name」パラメータと同じです。 |
omidpv |
文字列 | OM SDK 統合のバージョン。これは、OMID パートナー オブジェクトの「versionString」パラメータと同じです。 |
schain |
サプライ チェーン |
新しい統合では、代わりに [ソース] の schain フィールドを使用する必要があります。 |
Regs オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
coppa |
Integer | 0 (デフォルト): このリクエストには COPPA は適用されません。1 : このリクエストは COPPA の対象です。 |
ext |
Regs 拡張機能 | 省略可。 |
Regs 拡張機能オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
gdpr |
Integer | 入札リクエストが EEA 地域からのものかどうかを示します。0 (デフォルト): EEA 以外の地域。1 : EEA 地域詳しくは、GDPR 向けの同意済みプロバイダ ソリューションをご覧ください。 |
us_privacy |
文字列 | us_privacy 文字列を実装するには、IAB Tech Lab が提供する技術仕様に沿って行ってください。
入札リクエストで |
Imp オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 入札リクエストのコンテキスト内でこのインプレッションを一意に識別する識別子(通常、値は 1 から始まり、n インプレッションで n まで増加します)。 |
metric |
オブジェクト | サポート対象外。 |
banner |
バナー | バナー広告の広告枠では必須です。 |
video |
動画 | 動画広告の広告配信予想数には必須です。 |
audio |
音声 | オーディオ広告の広告配信予想数の場合、必須です。 |
native |
ネイティブ | ネイティブ広告の広告配信予想数には必須です。 |
pmp |
Pmp | このインプレッションで有効になっているプライベート マーケットプレイス取引。 |
displaymanager |
文字列 | 広告のレンダリングを担当する広告メディエーション パートナー、SDK テクノロジー、プレーヤーの名前(通常は動画またはモバイル)。一部の広告サーバーで、パートナーごとに広告コードをカスタマイズするために使用されます。動画やアプリに推奨します。 |
displaymanagerver |
文字列 | 広告のレンダリングを担当する広告メディエーション パートナー、SDK テクノロジー、プレーヤーのバージョン(通常は動画またはモバイル)。一部の広告サーバーで、パートナーごとに広告コードをカスタマイズするために使用されます。動画やアプリに推奨します。 |
instl |
Integer |
0 (デフォルト): インタースティシャルではない。1 : 広告がインタースティシャルまたは全画面表示の場合。
|
tagid |
文字列 | オークションの開始に使用された特定の広告プレースメントまたは広告タグの識別子。これは、問題のデバッグや購入者による最適化に役立ちます。 |
bidfloor |
浮動小数点数 | このインプレッションの最小入札単価(インプレッション単価)。 |
bidfloorcur |
文字列 |
ISO-4217 アルファベット コードを使用して指定された通貨。 |
clickbrowser |
Integer |
アプリ内のクリエイティブをクリックしたときに開くブラウザのタイプを示します。 iOS 9.x デバイスの Safari ビュー コントローラは、このフィールドではネイティブ ブラウザと見なされます。 |
secure |
Integer |
このインプレッションに安全な HTTPS URL が必要な場合、または安全でない HTTP URL が必要な場合。0 (デフォルト): 安全でない1 : 安全
|
iframebuster |
文字列配列 | |
exp |
Integer | 入札の有効期限は、このフィールドでパートナーが送信した値に関係なく、ディスプレイ&ビデオ 360 によって設定されます。インプレッションの古い期間(通常は 1 時間)を過ぎてから受信されたインプレッション イベントは古いとして破棄され、DV360 では請求対象と見なされません。 |
rwdd |
Integer |
ユーザーが広告を見る代わりにリワードを受け取るかどうかを示します。0 (デフォルト): 報酬なし1 : 報酬あり
通常、動画広告の実装では、ユーザーが追加のニュース記事を無料で読んだり、ゲームで追加のライフを獲得したり、スポンサー セッションで広告なしの音楽を聴いたりできます。通常、報酬は動画広告の再生が完了した後に配布されます。 |
インプレッション拡張機能オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
bcrid |
文字列 | ブロックする必要があるクリエイティブ ID のリスト。 |
バナー オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
format |
配列をフォーマットする | サポートされている形式のリスト。 |
w |
Integer |
format を使用することをおすすめします。 |
h |
Integer |
format を使用することをおすすめします。 |
wmax |
Integer | サポート対象外。 |
hmax |
Integer | サポート対象外。 |
wmin |
Integer | サポート対象外。 |
hmin |
Integer | サポート対象外。 |
btype |
整数配列 |
ブロックリストに登録されているバナー広告の種類:
|
battr |
整数配列 | 次の値をサポートします。
|
pos |
Integer |
広告の位置:
|
mimes |
文字列配列 |
サポート対象外。 ディスプレイ&ビデオ 360 では、すべてのバナー クリエイティブに text/html が使用されます。 |
topframe |
Integer |
0 (デフォルト): バナーは iframe で配信されます。1 : サポート対象外: バナーは上部フレームで配信されます。
|
expdir |
整数配列 |
1 : 左2 : 右3 : 上4 : 下5 : 全画面表示に拡張可能
|
api |
整数配列 |
サポートされている API フレームワーク
|
id |
文字列 |
バナー オブジェクトの識別子。インプレッション内で一意である必要があります。
|
vcm |
Integer |
動画オブジェクトで使用される 0 : バナーは動画クリエイティブと同時に表示されます。1 : バナーは動画の後の終了カードです。
|
オブジェクトの形式を設定する
フィールド | タイプ | 詳細 |
---|---|---|
w |
Integer | 幅(デバイス非依存ピクセル(DIPS)単位)。 |
h |
Integer | デバイスに依存しないピクセル(DIPS)単位の高さ。 |
wratio |
Integer | サポート対象外。 |
hratio |
Integer | サポート対象外。 |
wmin |
Integer | サポート対象外。 |
動画オブジェクト
入札リクエストで動画プレースメントを指定することを強くおすすめします。プレースメント フィールドが指定されていない場合は、不明なプレースメントとして分類されます。詳しくは、位置情報ターゲティングに関する記事をご覧ください。
フィールド | タイプ | 詳細 |
---|---|---|
mimes |
文字列配列 |
MIME タイプを少なくとも 1 つ指定する必要があります。
|
minduration |
Integer | 動画の最小再生時間(秒単位)。デフォルトは最小なし。 |
maxduration |
Integer | 動画の最大再生時間(秒単位)。デフォルトは上限なしです。 |
protocols |
整数配列 |
サポートされているプロトコルが 1 つ以上必要です。
|
w |
Integer | 動画プレーヤーの幅(デバイス非依存ピクセル(DIPS)単位)。 |
h |
Integer | 動画プレーヤーの高さ(デバイス非依存ピクセル(DIPS)単位)。 |
startdelay |
Integer | プレロール、ミッドロール、ポストロールの広告プレースメントの開始遅延(秒単位)。 |
placement |
Integer | 入札リクエストで動画の plcmt(および/または)プレースメントを指定することを強くおすすめします。
両方のフィールドが指定されていない場合は、不明なプレースメントとして分類されます。
|
plcmt |
Integer | 入札リクエストで動画の plcmt(および/または)プレースメントを指定することを強くおすすめします。
両方のフィールドが指定されていない場合は、不明なプレースメントとして分類されます。
注: インストリーム(プレースメントまたは Plcmt タイプ 1)と見なされるには、動画プレースメントまたはインプレッションが「音声オン」に設定され、再生方法で正しくシグナルが送信されている必要があります(値 1、3、4、5 はすべて該当します)。
注: plcmt: Accompanying Content (2) は placement: In Article (3) と見なされますplcmt: No Content/Standalone (4) は placement: In feed (4) と見なされますplacement: In Banner には plcmt にマッピングがありません
|
linearity |
Integer | サポート対象外。 |
skip |
Integer |
動画プレーヤーで広告をスキップできるかどうか。
|
skipmin |
Integer | サポート対象外。 |
skipafter |
Integer | サポート対象外。 |
sequence |
Integer | 同じ入札リクエストで複数の広告インプレッションが提供される場合、シーケンス番号により複数のクリエイティブを調整して配信できます。 |
battr |
整数配列 | ブロックされたクリエイティブの属性。 |
maxextended |
Integer |
延長が許可されている場合の動画広告の最大延長時間。
|
minbitrate |
Integer | 最小ビットレート(Kbps)。 |
maxbitrate |
Integer | 最大ビットレート(Kbps)。 |
boxingallowed |
Integer |
4:3 コンテンツを 16:9 ウィンドウにレターボックス表示することを許可するかどうかを示します。
|
playbackmethod |
整数配列 |
使用されている可能性のある再生方法。指定しない場合、任意のメソッドを使用できます。
|
playbackend |
Integer |
再生を終了させるイベント。
|
delivery |
整数配列 | サポートされている配信方法。指定しない場合、すべてがサポートされていると見なされます。
|
pos |
Integer |
画面上の広告の位置。
|
companionad |
バナー配列 | コンパニオン広告(利用可能な場合)。 |
api |
整数配列 |
|
companiontype |
整数配列 | サポート対象外。 |
maxseq |
Integer | 動的動画連続配信広告で返される広告の最大数。 |
poddur |
整数配列 | 動的動画連続配信広告の最大長(秒単位)。 |
動画オブジェクトでサポートされている拡張機能
フィールド | タイプ | 詳細 |
---|---|---|
rewarded |
Integer | このフィールドは、リクエストに報酬が支払われるかどうかを通知します。これは整数として送信する必要があります。
|
オーディオ オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
mimes |
文字列配列 |
MIME タイプを少なくとも 1 つ指定する必要があります。
|
minduration |
Integer | 広告の最小再生時間(秒単位)。 |
maxduration |
Integer | 広告の最大再生時間(秒単位)。 |
protocols |
整数配列 |
|
startdelay |
Integer | プレロール、ミッドロール、ポストロールの広告プレースメントの開始遅延(秒単位)。
|
sequence |
Integer | サポート対象外。 |
battr |
整数配列 | サポート対象外。 |
maxextended |
Integer | サポート対象外。 |
minbitrate |
Integer | 最小ビットレート(Kbps)。 |
maxbitrate |
Integer | 最大ビットレート(Kbps)。 |
delivery |
整数配列 | サポート対象外。 |
companionad |
バナー オブジェクト配列 | バナーのコンパニオン クリエイティブ スロット。 |
api |
整数配列 |
このインプレッションでサポートされている API フレームワークのリスト。
|
companiontype |
整数配列 | サポート対象外。 |
maxseq |
整数配列 | サポート対象外。 |
feed |
Integer |
音声フィードのタイプ。
|
stitched |
Integer | サポート対象外。 |
nvol |
Integer | サポート対象外。 |
ネイティブ オブジェクト
詳しくは、ディスプレイ&ビデオ 360 ネイティブ広告の仕様をご覧ください。
フィールド | タイプ | 詳細 |
---|---|---|
request |
文字列 | 文字列でエンコードされたネイティブ JSON オブジェクト。 |
ver |
文字列 |
1.0 : サポート対象外1.1 : サポート対象外1.2
|
api |
整数配列 |
このインプレッションでサポートされている API フレームワークのリスト。
|
battr |
整数配列 | サポート対象外。 |
PMP オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
private_auction |
Integer |
0 (デフォルト): すべての入札単価を許可1 : 特価のみ
|
deals |
取引オブジェクトの配列 | 含める取引。 |
取引オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | PMP オブジェクトには、ID ごとに複数の取引オブジェクトを含めることはできません。 |
bidfloor |
ダブル |
このインプレッションの最小入札単価(インプレッション単価)。
|
bidfloorcur |
文字列 |
ISO-4217 アルファベット コードを使用して指定された通貨。 指定しない場合、デフォルトで入札リクエストの通貨が使用されます。 |
at |
Integer |
指定しない場合、デフォルトは bid_request.at と一致します。
|
wseat |
文字列配列 |
取引の対象となるパートナーのパートナー ID。
座席なしは、座席制限なしを意味します。 |
wadomain |
文字列配列 |
この取引に入札を許可されている広告主のドメイン。
シートなしは、ドメインの制限なしを意味します。 |
guar |
Integer |
このフィールドは、取引が保証型取引かどうかを示すものです。これは整数として送信する必要があります。 ディスプレイ&ビデオ 360 で予約型取引を受け入れるには、エクスチェンジが許可リストに登録されている必要があります。この登録をリクエストするには、お問い合わせください。 現在、貴社のエクスチェンジが DV360 との保証取引を通知するために別のメカニズムを使用している場合は、この優先拡張機能への移行についてお問い合わせください。
|
ext |
ディール拡張機能 | 省略可。 |
取引オブジェクトでサポートされている拡張機能
フィールド | タイプ | 詳細 |
---|---|---|
guaranteed |
Integer |
このフィールドは、取引が保証型取引かどうかを示すものです。これは整数として送信する必要があります。 ディスプレイ&ビデオ 360 で予約型取引を受け入れるには、エクスチェンジが許可リストに登録されている必要があります。この登録をリクエストするには、お問い合わせください。 現在、貴社のエクスチェンジが DV360 との保証取引を通知するために別のメカニズムを使用している場合は、この優先拡張機能への移行についてお問い合わせください。
このフィールドの代わりに |
サイト オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | エクスチェンジ上のサイトの ID。 |
name |
文字列 | サポート対象外。 |
domain |
文字列 |
サイトのドメイン。 site.domain にのみ入力するのではなく、site.page に完全な URL を送信することをおすすめします。 |
cat |
文字列配列 | サポート対象外。 |
sectioncat |
文字列配列 | サポート対象外。 |
pagecat |
文字列配列 | サポート対象外。 |
page |
文字列 |
インプレッションを表示する完全な URL。
ターゲティング目的で完全な URL を送信することをおすすめします。 |
ref |
文字列 | 現在のページへのアクセスを誘導した参照 URL。 |
search |
文字列 | サポート対象外。 |
mobile |
Integer | サポート対象外。 |
privacypolicy |
Integer | サポート対象外。 |
publisher |
パブリッシャー オブジェクト | サイトのパブリッシャーに関する詳細。 |
content |
コンテンツ オブジェクト | サイト内のコンテンツに関する詳細。 |
keywords |
文字列(CSV 形式) | サポート対象外。 |
ext |
サイト拡張機能 | サイト オブジェクトのエクステンション。 |
サイト拡張機能オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
inventorypartnerdomain |
文字列 | CTV 広告枠の共有に使用されます。IAB CTV アプリの広告枠の追加に関する説明をご覧ください。 |
アプリ オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | エクスチェンジのアプリケーション ID。 |
name |
文字列 |
アプリケーション名(パブリッシャーのリクエストに応じてエイリアス化される場合があります)。 SDK を使用しないリクエスト(主にコネクテッド テレビ)のアプリ名は、パブリッシャーがリクエスト内で直接指定できます。 |
bundle |
文字列 |
必須。 iOS の場合は、数値の App Store ID である必要があります。リバース DNS スタイルのバンドル ID は使用できません。 コネクテッド テレビ アプリの場合は、ストア定義のアプリ ID を渡すことをおすすめします。先日公開された IAB OTT/CTV ストア割り当ての ID に関するガイドラインに準拠してください。 |
domain |
文字列 | ドメイン(mygame.foo.com など) |
storeurl |
文字列 | app-ads.txt の確認とコネクテッド テレビ アプリストアの検証に必要です。 |
cat |
文字列配列 | サポート対象外。 |
sectioncat |
文字列配列 | サポート対象外。 |
pagecat |
文字列配列 | サポート対象外。 |
ver |
文字列 | サポート対象外。 |
privacypolicy |
Integer | サポート対象外。 |
paid |
Integer | サポート対象外。 |
publisher |
パブリッシャー オブジェクト | アプリのパブリッシャーに関する情報。 |
content |
コンテンツ オブジェクト | アプリのコンテンツに関する情報。 |
keywords |
文字列(CSV 形式) | サポート対象外。 |
ext |
アプリリンク表示オプション | アプリ オブジェクトの拡張機能。 |
アプリリンク表示オプション オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
inventorypartnerdomain |
文字列 | CTV 広告枠の共有に使用されます。IAB CTV アプリの広告枠の追加に関する説明をご覧ください。 |
コンテンツ オブジェクト
利用可能な場合は、これらの属性を渡すことをおすすめします。
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | コンテンツを一意に識別する ID。 |
episode |
Integer | コンテンツのエピソード番号(通常は動画コンテンツ用)。 |
title |
文字列 | コネクテッド テレビ、動画、オーディオのリクエストに推奨されます。 |
series |
文字列 | コネクテッド テレビ、動画、オーディオのリクエストに推奨されます。 |
season |
文字列 | コンテンツのシーズンのラベル。 |
artist |
文字列 | コンテンツのクレジットされているアーティスト。 |
genre |
文字列 | コンテンツを最もよく表すジャンル。ディスプレイ&ビデオ 360 では、コネクテッド テレビ、動画、オーディオのリクエストにこのシグナルを提供することをおすすめします。
ディスプレイ&ビデオ 360 では、このフィールドの動画ジャンル値に次の分類がサポートされています。 |
album |
文字列 | コンテンツが属するアルバム(通常は音声の場合)。 |
isrc |
文字列 | ISO-3901 に準拠した国際標準レコーディング コード。 |
producer |
プロデューサー オブジェクト | コンテンツ プロデューサーに関する詳細。 |
url |
文字列 | コンテンツの URL。 |
cat |
文字列配列 | コンテンツを説明する IAB コンテンツ カテゴリ。 |
prodq |
Integer |
制作品質:
|
videoquality |
Integer | サポート対象外。 |
context |
Integer |
コンテンツの種類:
|
contentrating |
文字列 | この属性に基づいて判断が開始されるため、オーディオと動画/コネクテッド テレビに推奨されます。 |
userrating |
文字列 | 星の数、高評価の数など |
qagmediarating |
Integer |
[QAG ガイドライン](http://www.iab.net/ne_guidelines) に準拠したメディア評価。
|
keywords |
文字列(CSV 形式) | サポート対象外。 |
livestream |
Integer |
コンテンツがライブ配信コンテンツであるかどうか。
|
sourcerelationship |
Integer |
|
len |
Integer |
コンテンツの長さ(秒単位)。 コネクテッド テレビ/動画と音声のリクエストに推奨されます。 |
language |
文字列(ISO-639-1-alpha-2) | コンテンツの言語。 |
embeddable |
Integer |
コンテンツを埋め込めるかどうかを示すインジケーター(埋め込み可能な動画プレーヤーなど)
|
data |
データ オブジェクトの配列 | 追加データ。 |
プロデューサー オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | サポート対象外。 |
name |
文字列 | サポート対象外。 |
cat |
文字列配列 | サポート対象外。 |
domain |
文字列 | プロデューサーの最上位ドメイン。 |
データ オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | データ プロバイダの ID。 |
name |
文字列 | データ プロバイダの交換名。 |
segment |
セグメント オブジェクトの配列 | 実際のデータ値。 |
セグメント オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | データ プロバイダに固有のデータ セグメントの ID。 |
name |
文字列 | データセグメントの名前。 |
value |
文字列 | データ セグメントの値。 |
パブリッシャー オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 必須。 |
name |
文字列 | サポート対象外。 |
cat |
文字列配列 | サポート対象外。 |
domain |
文字列 | サポート対象外。 |
デバイス オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
ua |
文字列 | 必須。 |
sua |
UserAgent オブジェクト | 構造化されたユーザー エージェント情報。 |
geo |
ジオ オブジェクト | デバイスの場所。 |
dnt |
Integer |
ブラウザのヘッダーに設定された Do Not Track フラグ。
|
lmt |
Integer |
広告トラッキング制限シグナルが商業的に承認されている。
|
ip |
文字列 |
IPv4 の場合は必須です。
IP アドレスが切り捨てられる場合は、 |
ipv6 |
文字列 |
IPv6 の場合は必須です。
IP アドレスが切り捨てられる場合は、 |
devicetype |
Integer | すべての広告枠タイプで強くおすすめします。デバイスタイプの認識を強化するために使用されます。 |
make |
文字列 | |
model |
String | |
os |
文字列 |
デバイスのオペレーティング システム。
このフィールドでは大文字と小文字が区別されません。 |
osv |
文字列 | サポート対象外。 |
hwv |
文字列 | デバイスのハードウェア バージョン。 |
h |
Integer | 画面の物理的な高さ(ピクセル単位)。 |
w |
Integer | 画面の物理的な幅(ピクセル単位)。 |
ppi |
Integer | サポート対象外。 |
pxratio |
ダブル | 物理ピクセルとデバイス非依存ピクセルの比率。 |
js |
Integer | サポート対象外。 |
geofetch |
Integer | サポート対象外。 |
flashver |
文字列 | サポート対象外。 |
language |
文字列(ISO-639-1-alpha-2) | デバイスの言語。 |
carrier |
文字列 | サポート対象外。 |
mccmnc |
文字列 | サポート対象外。 |
connectiontype |
Integer | ネットワーク接続の種類 |
ifa |
文字列 | 広告主が明示的に使用することを許可されている ID。 |
didsha1 |
文字列 | サポート対象外。 |
didmd5 |
文字列 | サポート対象外。 |
dpidsha1 |
文字列 | サポート対象外。 |
dpidmd5 |
文字列 | サポート対象外。 |
macsha1 |
文字列 | サポート対象外。 |
macmd5 |
文字列 | サポート対象外。 |
ext |
デバイス拡張機能 | デバイス オブジェクトの拡張機能。 |
デバイス オブジェクトでサポートされている拡張機能
ip
が変更または切り捨てられた場合は、トラフィックが無効なトラフィックとして宣言されないように、次の拡張機能を送信することを強くおすすめします。
フィールド | タイプ | 詳細 |
---|---|---|
truncated_ip |
Integer |
入札リクエストの device.ip フィールドの IP アドレスが切り捨てられているかどうかを示します。
デフォルトでは切り捨てられず、IP アドレスが切り捨てられる場合は必須です。 宣言しない場合、入札リクエストが無効なトラフィックとして分類される可能性があります。 |
ifa_type |
文字列 |
device.ifa フィールドのオリジンを指定します。デバイス自体から提供されたものなのか、サプライ チェーン内のパブリッシャーまたは SSP によって生成されたものなのかを示します。
|
attestation_token |
文字列(Base64 エンコード) | デバイスの検証レベルをサポートするエクスチェンジ用のデバイスベースの構成証明トークン。 |
atts |
Integer |
(iOS のみ)アプリのアプリ トラッキング許可ステータスを表す整数。
|
cdep |
文字列 |
Chrome のサードパーティ Cookie のサポート終了ラベル。
Chrome 主導のテストと IAB コミュニティ仕様をご覧ください。 |
UserAgent オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
browsers |
BrandVersion オブジェクトの配列 | 各 BrandVersion オブジェクトは、ブラウザや同様のソフトウェア コンポーネントを識別します。 |
platform |
BrandVersion オブジェクト | プラットフォームを識別します。 |
mobile |
Integer |
0 (デフォルト): エージェントは「パソコン」または「完全」のコンテンツを優先します。1 : エージェントは「モバイル」コンテンツを優先します。
|
architecture |
文字列 | デバイスのアーキテクチャ(「x86」や「arm」など)。 |
bitness |
文字列 | デバイスのビット数(64 ビット アーキテクチャの場合は「64」など)。 |
model |
文字列 | デバイスのモデル。 |
source |
Integer | このオブジェクトの作成に使用されたデータソース。 リスト: ユーザー エージェントのソースをご覧ください。 UserAgent オブジェクトを渡す場合に推奨されます。 |
BrandVersion オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
brand |
文字列 | ブランド識別子(「Chrome」や「Windows」など)。必須。 |
version |
文字列配列 | バージョン コンポーネントのシーケンス(メジャー、マイナー、マイクロなど)。階層順に降順で指定します。 |
Geo オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
lat |
ダブル | サポート対象外。 |
lon |
ダブル | サポート対象外。 |
type |
Integer | サポート対象外。 |
accuracy |
Integer | サポート対象外。 |
lastfix |
Integer | サポート対象外。 |
ipservice |
Integer | サポート対象外。 |
country |
文字列 | サポート対象外。 |
region |
文字列 | サポート対象外。 |
regionfips104 |
文字列 | サポート対象外。 |
metro |
文字列 | サポート対象外。 |
city |
文字列 | サポート対象外。 |
zip |
文字列 | サポート対象外。 |
utcoffset |
Integer | サポート対象外。 |
ユーザー オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | Google が ID マッチテーブルをホストしている場合にサポートされます。 |
buyeruid |
文字列 | SSP が ID マッチテーブルをホストしている場合にサポートされます。 |
yob |
Integer | 年齢や性別によるターゲティングに推奨されます。 |
gender |
文字列 | 年齢や性別によるターゲティングに推奨されます。 |
keywords |
文字列(CSV) | サポート対象外。 |
customdata |
文字列 | サポート対象外。 |
geo |
ジオ オブジェクト | サポート対象外。 |
data |
データ オブジェクトの配列 | サポート対象外。 |
eids |
拡張 ID オブジェクトの配列 | エクスチェンジから提供される拡張 ID インスタンス。 |
ext |
ユーザー拡張機能 | ユーザー オブジェクトの拡張機能。 |
ユーザー オブジェクトでサポートされている拡張機能
フィールド | タイプ | 詳細 |
---|---|---|
consent |
文字列(ウェブセーフ Base64) |
IAB 同意文字列。
ユーザーが収集に同意した情報と、その情報を使用できるベンダーに関するメタデータが含まれます。 この値は、カスタム バイナリ形式を使用したウェブセーフな base64 エンコードのバイナリ文字列です。 |
us_privacy |
文字列 | お客様が CCPA や類似の法律のコンプライアンスを確認している場合。 |
consented_providers_settings .consented_providers |
内部の整数配列(consented_providers)をラップする外側のオブジェクト(consented_providers_settings)。 | GDPR リクエストの同意を得たベンダーに渡します。詳しくは、GDPR の同意プロバイダ ソリューションをご覧ください。 |
eids |
拡張 ID オブジェクトの配列 | エクスチェンジから提供される拡張 ID インスタンス。 |
拡張 ID オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
source |
文字列 | 識別子の提供元 |
uids |
拡張 ID UID オブジェクトの配列 | 実際の識別子 |
拡張 ID UID オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 識別子自体。 |
atype |
Integer | この ID に関連付けられているユーザー エージェントのタイプ。 |
サプライ チェーン オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
complete |
Integer | 0 (デフォルト): サプライ チェーンが不完全です。1 : サプライ チェーンがパブリッシャーまで完了しています。
|
ver |
文字列 | 必須。 値の形式は「major.minor」です。たとえば、バージョン 1.0 は文字列「1.0」です。 |
nodes |
サプライ チェーン ノード アレイ | 必須。 完全なサプライ チェーンでは、最初のノードは、トランザクションに関与する最初の広告システムと販売者 ID(サイト、アプリ、その他のメディアのオーナー)を表します。 不完全なサプライ チェーンでは、最初の既知のノードを表します。最後のノードは、この入札リクエストを送信するエンティティを表します。 |
サプライ チェーン ノード オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
asi |
文字列 | SSP、エクスチェンジ、ヘッダー ラッパーなど、入札者が接続するシステムの正規ドメイン名です。システムの運用ドメインが親会社のドメインと異なる場合は、運用ドメインを指定できます。これを指定しておくと、WHOIS 検索や IP の逆引きで委任システムの明確な所有権を示すことができます。 これは、ads.txt ファイルで販売者の識別に使用されている値と同じ値にする必要があります(存在する場合)。 |
sid |
文字列 | 広告システムで販売者または販売パートナー アカウントに関連付けられている識別子です。SSP またはエクスチェンジで指定されたフィールドに、トランザクション(OpenRTB 入札リクエストなど)で使用されている値と同じ値を指定する必要があります。 OpenRTB の場合、通常は publisher.id です。 OpenDirect の場合、通常はパブリッシャーの組織 ID が該当します。 長さは 64 文字に制限されています。 |
rid |
文字列 | この販売者によって発行されたリクエストの OpenRTB RequestId。 |
name |
文字列 | 指定された seller_id で取引された広告枠に対して支払いが行われる会社(法人)の名前。 この値は省略可能です。広告システムの sellers.json ファイルに存在する場合は、含めないでください。 |
domain |
文字列 | このノードで表されるエンティティのビジネス ドメイン名。 この値は省略可能です。広告システムの sellers.json ファイルに存在する場合は、含めないでください。 |
hp |
Integer | このノードが広告枠の支払いフローに関連付けられるかどうかを示します。
SupplyChain のバージョン 1.0 では、このプロパティは常に 1 にする必要があります。今後のバージョンの仕様で、お支払い以外の処理ノードが導入されることが予想されるため、明示的に含める必要があります。 実装者は、このフィールドをサポートし、ダウンストリームの広告システムに送信される入札リクエストで SupplyChain オブジェクトを作成するときに、このフィールドを伝播する必要があります。 |
入札レスポンスの仕様
BidResponse オブジェクト
属性 | サポート対象 | 実装の詳細 | 常に合格 |
---|---|---|---|
id | 解析エラーが発生した場合、ビッダー リクエスト ID ではなく「0」になることがあります。 | ○ | |
seatbid | |||
bidid | |||
cur | 解析エラーが発生した場合、これは渡されません。有効な入札リクエスト トラフィックの場合、cur は常に指定されます。 | ○ | |
customdata | |||
nbr |
これは、入札リクエストで問題が見つかった場合にのみ含まれ、OpenRTB 仕様に従い、常に 2 (無効なリクエスト)になります。NBR を含むリクエストは次のようになります。 { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } |
||
ext | 入札リクエストに問題がある場合は、エラーの診断に役立つ情報が ext に含まれる場合があります(サポートされている場合)。 |
BidResponse オブジェクトでサポートされているエクステンション
属性 | 実装の詳細 |
---|---|
err | 入札リクエストのエラーの説明(人が読める形式)。レスポンス ケースには次のようなものがあります。
|
errHelp | このページへのリンク。 |
Seatbid オブジェクト
属性 | サポート対象 | 実装の詳細 | 常に合格 |
---|---|---|---|
入札単価 | はい | ||
シート | はい | ||
グループ |
入札単価オブジェクト
属性 | サポート対象 | 実装の詳細 | 常に合格 |
---|---|---|---|
id | はい | ||
impid | はい | ||
価格 | はい | ||
nurl | |||
バール | |||
lurl | |||
adm | |||
adid | |||
adomain | |||
bundle | |||
iurl | |||
cid | はい | ||
crid | はい | ||
戦術 | |||
猫 | |||
attr | |||
API | |||
プロトコル | |||
qagmediarating | |||
language | |||
dealid | |||
w | |||
h | |||
wratio | |||
hratio | |||
exp |
入札オブジェクトでサポートされているエクステンション
属性 | 実装の詳細 |
---|---|
apis |
OMID と MRAID の両方がサポートされている場合、ディスプレイ&ビデオ 360 は seatbid.bid.apis を送信します。DV360 では、OMID_1 と MRAID の両方が整数配列として設定されます。 |
広告配信オプション
OpenRTB 仕様の 4.3 セクションには、次の 2 つのサービング オプションがあります。
- 落札通知に表示されたマークアップ
- 入札で配信されたマークアップ
ディスプレイ&ビデオ 360 では、両方のオプションがサポートされています。
- バナー広告の場合、ディスプレイ&ビデオ 360 は常に
adm
フィールドにマークアップを返します。落札通知で配信されるマークアップは任意です。 - VAST プロトコルを使用する動画広告またはオーディオ広告の場合、ディスプレイ&ビデオ 360 は、エクスチェンジ パートナーの要件に基づいて、
adm
フィールドまたは落札通知のレスポンスで VAST XML を返すことをサポートしています。
これらの 2 つのオプションのメリットとデメリットについては、OpenRTB 仕様をご覧ください。
ベスト プラクティス
シート ID には、ディスプレイ&ビデオ 360 のパートナー ID を使用することを強くおすすめします。交換に固有の座席 ID の使用はおすすめしません。
パブリッシャー様が ads.txt ファイルまたは app-ads.txt ファイルが関連付けられているアプリを所有し、そのファイルに認定販売者または販売業者として記載されていることを確認します。詳細
また、入札リクエストで一貫した情報が渡されるようにしてください。たとえば、app.bundle
はモバイル デバイス情報と app.storeurl
と一致している必要があります。
コネクテッド テレビ
device.ifa
と device.lmt
を渡す際は、IAB OTT IFA ガイドラインに準拠してください。また、ガイドラインに準拠するために device.ext.ifa_type
を実装する必要があります。コネクテッド テレビのフリークエンシー キャップとオーディエンス ターゲティングの機能はすべて、IFA の存在を必要とします。
また、最近公開された IAB OTT/CTV ストア割り当て ID ガイドラインにも準拠してください。このガイドラインでは、主にアプリストアで定義された ID を使用して、CTV アプリで app.bundle
を渡す方法が定義されています。
アクティブ ビューの測定
アクティブ ビューは、インプレッションが視認可能だったかどうかと、視認可能だった時間を測定するために使用される Google の技術です。アクティブ ビューでは、ディスプレイ広告と動画広告の両方で OMID が使用されます。OMID を使用した測定を有効にするには、エクスチェンジが OpenRTB リクエストに次のフィールドを追加して、DV360 がクライアントが OMID をサポートしていることを認識できるようにする必要があります。
- 必須: 入札リクエストに API フレームワーク(
OMSDK
の場合はVideo.api=7
)を追加します。これは、アクティブ ビューで OMID を使用した測定を有効にするために必須です。 - 推奨:
omidpn
とomidpv
をSource.Ext
に追加することを強くおすすめします。これは、ディスプレイ&ビデオ 360 でビューアビリティ測定結果がお客様に報告される方法に影響するためです。OMID パートナー名が IAB 認定リストにない場合は、MRC 認定指標とは別に視認性指標を報告することが MRC によって義務付けられています。詳細
よくある質問
- ディスプレイ&ビデオ 360 はエクスチェンジのカスタム拡張機能をサポートしていますか?
- はい。ディスプレイ&ビデオ 360 では、この仕様で説明されている拡張機能に加えて、ケースバイケースでカスタム拡張機能もサポートされる場合があります。統合期間中にカスタム拡張機能を指定してテストすることをおすすめします。
- ディスプレイ&ビデオ 360 はリワード動画に対応していますか?
- はい。動画リワード拡張機能を送信してください。
- 多くの広告枠がユーザー属性不明として表示されています。ユーザー属性の対象範囲を拡大するにはどうすればよいですか?
- ディスプレイ&ビデオ 360 への入札リクエストに
user.yob
とuser.gender
を入力して、カバレッジを拡大します。 - ディスプレイ&ビデオ 360 には、各地域のエンドポイントはありますか?
- いいえ。Google はグローバルに 1 つのエンドポイントを使用し、リクエストを最も近いデータセンターに自動的に転送するため、リージョン固有のエンドポイントはありません。
- サーバー間(s2s)リクエストの要件は何ですか?
- 許可リストへの追加をリクエストするには、お問い合わせください。クライアントのユーザー エージェントを転送し、s2s VAST フェッチのレスポンスで Cookie が無効化または無視されるようにする必要があります。
- ディスプレイ&ビデオ 360 は OMID をサポートしていますか?
- 入札リクエスト時に OMID が有効であると宣言されている限り、Google は OMID を使用して視認性を測定できます。詳しくは、24 ~ 25 ページをご覧ください。
- サポートされている Native のバージョンネイティブの要件はありますか?
- サポートされているのはネイティブ Ver1.2 のみです。ネイティブ仕様。
- ディスプレイ&ビデオ 360 は、GZIP として送信される入札リクエストをサポートしていますか?
- DV360 は gzip 圧縮された入札リクエストを受信できます。Accept-Encoding ヘッダーがサポートされていることを示している場合は、gzip 圧縮されたレスポンスで応答します。
- ディスプレイ&ビデオ 360 は DBURL をサポートしていますか?
- 現時点ではできません。
- ディスプレイ&ビデオ 360 は勝敗に関する通知をサポートしていますか?
- 現時点では対応しておりません。サポートが役立つと思われる場合は、詳細をお知らせください。
- ディスプレイ&ビデオ 360 でターゲティングに App.name は必要ですか?
- いいえ。ディスプレイ&ビデオ 360 では App.name が参照されますが、ターゲティングには必要ありません。ターゲティングには
App.bundle
が使用されます。 - ディスプレイ&ビデオ 360 では、1 つの入札リクエストで複数の広告サイズを送信できますか?
- はい。banner.format で指定された、対象となるすべてのクリエイティブ サイズが考慮されます。
- ディスプレイ&ビデオ 360 は、同じ入札リクエストで複数のフォーマットをサポートしていますか?
- 現在、マルチフォーマット入札リクエストのサポートは限定的ですが、改善に取り組んでいます。インタースティシャルではディスプレイと動画のフォーマットがサポートされていますが、現在のところディスプレイとネイティブはサポートされていません。複数フォーマットの入札リクエストを送信している場合は、テストをリクエストしてください。
- ディスプレイ&ビデオ 360 では、同じリクエストでインプレッション タイプを混在させることはできますか?
- 現在サポートしているのは、動画/バナー インタースティシャルのみです。現在、ネイティブ/バナーと動画/バナーに対応しています。その他の組み合わせがある場合は、Google のチームにお問い合わせください。
- 複数のシートが、同じリクエストで 1 つ以上のインプレッション チャンスに対して複数の入札を送信できますか?
- はい。
- ディスプレイ&ビデオ 360 には、同じリクエストで複数のそのようなインプレッション チャンスに対して同じ広告主を制限または表示するソリューションや特別なニーズはありますか?
- ディスプレイ&ビデオ 360 では、1 つのリクエストに対して 1 つの広告主が入札できるインプレッション チャンスは 1 つまでという制限が設けられています。SSP は、インプレッション オブジェクトを意味のあるグループにまとめることが求められます(同じページ上にあるもの、同じアプリ内にあるものなど)。
- ディスプレイ&ビデオ 360 では、1 つの入札リクエストで複数のインプレッションを指定できますか?
- 現在、ディスプレイ&ビデオ 360 では複数のインプレッション オーディオ オブジェクトがサポートされています。ただし、この機能を利用するエクスチェンジはそれぞれテスト/有効にする必要があります。詳しくは、入札リクエストの仕様をご覧ください。今後、他のフォーマットにも拡大していく予定です。
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
お問い合わせ
ご不明な点や問題がございましたら、交換サポートチームにお問い合わせください。