文档Experience Platform目标指南

Google Cloud Storage连接

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 用户

概述 overview

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

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

支持的受众 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格式的公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。

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

有关这些值的更多信息，请阅读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

详细了解Google Cloud Storage中的访问控制和权限。

激活此目标的受众 activate

IMPORTANT

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

  • 要导出​ 标识，您需要​ 查看标识图形 访问控制权限。

    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

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

计划中

在​ 计划 ​步骤中，您可以为Google Cloud Storage目标设置导出计划，还可以配置导出文件的名称。

映射属性和身份 map

在​ 映射 ​步骤中，您可以为配置文件选择要导出的属性和标识字段。 您还可以选择将导出文件中的标头更改为所需的任何友好名称。 有关详细信息，请查看激活批处理目标UI教程中的映射步骤。

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

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

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

如果需要将Adobe列入允许列表 IP添加到，请参阅IP地址允许列表一文。

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