バッチ ログ レベルのデータ
バッチ ログ レベル データ (LLD) を使用すると、Xandr UI または API Report Service で使用できないディメンションを含むログ レベルのイベント データのフィードを、バッチ処理された方法で取得および追跡できます。 フィードは 1 時間ごとに生成され、1 つ以上のファイルに分割されます (下記の 「ファイル形式 」を参照)。 受信するファイルの形式は、サブスクライブ時に指定した内容 (Avro、Protobuf、Protobuf 区切りなど) によって異なります。
ログ レベル データの一般的な情報については、「ログ レベル のデータ フィード](ログ level-data-feeds.md)」を参照してください。
スキーマ & ファイル形式
サービスをサブスクライブするときに、次の形式の 1 つ以上を指定できます。
パッケージ化されたサンプル ファイルとログ レベル データ ファイルを使用するためのコードについては、次に示すダウンロードを使用します。
注:
ログ レベル データ ファイルの使用に使用する実装をテストするときに役立つサンプル ファイルが作成されます。 テストを容易にするために、サンプル ファイルは、運用環境で取得する生成されたファイルよりもやや簡単です。
- protobuf 形式のファイルの例は圧縮されません (運用環境では、Snappy 圧縮されています)
- データ例には、特定の列に一般的な値が含まれていません。 代わりに、列の型に変換された列のインデックス番号が列に設定されます。
バージョン | リリース日 | スキーマ Zip | ファイルの例 Zip | コード例 Zip (スキーマとサンプル ファイルを含む) | Notes |
---|---|---|---|---|---|
0.5.46 | 2024 年 5 月 21 日 | ダウンロード | ダウンロード | ダウンロード | 追加private_auction private_auction_eligible chrome_traffic_label を標準フィードに設定します。 |
0.5.44 | 2024 年 2 月 21 日 | ダウンロード | ダウンロード | ダウンロード | 追加split_id external_campaign_id external_bidrequest_id external_bidrequest_imp_id postal_code_ext_id 次の値が既存 event_type のフィールドに追加されます。click served started skipped error 25_pct 50_pct 75_pct 100_pct |
0.5.43 | 2024 年 1 月 2 日 | ダウンロード | ダウンロード | ダウンロード | ビデオ イベント フィードに追加vg_id |
0.5.42 | 2023 年 11 月 10 日 | ダウンロード | ダウンロード | ダウンロード | キュレーター フィードに追加curated_deal_code |
0.5.41 | 2023 年 10 月 30 日 | ダウンロード | ダウンロード | ダウンロード | ブランド/購入者の透明性フィードに と external_bidrequest_imp_id を追加しましたexternal_bidrequest_id 。 |
0.5.37 | 2023 年 6 月 22 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードに追加されましたregion_id 。 |
0.5.36 | 2023 年 5 月 2 日 | ダウンロード | ダウンロード | ダウンロード | data_costs Standard フィードから非推奨になりました。 |
0.5.35 | 2023 年 3 月 8 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードに追加されましたfallback_ad_index 。 |
0.5.31 | 2023 年 2 月 1 日 | ダウンロード | ダウンロード | ダウンロード | 標準フィードに と feature_costs を追加しましたsegment_data_costs 。 |
0.5.27 | 2021 年 11 月 1 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードとキュレーター フィードに新しいフィールド extended_ids が追加されました。 |
0.5.26 | 2021 年 10 月 14 日 | ダウンロード | ダウンロード | ダウンロード | Buyer Transparency Feed (brand_transparency_feed ) は、完全にサポートされているログ レベル フィードになりました (以前はアルファ リリースでした)。 |
0.5.25 | 2021 年 9 月 8 日 | ダウンロード | ダウンロード | ダウンロード | 2 つの新しいフィールド device_unique_id と ip_address が 増分フィードに追加されました。 |
0.5.24 | 2021 年 7 月 22 日 | ダウンロード | ダウンロード | ダウンロード | 新しいフィールド ( postal_code_ext ) が Standard フィードに追加されました。 |
0.5.22 | 2021 年 7 月 21 日 | ダウンロード | ダウンロード | ダウンロード | キュレーター フィードにフィールドを追加しましたdevice_id 。 これらの ID 値は、Xandr API Device Model Service を使用して検索できます。 |
0.5.21 | 2021 年 6 月 18 日 | ダウンロード | ダウンロード | ダウンロード | キュレーター フィードに、3 つの新しいフィールド 、operating_system browser 、、および language を追加しました。 これらの値は、それぞれ Xandr API オペレーティング システム サービス、 ブラウザー サービス、および Language Service を使用して検索できます。 |
0.5.20 | 2021 年 5 月 20 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードに新しいフィールド device_make_id を追加しました。 フィールドには、デバイスの製造元 (Samsung など) であるデバイスの ID が含まれています。 デバイスメイク ID を名前にマップするには、 Device Make Service を使用します。 |
0.5.18 | 2021 年 4 月 19 日 | ダウンロード | ダウンロード | ダウンロード | キュレーター フィード (curator_feed ) に拡張機能を追加しました。 |
0.5.15 | 2021 年 3 月 31 日 | ダウンロード | ダウンロード | ダウンロード | - Standard フィードに新しいフィールド 、 personal_identifiers を追加しました。 "繰り返し" タイプのこのフィールドは、取引済み、非取引、表示インプレッションの購入者と販売者の両方に表示されます。 - キュレーター フィード ( curator_feed ) の初期バージョンを追加しました。 |
0.5.10 | 2021 年 2 月 4 日 | ダウンロード | ダウンロード | ダウンロード | - 購入者の透明性フィードに次の変更が加えられています。 (インデックス 9 ) の下に次のフィールドがbid message 追加されました。external_campaign_id insertion_order_id bidder_seat_id bidder_seat_name フィールドは sasc_cap_savings 、 (インデックス10 ) の下にresult message 追加されました。 custom_parameters - ユニバーサル ピクセル フィードのフィールド (インデックス17 ) が、省略可能なフィールドから繰り返しフィールドに変更されました。 追加されたフィールドの詳細については、個々のフィードのドキュメントを参照してください。 |
0.5.7 | 2020 年 4 月 6 日 | ダウンロード | ダウンロード | ダウンロード | ユニバーサル ピクセル フィードに 4 つの新しいフィールドを追加しました。 新しいフィールドは次のとおりです。 - traffic_type - ピクセルによって追跡されるトラフィックのソース。 使用可能な値は、 または です WEB 。 APP - application_id - ピクセルが配置されている (アプリ ストア内の) アプリケーションの ID。 この値は、数値または英数字 (例: com.xandr.application_name ) にすることができます。- device_unique_id - モバイル デバイスを表す一意の識別子 (このフィールド null の値は、特定の統合を除きます)。 数値プレフィックスは、一意のデバイス識別子の種類を示します。0 = IDFA (広告用 Apple ID)1 = SHA12 = MD53 = ODIN4 = OPENUDID5 = AAID (Android 広告 ID)6 = WINDOWSADID (Microsoft Advertising ID)。 - custom_parameters - ピクセル火災で送信されたすべてのカスタム パラメーターが含まれます。 |
0.5.4 | 2020 年 1 月 27 日 | ダウンロード | ダウンロード | ダウンロード | 新しい ユニバーサル ピクセル フィードのリリースに使用するスキーマの修正。 |
0.5.2 | 2019 年 11 月 7 日 | ダウンロード | ダウンロード | ダウンロード | LLD の標準フィードに新しいexternal_campaign_id フィールドを追加しました。 この新しいオプション フィールドは、再販インプレッション行の販売者にのみ表示されます。 このフィールドの値は、DSP の入札の cid フィールドを介して渡されます。 cid フィールドは省略可能であるため、新しいexternal_campaign_id フィールドには、外部の DSP が入札時にのみデータを設定します。 フィールドの詳細については、 Open RTB 仕様 を cid 参照してください。 |
0.5.1 | 2019 年 9 月 10 日 | ダウンロード | ダウンロード | ダウンロード | - Standard フィードに追加されましたpartner_fees 。 - データのデータベースへの読み込みとパーティション分割を簡略化するために、すべてのフィードにフィールドを追加しました partition_time_millis 。 - 匿名化された個人データのみを必要とするクライアントの [コンバージョン ピクセル] フィードと [セグメント フィード] にフィールドを追加しました hashed_user_id_64 。 |
0.4.4 | 2019 年 5 月 29 日 | ダウンロード | ダウンロード | ダウンロード | 標準フィードに追加されました tc_string 。 |
0.3.4 | 2019 年 4 月 10 日 | ダウンロード | ダウンロード | ダウンロード | 標準フィードに追加されました split_id 。 |
0.3.3 | 2019年4月5日 | ダウンロード | ダウンロード | ダウンロード | - セグメント フィードに追加されました hashed_user_id_64 。 - 標準の未翻訳フィードに 、 latitude_trunc 、longitude_trunc を追加hashed_user_id_64 しました。 |
0.3.0 | 2018 年 10 月 4 日 | ダウンロード | ダウンロード | ダウンロード | - Avro スキーマとサンプル ファイルを追加しました - レコードごとのパーティション フィルター処理用のすべてのフィードに列を追加しました partition_time_millis |
0.2.4 | 2018 年 8 月 23 日 | ダウンロード | ダウンロード | ダウンロード | - 標準フィード スキーマから削除 ( hashed_device_unique_id 使用されなくなった)- 標準の未翻訳フィードのスキーマを追加しました |
0.1.9 | 2018 年 4 月 12 日 | ダウンロード | ダウンロード | ダウンロード | - protobuf バージョンの指定を許可します (例: )。 -Dprotobuf.version="2.5.0" - proto3 で生成されたコードを操作するための修正プログラム付きスキーマ クラス ファインダー |
0.1.8 | 2018 年 3 月 16 日 | ダウンロード | ダウンロード | ダウンロード | proto3 で proto ファイルをコンパイルできるようにするための proto2 構文ヒントを追加しました |
0.1.7 | 2018 年 3 月 12 日 | ダウンロード | ダウンロード | ダウンロード | Protobuf 区切りが GZIP 圧縮され、それに応じて更新されたサンプル コードになりました |
0.1.6 | 2018 年 3 月 7 日 | ダウンロード | ダウンロード | ダウンロード | さまざまな関連する LLD スキーマに匿名化された個人データ フィールドを追加しました |
0.1.4 | 2017 年 12 月 8 日 | ダウンロード | ダウンロード | ダウンロード | 列を に追加しましたimps_for_budget_caps_pacing standard_feed |
0.1.3 | 2017年10月17日 | ダウンロード | ダウンロード | ダウンロード | 最初のリリース |
Protobuf (シーケンス ファイルでラップされたプロトコル バッファー)
重要
現在、バージョン 2.5.0 の protobuf のみがサポートされています。
ファイルは、各レコードの値が BytesWriteable であり、そのペイロードがエンコードされたプロトコル バッファー メッセージである Snappy 圧縮 Hadoop Sequence ファイルです。
すべてのスキーマでは、フィールドが省略可能であり、 null
値が protobuf メッセージの未設定フィールドであることを指定します。 フィールドの値null
の原因となる条件と、列の可用性の詳細については、「ログ レベル のデータ フィード」の下の個々のフィードを参照してください。
protobuf コンパイラをインストールして構成する方法と、スキーマとサンプル コードを含むプロジェクトをダウンロードする方法については、「Protobuf のインストールと構成」を参照してください。
Protobuf 区切り (プロトコル バッファー)
重要
現在、バージョン 2.5.0 の protobuf のみがサポートされています。
ファイルは、長さ区切りの プロトコル バッファー メッセージを含む GZIP 圧縮ファイルです。 各レコードは、メッセージの長さを指定する varint で、その後に protobuf メッセージ自体が続きます。 protobuf 形式の代わりに protobuf で区切られた形式を使用する理由の 1 つは、protobuf で区切られたファイルを読み取る場合、ネイティブの Snappy サポートを使用して Hadoop または Hadoop を必要としないことです。
すべてのスキーマでは、フィールドが省略可能であり、 null
値が protobuf メッセージの未設定フィールドであることを指定します。 フィールドの値null
の原因となる条件と、列の可用性の詳細については、個々のフィード サービス ページを参照してください。
protobuf コンパイラをインストールして構成する方法、およびスキーマとサンプル コードを含むプロジェクトをダウンロードする方法については、「Protobuf のインストールと構成」を参照してください。
アブロ
Avro は、スキーマとデータをバンドルするデータシリアル化フレームワークです。 圧縮には、DEFLATE コーデック (レベル = 1) が使用されます。 詳細については、 Avro のドキュメントを参照してください。
注:
protobuf 形式とは異なり、 null
値は使用されません。 フィールドが見つからないか未設定の場合、フィード スキーマで指定されている既定値でエンコードされます。
Avro は、既存のサード パーティ製クラウド システムとの統合を簡素化するために提供されます。 統合のテスト中に非互換性が見つかったため、protobuf の "enum
" フィールドは Avro "int
" として送信されます。