Customer Data Feeds customer-data-feeds

Customer Data Feed（CDF）ファイルに関する基本情報と導入方法の説明です。CDFファイルの受信に関心がある場合や詳細を知りたい場合は、ここから始めてください。

ファイルの内容と目的 file-contents-purpose

CDF ファイルには、Audience Manager イベント呼び出し（/event）でサーバーに送信されるデータと同じものが含まれています。ユーザー ID、trait IDs、segment IDs など、イベント呼び出しで表されるあらゆるパラメーターが含まれます。Audience Manager の内部システムがイベントデータを処理して CDF ファイルを生成します。このファイルの内容は、所定の順序で出現するフィールドで構成されます。Audience Manager は、時間ごとに CDF ファイルの生成を試み、Amazon S3 サーバー上のセキュリティで保護された顧客専用バケットにファイルを保存します。これらのファイルが提供されているのは、ユーザーインターフェイス上の制限を受けずに Audience Manager データを扱えるようにするためです。

はじめに getting-started

CDFファイル配信を開始するためのセルフサービスプロセスはありません。開始するには、担当の Audience Manager コンサルタントまたはカスタマーケアに問い合わせてください。実装時に Audience Manager 担当者は以下をおこないます。

ファイルのダウンロード準備ができたら、ファイル通知と CDF ファイルが S3 バケットに表示されます。割り当てられた S3 ディレクトリ内のファイルの監視やダウンロードは、ユーザー自身がおこないます。顧客データフィードファイル処理の通知。

次の手順 next-steps

このサービスの詳細については、以下の節および顧客データフィードの FAQ を参照してください。

Customer Data Feed定義済みコンテンツ cdf-defined

CDFファイルのデータ要素および配列を出現順に列挙し定義します。定義にはデータタイプが含まれていますが、この情報は CDF ファイルには含まれていません。

定義 definitions

CDF ファイルには、以下に定義するフィールドの一部または全部が含まれています。内部ファイル組織について詳しくは、顧客データフィードファイルの構造を参照してください。

Customer Data Feedファイル構造 cdf-file-structure

CDF ファイルのデータ構造を一覧表示および定義します。データ列、フィールド区切り文字、データファイルマップ、サンプルファイルが含まれています。

データフィールド識別子とデータ列 identifiers-and-sequence

CDF ファイルには、ラベル付きの列やフィールドヘッダーは含まれていません。代わりに、CDF ファイルでは非表示の ASCII 文字でフィールドと配列を定義します。また、CDF ファイルでは各フィールドと配列が特定の順序で並んでいます。フィールドの識別子と順序を理解すると、ファイルを適切に解析するうえで役に立ちます。

CDFファイルマップ cdf-file-map

CDF ファイルデータの出現順序は以下のとおりです。

配列の識別

CDF ファイル内の配列は Ctrl + a フィールド区切り文字で始まり、同じ区切り文字で終わります。これにより、配列の先頭要素は単独のデータフィールドのように見えます。例えば、適合済みtraitsの配列は ^A1234 で始まります。このエントリの後に、配列の区切り文字と ID ^B5678 が続きます。そのため、（^B で始まっているので）適合済みtraitsの配列の先頭要素が ID 5678 であると考えてしまうかもしれません。しかし、実際にはそうではありません。だからこそ、データファイルのデータ列と構造に熟知する必要があるのです。適合済みtraitの配列（または CDF ファイルに含まれている他の任意の配列）の先頭要素が ^A で始まっている場合であっても、ファイル内の出現順序や位置によって配列の開始が決まります。また、配列の先頭要素は必ず ^A で先行エントリと区切られます。

サンプル CDF ファイル sample-file

サンプル CDF ファイルは例えば次のようになります。このサンプルには、ページに合わせて改行が挿入されています。

Customer Data Feed ファイル命名規則 cdf-naming-conventions

CDF ファイル名の構成要素を次の表に列挙し定義します。

CDF ファイル名：構文と例 cdf-file-name

典型的な CDF ファイル名は以下の要素で構成されています。なお、斜体 ​の部分には実際の情報が入ります。

構文

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF_PARTNER-ID_FILE-SEQUENCE_0.gz

例

s3://aam-cdf/dataCompany/day=2017-09-14/hour=17/AAM_CDF_1234_0_0_0.gz

S3 ストレージバケットでは、ファイルはパートナー ID（PID）、日、時で昇順にソートされます。

CDF ファイル名要素の定義 cdf-file-name-elements

CDF ファイル名の構成要素を次の表に列挙し定義します。

Customer Data Feedファイル処理の通知 cdf-file-processing-notifications

Audience Manager は、ファイルのダウンロード準備が完了したことを知らせるために、Customer Data File（CDF）のダウンロード準備ができたことを知らせるために、S3 ディレクトリに .info ファイルを書き込みます。.info ファイルには、CDF ファイルの内容に関する JSON 形式のメタデータも含まれています。この通知ファイルで使用されている構文やフィールドについては、このセクションで確認してください。

サンプル .info ファイル sample-info-file

各 .info ファイルは、Files と Totals の 2 つのセクションで構成されます。Files セクションには、時間ごとのファイルの特定の指標を格納した配列が含まれています。Totals セクションには、特定の日のすべての CDF ファイルについて集計した指標が含まれています。.info ファイルの内容は、例えば次のようになります。

{
    "Files": [
        {
            "FileByteSize": 2709730,
            "FileChecksumMD5": "a9ea418e79511642cff11c2a898037dc-1",
            "FileName": "AAM_CDF_1109_000000_0.gz",
            "FileSequenceNumber": 1
        },
        {
            "FileByteSize": 2783351,
            "FileChecksumMD5": "7b469485d60274b6991acd0817855840-3",
            "FileName": "AAM_CDF_1109_000001_0.gz",
            "FileSequenceNumber": 2
        }
    ],
    "Totals": {
        "Day": "2017-09-26",
        "Hour": "18",
        "TotalByteSize": 150092997,
        "TotalNumberFiles": 2
    }
}

Info ファイルの各フィールドの定義 info-file-fields-defined

以下の表に、CDF .info ファイルの構成要素の一覧と説明を示します。

Files オブジェクト

Totals オブジェクト

Customer Data Feedファイル名の時間とファイルコンテンツの時間が異なる different-processing-times

CDF ファイルでは、ファイル名とファイルコンテンツにタイムスタンプが含まれています。これらのタイムスタンプは、同じ CDF ファイルに対する異なるイベントプロセスを記録します。同じファイルの名前とコンテンツに異なるタイムスタンプが表示されることは珍しくありません。各タイムスタンプを理解すると、このデータを操作したり時刻でソートしようとしたりするときに、犯しがちなミスを避けるうえで役に立ちます。

CDF ファイルのタイムスタンプの場所 locating-timestamps

CDF ファイルでは、2 つの別個の場所に異なる時刻を記録します。

タイムスタンプの違いについて understanding-timestamps

CDF ファイルのタイムスタンプの詳細とそれらの適切な使い方を次の表に示します。