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檔案時間戳的其他詳細資訊，以及如何正確使用這些時間戳的資訊。