次の節では、データフィード配信で見つかったファイルにアクセスし理解する方法について説明します。
データフィードのコンテンツにアクセスするには:
データフィードの宛先サイトにログインします。
これは、Amazon S3 やGoogle Cloud Platform バケットなど、データフィードを作成する際に設定する宛先サイトです。
圧縮データフィードファイルをローカルマシンにダウンロードします。
.tar.gz
ファイル拡張子をサポートするプログラムを使用して、圧縮ファイルを解凍します。
スプレッドシートまたはデータベースアプリケーションで hit_data.tsv
ファイルを開き、その日の生データを確認します。 —>
マニフェストファイルには、アップロードされるデータセット内の各ファイルに関する以下の詳細情報が含まれます。
マニフェストファイルは、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
:列ヘッダーを含む単一の行 hit_data.tsv
.browser.tsv
:ブラウザー ID( browser
フィード列 ) をブラウザーのわかりやすい名前に変更する必要があります。browser_type.tsv
:ブラウザー ID( browser
フィード列 ) をブラウザーのタイプに追加する必要があります。color_depth.tsv
:色深度 ID( color
フィード列 ) を色深度に変更します。connection_type.tsv
:接続タイプ ID ( connection_type
フィード列 ) を接続タイプに追加します。country.tsv
:国 ID( country
フィード列 ) を国名に追加する必要があります。javascript_version.tsv
:JavaScript バージョン ID ( javascript
フィード列 ) を JavaScript バージョンに追加する必要があります。languages.tsv
:言語 ID ( language
フィード列 ) を言語に追加します。operating_systems.tsv
:オペレーティングシステム ID( os
フィード列 ) をオペレーティングシステム名に追加します。plugins.tsv
:プラグイン ID( plugin
フィード列 ) を各プラグイン名に追加する必要があります。resolution.tsv
:解像度 ID ( resolution
フィード列 ) を画面の解像度に合わせて表示します。referrer_type.tsv
:リファラータイプ ID( ref_type
フィード列 ) をリファラータイプに追加します。search_engines.tsv
:検索エンジン ID( search_engine
フィード列 ) を検索エンジン名に追加します。event.tsv
:各イベント ID( event_list
フィード列 ) をそれぞれのイベント名に追加する必要があります。ヒットデータは 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
の行数を合計ファイルサイズで割ることで、より正確な数を算出できます。