为数字助理实施 Analytics

随着云计算、机器学习和自然语言处理等技术取得最新进展，数字助理日益成为日常生活的一部分。使用者开始与设备交谈，希望设备能像人一样理解他们所讲的内容并做出响应。随着这些平台变得日益成熟，各种企业品牌可以使用同样逼真且自然的方式来向使用者展现其服务。例如，使用者可以提出以下问题：

本页概要介绍了如何充分利用 Adobe Analytics 来测量并优化这些类型的体验。

数字体验架构概述

现如今的数字助理大多采用了类似的高层架构：

在何处实施 Analytics

实施 Analytics 的一个最佳位置是在应用程序内。应用程序从数字助理处接收意图和详细信息，然后确定如何做出响应。

在请求期间，有两次机会可向 Adobe Analytics 发送数据。

如果您只想记录客户发生的事情，以便日后进行优化，则可以在应用程序返回响应后向 Adobe Analytics 发送请求。这样，您就可以了解到请求以及系统响应的全部相关信息。

新安装

对于某些数字助理，当有人安装相应技能（特别是涉及身份验证）时，您会收到通知。Adobe 建议通过设置上下文数据变量 a.InstallEvent=1 来发送安装事件。此功能并非在所有数字助理上都可用，但当此功能可用于查看客户维系情况时将很有用。以下代码示例会将安装事件、安装日期及应用程序 ID 值发送到上下文数据变量。

GET
/b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.InstallEvent=1&c.a.InstallDate=2017-04-24&c.a.AppID=Spoofify1.0&c.OSType=Alexa&pageName=install
HTTP/1.1
Host:
<xref href="https://example.data.adobedc.net">
  example.data.adobedc.net
 Cache-Control: no-cache
</xref href="https:>

多个助理或多个应用程序

贵组织可能希望使用适用于多个平台的应用程序。最佳实践是在每个请求中各包含一个应用程序 ID。此变量可以在 a.AppID 上下文数据变量中进行设置。格式应遵循 [AppName] [BundleVersion]，例如 BigMac for Alexa 1.2：

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.a.Launches=1&c.Product=AmazonEcho&c.OSType=Alexa&pageName=install  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify2.0&c.a.Launches=1&c.Product=GoogleHome&c.OSType=Android&pageName=install  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

用户/访客识别

Adobe Analytics 可使用 Adobe Experience Cloud Identity Service 将不同时间的互动与同一人关联起来。大多数的数字助理将返回 userID，可使用该值保留不同用户的活动。在大多数情况下，可以将该值作为唯一标识符进行传递。有些平台返回的标识符长于允许的 100 个字符。在这些情况下，Adobe 建议使用标准哈希算法（如 MD5 或 Sha1）对唯一标识符进行哈希处理，使其变为固定长度值。

当您跨不同设备（例如从 Web 到数字助理）映射 ECID 时，使用 ID 服务能发挥最大作用。如果您的应用程序是移动设备应用程序，请按原样使用 Experience Platform SDK，然后使用 setCustomerID 方法发送用户 ID。但是，如果您的应用程序是一项服务，请使用该服务提供的用户 ID 作为 ECID，并在 setCustomerID 中对其进行设置。

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&pageName=[intent]  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

Sessions

由于数字助理采用对话方式，因此它们通常使用会话的概念。例如：

使用者：“Ok Google，帮我叫一辆出租车”

Google：“没问题，你什么时间要用车？”

使用者：“晚上 8:30”

Google：“好了，司机会在晚上 8:30 来接你”

会话对于保持语境非常重要，并有助于收集更多详细信息，从而使数字助理更加自然。如果对会话实施 Analytics，则会在启动新会话时执行以下两个操作：

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.LaunchEvent=1&c.Intent=[intent]&pageName=[intent]  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

意图

每个数字助理都使用自己的算法来检测意图，然后将意图传递至“应用程序”，以便应用程序了解要采取什么行动。这些意图是对请求的简洁表达。

例如，如果用户说“Siri，从我的银行应用中向John支付昨晚的晚餐费20美元”，则其意图可能类似于​ sendMoney。

通过将其中每个请求作为 eVar 发送，您将能够对会话应用程序的每个意图运行路径报告。此外，请确保您的应用程序可以处理无意图的请求。 Adobe 建议将“未指定意图”传入给意图上下文数据变量，而不是忽略变量。

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0&c.a.LaunchEvent=1&c.Intent=SendPayment&pageName=[intent]  HTTP/1.1
Host: example.sc.adobedc.net
Cache-Control: no-cache

或

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0&c.a.LaunchEvent=1&c.Intent=No_Intent_Specified&pageName=[intent]  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

参数/槽/实体

除了意图之外，数字助理通常还会使用一系列键值对来提供意图详情。这些键值对被称作槽、实体或参数。例如，“Siri，从我的银行应用中向 John 支付昨晚的晚餐费 20 美元”这一请求将具有以下参数：

通常情况下，应用程序中的这些值的数量有限。要在 Analytics 中跟踪这些值，可将这些值发送到上下文数据变量，然后将每个参数分别映射到一个 eVar。

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0=1&c.a.LaunchEvent=1&c.Intent=SendPayment&c.Amount=20.00&c.Reason=Dinner&c.ReceivingPerson=John&c.Intent=SendPayment&pageName=[intent]  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

错误状态

有时，数字助理会向应用程序提供它不知道要如何处理的输入内容。例如，“Siri，从我的银行应用中向 John 支付昨晚的晚餐费 20 袋煤”。

若出现这种情况，请让应用程序请求数字助理做出澄清说明。此外，还要向 Adobe 发送相应数据以指示应用程序出现错误状态，并同时发送用于指定所发生错误类型的 eVar。请务必包括输入内容不正确和应用程序遇到问题等错误。

GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0&c.Error=1&c.ErrorName=InvalidCurrency&pageName=[intent]  HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache

设备功能

虽然大多数平台不会公开与用户对话的设备，但却会公开所用设备的功能。例如，音频、屏幕、视频等。这一信息非常有用，因为它指明了与用户进行交互时可使用的内容类型。在测量设备功能时，最好按字母顺序将它们串联起来。

示例：":Audio:Camera:Screen:Video:"

创建区段时，可使用前导冒号和尾随冒号。例如，显示所有使用 :Audio: 功能的点击。

示例