Open RTB 2.5 入札リクエスト

このページでは、入札を行うために受け取る RTB リクエストのさまざまな構成要素について説明します。

入札リクエストヘッダー

• OpenRTBバージョンのHTTPヘッダー: x-openrtb-version: 2.5
• Keep-Alive HTTPヘッダー: Connection: Keep-Alive
• コンテンツ JSON: Content-Type: application/json
• データエンコーディングヘッダー: Accept-Encoding

入札リクエスト 2.5

特定のコンテキストで入札を要求する場合、プラットフォームはタイムアウト 300ms で HTTP リクエストを実行し、次のオブジェクトを JSON としてエンコードしてリクエスト本文に送信します。 HTTP HTTPS を使用すると追加の遅延が発生するため推奨されます。

属性	説明
id	一意の入札リクエストID（string）
site	配信者のWebサイトに関する Site オブジェクトを通じた詳細（オブジェクト）
device	インプレッションが配信されるユーザーのデバイスの詳細（オブジェクト）
user	デバイスを利用する人間のユーザー、つまり広告の対象となるオーディエンスの詳細（オブジェクト）
imp	オークションにかけられる広告枠またはインプレッションの詳細（オブジェクト）
regs	このリクエストに適用される業界・法令・政府規制の詳細（オブジェクト）
ext	OpenRTB 拡張用のプレースホルダー（オブジェクト）

site

属性	説明
id	一意の Site ID（string）
domain	サイトのドメイン名（string）
cat	IAB カテゴリ ID（文字列配列）
page	広告が表示されるページの完全な URL（string）
keywords	キーワードを使用すると、広告ゾーンに適切な種類の広告を表示させることができます。キーワードはカンマ区切りの単語列である必要があります
ext	取引所固有の拡張のためのプレースホルダー（object）

site.ext

属性	説明
exchangecat	カスタム ExoClick カテゴリ ID（integer）
idzone	カスタム ExoClick 広告ゾーン ID（integer）
keyword	一致するキーワードがある場合（string）

device

属性	説明
ua	ブラウザーのユーザーエージェント（string）
sua	構造化されたユーザーエージェント情報。クライアントが User-Agent Client Hints をサポートしている場合に使用できます（object）
geo	Geo オブジェクトで定義される、ユーザーの現在位置と見なされるデバイスの所在地
ip	ユーザーのIPv4アドレス（文字列）*
ipv6	ユーザーの IPv6 アドレス（string）*
language	ブラウザの言語（文字列）
os	オペレーティングシステム（string）
js	JavaScript のサポート。0 = いいえ、1 = はい（integer）
ext	OpenRTBへの交換事業者固有の拡張のためのプレースホルダー（オブジェクト）

*入札リクエストには ip または ipv6 のどちらか一方のみが含まれます。

device.geo

属性	説明
country	国の ISO3 コード
ipservice	必要に応じて IP アドレスからジオロケーションを特定するために使用するサービスまたはプロバイダー（整数）

device.ext

属性	説明
remote_addr	ユーザーのメイン IP アドレス（string）
x_forwarded_for	ユーザーの X-FORWARDED-FOR IP アドレス。未設定の場合は空（string）

device.sua

構造化された User Agent 情報。 device.sua デバイス属性をより正確に表すものと見なされます。

属性	説明
browsers	Sec-CH-UA-Full-Version-List ヘッダーから取得したブランドとバージョンを送信します。（ BrandVersion オブジェクトの配列）
platform	Sec-CH-UA-Platform ヘッダーから取得したブランドと、Sec-CH-UA-Platform-Version ヘッダーから取得したバージョンを送信します。(BrandVersion オブジェクト）
mobile	この値は Sec-CH-UA-Mobile ヘッダーから取得します。（integer）
architecture	この値は Sec-CH-UA-Arch ヘッダーから取得します。（string）
bitness	この値は Sec-CH-UA-Bitness ヘッダーから取得します。（string）
model	この値は Sec-CH-UA-Model ヘッダーから取得します。（string）
source	このオブジェクトの作成に使用されたデータのソース、 一覧: User-Agent ソース AdCOM 1.0 の中で（integer; デフォルト 0）

device.sua.browsers | device.sua.platform

属性	説明
brand	この値は User-Agent Client Hints ヘッダーから取得される場合があり、ユーザーエージェントのブランド（Sec-CH-UA-Full-Version ヘッダー由来）またはプラットフォームのブランド（Sec-CH-UA-Platform ヘッダー由来）のいずれかを表します。（string）
version	バージョン要素の並び。階層の降順 [major, minor, micro, …]（文字列配列）

user

属性	説明
id	一意のユーザー ID（string）

user.ext

属性	説明
consent	これはIAB標準で要求される同意文字列です。現時点ではネガティブ同意のみ（文字列）

regs

属性	説明
ext	OpenRTB の取引所固有拡張用プレースホルダー。

regs.ext

属性	説明
gdpr	これは、呼び出し元がユーザーがGDPR対象ではないと判断した場合は0、ユーザーがGDPR対象である場合は1です。どちらでもない場合、このパラメータは未定義になります。

imp

属性	説明
id	入札リクエストの文脈におけるこのインプレッションの一意の識別子（文字列）
instl	1 = 広告はインタースティシャルまたはフルスクリーン、0 = インタースティシャルではない（整数）
video	インストリーム動画インプレッションを表す Video オブジェクトを通じた詳細
secure	インプレッションに安全な HTTPS URL が必要かどうかを示すフラグ（整数）
ext	OpenRTBへの交換事業者固有の拡張のためのプレースホルダー（オブジェクト）

imp.video

属性	説明
mimes	サポートされるコンテンツの MIME タイプ（例: "video/mp4"）（文字列配列）
minduration	最小動画広告再生時間（秒）（整数）
maxduration	最大動画広告再生時間（秒）（整数）
protocols	サポートされる動画プロトコルの配列（整数）
linearity	インプレッションがリニア、ノンリニアなどである必要があるかを示します。指定がない場合は、すべて許可されているものと見なします（整数）
boxingallowed	4:3コンテンツを16:9ウィンドウにレターボックス表示することが許可されるかを示します。0 = いいえ、1 = はい（整数）
pos	画面上の広告位置（整数）
h	デバイス非依存ピクセル（DIPS）単位の動画プレーヤーの幅（整数）
w	デバイス非依存ピクセル（DIPS）単位の動画プレーヤーの高さ（整数）
ext	OpenRTBへの交換事業者固有の拡張のためのプレースホルダー（オブジェクト）

imp.video.ext

属性	説明
zone_type	ExoClickの広告フォーマット内のゾーンタイプ（例: video_slider）