20.5配置Stackchat与Adobe Experience Platform之间的集成

为了Stackchat从Adobe Experience Platform收发事件，您需要在Stackchat Studio中创建并配置集成。 在Stackchat Studio中设置集成之前，您需要创建一个Adobe I/O项目，它允许您与Adobe Experience PlatformAPI交互。

20.5.1您现有的Adobe I/O项目

在第3单元中，在练习3. 3.2 —— 设置您的Adobe I/O项目期间，您创建了自己的Adobe I/O项目。 创建Adobe I/O项目时，已创建证书对。 在本练习中，您需要使用该证书对。 如果您不再拥有它，请按照练习3.3.2 - 设置您的Adobe I/O项目中所述的步骤 ，创建新项目或仅生成新证书对。

无论采用哪种方式，在继续之前，您都需要准备好这些文件：

• private.key
• certificate_pub.crt

这些内容是在您的Adobe I/O项目设置过程中生成的，并会以名为config.zip的zip文件自动下载到您 的计算机。

此外，您还需要打开您的Adobe I/O项目以检索您的服务帐户( JWT)的其他重要信息 ，如客户端ID、客户端机密等。

要执行此操作，请访 问https://console.adobe.io/projects。 你们会看到这个。

转到顶 部导 航中的“项目”。 搜索并打开项目，该项目应命 名为Platform API ldap。

打开项目后，您将拥有类似的视图。 单击 服务帐户(JWT) ，以视图您的Adobe I/O项目的凭据。

你们会看到这个。 在接下来的2个步骤中保持此屏幕打开，因为在设置集成时，您需要在Stackchat Studio用户界面中输入这些凭据。

20.5.2在Stackchat中添加AdobeIO凭据

在Stackchat Studio中，单击 机器菜 单中的“集成”，然 后在右上 方单击“添加集成”,

接下来，从 模态窗 口中选择Adobe Experience Platform:

现在您将看到空的Adobe Experience Platform集成屏幕。

您现在需要在“身份验证”选项卡中输入所有字段的值。

JWT服务帐户字段

客户端ID、客户端机密、技术帐户ID和IMS组织ID字段均可通过从此页复制／粘贴JWT服务帐户值来填充：

在填写这些值后，您现在应该有：

私钥

“ 私钥 ”字段必须包含作为Adobe I/O项目设置 的一部分生成的 private.key文件的完整内容。 在文 本编辑器中 ，打开private.key，并将整个内容复制／粘贴到私钥文本输入中。

在将您的private.key粘贴到Stackchat Studio后，您现在应该有：

连接ID

连接ID是DCS Inlet ID的最后一部分，它已保存在配置ID 中。 但是，要保存单击，您的DCS入口ID如下：

--dcsInletId--

现在，您只需复制URL中最终／最 后 的每个字符，并将该值粘贴到Stackchat Studio的 连接ID 字段中，在此示例中： 92b2eb1267c8fc7ee8b41a760a7d616714ca380b449d2d83e68adf692a0a28b1。

然后，单击“验 证凭据”。

20.5.3配置沙箱、模式和数据集

Stackchat向Adobe Experience Platform发送两种事件:用户用户档案事件和行为交互事件。 每种事件类型都需要在Adobe Experience Platform定义专用模式和数据集。 在此步骤中，您将告诉Stackchat，它应在Adobe Experience Platform沙箱中的哪个位置发送用户档案和交互数据。

如果上一步中的凭据正确，您将自动切换到“数据 路由 ”选项卡。 单击“ 提取沙箱”。

提取沙箱后，搜索沙箱名称并将其选中。 您使用的沙箱是 --aepSandboxId--。 在此示例中，沙箱称为 AEP Enablement FY21。

加载模式和数据集时等待几秒钟。 加载UI后，请选择以下值：

• 用户档案模式: 演示系统- Stackchat Chatbot的用户档案模式(Global v1.1)
• 事件模式: 演示系统- Stackchat Chatbot的事件模式(Global v1.1)
• 用户档案数据集: 演示系统- Stackchat Chatbot的用户档案数据集(Global v1.1)
• 事件数据集: 演示系统- Stackchat Chatbot的事件数据集(Global v1.1)

