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。 你们会看到这个。

Stackchat

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

Stackchat

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

Stackchat

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

Stackchat

20.5.2在Stackchat中添加AdobeIO凭据

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

StackchatAdobe Experience Platform集成

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

StackchatAdobe Experience Platform集成

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

StackchatAdobe Experience Platform集成

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

JWT服务帐户字段

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

Stackchat

在填写这些值后,您现在应该有:

Stackchat

私钥

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

Stackchat

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

Stackchat

连接ID

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

--dcsInletId--

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

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

StackchatAdobe Experience Platform集成

注意

如果出现“ Invalid AEP Credentials (AEP凭据无效)”错误,多次会检查您是否正确复制/粘贴了所有内容。

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

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

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

StackchatAdobe Experience Platform集成

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

StackchatAdobe Experience Platform集成

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

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

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

StackchatAdobe Experience Platform集成

20.5.4用户档案映射

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

StackchatAdobe Experience Platform集成

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

StackchatAdobe Experience Platform集成

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

插槽名称 架构映射
ECID --aepTenantId--.identification.core.ecid
电子邮件 --aepTenantId--.identification.core.email
名字 person.name.firstName
NpsScore --aepTenantId--.customerSactisationScore.score
Nps反馈 --aepTenantId--.customerSactificationScore.feedback
NPSFeedbackText --aepTenantId--.customerSactificationScore.detailedFeedback

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

StackchatAdobe Experience Platform集成

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

StackchatAdobe Experience Platform集成

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

您的最终映射应当如下:

StackchatAdobe Experience Platform集成

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

20.5.5事件映射

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

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

插槽名称 架构映射
用户ID --aepTenantId--.identification.core.stackchatId
ECID --aepTenantId--.identification.core.ecid
电子邮件 --aepTenantId--.identification.core.email

您的最终映射应当如下:

StackchatAdobe 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 事件。

StackchatAdobe Experience Platform集成

该按❤️钮已配置为 回传按钮 ,这意味着当用户单击它时将调用云函数。 按钮❤️配置为调用 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

VSC

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

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。

VSC

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

VSC

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

export const CUSTOM_EVENT_SCHEMA_ID = 'fa8b21f33509e8ab9d5139b53652b61ec2b18dcea1388411';

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

VSC

CUSTOM_事件_DATASET_ID

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

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

VSC

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

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

VSC

CUSTOM_事件_ORCHESTRATION_事件_ID

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

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

ACOP

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

export const CUSTOM_EVENT_ORCHESTRATION_EVENT_ID = 'XXXX';

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

VSC

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

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

vs_terminal-open

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

注意

确保您在正确的目录中工作。 对于以下步骤,我们需要在/cloud-functions 目录中工作 。 要在终端中确 此类型pwd(打印工作目录),然后按Enter键。 如果打印的路径以/cloud-functions结 ,则您已全部设置,如果不尝试运行 cd cloud-functions来设置正确的目录 。 现在,重新运 行pwd,您应该看到路径结尾 为/cloud-functions

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

vs_terminal-open

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

vs-dist-cloud-functions

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

ui_cloud-functions-updated

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

StackchatAdobe Experience Platform集成

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

演示

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

演示

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

演示

你们会看到这个。 单击

演示

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

演示

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

演示

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

演示

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

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

演示

注意

您会注意到,如果您现在重复“我需 要创意流 ”,Luma Bot将记住您之前喜欢的产品并作为推荐显示。 它通过从Adobe Experience Platform获取用户已查看的 产品事件 来实现此目的。

聊天机器人的下一个问题是,您是否愿意提供有关聊天体验的反馈。 单击 “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

返回到所有模块

在此页面上