Show Menu
主题×

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

描述向发送数据时需要遵循的必填字段、语法、命名约定和文件大小 Audience Manager。 将数据发送到Audience Manager目录时,根据这些规范设置文件的名称和大 FTP 小。
We are gradually phasing out support for FTP configurations. While inbound data file ingestion is still supported in existing FTP integrations, we strongly recommend using Amazon S3 to onboard offline data for new integrations. 有关详细信息,请参阅 入站数据文件的 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 ManagerFTP目录的路径 和名 称。 请与客户经理联系以获取FTP目录和凭据。
DPID
一个D,告诉 Audience Manager ,数据文件是否包含您自己的用户ID、Android或iOS ID。 接受以下选项:
  • 数据合作伙伴ID: 这是Audience Manager分配给您的公司或组织的唯一ID。 在发送包含您自己的用户ID的数据时,请在文件名中使用此分配的ID。 例如,告 ...ftp_dpm_21_123456789.sync 诉Audience Manager ID为 21的合作伙伴发送了文件并包含该合作伙伴分配的用户ID。
  • Android ID(GAID): 如果数据文件包含Android ID,请在数据文件名中使用ID 20914。 例如,告 ...ftp_dpm_20914_123456789.sync Audience Manager ,数据文件仅包含Android ID。
  • iOS ID(IDFA): 如果数据文件包含iOS ID,请在其数据文件名中使用ID 20915。 例如,告 ...ftp_dpm_20915_123456789.sync Audience Manager ,数据文件仅包含iOS ID。
注意: 请勿在数据文件中混合使用ID类型。 例如,如果您的文件名包含Android标识符,则不要在数据文件中放置iOS ID或您自己的ID。
_DPID_TARGET_DATA_OWNER
ID的占位符。 例如,如果将DPID设置为数 据源 ID、Android或iOS ID,则可以将其设置为Audience ManagerID。 这样, Audience Manager 就可以将文件数据链接回您的组织。
例如:
  • ...ftp_dpm_33_21_1234567890.sync 显示ID为21的合作伙伴已从使用ID 33的数据源发送数据。
  • ...ftp_dpm_20914_21_1234567890.sync 显示ID为21的合作伙伴已发送包含Android ID的数据。
  • ...ftp_dpm_20915_21_1234567890.sync 显示ID为21的合作伙伴已发送包含iOS 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可以处理大型文件,但我们可能可以帮助您减小文件大小并提高数据传输效率。 请参阅 入站数据传输文件的文件压缩

文件名示例

以下示例显示格式正确的文件名。 您的文件名可能看起来类似。
  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite
如果您 需要其他示例,请下载示例文件。 此文件以文件扩展名 .overwrite 保存。 使用简单的文本编辑器打开它。

接受的文件大小

请考虑下图,以便最快/最早地处理文件,以及将数据发送到/目录时的文件大小 Audience Manager 限 FTP 制。
文件类型 最佳大小 最大大小
Compressed(已压缩)
200-300 MB
3 GB
未压缩
1 GB
5 GB