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

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

注意

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

文件名语法

S3 文件名包含以下必需和可选元素:

  • S3前缀: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

  • 文件名元素: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

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

注意

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

命名元素

该表定义S3文件名中的元素。

名称元素 描述

AWS_directory

Amazon S3存储桶的路径和名称。 请与客户经理联系,了解您的S3目录名称、路径和凭据。

date=yyyy-mm-dd

将文件发送到S3存储桶的时间的时间戳(基于UTC时间)。

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。

partner_name

您在Audience Manager中使用的公司或组织名称。

TIMESTAMP

10位、UTC UNIX时间戳(以秒为单位)。 时间戳有助于使每个文件名都是唯一的。

(.sync|.overwrite)

同步选项包括:

  • sync:第三方数据提供者按用户发送要在Audience Manager系统中添加或删除的特征时的正常情况。
  • overwrite:允许数据提供者按每个用户发送一列表特征,这些特征应覆盖该Audience Manager中此数据提供者的所有现有第三方特征。您不需要将所有用户都包含在覆盖文件中。 仅包括要更改的用户。

[SPLIT_NUMBER]

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

为了有效处理文件,请按照以下说明拆分数据文件:

  • 未压缩:1 GB
  • 压缩:200-300 MB

请参见下面前2个文件名示例

[.gz]

将文件发送到Amazon S3时,请仅使用gzip压缩。 压缩后,这些文件将获得 .gz扩展名。 请勿使用.zip压缩。

压缩文件必须为3 GB或更小。 如果您的文件较大,请与客户服务部联系。 尽管Audience Manager可以处理大型文件,但我们可能可以帮助您减小文件大小并提高数据传输效率。 请参阅入站数据传输文件的文件压缩

文件名示例

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

  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite

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

接受的文件大小

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

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

200-300 MB

3 GB

未压缩

1 GB

5 GB

注意

入站数据验证进程会将空文件标记为无效,并且不会处理它们。

行长限制

入站数据文件的行长限制为102400字节。 超过此限制的行将从转移中排除。

在此页面上

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