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 受众 Manager,数据文件仅包含Android ID,且ID应符合属于数据源21的特征。
  • iOS ID(IDFA):告 ...ftp_dpm_20915_21_1234567890.sync 受众 Manager,数据文件仅包含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可以处理大型文件,但我们可能可以帮助您减小文件大小并提高数据传输效率。 请参阅入站数据传输文件的文件压缩

文件名示例

以下示例显示格式正确的文件名。 您的文件名可能看起来类似。

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

[如] (assets/ftp_dpm_1234_1445374061.overwrite) 果需要其他示例,请下载示例文件。此文件以.overwrite文件扩展名保存。 使用简单的文本编辑器打开它。

接受的文件大小

请考虑下图,了解文件处理速度最快/最早的情况以及将数据发送到Audience Manager / FTP目录时文件大小限制。

文件类型 最佳大小 最大大小
Compressed(已压缩)

200-300 MB

3 GB

未压缩

1 GB

5 GB

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now