Amazon S3 连接 s3-connection

目标更改日志 changelog

查看更改日志
table 0-row-3 1-row-3 2-row-3 layout-auto
发行月份 更新类型 描述
2024 年 1 月 功能和文档更新 Amazon S3目标连接器现在支持新的假定角色身份验证类型。 欲知更多信息,请参阅 身份验证部分.
2023 年 7 月 功能和文档更新

在2023年7月的Experience Platform版本中, Amazon S3 目标提供了新功能,如下所示:

连接到您的 Amazon S3 通过API或用户界面进行存储 connect-api-or-ui

支持的受众 supported-audiences

此部分介绍哪些类型的受众可以导出到此目标。

受众来源
受支持
描述
Segmentation Service
✓ {\f13 }
通过Experience Platform生成的受众 分段服务.
自定义上传
受众 已导入 从CSV文件Experience Platform到。

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息,请参阅下表。

项目
类型
注释
导出类型
基于配置文件
您正在导出区段的所有成员,以及所需的架构字段(例如:电子邮件地址、电话号码、姓氏),如 目标激活工作流.
导出频率
批次
批量目标以三、六、八、十二或二十四小时的增量将文件导出到下游平台。 详细了解 批处理基于文件的目标.

UU中突出显示的基于配置文件的Amazon S3导出类型。

导出数据集 export-datasets

此目标支持数据集导出。 有关如何设置数据集导出的完整信息,请阅读教程:

导出数据的文件格式 file-format

导出时 受众数据,平台创建 .csvparquet,或 .json 文件存储位置。 有关这些文件的详细信息,请参见 支持的导出文件格式 部分。

导出时 数据集,平台创建 .parquet.json 文件存储位置。 有关这些文件的详细信息,请参见 验证数据集导出是否成功 导出数据集教程中的部分。

连接到目标 connect

IMPORTANT
要连接到目标,您需要 查看目标管理目标 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

要连接到此目标,请按照 目标配置教程. 在目标配置工作流中,填写下面两个部分中列出的字段。

验证目标 authenticate

要向目标进行身份验证,请填写必填字段并选择 连接到目标. Amazon S3目标支持两种身份验证方法:

  • 访问密钥和密钥身份验证
  • 担任的角色身份验证

访问密钥和密钥身份验证

当您想要输入Amazon S3访问密钥和密钥,以允许Experience Platform将数据导出到Amazon S3资产时,请使用此身份验证方法。

选择访问密钥和密钥身份验证时必填字段的图像。

  • Amazon S3访问密钥Amazon S3密钥:在 Amazon S3,生成 access key - secret access key 对,以授予对的Platform访问权限 Amazon S3 帐户。 在中了解详情 Amazon Web Services文档.

  • 加密密钥:(可选)您可以附加RSA格式公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。

    该图像显示了UI中格式正确的PGP密钥的示例。

担任的角色 assumed-role-authentication

选择承担的角色身份验证时必填字段的图像。

如果您不想与 Adobe 共享帐户密钥和私钥,请使用此身份验证类型。相反,Experience Platform会使用基于角色的访问连接到Amazon S3位置。

为此,您需要在AWS控制台中创建假定用户,以便Adobe 权限必需权限 以写入您的Amazon S3存储段。 创建 受信任的实体 在AWS中使用Adobe帐户 670664943635. 欲了解更多信息,请参见 有关创建角色的AWS文档.

  • Role:粘贴您在AWS中为Adobe用户创建的角色的ARN。 模式类似于 arn:aws:iam::800873819705:role/destinations-role-customer.
  • 加密密钥:(可选)您可以附加RSA格式公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。

填写目标详细信息 destination-details

要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

  • 名称:输入可帮助您识别此目标的名称。

  • 描述:输入此目标的描述。

  • 存储段名称:输入 Amazon S3 要由此目标使用的存储桶。

  • 文件夹路径:输入目标文件夹的路径,该文件夹将托管导出的文件。

  • 文件类型:选择导出的文件应使用的格式Experience Platform。 选择 CSV 选项,您还可以 配置文件格式选项.

  • 压缩格式:选择Experience Platform应用于导出文件的压缩类型。

  • 包含清单文件:如果您希望导出包含清单JSON文件,并且该文件包含有关导出位置、导出大小等的信息,请打开此选项。 清单的命名格式为 manifest-<<destinationId>>-<<dataflowRunId>>.json. 查看 示例清单文件. 清单文件包含以下字段:

    • flowRunId:和 数据流运行 生成了导出的文件。
    • scheduledTime:导出文件时的时间(UTC时间)。
    • exportResults.sinkPath:存储位置中存储导出文件的路径。
    • exportResults.name:导出文件的名称。
    • size:导出文件的大小(以字节为单位)。
TIP
在连接目标工作流中,您可以在Amazon S3存储中为每个导出的受众文件创建一个自定义文件夹。 读取 使用宏在您的存储位置中创建文件夹 以获取说明。

启用警报 enable-alerts

您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅以下内容中的指南: 使用UI订阅目标警报.

完成提供目标连接的详细信息后,选择 下一个.

必填 Amazon S3 权限 required-s3-permission

要成功连接数据并将其导出到 Amazon S3 存储位置,创建身份和访问管理(IAM)用户 Platform 在 Amazon S3 并为以下操作分配权限:

  • s3:DeleteObject
  • s3:GetBucketLocation
  • s3:GetObject
  • s3:ListBucket
  • s3:PutObject
  • s3:ListMultipartUploadParts

激活此目标的受众 activate

IMPORTANT
  • 要激活数据,您需要 查看目标激活目标查看配置文件、和 查看区段 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。
  • 要导出 身份,您需要 查看身份图 访问控制权限.
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

请参阅 将受众数据激活到批量配置文件导出目标 有关将受众激活到此目标的说明。

验证数据导出是否成功 exported-data

要验证数据是否已成功导出,请检查 Amazon S3 存储并确保导出的文件包含预期的配置文件人口。

IP地址允许列表 ip-address-allow-list

请参阅 IP地址允许列表 文章(如果需要将AdobeIP添加到允许列表)。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6