介绍向发送数据时需要遵循的必填字段、语法、命名约定和文件大小 Audience Manager. 在将数据发送到 Audience Manager / Amazon S3 目录访问Advertising Cloud的帮助。
文本样式(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 文件名。
名称元素 | 描述 |
---|---|
|
Amazon S3存储段的路径和名称。 有关S3目录名称、路径和凭据,请联系您的客户经理。 |
|
将文件发送到S3存储段的时间戳(基于UTC时间)。 |
|
一个能说明 Audience Manager 如果数据文件包含您自己的用户ID、Android ID、iOS ID或属于 全局数据源. 接受以下选项:
注意:请勿在数据文件中混合使用ID类型。 例如,如果您的文件名包含Android标识符,则不要将iOS ID或您自己的ID放置在数据文件中。 |
|
此字段告知Audience Manager要将数据载入到哪个数据源。 如果您将DPID设置为Android ID、iOS ID或属于全局数据源的其他ID,则此字段为必填字段。 这允许Audience Manager将文件数据关联回您的组织。 重要说明: 您 不 需要请求现有数据共享关系的映射(适用于属于您在2022年3月14日之前已载入数据的其他公司的目标数据源)。 将数据载入属于您的PID的目标数据源时,也不需要进行映射。 例如:
|
|
您在中使用的公司或组织名称 Audience Manager. |
|
以秒为单位的10位UTC UNIX时间戳。 时间戳有助于使每个文件名都是唯一的。 |
|
同步选项包括:
|
|
整数。 将大文件拆分为多个部分时使用,以缩短处理时间。 数字表示您发送的原始文件的哪个部分。 为了高效处理文件,请按照以下指示拆分数据文件:
请参阅前2个 文件名示例 下。 |
|
将文件发送到Amazon S3时,请仅使用gzip压缩。 压缩后,这些文件将获取 压缩文件必须为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
您可以 下载 示例文件(如果需要其他示例)。 此文件已与 .overwrite
文件扩展名。 使用简单的文本编辑器将其打开。
请考虑下图,以了解文件处理速度最快/最早的情况,以及在将数据发送到 Audience Manager / Amazon S3 目录访问Advertising Cloud的帮助。
文件类型 | 最佳大小 | 最大大小 |
---|---|---|
Compressed(已压缩) | 200-300兆字节 |
3 GB |
未压缩 | 1 GB |
5 GB |
集客数据验证过程会将空文件标记为无效,且不会处理它们。
入站数据文件的行长限制为102400字节。 超过此限制的行将从转移中排除。