Bidders - Bid request
重要
- サポートされていません: AppNexus 入札プロトコルはサポートされなくなりました。このドキュメントは、レガシのみを目的としています。 このプロトコルは、2018 年 12 月 1 日に非推奨になります。
- AppNexus と統合する新しい入札者の場合は、 OpenRTB 2.4 入札プロトコルを参照してください。
広告通話がインプレッション バスに到達するたびに、入札リクエストが入札者に送信されます。 入札者が入札価格とクリエイティブを提供するために必要なすべての情報が含まれています。
入札リクエストには、オークションに勝ち、ページで実行できる広告主とクリエイティブを指定する販売者からの情報が含まれています。 この情報は広告承認プロファイルに保存されます。このプロファイルは、入札者が入札が受け入れられるかどうかを確認するために使用できます。
入札要求の調整
AppNexus プラットフォームを通過するすべての入札要求を受け取りたくない場合があります。 要求をある割合で調整するか、geography などの事前設定された条件で要求をフィルター処理できます。
複数タグの入札リクエスト
1 つの入札リクエストに、サイズ、広告品質基準、予約価格などが異なる複数のタグ ID が含まれる場合があります。現時点では、これらの要求は、タグごとに個別の要求であるかのように個別の応答で処理する必要があります。 ただし、近い将来、これらのマルチタグ要求は、引き継ぎ、ページ全体の購入、およびその他の多くのプレミアム インベントリ機能の基盤になります。
マルチタグリクエストの個々のタグには、一意のオークション ID があります。
実装
要求ヘッダー
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
Connection |
すべて | string | 永続的な TCP 接続を確保するには、常に "キープアライブ" に設定します。 |
Content-Length |
すべて | int | HTTP 要求の本文の長さ (以下で説明するすべてのフィールドを含む)。 |
Host |
すべて | string | 入札要求が送信された IP アドレス。 |
X-Debug |
いくつ か | int | 1 に設定すると、広告呼び出しには debug=1 フラグが含まれ、広告は配信されません。 |
X-DMA |
いくつ か | int | IP アドレスに基づいてユーザーの指定された市場領域のコードを決定できる場合。 |
X-Exclusive |
いくつ か | int | オークションが既定で排他的かどうかを示します。 限定オークションは、プレースメント所有者のみが広告を配信できるオークションです。 排他的な既定値は、オークションの所有者フェーズ中に所有者によってオーバーライドされる場合があります。 |
X-Segment |
いくつ か | string | ユーザーが存在するセグメントのコンマ区切りのリスト。 利用できるセグメントには、メンバーが所有しているものと、サード パーティのデータ プロバイダー (AppNexus が入札者のアクセス権を付与したユーザー) が所有しているものが含まれます。 |
X-Venue |
すべて | int | このヘッダーは現在使用されていません。 |
オークション情報
一般的なデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
member_ad_profile_id |
いくつ か | int | インプレッションに適用されるメンバーレベルの広告承認プロファイル ID。 |
timestamp |
すべて | timestamp | 要求が送信された時刻。 |
bidder_timeout_ms |
すべて | int | Imp Bus から要求が送信されてから、タイムアウト前に Imp Bus によって応答が受信されるまでの、入札者が持つミリ秒数。 この番号は、供給パートナーによって異なります。 |
bid_info |
すべて | object | ユーザーと入札要求に関する一般的な詳細。 詳細については 、以下のBid_Info を参照してください。 |
members |
すべて | オブジェクトの配列 | この呼び出しで入札できるメンバーの配列。 メンバーは、AppNexus との財務売買関係を持ち、入札者に関連付けられているエンティティです。 一部の入札者には複数のメンバーが含まれる場合があります。あなた自身の排他的な使用のための入札者を構築している場合は、唯一のメンバーになります。 メンバー オブジェクトには、メンバーの ID があります。 詳細については、以下の 「メンバー 」を参照してください。 注: これは数値の配列ではなく、オブジェクトの配列です。 次の例では、正確な構文を 示 します。 |
tags |
すべて | オブジェクトの配列 | この呼び出しでオークションにかけているタグの配列。 オークションには少なくとも 1 つが含まれますが、複数のタグが含まれる場合があります。 詳細については、以下の タグ を参照してください。 |
所有者固有のデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
allow_exclusive |
いくつ か | ブール型 | 入札メンバーが広告枠 (タグのmember_id = 入札者のメンバー ID) を所有している場合、メンバーは他の入札者に参加を許可することなく、その広告枠にサービスを提供できます。 |
データのデバッグ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
debug_requested |
いくつ か | ブール型 | true の場合、広告呼び出しにはフラグがdebug=1含まれ、広告は配信されません。 これは、正しいドングルが使用されている場合にのみ入札要求に含まれます。 |
debug_member_id |
いくつ か | int | このフィールドには、パラメーターが querystring に渡され、querystring で渡された "dongle" パラメーターがメンバーのドングル ( メンバー サービスに設定) と一致する場合、"debug_member" パラメーターの値が含まれます。 入札者は、debug_member_idを使用して、特定のメンバーに限定されたデバッグ出力を生成できます。 |
test |
いくつ か | ブール型 | true の場合、広告タグはテストとして実行されており、広告は配信されません。 存在しない場合、test は false です。 |
その他のデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
excluded_adservers |
いくつ か | 整数の配列 | 販売者の広告品質設定で定義されているように、インプレッションの対象にならない広告サーバーの ID。 広告サーバー サービスを使用して、広告サーバーを検索できます。 |
excluded_brands |
いくつ か | 整数の配列 | 販売者の広告品質設定で定義されているように、インプレッションの対象にならないブランドの ID。 ブランド サービスを使用してブランドを検索できます。 |
excluded_languages |
いくつ か | 整数の配列 | 販売者の広告品質設定で定義されているように、インプレッションの対象にならない言語の ID。 言語サービスを使用して言語を検索できます。 |
excluded_categories |
いくつ か | 整数の配列 | 販売者の広告品質設定で定義されているように、インプレッションの対象にならないカテゴリの ID。 カテゴリ サービスを使用して、カテゴリを検索できます。 |
excluded_creatives |
いくつ か | 整数の配列 | 販売者の広告品質設定で定義されているように、インプレッションの対象にならないクリエイティブの ID。 クリエイティブ サービスを使用して、クリエイティブを検索できます。 |
excluded_technical_attributes |
いくつ か | 整数の配列 | 販売者の広告品質設定で定義されているように、インプレッションの対象にならない技術属性の ID。 技術属性サービスを使用して、技術属性を検索できます。 |
single_phase |
いくつ か | ブール型 | このフィールドは現在、入札者には使用されていません。 |
メンバー
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
id |
すべて | int | メンバーの ID。 |
タグ
広告タグに関連付けられている情報。
オークション データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
auction_id_64 |
すべて | int | オークションの ID。 これは調整と不一致に役立ちます。そのため、ログに追加することをお勧めします。 これは一意であるとは限りません。 |
インベントリ階層データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
id |
いくつ か | int | TinyTag の ID。 タグは、サイト内のインベントリのサブセットです。 入札者は、ID が対応するタグを検索できませんが、これらの ID は匿名で最適化可能なインベントリ チャンクとして使用できます。 |
site_id |
いくつ か | int | サイトの ID。 サイトは、AppNexus を通じてインベントリを販売するメンバーのインベントリの 2 番目に大きいグループです。 サイトは、パブリッシャーのインベントリのサブセットです。 入札者は ID が対応するサイトを参照できませんが、これらの ID は匿名で最適化可能なインベントリ チャンクとして使用できます。 |
一般的なデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
size |
すべて | string | このインプレッションのサイズ (widthxheight、300x160 など)。 |
sizes |
すべて | 文字列の配列 | "widthxheight" 形式で指定された、このインプレッションで許容されるクリエイティブ サイズ。 |
position |
すべて | enum("below","above","unknown") | 折り目の上または下のページ上の広告の位置。タグから取得されます (使用可能な場合)。 |
tag_format |
いくつ か | enum("iframe", "js", "wp7", "vast", "json", "xml") | "iframe" タグの場合、インプレッション バスから HTML が返され、パブリッシャーのページに受賞したクリエイティブが表示されます (必要に応じて、HTML には IFrame タグが含まれます)。"js" タグの場合、インプレッション バスは発行元のページで実行される javascript を返します。 (返される javascript には、通常、クリエイティブを表示するための HTML を生成する document.write コマンドが含まれます)。この区別は、クリエイティブが 1 つ以上のタグ形式で正しく表示されない場合にのみ、入札者に関連します。 |
allowed_media_types |
いくつ か | 整数の配列 | 有効なメディアの種類。 ID の一覧には 、Media Type Service を使用します。 |
allowed_media_subtypes |
いくつ か | 整数の配列 | 有効なメディア サブタイプ ID。 ID の一覧には 、メディア サブタイプ サービス を使用します。 |
media_subtypes |
いくつ か | 文字列の配列 | クリエイティブの有効なメディア サブタイプ (文字列形式)。 |
inventory_audits |
いくつ か | 配列 | サイトのコンテンツに関する販売者の自己分類データ。 |
venue_id |
いくつ か | int | このフィールドは現在、入札者には使用されていません。 |
ad_profile_id |
いくつ か | int | 特定のタグのインプレッションに適用されるタグレベルの広告承認プロファイル ID。 |
predicted_view_rate |
すべて | double | 履歴データに基づいて、ユーザーがインプレッションを表示できる確率。 |
価格データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
reserve_price |
いくつ か | 浮動小数点数 | 提供された場合、これはオークションに勝つために必要な最小入札です。 入札メンバーが在庫を所有している場合 (allow_exclusive = true)、これは無視されます。 |
estimated_clear_price |
いくつ か | double | ECP は、在庫を獲得するために必要な見積価格です。 ECP は、AppNexus を通じて送信されたこのタグのすべての落札額の 95% を超えています。 注: タグの落札額のかなりの割合は、AppNexus を通じて送信することはできません。 詳細については、「 値下げメカニズム 」を参照してください。 |
estimated_average_price |
いくつ か | double | EAP は ECP に似ていますが、EAP が AppNexus 経由で送信されたこのタグのすべての落札額の 70% を超えています。 |
estimated_price_verified |
いくつ か | ブール型 | このフィールドは、EAP と ECP が AppNexus によって観察されたデータによって検証されているかどうかを示します。 |
所有者固有のデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
tag_data |
所有のみ | string | 使用可能な場合は、この TinyTag ID に関連付けられている他の情報。 TinyTag の所有者は、オークションの前に TinyTag にこの情報を追加できます。 |
exclusive_default |
所有のみ | ブール型 | オークションが既定で排他的かどうかを示します。 限定オークションは、プレースメント所有者のみが広告を配信できるオークションです。 排他的な既定値は、オークションの所有者フェーズ中に所有者によってオーバーライドされる場合があります。 |
default_creative_id |
所有のみ | int | この TinyTag の既定のクリエイティブ ID。 |
モバイル固有のフィールド
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
supply_type |
いくつ か | "mobile_app" に対して常に送信されます ("web" には送信されません) | このインベントリが Web、モバイル ブラウザー、モバイル アプリのいずれであるかを区別します。 モバイル デバイスで Web インプレッションが表示されているかどうかを判断するには、入札要求でオペレーティング システムを使用します。 |
creative_formats |
いくつ か | 1 つ以上の "text"、"image"、"html-url"、"js-url"、"flash"、"js-raw"、"html-raw"、"html-iframe"、"url-vast"、"xml-url"、"file-url"、unknown" | インプレッションの入札に使用できる AppNexus クリエイティブ形式の一覧。 その他の形式は、サポートされるにつれてこの一覧に追加される場合があります。 |
creative_actions |
いくつ か | 1 つ以上の "Click-to-web"、"Click-to-call" | このインプレッションの入札に使用できるクリエイティブの許容クリック アクションの一覧。 現在、クリックツーコールは利用できませんが、近日中に利用できるようになります。 サポートされると、他のアクションがこの一覧に追加される場合があります。 |
smaller_sizes_allowed |
いくつ か | ブール型 | True の場合、サイズが小さいクリエイティブとテキスト クリエイティブを使用してインプレッションの入札を行うこともできます。 |
取引データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
deals |
いくつ か | オブジェクトの配列 | インプレッションに適用される取引の配列。 詳細については 、「Deals 」を参照してください。 |
取引
配列内の deals 各オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 |
|---|---|---|
ad_quality_override |
int | 取引がクリエイティブを処理する方法を指定します。 - 1: クリエイティブは既存の広告品質設定を使用します。 (既定)- 2: "保留中" の監査状態のクリエイティブが配信されます。 これらのクリエイティブが監査されると、既存の広告品質設定が使用されます。 - 3: この取引には広告プロファイルの制限は適用されません。 (最大信頼) |
allowed_media_subtypes |
整数の配列。 | この取引で許可されるメディア サブタイプの ID を指定します。 メディア サブタイプ サービスを使用して、メディア サブタイプの一覧を表示します。 メイン bid request オブジェクトと比較して、この取引の一意のメディア サブタイプがない場合、このフィールドは空の配列になります。 これは、取引がメディア サブタイプを許可しないことを意味するのではなく、メイン入札オブジェクトのメディア サブタイプをこの取引に入札するときに使用する必要があることを意味します。 |
allowed_media_types |
整数の配列。 | この取引で許可されるメディアの種類の ID を指定します。 メディア タイプ サービスを使用して、メディアの種類の一覧を表示します。 この取引に対して、メイン入札要求オブジェクトと比較して一意のメディアの種類がない場合、このフィールドは空の配列になります。 これは、取引がメディアの種類を許可しないことを意味するものではありません。代わりに、この取引に入札するときにメイン入札オブジェクトのメディアタイプを使用する必要があることを意味します。 |
floor_cpm |
double | 売り手が取引に設定した価格。 この在庫を競うために、この金額と適用される手数料を最小入札額として使用してください。 この金額に適用される手数料を加えた入札は、取引の資格を確保するのに役立ちますが、入札が勝利することを保証するものではありません。 この金額は常に米ドルで表示されます。 別の通貨で入力された価格を確認すると、ドルに変換されます。 |
id |
int | インプレッションに適用される取引の ID。 Deal Buyer Access Service を使用すると、取引名、説明、開始日と終了日、関連する在庫など、取引の詳細を表示できます。 |
member_id |
int | 取引が作成された購入者メンバーの ID。 |
sizes |
文字列の配列。 | "widthxheight" 形式で指定された、この取引で許容されるクリエイティブ サイズ。 メイン入札要求オブジェクトと比較して、この取引に一意のサイズがない場合、このフィールドは空の配列になります。 これは、取引でどのサイズも許可されないことを意味するのではなく、この取引に入札するときにメイン入札オブジェクトのサイズを使用する必要があることを意味します。 |
Bid_Info
ユーザーと全体的な入札要求に関する情報。
User
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
user_id_64 |
すべて | int | ユーザーの一意の 64 ビット ID。 Cookie がクリアされるまで、このユーザーからの要求はすべて同じになります。 注: この値は、 フィールド no_cookiesfalseが の場合にのみ設定されます。 このフィールドは、 0 AppNexus がこのユーザーと一致しない場合、またはユーザーのブラウザーが Cookie を受け入れない場合です。 これは、オプトアウト ユーザー向けになります -1 。 |
user_agent |
いくつ か | string | ブラウザーからの "User-Agent" ヘッダー。 (つまり、ブラウザーの種類。 |
operating_system |
いくつ か | int | ユーザーのオペレーティング システムの ID。 オペレーティング システム サービスを使用して、オペレーティング システム ID を名前にマップできます。 |
browser |
いくつ か | int | ユーザーのブラウザーの ID。 ブラウザー サービスを使用して、ブラウザー ID を名前にマップできます。 |
accepted_languages |
いくつ か | string | ブラウザーからの "Accept-Language" ヘッダー (ISO-639 言語と ISO-3166 国コードを使用)。 |
language |
いくつ か | int | accepted_languages文字列から解析される言語の ID。 Language Service を使用して、言語を名前にマップできます。 |
no_flash |
すべて | ブール値 | ユーザーのブラウザーにフラッシュがインストールされていないことが検出された場合に、入札者に通知します。 |
no_cookies |
すべて | ブール値 | フィールドが に no_cookies 設定されている場合 false- AppNexus は、ユーザーのブラウザーの Cookie に配置されたユーザー ID を介してユーザーを追跡できます。 - ユーザー ID は、入札要求の user_id_64 フィールドに含まれます。 フィールドが no_cookies AND に true 設定されている場合、 user_id_64 フィールドは に設定されます。 0 - ユーザーのブラウザーが Cookie を受け入れないため、AppNexus はユーザーを追跡できません。 - ユーザー データを必要とするキャンペーン (頻度上限、レジェンシー 上限など) に代わって、このようなオークションに入札しないでください。 フィールドが no_cookies AND に true 設定されている場合、 user_id_64 フィールドは 0 以外です - AppNexus は Cookie を使用してユーザーを追跡でき、user_id_64 フィールドにはユーザー ID が含まれています。 - ただし、AppNexus サーバー側のユーザー データ ストアでユーザー情報を調べている間に問題が発生しました。 - その結果、入札要求にユーザー データは含まれません。また、AppNexus は入札応答で送信されたコマンドに基づいてユーザー データを確実に更新することもできません。 - ユーザー データを必要とするキャンペーン (頻度上限、レジェンシー 上限など) に代わって、このようなオークションに入札しないでください。 |
gender |
いくつ か | 列挙 | "男性" または "女性" - このデータは、オークション時に発行元から提供される場合があります。 |
age |
いくつ か | int | このデータは、オークション時に発行元から提供される場合があります。 |
segments |
すべて | オブジェクトの配列。 | ユーザーが配置されているセグメントの配列。 利用できるセグメントには、メンバーが所有しているものと、サード パーティのデータ プロバイダー (AppNexus が入札者のアクセス権を付与したユーザー) が所有しているものが含まれます。 以下で詳しく説明します。 |
session_freq |
すべて | int | 閲覧セッション中に AppNexus がこのユーザーに提供したインプレッション数。 このような目的で、閲覧セッションはユーザーの AppNexus Cookie の有効期間として定義されます。 |
pub_session_freq |
すべて | int | 閲覧セッション中に AppNexus がこのユーザーに対してこのパブリッシャーに提供したインプレッション数。 このような目的で、閲覧セッションはユーザーの AppNexus Cookie の有効期間として定義されます。 |
地理データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
ip_address |
すべて | string | ユーザーの IP アドレス。 |
country |
いくつ か | string | IP アドレスに基づくユーザーの国 (決定可能な場合)。 |
region |
いくつ か | string | IP アドレスに基づいてユーザーのリージョン (状態/都道府県) を決定できる場合。 |
city |
いくつ か | string | IP アドレスに基づくユーザーの市区町村。 |
postal_code_id |
いくつ か | int | IP アドレスに基づくユーザーの郵便番号の ID。 |
dma |
いくつ か | int | IP アドレスに基づいてユーザーの指定された市場領域のコードを決定できる場合。 |
time_zone |
いくつ か | string | IP アドレスに基づくユーザーのタイム ゾーン (決定可能な場合)。 |
サーバー側 Cookie ストアからのユーザーデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
userdata_json |
いくつ か | 要求を受け取る入札者によって保存されたユーザーの Cookie にアタッチされたユーザーデータ。 | |
total_clicks |
いくつ か | int | このフィールドは非推奨になりました。 |
インベントリ (ページ) 情報
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
selling_member_id |
すべて | int | インベントリを販売しているメンバーの ID。 対応するメンバー名を見つけるには、「 プラットフォーム メンバー サービス 」を参照してください。 |
url |
いくつ か | string | 紹介 URL (広告が含まれます/広告要求を起動します)。 パブリッシャーが使用を制限することを選択していない限り、これは常に使用可能な場合に提供されます。 発行元は、参照元が利用できない場合、または発行元が使用を制限することを選択した場合に、入札要求で渡される既定の参照元 URL を AppNexus で構成することもできます。 詳細については、AppNexus 技術担当者にお問い合わせください。 |
domain |
いくつ か | string | 紹介 URL のドメイン。 |
inventory_audits |
いくつ か | 配列 | AppNexus は、サイトのコンテンツに関する監査データを監査します。 bid_infoの監査は、オークションのすべてのタグに関連します。 この情報は、多くの場合、ドメイン レベルの監査から取得されます。 以下で詳しく説明します。 |
within_iframe |
すべて | ブール値 | タグが囲まれた iframe のないページにある場合、これは です 'true'。 タグがラップされているかどうかを AppNexus が判断できない場合、これは になります 'false'。 |
publisher_id |
いくつ か | int | 発行元の ID。 パブリッシャーは、AppNexus を通じてインベントリを販売するメンバーのインベントリの最大のグループとして使用されます。 入札者は、ID が対応する発行元を検索できませんが、これらの ID は匿名で最適化可能なインベントリ チャンクとして使用できます。 |
is_secure |
いくつ か | ブール値 | ページがセキュリティで保護されている場合、これは true です。 注: インベントリをセキュリティで保護するための接続はすべてセキュリティで保護されている必要があります。 これには、ピクセル、クリエイティブ、サード パーティの通話が含まれます。 (つまり、クリエイティブの場合: https://mysecure.content.com/ad/ABC.123.com/DEF.40;sz=300x250) \\) |
certified_supply |
いくつ か | ブール値 | 非推奨。 |
モバイル固有のフィールド
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
app_id |
いくつ か | string | Android および iOS デバイスのグローバル アプリ ID (たとえば、怒っている鳥アプリの場合: "app_id": Android デバイスの "com.rovio.angrybirds"、"app_id" : "343200656" または "com.clickgamer.AngryBirds" (iOS デバイスの場合)。 |
loc |
いくつ か | string | 緯度と経度の観点から提供されるユーザーの場所。 "snnn.ddd,snnn.ddd" という形式で表されます (例: +123.456 や -456.123)。 南と西は負の値として表されます。 小数点以下最大 5 桁の有効桁数を指定できます。 |
carrier |
いくつ か | int | 運送業者の識別子。 通信事業者の名前と国への ID のマッピングは、通信事業者の読み取り専用サービスから利用できます。 WiFi 経由で接続するユーザーには、特別な通信事業者 "WIFI" が存在します。 |
device_make |
いくつ か | int | 広告が表示されるデバイスの ID。 これは、広告が表示されるデバイスの製造元に使用できます。 詳細については、「 Device Make Service」を参照してください。 |
device_model |
いくつ か | int | 広告が表示されるデバイス モデルの ID。 詳細については、「 Device Model Service」を参照してください。 |
device_type |
いくつ か | int | 広告が表示されるデバイスの種類の ID。 これは整数で表され、 Device Model Service を使用して検索できます。 許可される値とその意味: - 1 = "pc"- 2 = "phone"- 3 = "tablet" |
device_ids |
いくつ か | object | 入札のインプレッションアップに関連付けられているデバイス ID に関する情報を含む JSON オブジェクト。 詳細については、「 デバイス ID」を参照してください。 |
デバイス ID
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
aaid |
いくつ か | string | Google Play サービスから取得した Android デバイスの Google 広告識別子。 |
idfa |
いくつ か | string | iOS 6 以降を実行している iOS デバイスの Apple アドバタイズ識別子。 |
md5udid |
いくつ か | string | の MD5 ハッシュ ANDROID_ID。 これは Android デバイスに対してのみ送信する必要があります。 URL エンコードされている必要があります。 |
openudid |
いくつ か | string | デバイスの OpenUDID 。 これは、iOS バージョン 5 以降でのみ送信する必要があります。 |
sha1mac |
いくつ か | string | ODIN。 これは、iOS バージョン 5 以降でのみ送信する必要があります。 これは URL でエンコードする必要があります |
sha1udid |
いくつ か | string | の SHA1 ハッシュ ANDROID_ID。 これは Android デバイスに対してのみ送信する必要があります。 URL エンコードされている必要があります。 |
セグメント
ユーザーが配置されているセグメントの配列。 利用できるセグメントには、メンバーが所有しているものと、サード パーティのデータ プロバイダー (AppNexus が入札者のアクセス権を付与したユーザー) が所有しているものが含まれます。
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
code |
いくつ か | string | 詳細については、「 Pixel Services 」を参照してください。 |
id |
すべて | int | セグメント ID。 |
last_seen_min |
すべて | int | このユーザーがこのセグメントで最後にタグ付けされてからの分数。 Posix 時間で指定されます (分単位で表されます)。 この値に 60 を乗算して、このセグメントが更新されたエポックからの秒数を取得します。 |
member_id |
すべて | int | このセグメントに関連付けられているメンバーの ID。 |
other |
いくつ か | int | セグメントに値が含まれている場合のセグメントの値。 |
インベントリ監査
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
auditor_member_id |
すべて | int | この監査を提供したメンバーの ID。 このフィールドが null の場合、監査はプラットフォーム運用チームによって実行されました。 |
content_categories |
いくつ か | 整数の配列。 | サイトのコンテンツ カテゴリの ID。 特定のコンテンツ カテゴリまたは完全なリストのわかりやすい名前を取得するには、「 コンテンツ カテゴリ サービス」を参照してください。 注: この一覧には、コンテンツ カテゴリ サービスでは表示されない ID が表示される場合があります。 |
intended_audience |
いくつ か | 列挙 | 一般、子、young_adult、または成熟します。 この Web サイトの閲覧者の目標成熟度レベルを示します。 |
inventory_attributes |
いくつ か | 整数の配列。 | 一部の広告主が実行しないことを選択する可能性があるサイトの機密性の高い属性の ID。 特定の属性のわかりやすい名前を取得する場合、または完全な一覧については、「 インベントリ属性サービス」を参照してください。 このフィールドに空の配列が存在すると、サイトが監査され、機密性の高い属性 がないことを 示します。 |
例
単一タグ要求
{
"bid_request": {
"timestamp": "2015-06-07 14:39:35",
"bidder_timeout_ms": 100,
"members": [
{
"id": 6
},
{
"id": 12
}
],
"allow_exclusive": false,
"debug_requested": false,
"tags": [
{
"id": 13,
"sizes": [
"728x90"
],
"position": "unknown",
"inventory_source_id": 476,
"auction_id_64": 8984480746668973000,
"tag_format": "iframe",
"reserve_price": 1,
"ad_profile_id": 382,
"predicted_view_rate": 0.654321,
"inventory_audits": [
{
"auditor_member_id": 3,
"inventory_attributes": [
1431,
1432,
1887
],
"content_categories": [
171
]
}
]
}
],
"bid_info": {
"user_id_64": 2987961585469200400,
"no_flash": false,
"no_cookies": false,
"ip_address": "96.246.152.18",
"inventory_audits": [
{
"auditor_member_id": null,
"intended_audience": "young_adult",
"inventory_attributes": [
2,
3,
6,
7
],
"content_categories": [
39
]
}
],
"user_agent": "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US;rv:1.9.0.3) Gecko/2008092414 Firefox/3.0.3",
"accepted_languages": "en-US,en;q=0.8",
"country": "US",
"region": "NY",
"city": "New York",
"postal_code_id": "10014",
"dma": 501,
"time_zone": "America/New_York",
"url": "https://www.foodandwine.com/recipes/",
"domain": "foodandwine.com",
"selling_member_id": 3,
"inventory_source_id": 123,
"inventory_class": "class_2",
"within_iframe": false,
"total_clicks": 0,
"segments": [
{
"id": 103,
"member_id": 6,
"code": "PotentialCarBuyer",
"last_seen_min": 21108407
}
]
}
}
}
複数タグ要求
{
"bid_request": {
"timestamp": "2015-09-17 20:32:00",
"bidder_timeout_ms": 200,
"members": [
{
"id": 1513
}
],
"member_ad_profile_id": 11138,
"tags": [
{
"auction_id_64": 1704399148337927200,
"size": "120x600",
"sizes": [
"120x600"
],
"smaller_sizes_allowed": false,
"position": "unknown",
"tag_format": "js",
"site_id": 188164,
"creative_formats_map": "1111111110",
"creative_formats": [
"unknown",
"html-url",
"js-url",
"flash",
"image",
"js-raw",
"html-raw",
"html-iframe",
"url-vast"
],
"ad_profile_id": 201859,
"ad_profiles": [
201859
],
"visibility_profile_id": 132,
"venue_id": 12043,
"predicted_view_rate": 0.675,
"allowed_media_types": [
1
],
"allowed_media_subtypes": [],
"ecp": 1.43206,
"eap": 0.5,
"id": 624139,
"inventory_audits": [
{
"auditor_member_id": null,
"intended_audience": "general",
"inventory_attributes": [],
"content_categories": []
}
]
},
{
"auction_id_64": 3898100382999990000,
"size": "5x6",
"sizes": [
"5x6"
],
"smaller_sizes_allowed": false,
"position": "unknown",
"tag_format": "js",
"site_id": 188164,
"creative_formats_map": "1111111110",
"creative_formats": [
"unknown",
"html-url",
"js-url",
"flash",
"image",
"js-raw",
"html-raw",
"html-iframe",
"url-vast"
],
"ad_profile_id": 201859,
"ad_profiles": [
201859
],
"visibility_profile_id": 132,
"venue_id": 12043,
"predicted_view_rate": 0.7131,
"allowed_media_types": [
1
],
"allowed_media_subtypes": [],
"ecp": 2.07576,
"eap": 0.5,
"id": 624139,
"inventory_audits": [
{
"auditor_member_id": null,
"intended_audience": "general",
"inventory_attributes": [
14
],
"content_categories": []
}
]
}
],
"bid_info": {
"user_id_64": 488125638053592500,
"no_cookies": false,
"payment_rule_id": 91411,
"selling_member_id": 681,
"no_flash": false,
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/537.1 (KHTML, like Gecko) Chrome/21.0.1180.89 Safari/537.1",
"browser": 8,
"operating_system": 11,
"language": 1,
"accepted_languages": "en-US,en;q=0.8",
"session_freq": 75,
"pub_session_freq": 15,
"ip_address": "207.27.32.2",
"country": "US",
"region": "NY",
"city": "New York",
"dma": 501,
"time_zone": "America/New_York",
"inventory_class": "unaudited",
"within_iframe": false,
"publisher_id": 89400,
"url": "https://www.foodandwine.com/recipes/",
"domain": "www.foodandwine.com",
"inventory_audits": [
{
"auditor_member_id": null,
"inventory_attributes": [],
"content_categories": []
}
],
"userdata_json": "{}",
"segments": []
}
}
}
モバイル要求 (デバッグ モード)
{
"bid_request": {
"timestamp": "2015-08-23 14:27:08",
"bidder_timeout_ms": 2000,
"members": [
{
"id": 307
},
{
"id": 308
}
],
"single_phase": true,
"member_ad_profile_id": 8610,
"tags": [
{
"auction_id_64": 5638094169507807000,
"size": "728x90",
"sizes": [
"728x90"
],
"smaller_sizes_allowed": true,
"position": "unknown",
"tag_format": "wp7",
"site_id": 173564,
"supply_type": "mobile_app",
"creative_formats_map": "0000100001",
"creative_formats": [
"image",
"text"
],
"visibility_profile_id": 129,
"venue_id": 663,
"predicted_view_rate": 0.6891,
"inventory_source_id": 926,
"allowed_media_subtypes": [
1
],
"estimated_clear_price": 1.24481,
"estimated_average_price": 0.167,
"estimated_price_verified": true,
"id": 583751
}
],
"bid_info": {
"user_id_64": 5725700387444723000,
"no_cookies": false,
"payment_rule_id": 84497,
"selling_member_id": 618,
"no_flash": true,
"user_agent": "Mozilla%2f5.0+(compatible%3b+MSIE+9.0%3b+Windows+NT+6.1%3b+Trident%2f5.0)",
"operating_system": 13,
"language": 1,
"accepted_languages": "en-us,en;q=0.5",
"app_id": "2ac11907-8e3b-4b9b-b803-2ac834fa559a",
"ip_address": "131.107.0.83",
"country": "US",
"postal_code_id": "10016",
"loc": "38.7875232696533,-77.2614831924438",
"inventory_class": "class_1",
"within_iframe": false,
"publisher_id": 81242,
"gender": "male",
"age": 27,
"userdata_json": "{\"frequency\":[[\"r\",101,1,1,1,1303349386],[\"r\",102,1,1,1,1303349386]],\"last_imp_time\":1303349386,\"version\":4,\"pixel\":[],\"impserved\":45}",
"segments": []
}
}
}
展開可能な要求
{
"bid_request": {
"timestamp": "2015-04-20 20:00:14",
"bidder_timeout_ms": 2000,
"members": [
{
"id": 123
}
],
"test": true,
"member_ad_profile_id": 11138,
"tags": [
{
"auction_id_64": "7310650419817444682",
"size": "300x250",
"sizes": [
"300x250"
],
"smaller_sizes_allowed": false,
"position": "unknown",
"tag_format": "js",
"site_id": 188163,
"creative_formats_map": "1111111111",
"creative_formats": [
"unknown",
"html-url",
"js-url",
"flash",
"image",
"js-raw",
"html-raw",
"html-iframe",
"url-vast",
"text"
],
"ad_profile_id": 201859,
"predicted_view_rate": 0.675,
"visibility_profile_id": 132,
"venue_id": 12043,
"allowed_media_types": [
6
],
"allowed_media_subtypes": [
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
24
],
"estimated_clear_price": 1,
"estimated_average_price": 0.5
}
],
"bid_info": {
"user_id_64": 7994340253645703000,
"no_cookies": false,
"payment_rule_id": 91411,
"selling_member_id": 681,
"no_flash": false,
"is_secure": false,
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.163 Safari/535.19",
"browser": 8,
"operating_system": 11,
"language": 1,
"accepted_languages": "en-US,en;q=0.8",
"session_freq": 1,
"pub_session_freq": 1,
"ip_address": "68.67.167.12",
"country": "US",
"region": "NY",
"city": "New York",
"postal_code_id": "10003",
"dma": 501,
"time_zone": "America/New_York",
"inventory_class": "unaudited",
"within_iframe": false,
"url": "https://www.foodandwine.com/recipes/",
"domain": "foodandwine.com",
"inventory_audits": [
{
"auditor_member_id": null,
"inventory_attributes": []
}
],
"userdata_json": "{}",
"segments": []
}
}
}
取引関連の要求
{
"bid_request": {
"timestamp": "2015-04-18 17:00:57",
"bidder_timeout_ms": 2000,
"members": [
{
"id": 1417
}
],
"test": true,
"member_ad_profile_id": 555216,
"excluded_technical_attributes": [
2033
],
"tags": [
{
"auction_id_64": 5555508250840351000,
"size": "300x250",
"sizes": [
"300x250"
],
"smaller_sizes_allowed": false,
"position": "unknown",
"tag_format": "iframe",
"site_id": 555526,
"creative_formats_map": "111111111011",
"creative_formats": [
"unknown",
"html-url",
"js-url",
"flash",
"image",
"js-raw",
"html-raw",
"html-iframe",
"url-vast",
"unknown",
"unknown"
],
"ad_profile_id": 555180,
"visibility_profile_id": 5553,
"venue_id": 407258,
"predicted_view_rate": 0.675,
"pop_max_width": 300,
"pop_max_height": 250,
"pop_is_prepop": false,
"allowed_media_types": [
1
],
"media_subtypes": [
"banner"
],
"estimated_clear_price": 0.913,
"estimated_average_price": 0.456,
"id": 5555354,
"deals": [
{
"id": 555664,
"member_id": 5555,
"floor_cpm": 0.5,
"ad_quality_override": 2,
"allowed_media_types": [
1,
5
],
"allowed_media_subtypes": [
10,
11,
23,
50
],
"sizes": [
"300x250",
"300x600"
]
}
]
}
],
"bid_info": {
"user_id_64": 5555037017052493000,
"no_cookies": false,
"payment_rule_id": 555018,
"selling_member_id": 55578,
"no_flash": false,
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36",
"browser": 8,
"operating_system": 11,
"operating_system_extended": 81,
"operating_system_family": 4,
"carrier": 1,
"device_type": 1,
"language": 1,
"accepted_languages": "en-US",
"session_freq": 1,
"pub_session_freq": 1,
"ip_address": "555.1.12.54",
"country": "US",
"inventory_class": "unaudited",
"within_iframe": false,
"device_ids": {
"sha1udid": "d55555c2314f3789198685914c01425034b5d502",
"md5udid": "caf55557c5b39fb4ad68dabc9808bda1"
},
"publisher_id": 555547,
"userdata_json": "{}",
"segments": [
{
"id": 1,
"member_id": 0,
"code": "cookie_birthday",
"provider": "",
"last_seen_min": 23274134
}
]
}
}
}