重要
- サポートされていません: AppNexus 入札プロトコルはサポートされなくなりました。このドキュメントは、レガシー目的専用です。 このプロトコルは 2018 年 12 月 1 日に廃止されます。
- AppNexus と統合する新しい入札者は、 OpenRTB 2.4 入札プロトコルを参照してください。
広告呼び出しがインプレッション バスに到達するたびに、入札者に入札要求が送信されます。 これには、入札者が入札価格と提供するクリエイティブを作成するために必要なすべての情報が含まれています。
入札要求には、オークションに勝ってページ上で掲載できる広告主とクリエイティブを指定する販売者からの情報が含まれています。 この情報は広告承認プロファイルに保存され、入札者はそれを使用して入札が受け入れられることを確認できます。
入札要求の調整
AppNexus プラットフォームを経由するすべての入札要求を受信したくない場合があります。 一定の割合で要求を調整するか、地理などの事前設定された条件で要求をフィルター処理できます。
マルチタグ入札要求
"マルチタグ入札要求" を送信することがありますが、1 つの入札要求には、サイズ、広告品質基準、予約価格などが異なる可能性のある複数のタグ ID が含まれる場合があります。現時点では、これらの要求は、独立した要求であるかのように、タグごとに個別の応答で処理する必要があります。 ただし、近い将来、これらのマルチタグ要求は、買収、フルページバイアウト、その他多くのプレミアムインベントリ機能の基盤になるでしょう。
マルチタグ要求のタグにはそれぞれ、一意のオークション ID があります。
実装
要求ヘッダー
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
Connection |
すべて | string | 永続的な TCP 接続を確保するには、常に "キープアライブ" に設定してください。 |
Content-Length |
すべて | int | HTTP 要求の本文の長さ (以下で説明するすべてのフィールドを含む)。 |
Host |
すべて | string | 入札要求の送信先の IP アドレス。 |
X-Debug |
some | int | 1 に設定した場合、広告呼び出しに debug=1 フラグが含まれるため、広告は配信されません。 |
X-DMA |
some | int | IP アドレスに基づいて、ユーザーの指定された市場領域のコード (判別できる場合)。 |
X-Exclusive |
some | int | オークションが既定で排他的であるかどうかを示します。 排他オークションとは、プレースメント所有者のみが広告を提供できるオークションです。 排他的既定値は、オークションの所有者フェーズ中に所有者によって上書きされる場合があります。 |
X-Segment |
some | string | ユーザーが属しているセグメントのコンマ区切りのリスト。 利用可能なセグメントには、メンバーが所有するものと、(AppNexus が入札者へのアクセスを許可した) 第三者のデータ プロバイダーが所有するものが含まれます。 |
X-Venue |
すべて | int | このヘッダーは現在使用されていません。 |
オークション情報
全般データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
member_ad_profile_id |
some | int | インプレッションに適用されるメンバー レベルの広告承認プロファイル ID。 |
timestamp |
すべて | timestamp | 要求が送信された時刻。 |
bidder_timeout_ms |
すべて | int | Imp バスによって要求が送信されてから、タイムアウト前に Imp バスによって応答が受信されるまでに、入札者が持っているミリ秒数。 この数は、供給パートナーによって異なります。 |
bid_info |
すべて | object | ユーザーと入札要求全般に関する詳細。 詳細については、以下の Bid_Info を参照してください。 |
members |
すべて | オブジェクトの配列 | この呼び出しで入札できるメンバーの配列。 メンバーとは、AppNexus と金銭的な売買関係にあり、入札者に関連付けられているエンティティのことです。 一部の入札者は複数のメンバーを持つ場合があります。自分専用でビッダーを構築している場合は、メンバーはあなただけです。 メンバー オブジェクトにはメンバーの ID があります。 詳細については、以下 のメンバーを参照してください 。 注: これは数値の配列ではなく、オブジェクトの配列です。 正確な構文を次の 例 に示します。 |
tags |
すべて | オブジェクトの配列 | この呼び出しでオークションにかけられているタグの配列。 オークションには少なくとも 1 つのタグがありますが、複数のタグを持つ場合もあります。 詳細については、以下の タグを参照してください 。 |
所有者固有のデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
allow_exclusive |
some | ブール型 | 入札メンバーがインベントリを所有している場合 (つまり、タグのmember_id = 入札者のメンバー ID)、メンバーは他の入札者に参加することなくインベントリにサービスを提供できます。 |
デバッグ データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
debug_requested |
some | ブール型 |
true の場合、広告呼び出しにdebug=1フラグが含まれており、広告は配信されません。 これは、正しいドングルが使用されている場合にのみ、入札要求に含まれます。 |
debug_member_id |
some | int | パラメーターがクエリ文字列に渡され、クエリ文字列に渡された "dongle" パラメーターがメンバーのドングル ( メンバー サービスで設定) と一致する場合、このフィールドには "debug_member" パラメーターの値が含まれます。 入札者はこのdebug_member_idを使用して、特定のメンバーに限定されたデバッグ出力を生成できます。 |
test |
some | ブール型 | true の場合、広告タグはテストとして実行されており、広告は配信されません。 存在しない場合、test は false です。 |
その他のデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
excluded_adservers |
some | 整数の配列 | 販売者の広告品質設定で定義されている、インプレッションの対象とならない広告サーバーの ID。 広告サーバー サービスを使用して、広告サーバーを検索できます。 |
excluded_brands |
some | 整数の配列 | 販売者の広告品質設定で定義されている、インプレッションの対象とならないブランドの ID。 Brand Service を使用してブランドを検索できます。 |
excluded_languages |
some | 整数の配列 | 販売者の広告品質設定で定義されている、インプレッションの対象とならない言語の ID。 Language Service を使用すると、言語を検索できます。 |
excluded_categories |
some | 整数の配列 | 販売者の広告品質設定で定義されている、インプレッションの対象とならないカテゴリの ID。 カテゴリ サービスを使用してカテゴリを検索できます。 |
excluded_creatives |
some | 整数の配列 | 販売者の広告品質設定で定義されている、インプレッションの対象とならないクリエイティブの ID。 クリエイティブ サービスを使用してクリエイティブを検索できます。 |
excluded_technical_attributes |
some | 整数の配列 | 販売者の広告品質設定で定義されている、インプレッションの対象とならない技術属性の ID。 技術属性サービスを使用して、技術属性を検索できます。 |
single_phase |
some | ブール型 | このフィールドは現在、入札者には使用されていません。 |
メンバー
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
id |
すべて | int | メンバーの ID。 |
タグ
広告タグに関連付けられている情報。
オークション データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
auction_id_64 |
すべて | int | オークションの ID。 これは、調整と不一致に役立つため、ログに追加することをお勧めします。 これは一意であるとは限りません。 |
在庫階層データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
id |
some | int | TinyTag の ID。 A: タグは、サイト内のインベントリのサブセットです。 入札者は、ID が対応するタグを検索することはできませんが、これらの ID は匿名で最適化可能なインベントリ チャンクとして使用できます。 |
site_id |
some | int | サイトの ID。 サイトは、AppNexus を通じてインベントリを販売するメンバーのインベントリの 2 番目に大きなグループです。 サイトは、パブリッシャーのインベントリのサブセットです。 入札者は ID が対応するサイトを検索することはできませんが、これらの ID は匿名で最適化可能なインベントリ チャンクとして使用できます。 |
全般データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
size |
すべて | string | このインプレッションのサイズ (widthxheight; 例: 300x160)。 |
sizes |
すべて | 文字列の配列 | このインプレッションに使用できるクリエイティブ サイズは "widthxheight" 形式で指定されます。 |
position |
すべて | enum("below","above","unknown") | ページ上またはフォールドの下に表示されるページ上の広告の位置。タグから取得します (使用可能な場合)。 |
tag_format |
some | enum("iframe", "js", "wp7", "vast", "json", "xml") | "iframe" タグの場合、インプレッション バスは HTML を返し、優勝したクリエイティブをパブリッシャーのページに表示します (必要な場合、HTML には IFrame タグが含まれます)。"js" タグの場合、インプレッション バスはパブリッシャーのページで実行される javascript を返します。 (返される javascript には通常、クリエイティブを表示するための HTML を生成するための document.write コマンドが含まれます)。この違いは、クリエイティブが 1 つ以上のタグ形式では正しく表示されない場合にのみ、入札者に関係します。 |
allowed_media_types |
some | 整数の配列 | 有効なメディアの種類。 ID の一覧には メディア タイプ サービス を使用します。 |
allowed_media_subtypes |
some | 整数の配列 | 有効なメディア サブタイプ ID。 ID の一覧には、 Media Subtype Service を使用します。 |
media_subtypes |
some | 文字列の配列 | クリエイティブの有効なメディア サブタイプ (文字列形式)。 |
inventory_audits |
some | 配列 | サイトのコンテンツに関する販売者自己分類データ。 |
venue_id |
some | int | このフィールドは現在、入札者には使用されていません。 |
ad_profile_id |
some | int | 特定のタグのインプレッションに適用されるタグレベルの広告承認プロファイル ID。 |
predicted_view_rate |
すべて | double | 履歴データに基づく、インプレッションがユーザーに表示される確率。 |
価格データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
reserve_price |
some | 浮動小数点数 | 提供された場合、これはオークションに勝つために必要な最低入札額です。 入札メンバーがインベントリを所有している場合 (allow_exclusive = true)、これは無視されます。 |
estimated_clear_price |
some | double | ECP は、在庫を獲得するために必要な見積もり価格です。 ECP が、AppNexus を通じて送信されたこのタグのすべての落札の 95% を超えています。 注: タグの落札額のかなりの割合が AppNexus を通じて送信されない場合があります。 詳細については、「 値下げのしくみ 」を参照してください。 |
estimated_average_price |
some | double | EAP は ECP に似ていますが、EAP が AppNexus を通じて送信されたこのタグのすべての落札の 70% を超えている点が異なります。 |
estimated_price_verified |
some | ブール型 | このフィールドは、EAP と ECP が AppNexus によって観測されたデータによって検証されているかどうかを示します。 |
所有者固有のデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
tag_data |
所有のみ | string | 利用可能な場合は、この TinyTag ID に関連付けられているその他の情報。 TinyTag の所有者は、オークションに先立ってこの情報を TinyTag に追加することができます。 |
exclusive_default |
所有のみ | ブール型 | オークションが既定で排他的であるかどうかを示します。 排他オークションとは、プレースメント所有者のみが広告を提供できるオークションです。 排他的既定値は、オークションの所有者フェーズ中に所有者によって上書きされる場合があります。 |
default_creative_id |
所有のみ | int | この TinyTag の既定のクリエイティブ ID。 |
モバイル固有のフィールド
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
supply_type |
some | 常に "mobile_app" 用に送信されます ("web" 用は送信されません) | このインベントリが Web、モバイル ブラウザ、またはモバイル アプリのいずれであるかを区別します。 Web インプレッションがモバイル デバイスで表示されているかどうかを確認するには、入札要求のオペレーティング システムを使用します。 |
creative_formats |
some | "text"、"image"、"html-url"、"js-url"、"flash"、"js-raw"、"html-raw"、"html-iframe"、"url-vast"、"xml-url"、"file-url"、unknown" の 1 つ以上 | インプレッションに対する入札に使用できる AppNexus クリエイティブ フォーマットのリスト。 他の形式は、サポートされるようになり次第、このリストに追加される場合があります。 |
creative_actions |
some | "click-to-web"、"click-to-call" のいずれか 1 つ以上 | このインプレッションの入札に使用できるクリエイティブの許容されるクリック アクションの一覧。 現在はクリックコールは利用できませんが、間もなく利用できるようになります。 その他の操作は、サポートされるようになり次第、このリストに追加される場合があります。 |
smaller_sizes_allowed |
some | ブール型 | より小さいサイズのクリエイティブとテキスト クリエイティブもインプレッションの入札に使用できる場合は true。 |
取引データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
deals |
some | オブジェクトの配列 | インプレッションに該当する取引の配列。 詳細については、「 お得情報」 を参照してください。 |
セール
deals 配列の各オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 |
|---|---|---|
ad_quality_override |
int | 取引でクリエイティブを処理する方法を指定します: - 1: クリエイティブでは既存の広告品質設定が使用されます。 (既定) - 2: 監査ステータスが "保留中" のクリエイティブが機能します。 これらのクリエイティブが監査されると、既存の広告品質設定が使用されます。 - 3: この取引には、広告プロファイルの制限は適用されません。 (最大の信頼) |
allowed_media_subtypes |
整数の配列。 | この取引で許可されるメディア サブタイプの ID を指定します。 Media Subtype Service を使用して、Media Subtype のリストを表示します。 メインの入札要求オブジェクトと比較して、この取引に固有のメディア サブタイプがない場合、このフィールドは空の配列になります。 これは、取引でメディア サブタイプが許可されていないという意味ではなく、この取引に入札する際に、メインの入札オブジェクトのメディア サブタイプを使用する必要があるという意味にすぎません。 |
allowed_media_types |
整数の配列。 | この取引で許可されるメディアの種類の ID を指定します。 Media Type Service を使用して、メディアの種類のリストを表示します。 メインの入札要求オブジェクトと比較してこの取引に固有のメディア タイプがない場合、このフィールドは空の配列になります。 これは、取引でメディアの種類が許可されていないという意味ではなく、この取引に入札する際に、メインの入札オブジェクトのメディア タイプを使用する必要があるという意味にすぎません。 |
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_cookies が falseの場合にのみ入力されます。 このフィールドは、AppNexus にこのユーザーに一致するものがない場合、またはユーザーのブラウザーが Cookie を受け入れない場合に 0 されます。 オプトアウト ユーザーには -1 されます。 |
user_agent |
some | string | ブラウザーからの "User-Agent" ヘッダー。 (言い換えれば、ブラウザーの種類です)。 |
operating_system |
some | int | ユーザーのオペレーティング システムの ID。 オペレーティング システム サービスを使用して、オペレーティング システム ID を名前にマップできます。 |
browser |
some | int | ユーザーのブラウザーの ID。 ブラウザー サービスを使用して、ブラウザー ID を名前にマップできます。 |
accepted_languages |
some | string | ブラウザーの "Accept-Language" ヘッダー (ISO-639 言語と ISO-3166 国コードを使用)。 |
language |
some | int | accepted_languages文字列から解析された言語の ID。 Language Service を使用すると、言語を名前にマップできます。 |
no_flash |
すべて | ブール値 | ユーザーのブラウザーに Flash がインストールされていないことが検出された場合は、入札者に通知します。 |
no_cookies |
すべて | ブール値 |
no_cookiesフィールドがfalse- AppNexus は、ユーザーのブラウザの Cookie に配置されているユーザー ID を介してユーザーを追跡できます。 - ユーザー ID は、入札リクエストの user_id_64 フィールドに含まれます。 no_cookies フィールドが true に設定されていて、user_id_64 フィールドが0 - ユーザーのブラウザは Cookie を受け入れないため、AppNexus はユーザーを追跡できません。 - ユーザー データ (フリークエンシー キャップ、最新性キャッピングなど) を必要とするキャンペーンに代わってこのようなオークションに入札しないでください。 no_cookies フィールドが true に設定されていて、user_id_64 フィールドが 0 以外の場合 - AppNexus は Cookie を介してユーザーを追跡でき、user_id_64 フィールドにはユーザー ID が含まれています。 - ただし、AppNexus サーバー側のユーザー データ ストアでユーザー情報を検索中に問題が発生しました。 - その結果、入札リクエストにはユーザー データは含まれず、AppNexus が入札応答で送信されたコマンドに基づいてユーザー データを確実に更新することもできません。 - ユーザー データ (フリークエンシー キャップ、最新性キャッピングなど) を必要とするキャンペーンに代わってこのようなオークションに入札しないでください。 |
gender |
some | 列挙 | "male" または "female" - このデータはオークション時にパブリッシャーから提供される場合があります。 |
age |
some | int | このデータは、オークション時にパブリッシャーから提供される場合があります。 |
segments |
すべて | オブジェクトの配列。 | ユーザーが属しているセグメントの配列。 利用可能なセグメントには、メンバーが所有するものと、(AppNexus が入札者へのアクセスを許可した) 第三者のデータ プロバイダーが所有するものが含まれます。 以下で詳しく説明します。 |
session_freq |
すべて | int | 閲覧セッションの期間中に AppNexus がこのユーザーに提供したインプレッション数。 これらの目的のために、閲覧セッションはユーザーの AppNexus Cookie の有効期間として定義されます。 |
pub_session_freq |
すべて | int | 閲覧セッションの期間中に、AppNexus がこのユーザーに、このパブリッシャーで提供したインプレッション数。 これらの目的のために、閲覧セッションはユーザーの AppNexus Cookie の有効期間として定義されます。 |
地理的データ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
ip_address |
すべて | string | ユーザーの IP アドレス。 |
country |
some | string | IP アドレスに基づくユーザーの国または地域 (特定できる場合)。 |
region |
some | string | IP アドレスに基づくユーザーの地域 (都道府県) (判別できる場合)。 |
city |
some | string | IP アドレスに基づくユーザーの市区町村。 |
postal_code_id |
some | int | IP アドレスに基づくユーザーの郵便番号の ID。 |
dma |
some | int | IP アドレスに基づいて、ユーザーの指定された市場領域のコード (判別できる場合)。 |
time_zone |
some | string | IP アドレスに基づくユーザーのタイム ゾーン (判別できる場合)。 |
サーバー側 Cookie ストアからのユーザーデータ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
userdata_json |
some | リクエストを受け取る入札者によって保存され、ユーザーの Cookie に添付されたユーザー データ。 | |
total_clicks |
some | int | このフィールドは非推奨になりました。 |
インベントリ (ページ) 情報
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
selling_member_id |
すべて | int | インベントリを販売するメンバーの ID。 対応するメンバー名を見つけるには、「 プラットフォーム メンバー サービス 」を参照してください。 |
url |
some | string | 紹介 URL (広告を含む/広告要求を起動する)。 これは、発行元が使用を制限することを選択していない限り、利用可能な場合は常に提供されます。 発行元は、参照元が利用できない場合や発行元がその使用を制限することを選択した場合に、入札要求で渡される AppNexus の既定の参照元 URL を構成することもできます。 詳細については、AppNexus の技術担当者にお問い合わせください。 |
domain |
some | string | 参照 URL のドメイン。 |
inventory_audits |
some | 配列 | サイトのコンテンツに関する AppNexus 監査データ。 bid_info の監査は、オークション内のすべてのタグに関係します。 この情報は、多くの場合、ドメイン レベルの監査によって取得されます。 以下で詳しく説明します。 |
within_iframe |
すべて | ブール値 | 囲む iframe がないページにタグが存在する場合、これは 'true'です。 AppNexus がタグがラップされているかどうかを判断できない場合、これは 'false'になることに注意してください。 |
publisher_id |
some | int | 発行元の ID。 パブリッシャーは、AppNexus を通じてインベントリを販売するメンバーのインベントリの最大のグループとして使用されます。 入札者は、ID が対応するパブリッシャーを検索することはできませんが、これらの ID は匿名で最適化可能なインベントリ チャンクとして使用できます。 |
is_secure |
some | ブール値 | ページがセキュリティで保護されている場合、これは true です。 注: インベントリを保護するためのすべての接続はセキュリティで保護されている必要があります。 これにはピクセル、クリエイティブ、サード パーティの呼び出しが含まれます。 (例: クリエイティブの場合: https://mysecure.content.com/ad/ABC.123.com/DEF.40;sz=300x250) \\) |
certified_supply |
some | ブール値 | 非推奨です。 |
モバイル固有のフィールド
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
app_id |
some | string | Android および iOS デバイスのグローバル アプリ ID (例: Angry Birds アプリの場合: Android デバイスの場合は "app_id": "com.rovio.angrybirds"、iOS デバイスの場合は "app_id" : "343200656" または "com.clickgamer.AngryBirds")。 |
loc |
some | string | ユーザーの場所 (緯度と経度で指定)。 "snnn.ddd,snnn.ddd" の形式で表されます (例: +123.456 または -456.123)。 南と西は負として表されます。 精度は小数点以下最大 5 桁です。 |
carrier |
some | int | 通信事業者の識別子。 通信事業者名および国または地域への ID のマッピングは、通信事業者の読み取り専用サービスから利用できるようになります。 WiFi経由で接続するユーザーのために、特別なキャリア「WIFI」が存在します。 |
device_make |
some | int | 広告が表示されるデバイス メーカーの ID。 広告が表示されるデバイスの製造元には、これを使用できます。 詳細については、 デバイス メイク サービスを参照してください。 |
device_model |
some | int | 広告が表示されるデバイス モデルの ID。 詳細については、 デバイス モデル サービスを参照してください。 |
device_type |
some | int | 広告が表示されるデバイスの種類の ID。 これは整数で表され、 デバイス モデル サービスを使用して検索できます。 指定できる値とその意味: - 1 = "PC" - 2 = "phone" - 3 = "タブレット" |
device_ids |
some | object | 入札対象のインプレッションに関連付けられているデバイス ID に関する情報を含む JSON オブジェクト。 詳細については、「 デバイス ID」を参照してください。 |
デバイス ID
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
aaid |
some | string | Google Play サービスから取得した、Android デバイスの Google 広告識別子。 |
idfa |
some | string | iOS 6+ を実行している iOS デバイスの Apple 広告識別子。 |
md5udid |
some | string |
ANDROID_IDの MD5 ハッシュ。 これは Android デバイスに対してのみ送信する必要があります。 URL エンコードする必要があります。 |
openudid |
some | string | デバイスの OpenUDID 。 これは、iOS バージョン 5 以下にのみ送信する必要があります。 |
sha1mac |
some | string | ODIN. これは、iOS バージョン 5 以下にのみ送信する必要があります。 これは URL エンコードする必要があります |
sha1udid |
some | string |
ANDROID_IDの SHA1 ハッシュ。 これは Android デバイスに対してのみ送信する必要があります。 URL エンコードする必要があります。 |
セグメント
ユーザーが属しているセグメントの配列。 利用可能なセグメントには、メンバーが所有するものと、(AppNexus が入札者へのアクセスを許可した) 第三者のデータ プロバイダーが所有するものが含まれます。
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
code |
some | string | 詳細については、「 Pixel サービス 」を参照してください。 |
id |
すべて | int | セグメント ID。 |
last_seen_min |
すべて | int | このユーザーが最後にこのセグメントにタグ付けされてからの分数。 Posix 時間 (分で表されます) で指定されます。 この値に 60 を乗算して、このセグメントが更新されたエポックからの秒数を求めます。 |
member_id |
すべて | int | このセグメントに関連付けられているメンバーの ID。 |
other |
some | int | セグメントに値が含まれている場合は、セグメントの値。 |
インベントリ監査
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
auditor_member_id |
すべて | int | この監査を提供したメンバーの ID。 このフィールドが null の場合、監査はプラットフォーム運用チームによって実行されました。 |
content_categories |
some | 整数の配列。 | サイトのコンテンツ カテゴリの ID。 特定のコンテンツ カテゴリの意味のある名前または完全なリストを取得するには、「 コンテンツ カテゴリ サービス」を参照してください。 注: この一覧には、コンテンツ カテゴリ サービスには表示されない ID が表示される場合があります。 |
intended_audience |
some | 列挙 | general、children、young_adult、mature。 この Web サイトの読者の目標成熟度レベルを示します。 |
inventory_attributes |
some | 整数の配列。 | 一部の広告主が実行しないことを選択したサイトの機密性の高い属性の 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
}
]
}
}
}