Customer Data Feeds

有關Customer Data Feed (CDF)檔案的基本資訊以及如何開始使用的指示。 如果您想要接收CDF檔案，或只想要更多資訊，請從這裡開始。

檔案內容與用途

CDF 檔案包含的資料與 Audience Manager 事件呼叫 (/event) 傳送至我們伺服器的資料相同。這包括使用者ID、trait IDs、segment IDs等資料，以及事件呼叫所擷取的所有其他參數。 內部Audience Manager系統將事件資料處理為CDF檔案，內容會組織為依固定順序顯示的欄位。 Audience Manager 嘗試每小時產 CDF 生檔案，並將它們儲存在伺服器上安全、客戶專屬的儲 Amazon S3 存貯體。我們提供這些檔案，讓您能夠處理Audience Manager資料，不受使用者介面的限制。

快速入門

沒有啟動CDF檔案傳送的自助服務進程。 請連絡您的Audience Manager顧問或客戶服務以開始使用。 在實施期間，您的Audience Manager代表將：

• 設定您的Amazon S3儲存貯體。
• 為檔案儲存桶提供唯讀S3驗證憑據。 您將無法查看或訪問屬於其他客戶的目錄和檔案。

當檔案通知和CDF檔案準備好下載時，會出現在您的S3儲存貯體中。 您負責從您指派的S3目錄監視和下載檔案。 請參閱客戶資料摘要檔案處理通知。

後續步驟

以下各節和客戶資料饋送常見問答集可協助您更熟悉這項服務。

Customer Data Feed 定義的內容

按外觀順序列出並定義CDF檔案中的資料元素和陣列。 定義包括資料類型，但此資訊不屬於CDF檔案。

定義

CDF檔案包含下面定義的部分或全部欄位。 如需內部檔案組織的詳細資訊，請參閱客戶資料饋送檔案結構。

Customer Data Feed 檔案結構

列出並定義CDF檔案的資料結構。 這包括資料順序、欄位分隔字元和分隔符號、資料檔案地圖和範例檔案。

資料欄位識別碼和序列

CDF 檔案不包含已標示的欄或欄位標題。相反，CDF檔案定義了欄位和陣列，這些欄位和陣列不打印ASCII字元。 此外，CDF檔案還按特定順序列出每個欄位和陣列。 瞭解欄位識別碼和順序有助於正確剖析檔案。

CDF 檔案映射

CDF 檔案資料會依下列順序顯示。

識別陣列

CDF檔案中的陣列以Ctrl + a欄位分隔符開始和結束。 這會使陣列中的第一個元素看起來像獨立的資料欄位。 例如，實現的traits陣列以^A1234開頭。 陣列分隔字元和ID ^B5678會遵循此項目。 因此，您可能會想到實現的traits陣列中的第一個元素是ID 5678（因為它以^B開頭）。 但情況並非如此，因此您需要熟悉資料檔案的順序和結構。 即使實現的trait陣列（或CDF檔案中的任何其它陣列）中的第一個元素以^A開頭，檔案中的外觀或位置順序仍定義了陣列的開頭。 而且，陣列中的第一個元素始終由^A與前一個條目分開。

示例CDF檔案

範例CDF檔案看起來可能類似下列。 我們在此範例中插入了分行符號，以協助它符合頁面。

Customer Data Feed 檔案命名慣例

以下各節列出並定義CDF檔案名稱中的元素。

CDF 檔案名：語法與範例

典型的CDF檔案名包含下列元素。 請注意，斜體字​表示變數預留位置：

語法

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF-PARTNER-ID-AAM PROCESS-ID_0.gz

範例

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

在您的S3儲存貯體中，檔案會依合作夥伴ID(PID)、日和小時的遞增順序排序。

CDF 定義的檔案名元素

下表列出並定義CDF檔案名稱中的元素。

Customer Data Feed 檔案處理通知

Audience Manager 將檔 .info 案寫入 S3 您的目錄，以告知您 Customer Data File (CDF)已準備下載。.info檔案也包含有關CDF檔案內容的JSON格式化中繼資料。 請檢閱本節，以取得有關此通知檔案所使用之語法和欄位的資訊。

範例資訊檔案

每個.info檔案都包含Files和Totals區段。 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
    }
}

定義的資訊檔案欄位

下表列出並定義CDF .info檔案中的元素。

檔案對象

總計物件

Customer Data Feed 檔案名時間和檔案內容時間不同

您的CDF檔案在檔案名稱和檔案內容中包含時間戳記。 這些時間戳記會記錄相同CDF檔案的不同事件進程。 相同檔案的名稱和內容中會出現不同的時間戳記，這種情況並不少見。 瞭解每個時間戳記有助於您避免在處理此資料或嘗試依時間排序時常出錯。

查找CDF檔案時間戳

CDF 檔案在2個不同位置記錄的時間不同。

瞭解時間戳記之間的差異

下表提供有關CDF檔案時間戳記的其他詳細資訊，以及如何正確使用時間戳記的資訊。