バッチ ログ レベル データ (LLD) を使用すると、Xandr UI または API Report Service を介してバッチ処理された方法で使用できないディメンションを含むログ レベルのイベント データのフィードを取得および追跡できます。 フィードは 1 時間ごとに生成され、1 つ以上のファイルに分割されます (下記 の「ファイル形式」 を参照)。 受信するファイルの形式は、サブスクライブ時に指定した内容によって異なります (例: Avro、Protobuf、Protobuf-delimited)。
ログレベルデータの詳細については、[ログレベルデータフィード](log level-data-feeds.md)を参照してください。
ファイル形式 & スキーマ
サービスに加入するときに、次の形式の 1 つ以上を指定できます。
パッケージ化されたサンプル ファイルとログ レベル データ ファイルを使用するためのコードについては、次のダウンロードを使用します。
注:
ログ レベル データ ファイルの使用に使用する実装をテストするときに役立つサンプル ファイルが作成されます。 テストを容易にするために、サンプル ファイルは、実稼働環境で取得する生成ファイルよりもやや単純です。
- protobuf 形式のサンプル ファイルは圧縮されません (本番環境では、Snappy 圧縮されています)
- サンプル データには、特定の列の一般的な値は含まれません。 代わりに、列の型に変換された列のインデックス番号が列に設定されます。
| バージョン | リリース日 | スキーマ Zip | Example Files Zip | コード 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 to Standard Feed. |
| 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 日 | ダウンロード | ダウンロード | ダウンロード | 新しいフィールド extended_ids が Standard フィードとキュレーター フィードに追加されました。 |
| 0.5.26 | 2021 年 10 月 14 日 | ダウンロード | ダウンロード | ダウンロード |
購入者の透明性フィード (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 オペレーティング システム サービス、 ブラウザー サービス、 言語サービスを それぞれ使用して検索できます。 |
| 0.5.20 | 2021 年 5 月 20 日 | ダウンロード | ダウンロード | ダウンロード | 新しいフィールド device_make_id をStandardフィードに追加しました。 このフィールドには、デバイス製造元の ID (通常はデバイスの製造元 (Samsung など) が含まれます。 デバイス作成 ID を名前にマップするには、 デバイス作成サービスを使用します。 |
| 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 result message (インデックス 10) の下に sasc_cap_savings フィールドが追加されました。 - ユニバーサルピクセルフィードの 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 広告識別子) 6 = WINDOWSADID (Microsoft 広告 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 日 | ダウンロード | ダウンロード | ダウンロード | proto2 構文のヒントを追加し、proto3 で proto ファイルをコンパイルできるようにしました |
| 0.1.7 | 2018 年 3 月 12 日 | ダウンロード | ダウンロード | ダウンロード | Protobuf-delimited が 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 (シーケンス ファイルでラップされたプロトコル バッファー)
重要
現在、protobuf のバージョン 2.5.0 のみがサポートされています。
Files は Snappy 圧縮された Hadoop シーケンス ファイルで、各レコードの値は BytesWriteable であり、そのペイロードはエンコードされたプロトコル バッファ メッセージです。
すべてのスキーマは、フィールドがオプションであり、 null 値は protobuf メッセージの未設定フィールドであることを指定します。 フィールドの値がnullになる原因となる条件と、列の使用可能性の詳細については、[ログ レベル データ フィード] の個々のフィードを参照してください。
protobuf コンパイラをインストールして設定する方法、およびスキーマとサンプル コードを含むプロジェクトをダウンロードする方法については、「 Protobuf のインストールと構成 」を参照してください。
Protobuf-delimited (プロトコル バッファー)
重要
現在、protobuf のバージョン 2.5.0 のみがサポートされています。
Files は、長さで区切られたプロトコル バッファー メッセージを含む GZIP 圧縮ファイルです。 各レコードは、メッセージの長さを指定する varint であり、その後に protobuf メッセージ自体が続きます。 protobuf 形式の代わりに protobuf 区切り形式を使用する理由の 1 つは、protobuf 区切りファイルの読み取りに Hadoop またはネイティブ Snappy サポートを備えた Hadoop を必要としないことです。
すべてのスキーマは、フィールドがオプションであり、 null 値は protobuf メッセージの未設定フィールドであることを指定します。 フィールドの値がnullになる条件および列の使用可能の詳細については、個々のフィード サービス ページを参照してください。
protobuf コンパイラをインストールして設定する方法、およびスキーマとサンプルコードを含むプロジェクトをダウンロードする方法については、「 Protobuf のインストールと構成 」を参照してください。
Avro
Avro は、スキーマとデータをバンドルするデータ シリアル化フレームワークです。 圧縮には、DEFLATE コーデック (レベル = 1) が使用されます。 詳細については、 Avro のドキュメントを参照してください。
注:
protobuf 形式とは異なり、 null 値は使用されません。 存在しないフィールドまたは未設定のフィールドは、フィード スキーマで指定されているように、既定値でエンコードされます。
Avro は、既存のサードパーティのクラウド システムと簡単に統合できるように提供されています。 統合のテスト中に非互換性が見つかったため、protobuf で "enum" のフィールドは Avro "int" として送信されます。