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

介绍向发送数据时需要遵循的必填字段、语法、命名约定和文件大小 Audience Manager. 在向Audience Manager发送数据时,根据这些规范设置文件的名称和大小 FTP 目录访问Advertising Cloud的帮助。

警告

我们正在逐步取消对 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

一个能说明 Audience Manager 如果数据文件包含您自己的用户ID、Android ID、iOS ID或属于 全局数据源. 接受以下选项:

  • 数据源ID(也称为数据提供程序ID): 这是Audience Manager分配给数据源的唯一ID(请参阅Audience Manager ID索引 )。 发送包含您自己的用户ID的数据时,请在文件名中使用此分配的ID。 例如, ...ftp_dpm_21_123456789.sync 告知 Audience Manager 将数据载入到属于数据源21的ID。
  • Android ID(GAID): 如果数据文件名中包含Android ID,请在其中使用ID 20914。 您需要使用该字段 _DPID_TARGET_DATA_OWNER 使用Android ID时。 例如, ...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。 您需要使用该字段 _DPID_TARGET_DATA_OWNER 使用iOS ID时。 例如, ...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 将文件数据关联回您的组织。
此目标数据源需要归您的公司所有。 出于第二方数据共享的目的,要将数据摄取到属于其他公司的目标数据源中,您必须在您的公司和目标数据源之间具有访问映射。 请联系您的Adobe顾问或客户支持以设置映射。

重要说明: 需要请求现有数据共享关系的映射(适用于属于您在2022年3月14日之前已载入数据的其他公司的目标数据源)。 将数据载入属于您的PID的目标数据源时,也不需要进行映射。

例如:

  • ...ftp_dpm_33_21_1234567890.sync 告知Audience Manager您是否符合属于数据源33的客户ID的资格条件,以识别属于数据源21的特征或信号。
  • Android ID(GAID): ...ftp_dpm_20914_21_1234567890.sync 告知 Audience Manager 数据文件仅包含Android ID,且ID应符合属于数据源21的特征的条件。
  • iOS ID(IDFA): ...ftp_dpm_20915_21_1234567890.sync 告知 Audience Manager 数据文件仅包含iOS ID,且ID应符合属于数据源21的特征的条件。
  • 属于其他全局数据源的ID: ...ftp_dpm_121963_21_1234567890.sync 告知 Audience Manager 数据文件仅包含Roku ID,且ID应符合属于数据源21的特征资格。 使用与每个数据源对应的ID,如 全局数据源文章.

(.sync |.overwrite)

同步选项包括:

  • sync:第三方数据提供商按用户发送特征,以在Audience Manager系统中添加或删除的正常情况。
  • overwrite:允许客户和数据提供商基于每位用户发送一个特征列表,该列表应会覆盖给定数据源中该用户的所有现有特征(Audience Manager)。 您无需在覆盖文件中包含所有用户。 仅包括那些要更改的用户。 未分配给目标数据源的特征将不会被擦除。

[SPLIT_NUMBER]

整数。 将大文件拆分为多个部分时使用,以缩短处理时间。 数字表示您发送的原始文件的哪个部分。

为了高效处理文件,请按照以下指示拆分数据文件:

  • 未压缩:1 GB
  • 压缩:200-300兆字节

请参阅前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 目录访问Advertising Cloud的帮助。

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

200-300兆字节

3 GB

未压缩

1 GB

5 GB

在此页面上