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

以下章節及客戶資料摘要常見問題集可協助您更熟悉此服務。

已定義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開頭。 陣列分隔符號和識別碼^B5678會依循此專案。 因此，您可能會認為已實現的traits陣列中的第一個元素識別碼5678 （因為它以^B開頭）。 但事實並非如此，因此您需要熟悉資料檔案的順序和結構。 即使已實現的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會將.info檔案寫入您的S3目錄，以便在您的Customer Data File (CDF)準備下載時通知您。 .info檔案也包含有關CDF檔案內容的JSON格式化中繼資料。 請參閱本節，瞭解此通知檔案使用的語法和欄位。

範例資訊檔案 sample-info-file

每個.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
    }
}

已定義的資訊檔案欄位 info-file-fields-defined

下清單格列出並定義CDF .info檔案中的專案。

檔案物件

總計物件

Customer Data Feed檔案名稱時間和檔案內容時間不同 different-processing-times

您的CDF檔案在檔案名稱和檔案內容中包含時間戳記。 這些時間戳記會針對相同的CDF檔案記錄不同的事件程式。 在同一個檔案的名稱和內容中看到不同的時間戳記是很常見的現象。 瞭解每個時間戳記可協助您在處理此資料或嘗試依時間排序資料時，避免常見錯誤。

找到CDF個檔案時間戳記 locating-timestamps

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

瞭解時間戳記之間的差異 understanding-timestamps

下表提供有關您的CDF檔案時間戳記的更多詳細資料，以及如何正確使用這些時間戳記的資訊。