データフィードの内容 - 概要

このセクションでは、データフィード配信に含まれるファイルについて説明します。

マニフェストファイル

マニフェストファイルには、アップロードされるデータセット内の各ファイルに関する以下の詳細情報が含まれます。

• ファイル名
• ファイルサイズ
• MD5 ハッシュ
• ファイルに含まれるレコードの数

マニフェストファイルは、Java JAR マニフェストファイルと同じ書式に従います。

マニフェストファイルは、別個の .txt ファイルとして常に最後に配布されるので、このファイルの存在は、対象リクエスト期間のデータセット全体が配信済みであることを示します。マニフェストファイルには以下の書式の名前が付けられます。

[rsid]_[YYYY-mm-dd].txt

一般的なマニフェストファイルには以下のようなデータが含まれています。

Datafeed-Manifest-Version: 1.0
 Lookup-Files: 1
 Data-Files: 1
 Total-Records: 611

 Lookup-File: rsid_date-lookup_data.tar.gz
 MD5-Digest: af6de42d8b945d4ec1cf28360085308
 File-Size: 63750

 Data-File: 01-rsid_date.tsv.gz
 MD5-Digest: 9c70bf783cb3d0095a4836904b72c991
 File-Size: 122534
 Record-Count: 611

すべてのマニフェストファイルに、参照ファイルの合計数、データファイルの合計数、全データファイル内のレコードの合計数を示すヘッダーが含まれています。このヘッダーの後に、データフィード配信に含まれる各ファイルの情報が記述された複数のセクションが続きます。

.fin ファイルのマニフェストの代わりに .txt ファイルを受信するようにフィードが設定されている場合もあります。この .fin ファイルは、アップロードが完了したことを示しますが、アップロードに関するメタデータを含みません。

参照ファイル

一部のデータフィード列は、実際の値に対応する数値を出力します。ルックアップファイルは、データフィード列の数値を照合し、実際の値と照合するために使用されます。例えば、browser ヒットデータ列の値が「497」の場合は、browser.tsv を見ると、そのヒットが「Microsoft Internet Explorer 8」からのヒットであることがわかります。

column_headers.tsv と event_list.tsv はそのデータフィードとレポートスイートに固有のファイルです。それ以外のファイル（browser.tsv など）は汎用ファイルです。

参照ファイルは次の書式の名前を持つ 1 つのファイルに圧縮されて配信されます。

[rsid]_[YYYY-mm-dd]-lookup_data.[compression_suffix]

• column_headers.tsv（このデータフィード用にカスタマイズされています）
• browser.tsv
• browser_type.tsv
• color_depth.tsv
• connection_type.tsv
• country.tsv
• javascript_version.tsv
• languages.tsv
• operating_systems.tsv
• plugins.tsv
• resolution.tsv
• referrer_type.tsv
• search_engines.tsv
• event_lookup.tsv（このデータフィード用にカスタマイズされています）

ヒットデータファイル

ヒットデータは hit_data.tsv ファイルで提供されます。このファイルに含まれるデータの分量は、配信形式（時間別または日別、および単一ファイルまたは複数ファイル）によって異なります。このファイルにはヒットデータのみが含まれます。列ヘッダーは、参照ファイルと一緒に別途配信されます。このファイル内の各行には 1 個のサーバーコールが含まれます。

アドビから配信されるファイルは、設定したデータフィードの種類によって異なります。すべてのファイルは ISO-8859-1 を使用してエンコードされます。

• [rsid] は、データフィードの元となるレポートスイート ID を指します。
• [index] は、複数のファイルフィードでのみ使用され、ページ分割されたファイルの正しい順序を示します。
• [YYYY-mm-dd] は、データフィードの開始日を示します。
• [HHMMSS] は時間別フィードでのみ使用され、データフィードの開始時間を示します。
• [compression_suffix] は、使用される圧縮のタイプを指します。通常、データフィードは tar.gz または zip ファイルに圧縮されます。

日別、単一ファイル

1 日分のデータを収集した後、圧縮データファイルが 1 つ以上とマニフェストファイル 1 つを受け取ります。データファイルの名前は次のようになります。

[rsid]_[YYYY-mm-dd].[compression_suffix]

展開すると、各データファイルにはその日のすべてのデータを含む hit_data.tsv が 1 つと、必要な列のルックアップファイルが含まれています。

毎日、複数のファイル

1 日分のデータを収集した後、圧縮データファイル 1 つ以上とマニフェストファイル 1 つを受け取ります。データファイルの名前は次のようになります。

[index]-[rsid]_[YYYY-mm-dd].[compression_suffix]

展開すると、各データファイルには約 2GB の非圧縮データを含む hit_data.tsv が 1 つと、必要な列のルックアップファイルが含まれています。

時間別、単一ファイル

1 時間分のデータを収集した後、圧縮データファイルが 1 つ以上とマニフェストファイル 1 つが届きます。データファイルの名前は次のようになります。

[rsid]_[YYYYmmdd]-[HHMMSS].[compression_suffix]

展開すると、各データファイルにはその時間のすべてのデータを含む hit_data.tsv が 1 つと、必要な列のルックアップファイルが含まれています。

時間別、複数のファイル

1 時間分のデータを収集した後、圧縮データファイル 1 つ以上とマニフェストファイル 1 つを受け取ります。データファイルの名前は次のようになります。

[index]-[rsid]_[YYYYmmdd]-[HHMMSS].[compression_suffix]

展開すると、各データファイルには約 2GB の非圧縮データを含む hit_data.tsv が 1 つと、必要な列のルックアップファイルが含まれています。

データファイルサイズ

ヒットデータのファイルサイズは、レポートスイートでアクティブに使用される変数の数、およびレポートスイートに送信されたトラフィック量に応じて大きく異なります。ただし、データ 1 行の平均は約 500B（圧縮時）または 2KB（非圧縮時）です。これにサーバーコールの数をかけることによって、データフィードファイルのおおよその大きさを概算できます。組織がデータフィードファイルの受信を開始すると、hit_data.tsv の行数を合計ファイルサイズで割ることで、より正確な数を算出できます。