现在点 击保存 配置，以便您可以转到下一步。

20.5.4用户档案映射

在下一个选项卡中，您将Stackchat插槽映射到在Adobe Experience Platform模式中定义的属性。 您将看到：

第一个要执行的映射是Stackchat ID的必需映射。 从“选 择插槽 ”菜单中，选 择用户Id。

接下来，您需要添加多个可选映射。 下面是一张表格，其中列出了要另外映射的内容：

对于每个映射，单击 + 按钮以添加新映射。

例如，让我们通过映射用户的开始ID进行Experience Cloud。 从“选择插槽” 菜单中选择 ECID。

你做得很好！ 现在，只需对练习20.2.2中创建的以 下插槽重复此过程。 他们都将为您设置相应的模式属性。

您的最终映射应当如下：

完成所有映射后，请点 击右上 方的更新映射。

20.5.5事件映射

在此选项卡中，您将Stackchat插槽映射到Stackchat发送给Adobe Experience Platform的行为事件。 您在步骤20.5.2(Demo System - Stackchat Chatbot(Global v1.1))中选择的模式有一个混音器，它将由--aepTenantId--.chatbotInteraction Stackchat自动填充，其中包含用户所在的会话流或执行云函数时的信息。 你唯一的工作就是映射标识槽，这样Adobe Experience Platform才能将此行为归因给正确的用户。

在“事件映射”选项卡中添加以下映射。

您的最终映射应当如下：

完成所有映射后，请点 击右上 方的更新映射。

20.5.5将产品视图事件发送至Adobe Experience Platform

在某些情况下，除了Stackchat自动发送的用户事件和行为事件外，您还希望将用户档案发送到Adobe Experience Platform。 当出现这种情况时，您可以通过Stackchat Cloud函数将这些特殊案例事件发送到Adobe Experience Platform。

在本节中，当用户点击给定产品卡的按钮时，我们将配置您的Luma Bot，以 在捕获电子邮件地 址和产品 视图❤️Adobe Experience Platform时发送Luma Bot Insed User Intified Sibles 事件。

该按❤️钮已配置为 回传按钮 ，这意味着当用户单击它时将调用云函数。 按钮❤️配置为调用 notifyAEPOfProductView cloud函数，并在有效负荷中传递，如下所示：

{
  name: result.name,
  imageUrl: result.image1.url,
  price: result.finalPrice,
  sku: result.SKU,
  pageUrl: BASE_PRODUCT_URL + result.productUrl
}

已 设置notifyAEPOfProduct View方法以根据此负载构建Adobe Experience Platform产品视图事件，但它需要从您的Adobe Experience Platform沙箱中了解产品视图/用户识别模式的id。

返回Visual Studio代码环境并打 开file_constants.ts。

您现在需要更新以下三行代码：

export const CUSTOM_EVENT_SCHEMA_ID = 'XXXX';   // For "product viewed" and "user identified" events
...
export const CUSTOM_EVENT_DATASET_ID = 'XXXX';
export const CUSTOM_EVENT_ORCHESTRATION_EVENT_ID = 'XXXX';

CUSTOM_事件_模式_ID

您可以通过打开Adobe Experience Platform用户界面、转到 事件 页并搜索Stackchat Chatbot(Global v1.1) 的Demo -事件模式，然后单击以打开模式来获取CUSTOM_模式_模式_ID。

要获取模式id，请从URL复制它——它是查询字符串末尾的长号，如 fa8b21f33509e8ab9d5139b53652b61ec2b18dcea1388411。

复制模式ID并将其粘贴到 _constants.ts文件的此字段 :

export const CUSTOM_EVENT_SCHEMA_ID = 'fa8b21f33509e8ab9d5139b53652b61ec2b18dcea1388411';

您的 file_constants .ts现在应该如下：

