Show Menu
主题×

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

描述向Audience manager发送数据时需要遵循的必填字段、语法、命名惯例和文件大小。 在将数据发送到Audience manager目录时,根据这些规范设置文件的名称和大 FTP 小。
我们正在逐步取消对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或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 Manager ID。 这样, 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