[Ultimate]{class="badge positive"}

Google PubSub源

IMPORTANT
Google PubSub源在源目录中可供已购买Real-time Customer Data Platform Ultimate的用户使用。

Adobe Experience Platform为云提供商(如AWS、Google Cloud Platform和Azure)提供本机连接,允许您将这些系统中的数据引入到Platform中,以用于下游服务和目标。

云存储源可以将您的数据导入Platform,而无需下载、格式化或上传。 引入的数据可以格式化为XDM JSON、XDM Parquet或分隔。 该过程的每个步骤都集成到源工作流中。 平台允许您从Google PubSub实时引入数据。

先决条件 prerequisites

此部分概述在将Google PubSub帐户连接到Experience Platform之前必须完成的先决条件设置。

创建服务帐户 create-service-account

服务帐户 ​是应用程序或计算工作负载经常使用的帐户类型,而不是个人使用的帐户类型。 服务帐户由其电子邮件地址标识,该地址是该帐户独有的。

  • 一方面,服务帐户是​ 主体 — 您可以授予服务帐户访问Google Cloud资源的权限。 例如,您可以在给定项目中向服务帐户授予计算管理员角色(roles/compute.admin)。 然后,该服务帐户将能够管理该特定项目中的计算引擎资源。
  • 另一方面,服务帐户也是资源 — 您可以向其他承担者授予访问服务帐户的权限。 例如,您可以在服务帐户上授予用户服务帐户用户角色(roles/iam.serviceAccountUser),以便用户将该服务帐户附加到资源。 或者,您可以授予用户服务帐户管理员角色(roles/iam.serviceAccountAdmin),以允许用户完成查看、编辑、禁用和删除服务帐户等任务。

有关为您的用例确定正确的身份验证类型的更多信息,请阅读身份验证方法的Google 指南

按照下面列出的步骤创建服务帐户:

首先,导航到Google Developer Console的IAM页面,然后选择​ Create Service Account

Google Developer Console中的“创建服务帐户”窗口

接下来,输入服务帐户的显示名称和ID,然后选择​ Create and Continue

Google Developer Console中的服务帐户详细信息

生成服务帐户密钥 generate-service-account-keys

要为服务帐户生成密钥,请在服务帐户页中选择密钥标头。 从该位置,选择​ Add key,然后从下拉菜单中选择​ Create new key。 您还可以使用此面板上传现有密钥。

Google Developer Console中的add key窗口

成功后,您将收到一条消息,指示私钥已保存到您的计算机,并将下载文件。 然后,在Experience Platform上创建Google PubSub帐户时,您可以将此文件的内容用作凭据。

在主题和订阅级别授予权限 grant-permissions

要授予主题和订阅级别的权限,请导航到主题控制台页面,然后选择​ Show info panel。 接下来,在Permissions选项卡下,选择Add Principal,然后添加服务帐户主体以及权限。

Google Developer Console中的弹出窗口,您可以在其中授予主题和订阅级别的权限

最佳Google PubSub usage的配置 optimal-configurations

此部分概述了为优化Experience Platform上对Google PubSub源的使用,建议您进行的配置。

订阅属性 subscription-properties

使用Google Developer Console将​ 增加您的确认截止日期。 这允许Google Publisher在再次发送消息之前根据您配置的时间等待。 这种延迟有助于在订阅者级别减少不必要的负载。

Google Developer Console中的确认截止日期接口。

启用​ exactly one delivery。 此配置通知Google Publisher确保在确认截止日期到期之前,不会重新发送发送到订阅的邮件。 您可以使用此设置来确保确认消息不会被重新发送到订阅。

Google Developer Console中只有一个投放配置页面。

您可以启用​ Retry after exponential backoff delay ​以降低进一步使服务器不堪重负的风险。 您可以在Google Developer Console中启用此配置,以便在尝试其他连接之前为系统提供更多恢复时间,从而更好地缓解暂时性故障(通常可自行解决的暂时性错误)。

Google Developer Console中的“重试策略”窗口。

您必须​ 将订阅消息保留持续时间设置为24小时或更长,以确保未确认的数据不会在高峰加载期间丢失。 此外,启用死信主题 ​以确保即使在极少数边缘情况下也不会发生数据丢失。

IMPORTANT
每个Google PubSub订阅只能创建一个源数据流。 重用订阅(甚至跨沙盒)会导致数据丢失。

将Google PubSub连接到Experience Platform

以下文档提供了有关如何使用API或用户界面将Google PubSub连接到Platform的信息:

使用API

使用UI

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089