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开头。 数组分隔符和ID ^B5678遵循此条目。 因此，您可能认为已实现的traits数组中的第一个元素是ID 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文件中的元素。

Files对象

总计对象

Customer Data Feed文件名时间和文件内容时间不同 different-processing-times

您的CDF文件在文件名和文件内容中包含时间戳。 这些时间戳为同一CDF文件记录不同的事件进程。 在同一文件的名称和内容中看到不同的时间戳并不少见。 了解每个时间戳可以帮助您避免在处理此数据或尝试按时间对数据进行排序时经常会犯的错误。

查找CDF文件时间戳 locating-timestamps

CDF个文件在2个不同位置记录的时间不同。

了解时间戳之间的差异 understanding-timestamps

下表提供了有关CDF文件时间戳的更多详细信息以及如何正确使用它们。