为了Stackchat从Adobe Experience Platform收发事件,您需要在Stackchat Studio中创建并配置集成。 在Stackchat Studio中设置集成之前,您需要创建一个Adobe I/O项目,它允许您与Adobe Experience PlatformAPI交互。
在第3单元中,在练习3. 3.2 —— 设置您的Adobe I/O项目期间,您创建了自己的Adobe I/O项目。 创建Adobe I/O项目时,已创建证书对。 在本练习中,您需要使用该证书对。 如果您不再拥有它,请按照练习3.3.2 - 设置您的Adobe I/O项目中所述的步骤 ,创建新项目或仅生成新证书对。
无论采用哪种方式,在继续之前,您都需要准备好这些文件:
这些内容是在您的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用户界面中输入这些凭据。
在Stackchat Studio中,单击 机器菜 单中的“集成”,然 后在右上 方单击“添加集成”,
接下来,从 模态窗 口中选择Adobe Experience Platform:
现在您将看到空的Adobe Experience Platform集成屏幕。
您现在需要在“身份验证”选项卡中输入所有字段的值。
客户端ID、客户端机密、技术帐户ID和IMS组织ID字段均可通过从此页复制/粘贴JWT服务帐户值来填充:
在填写这些值后,您现在应该有:
“ 私钥 ”字段必须包含作为Adobe I/O项目设置 的一部分生成的 private.key文件的完整内容。 在文 本编辑器中 ,打开private.key,并将整个内容复制/粘贴到私钥文本输入中。
在将您的private.key粘贴到Stackchat Studio后,您现在应该有:
连接ID是DCS Inlet ID的最后一部分,它已保存在配置ID 中。 但是,要保存单击,您的DCS入口ID如下:
--dcsInletId--
现在,您只需复制URL中最终/最 后 的每个字符,并将该值粘贴到Stackchat Studio的 连接ID 字段中,在此示例中: 92b2eb1267c8fc7ee8b41a760a7d616714ca380b449d2d83e68adf692a0a28b1。
然后,单击“验 证凭据”。
如果出现“ Invalid AEP Credentials (AEP凭据无效)”错误,多次会检查您是否正确复制/粘贴了所有内容。
Stackchat向Adobe Experience Platform发送两种事件:用户用户档案事件和行为交互事件。 每种事件类型都需要在Adobe Experience Platform定义专用模式和数据集。 在此步骤中,您将告诉Stackchat,它应在Adobe Experience Platform沙箱中的哪个位置发送用户档案和交互数据。
如果上一步中的凭据正确,您将自动切换到“数据 路由 ”选项卡。 单击“ 提取沙箱”。
提取沙箱后,搜索沙箱名称并将其选中。 您使用的沙箱是 --aepSandboxId--
。 在此示例中,沙箱称为 AEP Enablement FY21。
加载模式和数据集时等待几秒钟。 加载UI后,请选择以下值:
现在点 击保存 配置,以便您可以转到下一步。
在下一个选项卡中,您将Stackchat插槽映射到在Adobe Experience Platform模式中定义的属性。 您将看到:
第一个要执行的映射是Stackchat ID的必需映射。 从“选 择插槽 ”菜单中,选 择用户Id。
接下来,您需要添加多个可选映射。 下面是一张表格,其中列出了要另外映射的内容:
插槽名称 | 架构映射 |
---|---|
ECID | --aepTenantId-- .identification.core.ecid |
电子邮件 | --aepTenantId-- .identification.core.email |
名字 | person.name.firstName |
NpsScore | --aepTenantId-- .customerSactisationScore.score |
Nps反馈 | --aepTenantId-- .customerSactificationScore.feedback |
NPSFeedbackText | --aepTenantId-- .customerSactificationScore.detailedFeedback |
对于每个映射,单击 + 按钮以添加新映射。
例如,让我们通过映射用户的开始ID进行Experience Cloud。 从“选择插槽” 菜单中选择 ECID。
你做得很好! 现在,只需对练习20.2.2中创建的以 下插槽重复此过程。 他们都将为您设置相应的模式属性。
您的最终映射应当如下:
完成所有映射后,请点 击右上 方的更新映射。
在此选项卡中,您将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 |
您的最终映射应当如下:
完成所有映射后,请点 击右上 方的更新映射。
在某些情况下,除了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';
您可以通过打开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现在应该如下:
现在,我们对数据集也做同样的尝试。 调出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现在应该如下:
剩下最后一项:您的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代码窗口底部的面板。
确保您在正确的目录中工作。 对于以下步骤,我们需要在/cloud-functions 目录中工作 。 要在终端中确 认 此类型pwd(打印工作目录),然后按Enter键。 如果打印的路径以/cloud-functions结 束 ,则您已全部设置,如果不尝试运行 cd cloud-functions来设置正确的目录 。 现在,重新运 行pwd,您应该看到路径结尾 为/cloud-functions。
通过在终端中运行以下命令来构建云功能: npm run build ,然后按enter。
这将生成一个名为的文件夹 。/dist ,它将包含一个名 为cloud-functions.js的文件。
打开文 件cloud-functions.js,复制所有内容并将其粘贴到Stackchat Studio的云函数编辑器中,替换当前代码,然后点击“保 存 ”按钮。
干得好,你快到了! 点击左 侧导航 底部的“发布”按钮,在您等待Luma Bot发布时哼出怀旧的曲调。
在机器人完成发布后,打开聊天构件并发送消 息/重置 ,以清除聊天会话和开始。
你们会看到这个。 指定您的姓名,然后单 击“发送”。
接下来,选择“ 我需要创意 ”菜单项。
你们会看到这个。 单击 是。
然后,提供您的电子邮件地址。
单击“是”确认您的电子邮 件地址。
然后您将看到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在演示网站上测试您的聊天机器人