FTP入站数据文件的名称和文件大小要求

描述向Audience Manager发送数据时需要遵循的必填字段、语法、命名约定和文件大小。将数据发送到Audience ManagerFTP目录时，根据这些规范设置文件的名称和大小。

警告

我们正在逐步取消对FTP配置的支持。尽管现有FTP集成仍支持入站数据文件摄取，但我们强烈建议使用Amazon S3载入离线数据，进行新集成。有关详细信息，请参阅入站数据文件的 Amazon S3 名称和文件大小要求。

注意

文本样式（monospaced text、斜体、括号 [ ] ( ) 等）在此文档中指示代码元素和选项。请参阅代码和文本元素的样式约定，以了解更多信息。

文件名语法

FTP 文件名包含以下必需和可选元素：

ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

有关其他已接受的文件名格式，请参阅自定义合作伙伴集成。

注意

Audience Manager 仅处理 ASCII 和编 UTF-8 码文件。

命名元素

表定义FTP文件名中的元素。

文件名元素	描述
`ftp_dpm_`	Audience Manager FTP目录的路径和名称。请与客户经理联系以获取FTP目录和凭据。
`DPID`	一个lD，它告知Audience Manager数据文件是否包含您自己的用户ID、Android ID、iOS ID或属于全局数据源的其他ID。接受以下选项：数据源ID(也称为数据提供者 ID)：这是Audience Manager分配给数据源的唯一ID(请参阅ID的Audience Manager 索引)。在发送包含您自己的用户ID的数据时，请在文件名中使用此分配的ID。例如，`...ftp_dpm_21_123456789.sync`告诉Audience Manager将数据载入属于数据源21的ID。 Android ID(GAID)：如果数据文件包含Android ID，请在数据文件名中使用ID 20914。使用Android ID时，需要使用字段`_DPID_TARGET_DATA_OWNER`。例如，`...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync`告诉Audience Manager，数据文件仅包含Android ID,ID应符合属于`_DPID_TARGET_DATA_OWNER`数据源的特征。 iOS ID(IDFA)：如果数据文件包含iOS ID，请使用数据文件名中的ID 20915。使用iOS ID时，需要使用字段`_DPID_TARGET_DATA_OWNER`。例如，`...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync`告诉Audience Manager，数据文件仅包含iOS ID,ID应符合属于`_DPID_TARGET_DATA_OWNER`数据源的特征。属于其他全局数据源的ID:您可以加入Roku ID for Advertising(RIDA)、Microsoft Advertising ID(MAID)和其他ID。按照全局数据源文章中的说明，使用与每个数据源对应的ID。注意：请勿在数据文件中混合使用ID类型。例如，如果您的文件名包含Android标识符，则不要将iOS ID或您自己的ID放入数据文件中。
`_DPID_TARGET_DATA_OWNER`	此字段告知Audience Manager要将数据载入哪个数据源。如果将DPID设置为Android ID、iOS ID或属于全局数据源的其他ID，则此字段为必填字段。这允许Audience Manager将文件数据链接回您的组织。例如： `...ftp_dpm_33_21_1234567890.sync` 告诉Audience Manager您对属于数据源33的客户ID有资格获得属于数据源21的特征或信号。 Android ID(GAID)：告 `...ftp_dpm_20914_21_1234567890.sync` 诉受众管理器，数据文件仅包含Android ID，且ID应符合属于数据源21的特征。 iOS ID(IDFA)：告 `...ftp_dpm_20915_21_1234567890.sync` 诉受众管理器，数据文件仅包含iOS ID，且ID应符合属于数据源21的特征。属于其他全局数据源的ID: `...ftp_dpm_121963_21_1234567890.sync` 告知受众管理者数据文件仅包含Roku ID，且ID应符合属于数据源21的特征。按照全局数据源文章中的说明，使用与每个数据源对应的ID。
`(.sync \|.overwrite)`	同步选项包括： `sync`:第三方数据提供者按用户发送要在Audience Manager系统中添加或删除的特征时的正常情况。 `overwrite`:允许客户和数据提供者按用户发送一列表特征，该特征应覆盖Audience Manager中给定数据源的此用户的所有现有特征。无需将所有用户都包含在覆盖文件中。仅包含要更改的用户。未分配给目标数据源的特征将不被擦除。
`[SPLIT_NUMBER]`	整数。将大型文件拆分为多个部分以缩短处理时间时使用。数字表示要发送的原始文件的哪个部分。为了有效处理文件，请按照以下说明拆分数据文件：未压缩：1 GB 压缩：200-300 MB 请参见下面前2个文件名示例。
`TIMESTAMP`	10位数的UTC UNIX时间戳（秒）。时间戳有助于使每个文件名都是唯一的。
`[.gz]`	Gzip是允许的FTP文件名压缩格式。如果使用文件压缩，请确保文件名的扩展名正确。压缩文件必须为3 GB或更小。如果文件较大，请咨询客户服务。尽管Audience Manager可以处理大型文件，但我们可能可以帮助您减小文件大小并提高数据传输效率。请参阅入站数据传输文件的文件压缩。