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

您的AmazonS3存储桶的路径和名称。 请与客户经理联系,了解您的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 受众 管理器,数据文件仅包含Android ID,且ID应符合属于数据源21的特征。
  • iOS ID(IDFA):告 ...ftp_dpm_20915_21_1234567890.sync 受众 管理器,数据文件仅包含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]

将文件发送到AmazonS3时,仅使用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字节。 超出此限制的行将从转移中排除。

在此页面上