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 文件在两个不同位置记录的时间不同。

了解时间戳之间的差异

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