入站数据文件的Amazon S3名称和文件大小要求 amazon-s-name-and-file-size-requirements-for-inbound-data-files
描述向Audience Manager发送数据时需要遵循的必填字段、语法、命名惯例和文件大小。 在向Audience Manager / Amazon S3目录发送数据时,根据这些规范设置文件的名称和大小。
文件名语法 file-name-syntax
S3文件名包含以下必需和可选元素:
-
S3前缀:
s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
-
文件名元素:
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
有关其他接受的文件名格式,请参阅自定义合作伙伴集成。
为元素命名
该表定义S3文件名中的元素。
AWS_directory
date=yyyy-mm-dd
DPID
告知Audience Manager数据文件是否包含您自己的用户ID、Android ID、iOS ID或其他属于全局数据源的ID的lD。 接受以下选项:
- 数据Source 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:您可以载入适用于Advertising (RIDA)、Microsoft Advertising ID (MAID)和其他ID的Roku 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,如全局数据源文章中所述。
partner_name
TIMESTAMP
(.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可以处理大型文件,但我们或许能够帮助您减小文件大小并提高数据传输效率。 请参阅入站数据传输文件的文件压缩。
文件名示例 file-name-examples
以下示例显示格式正确的文件名。 您的文件名可能类似。
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
如果您需要其他示例,可以下载示例文件。 此文件已使用.overwrite
文件扩展名保存。 使用简单的文本编辑器将其打开。
接受的文件大小 accepted-file-sizes
请考虑下图,以了解处理文件的最快/最早时间以及在将数据发送到Audience Manager / Amazon S3目录时文件大小限制。
行长度限制 line-limits
入站数据文件的行长度限制为102400字节。 超出此限制的行将从传输中排除。