文档Experience Platform目标指南

Amazon S3 连接 s3-connection

Last update: Mon Mar 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Admin
  • User

目标更改日志 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

导出时 受众数据，平台创建 .csv， parquet，或 .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

  • 要激活数据，您需要 查看目标， 激活目标， 查看配置文件、和 查看区段 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

  • 要导出 身份，您需要 查看身份图 访问控制权限.

    img-md
    w-100 modal-image
    选择工作流中突出显示的身份命名空间以将受众激活到目标。

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

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

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

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

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

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