CUSTOM_事件_DATASET_ID

现在，我们对数据集也做同样的尝试。 调出Adobe Experience Platform用户界面，打开“ 数据集 ”页面并搜索 Demo System - Stackchat Chatbot(Global v1.1)的 事件数据集，然后单击生成的数据集结果。

从右侧的标签复制数据集ID，并将其粘贴到 _constants.ts文件的此字段 :

export const CUSTOM_EVENT_DATASET_ID = 'paste-your-value-here';

您的 file_constants .ts现在应该如下：

CUSTOM_事件_ORCHESTRATION_事件_ID

剩下最后一项：您的Journey OrchestrationID! 在20. 4中，在您与聊天机器交互后，使用Journey Orchestration触发电子邮件跟进 ，您在Journey Orchestration中创建了自己的事件。 复制您创建的业务流程事件ID并将其粘贴到_constants.ts 文件中的此字段 。

您可以在以下网址找到业务流程eventID:

在此示例中，业务流程 事件ID为bacd25051c871367b0e2d5e4a1af292c6b716673faf85aad776de0e010e0d88a

export const CUSTOM_EVENT_ORCHESTRATION_EVENT_ID = 'XXXX';

您的 file_constants .ts现在应该如此。 在file_constants.ts中保 存更改

你们都准备好了！ 现在，我们只需在Stackchat Studio中编译您的代码并更新您的云功能。

首先，打开终端(视图->终端)。

这将打开VS代码窗口底部的面板。

通过在终端中运行以下命令来构建云功能： npm run build ，然后按enter。

这将生成一个名为的文件夹 。/dist ，它将包含一个名 为cloud-functions.js的文件。

打开文 件cloud-functions.js，复制所有内容并将其粘贴到Stackchat Studio的云函数编辑器中，替换当前代码，然后点击“保 存 ”按钮。

干得好，你快到了！ 点击左 侧导航 底部的“发布”按钮，在您等待Luma Bot发布时哼出怀旧的曲调。

在机器人完成发布后，打开聊天构件并发送消 息／重置 ，以清除聊天会话和开始。

你们会看到这个。 指定您的姓名，然后单 击“发送”。

接下来，选择“ 我需要创意 ”菜单项。

你们会看到这个。 单击 是。

然后，提供您的电子邮件地址。

单击“是”确认您的电子邮 件地址。

然后您将看到Luma产品显示在聊天机器人中。

接下来，点击❤️几款产品上的按钮，生成已查看产品的事件，并触发Journey Orchestration旅程。

几秒钟后，您应会收到一封来自Adobe Experience Platform和Journey Orchestration的电子邮件，其中包含您刚刚喜欢的商品的促销信息。

聊天机器人的下一个问题是，您是否愿意提供有关聊天体验的反馈。 单击 “Sure”。

做出选择，在这种情况下，选择是 好的。

单击“ 乐意”!

提供更多详细反馈，然后单击“ 发送”。

现在，让我们在Adobe Experience Platform实时客户用户档案中验证数据摄取。

转到https://platform.adobe.com 并 导航到 用户档案。 Click the + Browse button. 然后您将看到：

选择“ 身份命名空间 -电 子邮件 ”，然后输入您在Stackchat聊天对话中提交的电子邮件地址。 单 击 视图 ，然后单击 用户档案的用户档案ID。

随后您将在Adobe Experience Platform看到客户用户档案的基本概述。 转至“属 性”。

在“ 属性”中，您将看到NPS得分和详细反馈等内容。 转到 事件。

在 事件​中，您将看到所有发生的交互。 如果单击“ 视图JSON ”按钮，您可以看到更多详细信息，如本例中Nadia Elements Shell产品上产品视图事件的所有详细信息。

如果您收到电子邮件并能够在Adobe Experience Platform直观地显示您的用户档案，则您与Stackchat的集成现在可以正常工作，您可以继续进行下一个练习。

下一步： 20.6在演示网站上测试您的聊天机器人

返回模块20

返回到所有模块