设置Adobe Analytics和Customer Journey Analytics analytics-setup
将您应用的事件发送到Adobe Analytics、Customer Journey Analytics或两者。 LLM Apps通过您拥有的数据流将事件转发到Adobe Experience Platform Edge Network。 数据流将事件路由到您添加到它的每个服务。
- Adobe Analytics报告LLM平台调用的操作、用户选择的链接构件以及每个调用背后的意图。
- Customer Journey Analytics在您基于Experience Platform数据构建的数据视图中，按人员分析相同的事件。
此设置与LLM Apps中的内置分析不同。
在本指南中：了解LLM Apps在Experience Platform、Adobe Analytics和Customer Journey Analytics中需要哪些设置，以及指向每个产品屏幕的Experience League过程的链接。 接下来，在应用程序中启用Analytics，部署到暂存环境，并在部署到生产环境之前验证数据。
设置核对清单 setup-checklist
完成为您使用的服务标记为 必需 的每个步骤。 跳过的步骤很少显示错误。 相反，数据并未到达。
在同一Experience Platform沙盒中创建命名空间、架构、数据集和数据流。 在生产中使用您计划从中报告的沙盒和数据流。 在应用程序中保存数据流后，请与LLM应用程序团队联系以进行更改。
开始之前 before-you-begin
您需要：
- 支持的运行时和SDK。 您的处理程序存储库必须使用
@adobe/llm-apps-runtime1.2.0或更高版本。 对于EDS小组件，请使用LLM应用程序SDK 0.1.13或更高版本。 若要在启用Analytics之前将旧版应用程序更新为最新的运行时和SDK，请按照升级现有应用程序中的说明进行操作。 满足这些要求的应用程序不需要升级。 - 代理字段组。 必须为代理信息和对话事件字段组启用您的组织。 如果向架构添加字段组时未显示这些字段组，请联系您的Adobe客户团队。 请参阅实施对话分析。 操作调用记录在代理信息的
agenticExperience.tools字段中，该字段位于Experience Platform的Beta中。 - Experience Platform权限，用于在沙盒中创建身份命名空间、架构、数据集和数据流。
- 用于Adobe Analytics：管理报表包和处理规则的权限。 默认情况下，产品管理员具有这两个角色。
- 对于Customer Journey Analytics：产品管理员创建连接和数据视图的访问权限。
您的应用程序发送的内容 what-your-app-sends
启用Analytics和部署后，您的应用程序会发送两种事件：
eventTypemcp.tool_callweb.webinteraction.linkClicks在Adobe Analytics中，每个操作调用都计为名为mcp:<code identifier>的页面的页面视图，而每个小组件交互都计为链接点击。 查看Adobe Analytics中的Edge Network事件类型。
每个action调用和每个Widget交互都是Experience Platform数据集中的一个Adobe Analytics点击和一个事件。 在高流量应用程序上，在启用Analytics之前，请检查您的合同是否涵盖此流量。
在阅读报告时，请牢记以下详细信息：
- 失败的调用包含登录提示。 如果某些操作需要登录，则预期这些操作会有更高的失败率。
- 未记录某些被拒绝的呼叫。 当ChatGPT以外的平台调用需要在没有有效登录或所需范围的情况下登录的操作时，调用在操作运行之前被拒绝，并且不发送任何事件。 在每次操作都需要登录的应用程序上，任何没有登录的调用都会以相同的方式被拒绝。
- 用户意图经常缺失。 平台决定是否提供该服务，因此许多呼叫没有服务，显示为未指定。
- 平台详细信息不尽相同。 目前，ChatGPT提供所有这些功能。 对于Claude，仅记录平台名称。
- 小组件标签来自页面。 要设置稳定标签，请将
data-analytics属性添加到链接或按钮。 否则，会使用其可见文本。
要选择收集用户意图的操作，请参阅配置Analytics。
事件如何识别人员 identities
MCPHOSTUSERMCPHOSTUSER ID在可用时作为辅助标识包括在内。ECID某些平台（如Claude）不提供用户ID。 来自这些平台的操作调用没有标识，因此Customer Journey Analytics将跳过它们。
- Customer Journey Analytics将用户的操作调用计为一个人，但将其小组件的交互计为每个操作调用的不同人。
- Adobe Analytics可能会将每个操作调用计为新访客。
步骤1：创建身份命名空间 identity-namespace
对于 Adobe Analytics和Customer Journey Analytics是必需的。
操作调用识别MCPHOSTUSER命名空间中的人员，因此命名空间必须存在于沙盒中。 使用以下设置创建自定义命名空间：
MCP host user或您选择的其他名称MCPHOSTUSER，与显示的完全相同有关过程，请参阅创建自定义命名空间。
第2步：创建架构 schema
对于 Adobe Analytics和Customer Journey Analytics是必需的。
数据流和数据集都使用此架构。 使用以下设置创建架构：
AEM LLM Apps您不需要Adobe Analytics ExperienceEvent字段组。 用户意图改为通过处理规则达到Adobe Analytics。 请参阅步骤4。
步骤3：创建数据集 dataset
需要： Customer Journey Analytics。
数据集将您的应用程序事件存储在Experience Platform中。 使用以下设置创建数据集：
有关过程，请参阅创建数据集。
步骤4：准备报表包 report-suite
需要： Adobe Analytics。
Adobe Analytics自动映射页面名称和链接字段，因此mcp:<code identifier>页面和小组件链接点击不需要额外设置。 用户意图需要一个eVar和一个处理规则。
创建或选择报表包 create-report-suite
创建报表包，或选择现有报表包。 记下完整的报表包ID，包括Adobe Analytics添加的前缀。 您需要步骤5中的ID。
有关过程，请参阅创建报表包。
启用用户意图eVar user-intent-evar
在报表包的转化变量中，使用以下设置启用eVar：
User Intent如果报表包已使用eVar3，请选择另一个未使用的eVar，然后在处理规则中使用该eVar。
有关过程，请参阅添加或编辑转化变量。
创建处理规则 processing-rule
Adobe Analytics将用户意图作为上下文数据变量接收，而不是作为eVar接收。 要了解原因，请参阅隐式映射。 创建一个将用户意图复制到eVar中的处理规则：
- 条件：上下文数据变量
a.x.conversation.prompt.raw.0.purpose等于intents。 - 操作：使用上下文数据变量
a.x.conversation.prompt.raw.0.text覆盖 用户意图(eVar3) 的值。
如果没有此规则，用户意图维度将保留为空。 该规则仅适用于保存后收集的数据。 构件交互不带有用户意图，因此规则不会更改它们。
其他字段，例如调用失败还是平台名称，也作为上下文数据变量到达。 要在Adobe Analytics中报告这些规则，请以相同方式创建更多处理规则。
步骤5：创建数据流 datastream
对于 Adobe Analytics和Customer Journey Analytics是必需的。
数据流接收您应用程序的事件并将它们转发到您添加的每个服务。
创建数据流 create-datastream
使用以下设置创建数据流：
在与架构相同的沙盒中创建数据流。 创建数据流后，无法更改该沙盒。
有关过程，请参阅创建数据流。
添加服务 add-services
为每个目标添加服务：
有关过程，请参阅将服务添加到数据流、Adobe Analytics设置和Adobe Experience Platform设置。
然后从数据流详细信息中复制数据流ID。 在步骤6中需要它。
步骤6：启用Analytics并部署到暂存环境 enable-analytics
对于 Adobe Analytics和Customer Journey Analytics是必需的。
步骤7：创建连接和数据视图 cja
需要： Customer Journey Analytics。
创建连接 connection
使用以下设置从步骤3创建连接并添加数据集：
LLM Apps events在此人员ID中，Customer Journey Analytics使用每个事件的主标识作为人员，并跳过没有主标识的事件。 查看事件如何识别人员。
有关过程，请参阅创建连接、事件数据集设置和将身份映射用作人员ID。
创建数据视图 data-view
使用以下设置创建连接的数据视图：
LLM Apps将这些架构字段添加为组件：
agenticExperience.tools.nameagenticExperience.tools.failedagenticExperience.tools.errorReasonagenticExperience.agents.nameconversation.prompt.raw.textconversation.conversationIDweb.webInteraction.name添加文本字段（如用户意图）作为维度。 添加为量度的文本字段只能计数，按其值划分时，显示无效。
步骤8：验证数据并部署到生产环境 verify
对于 Adobe Analytics和Customer Journey Analytics是必需的。
从支持的LLM平台在暂存应用程序中调用操作，并在其小部件中选择链接。 查看ChatGPT中的测试或Claude中的测试。 然后检查您设置的每个服务：
mcp:<code identifier>，自定义链接行，意图文本每个服务都会延迟处理数据，因此新事件不会立即显示。
要生成报告，请参阅在Adobe Analytics中创建项目、自由格式表概述和在Customer Journey Analytics中创建项目。
当数据正确时，将您的应用程序部署到生产环境。
限制 limitations
- 小组件交互拆分为许多人。 每个操作调用都会获得一个新的ECID，因此Customer Journey Analytics会将来自不同操作调用的构件交互计为不同的人员。 查看事件如何识别人员。
- 没有指向您网站的链接。 当有人浏览指向您网站的小组件链接时，网站访问未链接到对话。
- 暂存和生产共享报告。 两个环境都会发送到相同的数据流，而事件不会记录发送它们的环境。
- 某些平台不发送标识。 未提供用户ID的平台（如Claude）的操作调用在Customer Journey Analytics中被跳过。
- 每个操作调用一圈。 每个操作调用均记录为其自身的对话轮次，因此触发多个操作的提示将计为多个轮次。
疑难解答 troubleshooting
mcp:<code identifier>，但用户意图，并且操作字段为空@adobe/llm-apps-runtime 1.2.0或更高版本，并且您在升级后进行了部署。 在开始之前🔗，请参阅。