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文件还包含JSON格式化的元数据，其中包含有关CDF文件内容的元数据。 有关此通知文件使用的语法和字段的信息，请参阅此部分。

示例信息文件

每个.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文件时间戳的其他详细信息以及有关如何正确使用这些时间戳的信息。