バッチ ログ レベル データ (LLD) を使用すると、Xandr UI または API Report Service で使用できないディメンションを含むログ レベルのイベント データのフィードを、バッチ処理された方法で取得および追跡できます。 フィードは 1 時間ごとに生成され、1 つ以上のファイルに分割されます (下記の 「ファイル形式 」を参照)。 受信するファイルの形式は、サブスクライブ時に指定した内容 (Avro、Protobuf、Protobuf 区切りなど) によって異なります。
ログ レベル データの一般的な情報については、「ログ レベル のデータ フィード](ログ level-data-feeds.md)」を参照してください。
スキーマ & ファイル形式
サービスをサブスクライブするときに、次の形式の 1 つ以上を指定できます。
パッケージ化されたサンプル ファイルとログ レベル データ ファイルを使用するためのコードについては、次に示すダウンロードを使用します。
注:
ログ レベル データ ファイルの使用に使用する実装をテストするときに役立つサンプル ファイルが作成されます。 テストを容易にするために、サンプル ファイルは、運用環境で取得する生成されたファイルよりもやや簡単です。
- protobuf 形式のファイルの例は圧縮されません (運用環境では、Snappy 圧縮されています)
- データ例には、特定の列に一般的な値が含まれていません。 代わりに、列の型に変換された列のインデックス番号が列に設定されます。
| バージョン | リリース日 | スキーマ Zip | Zip Files例 | コード例 Zip (スキーマとサンプル ファイルを含む) | 備考 |
|---|---|---|---|---|---|
| 0.5.47 | 2026 年 5 月 29 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードにcurator_member_idを追加しました |
| 0.5.46 | 2024 年 5 月 21 日 | ダウンロード | ダウンロード | ダウンロード | 追加 private_auction private_auction_eligible chrome_traffic_label フィードをStandardします。 |
| 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_idとexternal_bidrequest_imp_idを追加しました。 |
| 0.5.37 | 2023 年 6 月 22 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードにregion_idを追加しました。 |
| 0.5.36 | 2023 年 5 月 2 日 | ダウンロード | ダウンロード | ダウンロード |
Standard フィードからの非推奨のdata_costs。 |
| 0.5.35 | 2023 年 3 月 8 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードにfallback_ad_indexを追加しました。 |
| 0.5.31 | 2023 年 2 月 1 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードにsegment_data_costsとfeature_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 日 | ダウンロード | ダウンロード | ダウンロード |
増分フィードには、device_unique_idとip_addressの 2 つの新しいフィールドが追加されました。 |
| 0.5.24 | 2021 年 7 月 22 日 | ダウンロード | ダウンロード | ダウンロード | Standard フィードに新しいフィールド (postal_code_ext) が追加されました。 |
| 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 日 | ダウンロード | ダウンロード | ダウンロード | - 購入者の透明性フィードに次の変更が加えられています。 bid messageの下に次のフィールドが追加されました (インデックス 9)。 external_campaign_id insertion_order_id bidder_seat_id bidder_seat_name sasc_cap_savings フィールドが result message (インデックス 10) の下に追加されました。 - ユニバーサル ピクセル フィードの 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 = SHA1 2 = MD5 3 = ODIN 4 = OPENUDID 5 = AAID (Android 広告 ID) 6 = WINDOWSADID (Microsoft Advertising ID)。 - custom_parameters - ピクセル火災で送信されたすべてのカスタム パラメーターが含まれます。 |
| 0.5.4 | 2020 年 1 月 27 日 | ダウンロード | ダウンロード | ダウンロード | 新しい ユニバーサル ピクセル フィードのリリースに使用するスキーマの修正。 |
| 0.5.2 | 2019 年 11 月 7 日 | ダウンロード | ダウンロード | ダウンロード | LLD のStandard フィードに新しいexternal_campaign_id フィールドを追加しました。 この新しいオプション フィールドは、再販インプレッション行の販売者にのみ表示されます。 このフィールドの値は、DSP の入札の cid フィールドを介して渡されます。
cid フィールドは省略可能であるため、新しいexternal_campaign_id フィールドには、外部の DSP が入札時にのみデータを設定します。 [ cid] フィールドの詳細については、「Open RTB 仕様」を参照してください。 |
| 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 を追加しました。 - hashed_user_id_64、 latitude_trunc、 longitude_trunc を標準の翻訳されていないフィードに追加しました。 |
| 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 のみがサポートされています。
Filesは、各レコードの値が BytesWriteable であり、そのペイロードがエンコードされたプロトコル バッファー メッセージである Snappy 圧縮 Hadoop Sequence ファイルです。
すべてのスキーマでは、フィールドが省略可能であり、 null 値が protobuf メッセージの未設定フィールドであることを指定します。 フィールドの値をnullする条件と、列の可用性の詳細については、「ログ レベル のデータ フィード」の下の個々のフィードを参照してください。
protobuf コンパイラをインストールして構成する方法と、スキーマとサンプル コードを含むプロジェクトをダウンロードする方法については、「Protobuf のインストールと構成」を参照してください。
Protobuf 区切り (プロトコル バッファー)
重要
現在、バージョン 2.5.0 の protobuf のみがサポートされています。
Filesは、長さ区切りのプロトコル バッファー メッセージを含む 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" として送信されます。