このページを参照する際は、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 のサポートはベータ版です。ご興味のある方は、ディスプレイ&ビデオ 360 にお問い合わせください。
JSON リクエストとレスポンスは、IAB の OpenRTB 2.6 Protobuf 仕様に準拠しています。
拡張機能のサポートは限定的です。ご興味をお持ちの場合は、Display & Video 360 にお問い合わせください。
Protobuf 入札リクエストを示すヘッダー Content-Type
: application/x-protobuf
を送信し、Protobuf 入札レスポンスを受信するように Accept
: application/x-protobuf
を設定します。
入札リクエスト オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 必須。 入札リクエストの一意の ID。これは、リクエストが処理された後、ごく短期間に個々のリクエストを識別するために使用できます。 |
imp |
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 |
サプライ チェーン |
新しい統合では、代わりに Source の BidRequest.source.schain フィールドを使用する必要があります。 |
purch |
Integer |
購入したトラフィック パラメータは、所有プロパティ、獲得プロパティ、または報酬提供型のアクティビティ以外からリダイレクトされたトラフィックです。 これは、新しい MRC IVT 2.0 仕様に準拠しています。
購入者向けのレポートでは、これは「パブリッシャーのトラフィック ソース」と呼ばれ、次のいずれかの値になります。 |
gdemsignals |
文字列 | GMA SDK からの SCAR API シグナル BLOB。 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 認定リストに記載されていない場合、MRC の要件に従い、視認性指標を MRC 認定指標とは別にレポートする必要があります。詳細
フィールド | タイプ | 詳細 |
---|---|---|
omidpn |
文字列 | OM SDK 統合の識別子。これは、OMID パートナー オブジェクトの「name」パラメータと同じです。 |
omidpv |
文字列 | OM SDK 統合のバージョン。これは、OMID パートナー オブジェクトの「versionString」パラメータと同じです。 |
schain |
サプライ チェーン |
新しい統合では、代わりに Source の schain フィールドを使用する必要があります。 |
Regs オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
coppa |
Integer | 0 (デフォルト): このリクエストには COPPA は適用されません。1 : このリクエストは COPPA の対象です。 |
ext |
Regs 拡張機能 | 省略可。 |
Regs 拡張機能オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
gdpr |
Integer | 入札リクエストが EEA 地域からのものかどうかを示します。0 (デフォルト): EEA 以外の地域。1 : EEA 地域。詳しくは、GDPR の同意済みプロバイダ ソリューションをご覧ください。 |
us_privacy |
文字列 | IAB Tech Lab が提供する技術仕様に沿って、us_privacy 文字列を実装してください。
入札リクエストで |
Imp オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 入札リクエストのコンテキスト内でのこのインプレッションの一意の識別子(通常、値は 1 から始まり、n 個のインプレッションに対して n まで増えます)。 |
metric |
オブジェクト | サポート対象外。 |
banner |
バナー | バナー広告の機会に必要です。 |
video |
動画 | 動画広告の広告配信予想数に必要です。 |
audio |
音声 | オーディオ広告の広告枠で必須です。 |
native |
ネイティブ | ネイティブ広告の機会に必要です。 |
pmp |
Pmp | このインプレッションに有効なプライベート マーケットプレイス取引。 |
displaymanager |
文字列 | 広告(通常は動画またはモバイル)のレンダリングを担当する広告メディエーション パートナー、SDK テクノロジー、またはプレーヤーの名前。一部の広告サーバーで、パートナーごとに広告コードをカスタマイズするために使用されます。動画やアプリにおすすめします。 |
displaymanagerver |
文字列 | 広告のレンダリングを担当する広告メディエーション パートナー、SDK テクノロジー、またはプレーヤー(通常は動画またはモバイル)のバージョン。一部の広告サーバーで、パートナーごとに広告コードをカスタマイズするために使用されます。動画やアプリにおすすめします。 |
instl |
Integer |
0 (デフォルト): インタースティシャルではありません。1 : 広告がインタースティシャルまたは全画面表示の場合。
|
tagid |
文字列 | オークションの開始に使用された特定の広告プレースメントまたは広告タグの識別子。これは、問題のデバッグや購入者による最適化に役立ちます。 |
bidfloor |
浮動小数点数 | このインプレッションの最小入札単価(CPM)。 |
bidfloorcur |
文字列 |
ISO-4217 アルファベット コードを使用して指定された通貨。 |
clickbrowser |
Integer |
アプリでクリエイティブをクリックしたときに開くブラウザの種類を示します。 iOS 9.x デバイスの Safari View Controller は、このフィールドの目的ではネイティブ ブラウザと見なされます。 |
secure |
Integer |
このインプレッションに安全な HTTPS URL が必要か、安全でない HTTP URL が必要か。0 (デフォルト): insecure1 : secure
|
iframebuster |
文字列配列 | |
exp |
Integer | 入札の有効期限は、このフィールドでパートナーから送信された値に関係なく、ディスプレイ&ビデオ 360 によって設定されます。インプレッションの鮮度ウィンドウ(通常は 1 時間)の後に受信したインプレッション イベントは、古いものとして破棄され、DV360 では請求対象と見なされません。 |
rwdd |
Integer |
ユーザーが広告を見る代わりにリワードを受け取るかどうかを示します。0 (デフォルト): リワードなし1 : リワードあり
通常、動画広告の実装では、ユーザーは追加のニュース記事を無料で読んだり、ゲームで追加ライフを受け取ったり、スポンサー付きの広告なしの音楽セッションを利用したりできます。通常、動画広告が完了すると報酬が付与されます。 |
Imp 拡張オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
bcrid |
文字列 | ブロックするクリエイティブ ID のリスト。 |
バナー オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
format |
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 | デバイスに依存しないピクセル(DIP)単位の高さ。 |
wratio |
Integer | サポート対象外。 |
hratio |
Integer | サポート対象外。 |
wmin |
Integer | サポート対象外。 |
動画オブジェクト
入札リクエストで動画プレースメントを指定することを強くおすすめします。プレースメント フィールドがない場合は、不明なプレースメントとして分類されます。詳しくは、プレースメント ターゲティングに関する記事をご覧ください。
フィールド | タイプ | 詳細 |
---|---|---|
mimes |
文字列配列 |
少なくとも 1 つの MIME タイプが必要です。
|
minduration |
Integer | 動画の最小再生時間(秒単位)。デフォルトでは最小値はありません。 |
maxduration |
Integer | 動画の最大再生時間(秒)。デフォルトでは最大値はありません。 |
protocols |
整数配列 |
サポートされているプロトコルが少なくとも 1 つ必要です。
|
w |
Integer | 動画プレーヤーの幅(デバイス非依存ピクセル(DIPS)単位)。 |
h |
Integer | 動画プレーヤーの高さ(デバイスに依存しないピクセル(DIP)単位)。 |
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 |
Banner 配列 | コンパニオン広告(利用可能な場合)。 |
api |
整数配列 |
|
companiontype |
整数配列 | サポート対象外。 |
maxseq |
Integer | 動的動画連続配信広告で返される広告の最大数。 |
poddur |
整数配列 | 動的動画ポッドの最大長(秒単位)。 |
動画オブジェクトでサポートされている拡張機能
フィールド | タイプ | 詳細 |
---|---|---|
rewarded |
Integer | このフィールドは、リクエストがリワード対象かどうかを示すものです。これは整数として送信する必要があります。
|
オーディオ オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
mimes |
文字列配列 |
少なくとも 1 つの MIME タイプが必要です。
|
minduration |
Integer | 広告の最小再生時間(秒単位)。 |
maxduration |
Integer | 広告の最大再生時間(秒)。 |
protocols |
整数配列 |
|
startdelay |
Integer | プレロール、ミッドロール、ポストロールの広告プレースメントの開始遅延(秒単位)。
|
sequence |
Integer | サポート対象外。 |
battr |
整数配列 | サポート対象外。 |
maxextended |
Integer | サポート対象外。 |
minbitrate |
Integer | 最小ビットレート(Kbps)。 |
maxbitrate |
Integer | 最大ビットレート(Kbps)。 |
delivery |
整数配列 | サポート対象外。 |
companionad |
Banner オブジェクトの配列 | バナー コンパニオン クリエイティブ スロット。 |
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 |
Deal オブジェクトの配列 | 含める取引。 |
Deal オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | PMP オブジェクトには、ID ごとに複数の取引オブジェクトを含めることはできません。 |
bidfloor |
Double |
このインプレッションの最小入札単価(CPM)。
|
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 |
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 |
Publisher オブジェクト | アプリのパブリッシャーに関する情報。 |
content |
コンテンツ オブジェクト | アプリのコンテンツに関する情報。 |
keywords |
文字列(CSV 形式) | サポート対象外。 |
ext |
アプリリンク表示オプション | アプリ オブジェクトの拡張機能。 |
アプリリンク表示オプション オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
inventorypartnerdomain |
文字列 | CTV 広告枠の共有に使用されます。IAB CTV アプリ追加の説明をご覧ください。 |
コンテンツ オブジェクト
これらの属性は、利用可能な場合は渡すことをおすすめします。
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | コンテンツを一意に識別する ID。 |
episode |
Integer | コンテンツのエピソード番号(通常は動画コンテンツ用)。 |
title |
文字列 | コネクテッド テレビ、動画、オーディオのリクエストにおすすめします。 |
series |
文字列 | コネクテッド テレビ、動画、オーディオのリクエストにおすすめします。 |
season |
文字列 | コンテンツのシーズンのラベル。 |
artist |
文字列 | コンテンツのクレジットに記載されているアーティスト。 |
genre |
文字列 | コンテンツを最もよく表すジャンル。ディスプレイ&ビデオ 360 では、CTV、動画、オーディオのリクエストでこのシグナルを提供することをおすすめします。 ディスプレイ&ビデオ 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 |
コンテンツの長さ(秒単位)。 CTV/動画と音声のリクエストに推奨されます。 |
language |
文字列(ISO-639-1-alpha-2) | コンテンツの言語。 |
embeddable |
Integer |
コンテンツが埋め込み可能かどうかを示すインジケーター(埋め込み可能な動画プレーヤーなど)
|
data |
データ オブジェクトの配列 | 追加データ。 |
プロデューサー オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | サポート対象外。 |
name |
文字列 | サポート対象外。 |
cat |
文字列配列 | サポート対象外。 |
domain |
文字列 | プロデューサーの最上位レベルのドメイン。 |
データ オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | データ プロバイダの ID。 |
name |
文字列 | データ プロバイダの取引所名。 |
segment |
セグメント オブジェクトの配列 | 実際のデータ値。 |
ext |
データ拡張機能 | Data オブジェクトの拡張機能。 |
データ オブジェクトでサポートされている拡張機能
フィールド | タイプ | 詳細 |
---|---|---|
segtax |
Integer | 分類 ID。詳しくは、セグメント分類をご覧ください。 |
segclass |
文字列 | 分類方法内のセグメント ID を生成した分類子のバージョン。 |
セグメント オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | データ プロバイダに固有のデータ セグメントの ID。 |
name |
文字列 | データ セグメントの名前。 |
value |
文字列 | データ セグメントの値。 |
Publisher オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | 必須。 |
name |
文字列 | サポート対象外。 |
cat |
文字列配列 | サポート対象外。 |
domain |
文字列 | サポート対象外。 |
デバイス オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
ua |
文字列 | 必須。 |
sua |
UserAgent オブジェクト | 構造化されたユーザー エージェント情報。 |
geo |
Geo オブジェクト | デバイスの場所。 |
dnt |
Integer |
ブラウザのヘッダーで設定されたトラッキング拒否フラグ。
|
lmt |
Integer |
広告トラッキング制限シグナルが商業的に承認されているかどうか。
|
ip |
文字列 |
IPv4 の場合は必須です。
IP アドレスが切り捨てられている場合は、 |
ipv6 |
文字列 |
IPv6 の場合は必須です。
IP アドレスが切り捨てられている場合は、 |
devicetype |
Integer | すべての広告枠タイプで強く推奨されます。デバイスタイプの認識を強化するために使用されます。 |
make |
文字列 | |
model |
String | |
os |
文字列 |
デバイスのオペレーティング システム。
このフィールドでは大文字と小文字が区別されません。 |
osv |
文字列 | サポート対象外。 |
hwv |
文字列 | デバイスのハードウェア バージョン。 |
h |
Integer | 画面の物理的な高さ(ピクセル単位)。 |
w |
Integer | 画面の物理的な幅(ピクセル単位)。 |
ppi |
Integer | サポート対象外。 |
pxratio |
Double | 物理ピクセルとデバイス非依存ピクセルの比率。 |
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 Community Specification をご覧ください。 |
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 |
Double | サポート対象外。 |
lon |
Double | サポート対象外。 |
type |
Integer | サポート対象外。 |
accuracy |
Integer | サポート対象外。 |
lastfix |
Integer | サポート対象外。 |
ipservice |
Integer | サポート対象外。 |
country |
文字列 | サポート対象外。 |
region |
文字列 | サポート対象外。 |
regionfips104 |
文字列 | サポート対象外。 |
metro |
文字列 | サポート対象外。 |
city |
文字列 | サポート対象外。 |
zip |
文字列 | サポート対象外。 |
utcoffset |
Integer | サポート対象外。 |
User オブジェクト
フィールド | タイプ | 詳細 |
---|---|---|
id |
文字列 | Google が ID マッチテーブルをホストしている場合にサポートされます。 |
buyeruid |
文字列 | SSP が ID マッチテーブルをホストしている場合はサポートされます。 |
yob |
Integer | 年齢や性別によるターゲティングにおすすめします。 |
gender |
文字列 | 年齢や性別によるターゲティングにおすすめします。 |
keywords |
文字列(CSV) | サポート対象外。 |
customdata |
文字列 | サポート対象外。 |
geo |
Geo オブジェクト | サポート対象外。 |
data |
データ オブジェクトの配列 | 追加データ。 |
eids |
拡張 ID オブジェクトの配列 | エクスチェンジによって提供される拡張 ID インスタンス。 |
ext |
ユーザー拡張機能 | ユーザー オブジェクトの拡張機能。 |
ユーザー オブジェクトでサポートされている拡張機能
フィールド | タイプ | 詳細 |
---|---|---|
consent |
文字列(ウェブセーフ Base64) |
IAB 同意文字列。 ユーザーが収集に同意した情報と、その情報の使用を許可されたベンダーに関するメタデータが含まれます。 この値は、カスタム バイナリ形式を使用した、ウェブセーフな base64 エンコード バイナリ文字列です。 |
us_privacy |
文字列 | お客様が CCPA などの法律の遵守について確認している場合。 |
consented_providers_settings .consented_providers |
内部の整数配列(consented_providers)をラップする外部オブジェクト(consented_providers_settings)。 | TCF を介して GDPR の同意が収集された場合、このフィールドには、TCF に参加していないユーザーが同意した広告技術プロバイダが一覧表示されます。Google の追加同意の技術仕様をご覧ください。 |
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 |
これは、入札リクエストで問題が見つかった場合にのみ含まれます。有効な値は次のとおりです。2 : 無効なリクエスト12 : Ads.txt の承認違反16 : 不完全な SupplyChain17 : ブロックされた SupplyChain ノード注: (アプリ)ads.txt または SupplyChain の特定の違反が検出された場合、レスポンスの一部(1%)にコード 12、16、または 17 のいずれかが入力されます。他のすべての無効なリクエストにはコード 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 仕様を参照してください。
ベスト プラクティス
ディスプレイ&ビデオ 360 のパートナー ID をシート ID として使用することを強くおすすめします。取引所固有のシート ID の使用はおすすめしません。
パブリッシャーが ads.txt ファイルを所有しているか、app-ads.txt ファイルが関連付けられたアプリを所有しており、そのファイルで貴社が認定販売者または再販業者としてリストされていることを確認します。詳細
また、入札リクエストで一貫した情報が渡されるようにします。たとえば、app.bundle
はモバイル デバイスの情報と app.storeurl
と一致している必要があります。
コネクテッド テレビ
device.ifa
と device.lmt
を渡す際は、IAB OTT IFA のガイドラインに準拠してください。ガイドラインに準拠するため、device.ext.ifa_type
も実装する必要があります。CTV のフリークエンシー キャップとオーディエンス ターゲティングのすべての機能で IFA が必要になります。
また、最近公開された IAB OTT/CTV ストア割り当て ID に関するガイドラインにも準拠してください。このガイドラインでは、CTV アプリで app.bundle
を渡す方法を定義しています。主にアプリストアで定義された ID を使用します。
アクティブ ビューの測定
アクティブ ビューは、インプレッションが視認可能だったかどうかと、視認可能だった時間を測定するために使用される 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 はグローバルに単一のエンドポイントを使用し、リクエストを最も近いデータセンターに自動的にルーティングするため、提供できるリージョン固有のエンドポイントはありません。
- サーバー間(s2s)リクエストの要件は何ですか?
- お問い合わせのうえ、許可リストへの追加をご依頼ください。クライアントのユーザー エージェントを転送し、s2s VAST フェッチに対するレスポンスで Cookie が無効化または無視されるようにする必要があります。
- ディスプレイ&ビデオ 360 は OMID をサポートしていますか?
- 入札リクエスト時に OMID 対応として宣言されていれば、OMID を使用して視認性を測定できます。詳細については、24 ~ 25 ページをご覧ください。
- どのバージョンのネイティブ広告をサポートしていますか?ネイティブの要件はありますか?
- サポートされているのはネイティブ 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 は、同じリクエストで複数のインプレッション タイプをサポートしていますか?
- 現在、サポートされているのは動画/バナーのインタースティシャルのみです。ネイティブ/バナー、動画/バナーに取り組んでいます。その他の組み合わせについては、お問い合わせください。
- 複数のシートが、同じリクエストで、このようなインプレッション機会の 1 つまたは複数に対して複数の入札を送信できますか?
- はい。
- ディスプレイ&ビデオ 360 には、同じリクエストで同じ広告主のインプレッション機会が複数ある場合に、その広告主の広告のフリークエンシー キャップを設定したり、表示したりするためのソリューションや特別なニーズがありますか?
- ディスプレイ&ビデオ 360 では、1 つの広告主が 1 回のリクエストで入札できるインプレッション機会は 1 回のみという制限が適用されます。SSP は、インプレッション オブジェクトを意味のあるグループにまとめることが想定されます(同じページ、同じアプリなど)。
- ディスプレイ&ビデオ 360 は、同じ入札リクエストで複数のインプレッションをサポートしていますか?
- ディスプレイ&ビデオ 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" }
お問い合わせ
ご不明な点や問題がある場合は、お問い合わせください。