[Ultimate]{class="badge positive"}
Google PubSub源
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。
接下来,输入服务帐户的显示名称和ID,然后选择 Create and Continue。
生成服务帐户密钥 generate-service-account-keys
要为服务帐户生成密钥,请在服务帐户页中选择密钥标头。 从该位置,选择 Add key,然后从下拉菜单中选择 Create new key。 您还可以使用此面板上传现有密钥。
成功后,您将收到一条消息,指示私钥已保存到您的计算机,并将下载文件。 然后,在Experience Platform上创建Google PubSub帐户时,您可以将此文件的内容用作凭据。
在主题和订阅级别授予权限 grant-permissions
要授予主题和订阅级别的权限,请导航到主题控制台页面,然后选择 Show info panel。 接下来,在Permissions选项卡下,选择Add Principal,然后添加服务帐户主体以及权限。
最佳Google PubSub usage的配置 optimal-configurations
此部分概述了为优化Experience Platform上对Google PubSub源的使用,建议您进行的配置。
订阅属性 subscription-properties
使用Google Developer Console将 增加您的确认截止日期。 这允许Google Publisher在再次发送消息之前根据您配置的时间等待。 这种延迟有助于在订阅者级别减少不必要的负载。
启用 exactly one delivery。 此配置通知Google Publisher确保在确认截止日期到期之前,不会重新发送发送到订阅的邮件。 您可以使用此设置来确保确认消息不会被重新发送到订阅。
您可以启用 Retry after exponential backoff delay 以降低进一步使服务器不堪重负的风险。 您可以在Google Developer Console中启用此配置,以便在尝试其他连接之前为系统提供更多恢复时间,从而更好地缓解暂时性故障(通常可自行解决的暂时性错误)。
您必须 将订阅消息保留持续时间设置为24小时或更长,以确保未确认的数据不会在高峰加载期间丢失。 此外,启用死信主题 以确保即使在极少数边缘情况下也不会发生数据丢失。
将Google PubSub连接到Experience Platform
以下文档提供了有关如何使用API或用户界面将Google PubSub连接到Platform的信息: