Adobe Experience Platform在Sources中提供一个连接器,帮助您将BigQuery数据集导入Adobe Experience Platform。 此数据连接器基于Google BigQuery API。 因此,正确准备Google Cloud Platform和BigQuery环境以接收来自Adobe Experience Platform的API调用非常重要。
要在Adobe Experience Platform中配置BigQuery源连接器,您需要以下4个值:
到目前为止,您只有第一个,项目ID。 此项目ID值是在练习16.1期间创建BigQuery项目时由Google生成的随机ID。
请将项目ID复制到分隔的文本文件中。
凭据 | 命名 | 示例 |
---|---|---|
项目ID | random | commented-任务-306413 |
您可以随时通过单击顶部菜单栏中的项目名称检查项目ID:
右侧将显示项目ID:
在本练习中,您将学习如何获取其他3个必填字段:
要开始,请返回Google Cloud Platform主页。 为此,只需单击屏幕左上角的徽标。
进入主页后,转到左菜单并单击API和服务,然后单击仪表板。
您现在将看到API和服务主页。
在本页中,您可以看到各种Google API连接的使用情况。 要设置API连接以便Adobe Experience Platform能够从BigQuery读取,您需要执行以下步骤:
让我们开始创建OAuth同意屏幕。 在API和服务主页的左侧菜单中,单击OAuth同意屏幕。
然后您将看到:
选择用户类型:外部。 接下来,单击创建。
然后,您将位于OAuth同意屏幕配置窗口中。
此处唯一要做的就是在应用程序名称字段中输入同意屏幕的名称,然后选择用户支持电子邮件。 对于应用程序名称,请使用以下命名约定:
命名 | 示例 |
---|---|
ldap - AEP BigQuery Connector | vangeluw - Platform BigQuery Connector |
接下来,向下滚动直到您看到开发人员联系信息并填写电子邮件地址。
单击保存并继续。
然后你会看到这个。 单击保存并继续。
然后你会看到这个。 单击保存并继续。
然后你会看到这个。 单击返回仪表板。
然后你会看到这个。 单击发布应用程序。
单击确认。
然后你会看到这个。
在下一步中,您将完成API设置并获取您的API凭据。
在左侧菜单中,单击凭据。 然后您将看到:
单击+ CREATE CREDENTIALS按钮。
您将看到3个选项。 单击OAuth客户端ID:
在下一个屏幕中,选择Web 应用程序。
将弹出多个新字段。 现在,您需要输入OAuth客户端ID的名称,并输入授权的重定向URI。
请遵循以下命名规范:
字段 | 值 | 示例 |
---|---|---|
名称 | ldap - AEP BigQuery Connector | vangeluw - Platform BigQuery Connector |
已授权的重定向URI | https://developers.google.com/oauthplayground | https://developers.google.com/oauthplayground |
已授权重定向URI字段非常重要,因为您以后需要它来获取完成Adobe Experience Platform中BigQuery源连接器的设置所需的RefreshToken。
在继续之前,您需要在输入URL后实际按Enter按钮,以将值存储在已授权的重定向URI字段中。 如果未单击Enter按钮,则在稍后的OAuth 2.0 Parkyand中,您将遇到问题。
接下来,单击创建:
现在您将看到您的客户端ID和客户端机密。
请复制这两个字段并将其粘贴到桌面上的文本文件中。 您始终可以在以后的阶段访问这些凭据,但如果将它们保存在BigQuery项目ID旁边的文本文件中,则会更轻松。
作为Adobe Experience Platform中BigQuery Source Connector设置的回顾,您现在已有以下值可用:
BigQuery连接器凭据 | 值 |
---|---|
项目ID | 您自己的项目ID(例如:commented-任务-306413) |
clientid | yourclientid |
cillsecret | yourclientsecret |
您仍缺少refreshToken。 由于安全原因,需要refreshToken。 在API领域,令牌通常每24小时过期一次。 因此,每24小时需要refreshToken刷新一次安全令牌,这样您的源连接器设置就可以继续连接到Google Cloud Platform和BigQuery。
获取refreshToken以访问Google Cloud Platform API有多种方法。 其中一个选项是例如使用Postman。
但是,Google已经构建了一些更易于测试和使用其API的工具,该工具名为OAuth 2.0 Parkyout。
要访问OAuth 2.0 Paryground,请转到https://developers.google.com/oauthplayground。
然后,您将看到OAuth 2.0 Playment主页。
单击屏幕右上方的gear图标:
确保设置与上图中显示的设置相同。
多次检查设置以100%确定。
完成后,选中使用您自己的OAuth凭据复选框
应显示两个字段,并且您有相应的值。
请填写下表中的字段:
操场API设置 | 您的Google API凭据 |
---|---|
OAuth客户端ID | 您自己的客户端ID(在桌面上的文本文件中) |
OAuth客户端机密 | 您自己的客户端机密(在桌面上的文本文件中) |
从您在桌面上创建的文本文件中复制客户端ID和客户端机密。
填写完凭据后,请单击关闭
在左侧菜单中,您可以看到所有可用的Google API。 搜索BigQuery API v2。
接下来,选择下图所示的范围:
选择API后,应显示一个蓝色按钮,表示“授权API”。 单击它。
选择用于设置GCP和BigQuery的Google帐户。
你可能会看到一个重大警告:未验证此应用程序。 这是因为您的Platform BigQuery Connector尚未得到正式审查,所以Google不知道它是否是正版应用程序。 您应忽略此通知。
单击高级。
接下来,单击转至ldap - AEP BigQuery Connector(insave)。
您将被重定向到您创建的OAuth同意屏幕。
如果您使用双因素身份验证(2FA),请输入发送给您的验证代码。
Google现在将向您显示八个不同的Permission提示。 单击允许获取所有八个权限请求。 (在API允许程序化请求之前,必须由真人遵循并确认一次此过程)
同样,将不显示8个不同的弹出窗口,您必须单击允许以查看所有窗口。
八次权限请求后,您将看到此概述。 单击允许完成该过程。
在最后一次Allow单击后,您将被发送回OAuth 2.0 Playment,您将看到:
单击令牌的Exchange授权码。
几秒钟后,令牌视图的步骤2 - Exchange授权代码将自动关闭,您将看到步骤3 — 配置对API的请求。
您必须返回至令牌的步骤2 Exchange授权码,因此请再次单击令牌步骤2 Exchange授权码以可视化刷新令牌。
您现在将看到刷新令牌。
复制刷新令牌并将其与其他BigQuery源连接器凭据一起粘贴到桌面上的文本文件中:
BigQuery源连接器凭据 | 值 |
---|---|
项目ID | 您自己的随机项目ID(例如:apt-summer-273608) |
clientid | yourclientid |
cilsecret | yourclientsecret |
refrestok | yourrefrestoken |
接下来,让我们在Adobe Experience Platform中设置源连接器。
通过转到以下URL登录Adobe Experience Platform:https://experience.adobe.com/platform。
登录后,您将登录Adobe Experience Platform主页。
在继续之前,您需要选择沙箱。 要选择的沙箱名为--aepSandboxId--
。 单击屏幕顶部蓝线中的文本Production Prod即可执行此操作。
选择适当的沙箱后,屏幕会发生变化,现在您就位于专用沙箱中。
在左侧菜单中,转到“源”。
然后,您将看到Sources主页。 在源菜单中,单击数据库。
单击Google BigQuery卡。 接下来,单击+ Configure。
您现在应创建新连接。
单击新建帐户。 您现在需要根据您在GCP和BigQuery中进行的设置填写以下所有字段。
让我们通过命名连接来开始:
请使用此命名规范:
BigQuery连接器凭据 | 值 | 示例 |
---|---|---|
帐户名称 | ldap - BigQuery连接 | vangeluw - BigQuery连接 |
描述 | ldap - BigQuery连接 | vangeluw - BigQuery连接 |
这应该给你这样的东西:
然后,填写存储在桌面上文本文件中的GCP和BigQuery API 帐户身份验证-details:
BigQuery连接器凭据 | 值 |
---|---|
项目ID | 您自己的随机项目ID(例如:apt-summer-273608) |
clientId | … |
clientSecret | … |
refreshToken | … |
您的帐户身份验证-details现在应当如下:
填写完所有这些字段后,单击连接到源。
如果您的帐户身份验证详细信息已正确填写,您现在应通过查看已连接确认,看到一条可视确认消息,确认连接正常工作。
现在已创建连接,请单击下一步:
您现在将看到在练习16.2期间创建的BigQuery数据集。
干得好! 在下一个练习中,您将从该表加载数据,并将其映射到Adobe Experience Platform中的模式和数据集。