Google Cloud Storage连接

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined
undefined

概述 overview

创建到Google Cloud Storage的实时出站连接，定期将数据文件从Adobe Experience Platform导出到您自己的存储桶中。

通过API或UI连接到您的Google Cloud Storage存储 connect-api-or-ui

要使用Platform用户界面连接到Google Cloud Storage存储位置，请阅读下面的连接到目标和将受众激活到此目标部分。
若要以编程方式连接到Google Cloud Storage存储位置，请阅读使用流服务API教程将受众激活到基于文件的目标。

支持的受众 supported-audiences

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

受众来源

支持

描述

Segmentation Service

✓ {\f13 }

通过Experience Platform分段服务生成的受众。

自定义上传

✓ {\f13 }

受众已将从CSV文件导入到Experience Platform中。

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

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

项目

类型

注释

导出类型

基于配置文件

您正在导出区段的所有成员，以及适用的架构字段，如目标激活工作流的选择配置文件属性屏幕中所选。

导出频率

批次

批量目标以三、六、八、十二或二十四小时的增量将文件导出到下游平台。阅读有关基于批处理文件的目标的详细信息。

导出数据集 export-datasets

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

如何使用Platform用户界面🔗导出数据集。
如何使用流服务API🔗以编程方式导出数据集。

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

导出 受众数据 时，Platform会在您提供的存储位置创建一个.csv、parquet或.json文件。有关这些文件的更多信息，请参阅Audience Activation教程中的导出的支持文件格式部分。

导出 数据集 时，Platform会在您提供的存储位置创建一个.parquet或.json文件。有关这些文件的更多信息，请参阅导出数据集教程中的验证成功的数据集导出部分。

用于连接Google Cloud Storage帐户的必备设置 prerequisites

为了将Platform连接到Google Cloud Storage，您必须首先为您的Google Cloud Storage帐户启用互操作性。要访问互操作性设置，请打开Google Cloud Platform并从导航面板的 云存储 选项中选择设置。

突出显示了Cloud Storage和设置的Google Cloud Platform仪表板。

此时会显示设置页面。在此处，您可以看到有关您的Google项目ID的信息以及有关您的Google Cloud Storage帐户的详细信息。要访问互操作性设置，请从顶部标题中选择 互操作性。

Google Cloud Platform仪表板中突出显示的“互操作性”选项卡。

互操作性 页面包含有关身份验证、访问密钥以及与您的服务帐户关联的默认项目的信息。要为您的服务帐户生成新的访问密钥ID和访问密钥，请选择 为服务帐户创建密钥。

Google Cloud Platform仪表板中突出显示的服务帐户控制的创建密钥。

您可以使用新生成的访问密钥ID和秘密访问密钥将Google Cloud Storage帐户连接到Platform。

连接到目标 connect

IMPORTANT

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

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

验证目标 authenticate

要验证到目标，请填写必填字段并选择 连接到目标。

访问密钥ID：一个61字符的字母数字字符串，用于向Platform验证您的Google Cloud Storage帐户。有关如何获取此值的信息，请阅读上面的先决条件部分。
访问密钥：用于向Platform验证您的Google Cloud Storage帐户的40字符base64编码字符串。有关如何获取此值的信息，请阅读上面的先决条件部分。
加密密钥：（可选）您可以附加RSA格式的公钥以向导出的文件添加加密。查看下图中的加密密钥格式正确示例。

有关这些值的更多信息，请阅读Google Cloud Storage HMAC密钥指南。有关如何生成自己的访问密钥ID和访问密钥的步骤，请参阅Google Cloud Storage 源概述。

填写目标详细信息 destination-details

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

名称：填写此目标的首选名称。
描述：可选。例如，您可以提及要将此目标用于哪个营销活动。
Bucket名称：输入要由此目标使用的Google Cloud Storage存储段的名称。
文件夹路径：输入将承载导出文件的目标文件夹的路径。
文件类型：选择导出文件应使用的格式Experience Platform。在选择CSV选项时，您还可以配置文件格式选项。
压缩格式：选择Experience Platform应用于导出文件的压缩类型。
包含清单文件：如果希望导出包含清单JSON文件，并且该文件包含有关导出位置、导出大小等的信息，请打开此选项。清单的命名格式为manifest-<<destinationId>>-<<dataflowRunId>>.json。查看样本清单文件。清单文件包含以下字段：
- flowRunId：生成导出文件的数据流运行。
- scheduledTime：导出文件时的时间（UTC时间）。
- exportResults.sinkPath：存储位置中保存导出文件的路径。
- exportResults.name：导出文件的名称。
- size：导出文件的大小（字节）。

启用警报 enable-alerts

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

完成提供目标连接的详细信息后，选择 下一步。

所需的Google Cloud Storage权限 required-google-cloud-storage-permission

要成功连接数据并将其导出到您的Google Cloud Storage存储位置，您需要对存储桶拥有以下Google Cloud Storage权限：

*orgpolicy.policy.get
*resourcemanager.projects.get
*resourcemanager.projects.list
*storage.managedFolders.create
*storage.multipartUploads.abort
*storage.multipartUploads.create
*storage.multipartUploads.listParts
*storage.objects.create
*storage.objects.list