次の方法で共有


バッチ ログ レベルのデータ

バッチ ログ レベル データ (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_costsStandard フィードから非推奨になりました。
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_idip_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_systembrowser、、および 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 - ピクセルによって追跡されるトラフィックのソース。 使用可能な値は、 または です WEBAPP
- 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 の標準フィードに新しい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_trunclongitude_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_pacingstandard_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" として送信されます。