キュレーター フィード
Log-Level キュレーター フィードは、キュレーションされた取引の取引インプレッションに関するデータを提供します。 フィードには、トランザクションインプレッションごとに 1 行が含まれます。 その後、このデータをキュレーターが使用して、強力なオフライン 属性モデル、ダッシュボード、カスタム レポート、およびその他のソリューションを開発できます。
このフィードの Xandr 内部名は です curator_feed。
Sequence
以下の列は、ログ レベルのフィード ファイルに表示される順序と同じ順序で一覧表示されます (ここでは上から下、ファイルでは左から右)。
推奨される有効桁数/データ型の長さ
次の Columns テーブルの Type 列の一部の値には、推奨される有効桁数またはかっこ内の長さが含まれています。 たとえば、 string(100) "この文字列はおそらく 100 文字以下である可能性があります (ただし、保証されません) であることを意味します。
整数の場合、サイズについては、「 整数キー 」セクションで説明します。
(浮動小数点) データ型の場合 numeric は、(18,6) の有効桁数を受け入れることをお勧めします。つまり、小数点の左側に 12 桁、右側に 6 桁の最大合計 18 桁が存在することを想定しています。
データ型の場合 string 、フィールドの推奨される長さはフィールドによって異なります。 次の表を参照してください。
警告
これらは推奨事項であり、保証ではありません。
データ 型 は、文書化されているとおりに正確であることを意図しています。 ただし、特定のデータ型に推奨される 有効桁数 または 長さは 、保証として読み取られるべきではありません。 たとえば、文字列または数値列の値が、このページに記載されている推奨される長さまたは有効桁数を超える場合があります。
推奨事項は、このデータを取り込むためのシステムの構築に役立ちます。 キュレーター フィードを特定の統合で動作させるには、キュレーター フィードの出力に対して追加の処理を行う必要がある場合があります。
整数キー
- tinyint = 1 バイト (8 ビット)
- smallint = 2 バイト (16 ビット)
- int = 4 バイト (32 ビット)
- bigint = 8 バイト (64 ビット)
段組み
| 列インデックス | 列名 | 型 | 説明 |
|---|---|---|---|
| 01 | auction_id_64 | Bigint | Xandr 一意のオークション識別子。 |
| 02 | date_time | UNIX エポック時間 | イベントの日時 (たとえば、 1526057561 に変換 Friday, May 11, 2018 4:52:41 PM (UTC)する必要があります)。 イベントの一覧については、「」を参照してください event_type 。 |
| 03 | user_tz_offset | Tinyint | ユーザーのタイム ゾーンと UTC。 daypart のターゲット設定に役立ちます。 |
| 04 | media_type | Tinyint | メディア サブタイプ別に分類されるクリエイティブの一般的な表示スタイル。 メディア サブタイプ ID を名前と親メディアの種類にマップするには、 Media サブタイプ サービスを使用します。 ビデオ メディアの種類の場合、 列と 列のcreative_width値は になります1。creative_height |
| 05 | event_type | 列挙 | 使用可能な値: - imp = インプレッション- click - served = VAST Creative が提供されました- started = VAST Creative が開始されました- skipped = VAST クリエイティブがスキップされました- error = VAST クリエイティブの再生中にエラーが発生しました- 25_pct = VAST クリエイティブは、通常の速度で合計再生時間の少なくとも 25% を連続して再生しました- 50_pct = VAST クリエイティブは、通常の速度で合計再生時間の少なくとも 50% を連続して再生しました- 75_pct = VAST クリエイティブは、通常の速度で再生時間の少なくとも 75% を連続して再生しました- 100_pct = VAST クリエイティブは通常の速度で最後まで再生され、クリエイティブの 100% が再生されました。 |
| 06 | user_id_64 | Bigint | Xandr Cookie ストアに格納されている Xandr 64 ビット ユーザー ID このフィールドは、次の場合です 0 。- Xandr には、このユーザーに一致するものがありません。または - ユーザーのブラウザーが Cookie を受け入れない。または - GDPR が適用される印象のために個人データにアクセスして処理するための法的根拠がありません これは、オプトアウト/同意されていないユーザー向けになります -1 。 注: このフィールドのバージョンを hashed_user_id_64 受け取った場合、ハッシュされていないバージョンは受け取りません。 |
| 07 | hashed_user_id_64 | バイト | Xandr が実際 user_id_64の を提供できない場合にプロキシとして提供される Xandr 64 ビット ユーザー ID のハッシュバージョン。 ハッシュされたユーザー ID を使用してユーザーをターゲットにすることはできません。 ただし、この識別子を使用して、一意のユーザー、ユーザーの頻度、およびユーザーの再使用性を計算できます。 例を次に示します。user_id_64: XXXXXX304391387YYYY hashed_user_id_64: 0000f47b074866470613d9397f0bd7efa78c7adec992aac5e117cbe2d55993a94767 注: このフィールドのバージョンを user_id_64 受け取った場合、ハッシュされたバージョンは受け取りません。 |
| 08 | ip_address | string | ユーザーの IP アドレス。 このフィールドの最大文字数は 40 文字です。 |
| 09 | ip_address_trunc | string | 最後のオクテットが削除されたユーザーの IP アドレス。 このフィールドの最大文字数は 40 文字です。 |
| 10 | country | string | 印象の地理的な国。 ユーザーの IP アドレスから派生するか、インプレッションに関連付けられているサイトによって提供されます。 ISO 3166 国コードを使用します。 |
| 11 | 地域 | string | インプレッションの地理的リージョン。 ユーザーの IP アドレスから派生するか、インプレッションに関連付けられているサイトによって提供されます。 米国とカナダのリージョンでは ISO-3166-2 コード、その他のすべての国のリージョンでは FIPS コードを使用します。 |
| 12 | Dma | int | このインプレッションの指定された市場領域の ID を指定します。 指定されたマーケット エリア サービスを使用して、ID に関連付けられている領域を検索します。 |
| 13 | city | int | この印象の市区町村の ID。 ユーザーの IP アドレスから派生するか、インプレッションに関連付けられているサイトによって提供されます。 City Service を使用して、ID に関連付けられている都市を検索します。 |
| 14 | postal_code | string | ユーザーの場所の郵便番号。 ユーザーの IP アドレスから派生するか、インプレッションに関連付けられているサイトによって提供されます。 郵便番号については、「 郵便番号サービス」を参照してください。 |
| 15 | latitude | string | モバイル デバイスから GPS データを使用できる場合の、ユーザーの場所の緯度。 "snn.ddd,snn.ddd" という形式で表されます。たとえば +12.345 、 や -45.123は、south が負の値として表されます。 小数点以下最大 5 桁の有効桁数を指定できます。 |
| 16 | latitude_trunc | string | モバイル デバイスから GPS データを使用できる場合、ユーザーの位置情報の緯度の切り捨てられた値 (小数点以下 3 桁に制限)。 "snn.ddd,snn.ddd" という形式で表されます。 例: - +12.345 または- -45.123 (南は負の値として表されます)。 |
| 17 | longitude | string | モバイル デバイスから GPS データを利用できる場合の、ユーザーの位置情報の経度。 "snn.ddd,snn.ddd" という形式で表されます。たとえば +12.345 、または -45.123、west は負の値として表されます。 小数点以下最大 5 桁の有効桁数を指定できます。 |
| 18 | longitude_trunc | string | モバイル デバイスから GPS データを使用できる場合、ユーザーの位置情報の経度の切り捨てられた値 (小数点以下 3 桁に制限)。 "snn.ddd,snn.ddd" という形式で表されます。 例: - +12.345 または- -45.123 (west は負の値として表されます)。 |
| 19 | device_unique_id | string | モバイル デバイスを表す一意の識別子。 数値プレフィックスは、一意のデバイス識別子の種類を示します。 - 0 = IDFA (広告用 Apple ID)- 1 = SHA1- 2 = MD5- 3 = ODIN- 4 = OPENUDID- 5 = AAID (Android 広告 ID)- 6 = WINDOWSADID (Microsoft Advertising ID)- 7 = RIDA (広告用のRoky id)- 8.9 = AFAI (Amazon Fire OS)- 8.10 = TIFA (Tizen Identifier for Advertising (Samsung Ad ID))- 8.11 = VIDA (Vizio Advertising ID)- 8.12 = LGUDID (LG 固有のデバイス ID) |
| 20 | device_type | int | デバイスの種類。 使用可能な値は次のとおりです。 - 0 = その他のデバイス- 1 = デスクトップとノート PC- 2 = 携帯電話- 3 = タブレット- 4 = テレビ- 5 = ゲーム コンソール- 6 = メディア プレーヤー- 7 = トップ ボックスの設定 |
| 21 | tc_string | string | 透過性と同意文字列は 、IAB の透過性と同意フレームワーク の文字列を表します。 文字列は base-64 url-safe でエンコードされており、IAB GDPR の透明性と同意フレームワークの技術仕様を使用してデコードできます。 文字列には、データ権限、使用状況、およびプライバシー情報が含まれています。 |
| 22 | curated_deal_id | int | インプレッションが処理されたキュレーターの取引の ID。 |
| 23 | gross_revenue_dollars | 数値 | インプレッションのためにキュレーターに送信された購入者の支出額 (該当する場合は購入者料金を含む)。 これは、購入者のメディア コストと同じです (ただし、メディア コストには購入者料金は含まれません)。 これは、キュレーター分析レポートと同じ値 curator_revenueです。 |
| 24 | curator_margin | 数値 | キュレーターが取引に対して行った利益。 |
| 25 | total_tech_fees_dollars | 数値 | インプレッションに関してキュレーターに請求された料金 Xandr。 |
| 26 | total_cost_dollars | 数値 | キュレーターがインプレッションの交換手数料 (Xandr) と販売者メディアに費やした金額。 これには、キュレーターのマージンやキュレーター料金は含まれません。 これは、キュレーター分析レポートと同じ値 curator_total_costです。 |
| 27 | net_media_cost_dollars | 数値 | キュレーターが売り手メディアに費やしたインプレッションの金額。 これには、キュレーターの手数料やキュレーターのマージンは含まれません (該当する場合)。 これは、総販売者収益 (販売者手数料を含む) と同じです。 |
| 28 | seller_member_id | int | 販売者のメンバー ID。 |
| 29 | publisher_id | int | 配置の発行元の ID。 キュレーターメンバーは、販売者がパブリッシャーを公開することを選択した場合、 インベントリ再販サービス を使用してパブリッシャー ID を名前にマップできます。 キュレーターへの露出は、販売者の可視性プロファイルによって異なります。 |
| 30 | site_id | int | 配置に関連付けられているサイトの ID。 サイトを所有する販売者メンバーを除き、名前に関連付けることはできません。 キュレーターへの露出は、販売者の可視性プロファイルによって異なります。 |
| 31 | site_domain | string | 提供できるサイトの最も詳細な識別子 (ただし、完全なドメインではありません)。 これは、供給パートナーのドメイン ( たとえば、doubleclick.com)、再販されたインベントリを所有するネットワーク、または単に "再売り在庫" です。 キュレーターへの露出は、販売者の可視性プロファイル設定によって異なります。 このフィールドの最大文字数は 100 文字です。 |
| 32 | tag_id | int | インプレッションの配置タグの ID。 タグを所有する販売者メンバーを除き、名前に関連付けることはできません。 キュレーターへの露出は、販売者の可視性プロファイルによって異なります。 |
| 33 | application_id | string | モバイル アプリケーションの ID (該当する場合)。 |
| 34 | mobile_app_instance_id | int | このインプレッションのモバイル アプリ インスタンスの ID を指定します。 モバイル アプリ インスタンス サービスを使用して、ID に関連付けられているモバイル アプリ インスタンスを検索します。 |
| 35 | buyer_member_id | int | 購入者のメンバー ID。 |
| 36 | creative_id | int | 配信されたクリエイティブの ID。 |
| 37 | brand_id | int | クリエイティブのブランドの ID。 キュレーター メンバーは、ブランド サービスをbrand_id使用して、 を名前にマップできます。 |
| 38 | deal_id | int | インプレッション seller_deal_id に関連付けられたもの、または 0 キュレーターがオープン エクスチェンジからインプレッションを提供した場合。 |
| 39 | view_result | 列挙 | インプレッションの Xandr 視認性測定結果。 使用可能な値: - 0 = VIEW_UNKNOWN- 1 = VIEW_DETECTED- 2 = VIEW_NOT_DETECTED- 3 = VIEW_NOT_MEASURABLE- -1 = UNKNOWN注: 視認性の詳細については、「表示 可能性の概要」を参照してください。 |
| 40 | view_non_measurable_reason | int | 視認性のために印象を測定できなかった理由。 使用可能な値: - 0 = N/A。 視認性を測定した印象- 1 = SCRIPT_NOT_SERVED。 視認性スクリプトはクリエイティブで提供されませんでした。 たとえば、モバイル アプリ インベントリの場合などです。 - 2 = NO_SCRIPT_CALLBACK。 視認性スクリプトはクリエイティブで提供されましたが、コールバック/イベントは受信されませんでした。 たとえば、ユーザーはクリエイティブが配信される前にページを離れたとします。 - 3 = TECHNICAL_LIMITATION。 ビューアビリティ スクリプトが提供され、読み込まれましたが、技術的な理由で測定できませんでした。 たとえば、Flash が無効になっているクロスドメイン iframe などです。 - -1 = UNKNOWN。 理由は不明です。 注: 視認性の詳細については、「表示 可能性の概要」を参照してください。 |
| 41 | supply_type | 列挙 | 供給の種類。 使用可能な値: - 0 = WEB- 1 = MOBILE_WEB- 2 = MOBILE_APP- 5 = ツール バー |
| 42 | creative_width | Smallint | クリエイティブの幅。 |
| 43 | creative_height | Smallint | クリエイティブの高さ。 |
| 44 | partition_time_millis | UNIX エポック時間 | UNIX エポック タイムスタンプ値 (ミリ秒単位) として表される、レコード行がに分類される時間単位パーティション。 データベースまたはデータ ウェアハウスへの読み込み時に、時間単位のパーティションを定義する場合に便利です。 Avro 形式の場合、このフィールドにはネイティブ タイムスタンプ検出用の timestamp-millis 論理型が指定されます。 たとえば、 15680772000002019 年 9 月 10 日午前 1 時 (UTC) の火曜日にも表すことができます。 |
| 45 | operating_system | Smallint | インプレッションが発生したオペレーティング システム。 オペレーティング システム サービスを使用して、ID に関連付けられているオペレーティング システムを検索します。 |
| 46 | ブラウザー | Smallint | インプレッションが発生したブラウザー。 ブラウザー サービスを使用して、ID に関連付けられているブラウザーを検索します。 |
| 47 | language | Smallint | インプレッションが発生したブラウザーの言語設定。 言語サービスを使用して、ID に関連付けられている言語を検索します。 |
| 48 | device_id | Smallint | インプレッションが発生したデバイスのモデル。 デバイス モデル サービスを使用して、ID に関連付けられているデバイス モデルを検索します。 |
| 49 | extended_ids | メッセージの配列 | トランザクションに特に影響を与えたかどうかに関係なく、オークションで利用できる拡張 ID の一覧。 詳細については、以下のextended_ids表を参照してください。 |
| 50 | curated_deal_code | 文字列 | curated_deal_code を使用すると、キュレーションされた取引オブジェクトに設定したコードを簡単に受け取ることができます。 |
| 51 | split_id | int32 | 購入者がインプレッションを購入したオークションにキュレーション取引を追加した分割の ID。 |
| 52 | external_campaign_id | string | オプションの値の DSP は、入札応答の cid フィールドに渡すことができます。ここで、入札を送信したシステム内の明細 ID を示すことができます。 cid フィールドは省略可能であるため、external_campaign_id フィールドには、外部の DSP が入札応答にデータを設定する場合にのみデータが含まれます。 cid フィールドの詳細については、 Open RTB 仕様 を参照してください。 |
| 53 | external_bidrequest_id | Bigint | 入札要求に対して Microsoft によって生成される一意の識別子。 DSP は、この識別子を使用して、入札応答を入札要求に関連付け、入札要求識別子を独自のログ レベル データに記録する可能性があります。 |
| 54 | external_bidrequest_imp_id | Bigint | 入札要求内のインプレッションの一意識別子。 1 つの入札リクエストに複数のインプレッション機会があり、それぞれに独自の ID が設定されている場合、DSP は入札応答を入札リクエストインプレッションに関連付け、入札リクエストインプレッション識別子を独自のログ レベルデータに記録できます。 |
| 55 | postal_code_ext_id | int32 | 米国のみ。 ユーザーの場所の 9 つのデジタル米国郵便番号 。形式は 12345-1234 です。 ユーザーの IP アドレスから派生するか、インプレッションに関連付けられているサイトによって提供されます。 郵便番号については、「郵便番号サービス」を参照してください。 |
extended_ids
| 列インデックス | 列名 | 型 | 説明 |
|---|---|---|---|
| 1 | id_type | unsigned 32 bit int | 拡張識別子のソース: - 10 = Trade Desk ID (Unified ID 1.0)- 11 = Criteo ID- 12 = NetID- 13 = RampID- 15 = UID 2.0 |
| 2 | id_value | string | 拡張識別子の値 (例: "ID0001")。 注: このフィールドの値は、アクセス許可が付与されている場合にのみ表示されます。 |