- 教程概述
- 架构概述
- 视频概述
- 测量完成
- 0 — 入门
- 1 - Adobe Experience Platform数据收集和Web SDK扩展
- 2 — 数据摄取
- 3 — 实时客户资料
- 4 — 语音助手 — Amazon Alexa
- 5 - ETL工具
- 6 -Adobe Journey Optimizer:编排
- 7 — 查询服务
- 8 — 数据科学工作区 — 基于热门程度的Recommendations
- 9 — 使用Google Tag Manager和Google Analytics摄取数据
- 10 — 智能服务
- 11 — 实时CDP — 构建一个区段并采取行动！
- 12 -Adobe Journey Optimizer:外部数据源和自定义操作
- 13 -Customer Journey Analytics — 使用Adobe Experience Platform上的Analysis Workspace构建功能板
- 14 -Offer decisioning
- 15 - Data Science Workspace — 汽车保险销售倾向
- 16 — 使用BigQuery Source Connector在Adobe Experience Platform中摄取并分析Google Analytics数据
- 17 - Adobe Experience Platform和Microsoft Dynamics 365
- 18 — 区段激活到Microsoft Azure事件中心
- 19 - Adobe Experience Platform和ServiceNow:将服务连接到营销和销售
- 20 — 由Stackchat提供支持的AI驱动聊天应用程序和实时聊天
- 21 -Adobe Experience Platform数据收集和实时事件转发与Adobe Experience Platform数据收集
- 22 — 使用Adobe I/O构建您自己的实时功能板 — 项目Firefly和Adobe Experience Platform
- 23 - Adobe Journey Optimizer
- 24 — 将数据从Apache Kafka流式传输到Adobe Experience Platform
16.3 Connect GCP和BigQuery到Adobe Experience Platform
目标
- 浏览Google Cloud Platform中的API和服务
- 熟悉用于测试Google API的OAuth操场
- 在Adobe Experience Platform中创建您的第一个BigQuery连接
上下文
Adobe Experience Platform在Sources中提供一个连接器，帮助您将BigQuery数据集导入Adobe Experience Platform。 此数据连接器基于Google BigQuery API。 因此，正确准备Google Cloud Platform和BigQuery环境以接收来自Adobe Experience Platform的API调用非常重要。
要在Adobe Experience Platform中配置BigQuery源连接器，您需要以下4个值：
- 项目
- clientId
- clientSecret
- refreshToken
到目前为止，您只有第一个，项目ID。 此项目ID值是在练习16.1期间创建BigQuery项目时由Google生成的随机ID。
请将项目ID复制到分隔的文本文件中。
| 凭据 | 命名 | 示例 |
|---|---|---|
| 项目ID | random | commented-任务-306413 |
您可以随时通过单击顶部菜单栏中的项目名称检查项目ID:
右侧将显示项目ID:
在本练习中，您将学习如何获取其他3个必填字段：
- clientId
- clientSecret
- refreshToken
16.3.1 Google Cloud API & Services
要开始，请返回Google Cloud Platform主页。 为此，只需单击屏幕左上角的徽标。
进入主页后，转到左菜单并单击API和服务，然后单击仪表板。
您现在将看到API和服务主页。
在本页中，您可以看到各种Google API连接的使用情况。 要设置API连接以便Adobe Experience Platform能够从BigQuery读取，您需要执行以下步骤：
- 首先，您需要创建一个OAuth同意屏幕，以启用将来的身份验证。 谷歌的安全理由还要求在允许程序化访问之前，首先进行身份验证。
- 其次，您需要API凭据（clientId和clientSecret），以用于API身份验证和访问BigQuery Connector。
16.3.2 OAuth同意屏幕
让我们开始创建OAuth同意屏幕。 在API和服务主页的左侧菜单中，单击OAuth同意屏幕。
然后您将看到：
选择用户类型：外部。 接下来，单击创建。
然后，您将位于OAuth同意屏幕配置窗口中。
此处唯一要做的就是在应用程序名称字段中输入同意屏幕的名称，然后选择用户支持电子邮件。 对于应用程序名称，请使用以下命名约定：
| 命名 | 示例 |
|---|---|
| ldap - AEP BigQuery Connector | vangeluw - Platform BigQuery Connector |
接下来，向下滚动直到您看到开发人员联系信息并填写电子邮件地址。
单击保存并继续。
然后你会看到这个。 单击保存并继续。
然后你会看到这个。 单击保存并继续。
然后你会看到这个。 单击返回仪表板。
然后你会看到这个。 单击发布应用程序。
单击确认。
然后你会看到这个。
在下一步中，您将完成API设置并获取您的API凭据。
16.3.3 Google API凭据：客户端密码和客户端ID
在左侧菜单中，单击凭据。 然后您将看到：
单击+ 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。
16.3.4 BigQuery API和refreshToken
获取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中设置源连接器。
练习16.3.5 - Connect Platform与您自己的BigQuery表
通过转到以下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中的模式和数据集。
下一步：16.4将数据从BigQuery加载到Adobe Experience Platform
adobe.com 上的资源
