設定Adobe Analytics和Customer Journey Analytics analytics-setup

IMPORTANT
所有AEM Sites Cloud Service客戶都可使用LLM應用程式來開發及管理自己的應用程式。 一旦計數開始,每個應用程式呼叫都會計入客戶的AEM Sites內容請求。 Adobe會在計量生效前宣告計量速率和開始日期。

將應用程式的事件傳送至Adobe Analytics、Customer Journey Analytics或兩者。 LLM Apps透過您擁有的資料流將事件轉送到Adobe Experience Platform Edge Network。 資料流會將事件路由至您新增的每個服務。

  • Adobe Analytics​會報告LLM平台呼叫的動作、使用者選取的Widget連結,以及每個呼叫背後的目的。
  • Customer Journey Analytics​在您以Experience Platform資料建置的資料檢視中,依個人分析相同事件。

此設定與LLM Apps中的內建分析不同。

在本指南中:​瞭解LLM Apps在Experience Platform、Adobe Analytics和Customer Journey Analytics中需要哪些設定,以及每個產品畫面的Experience League程式連結。 接下來,請在應用程式中啟用Analytics、部署至Stage,並在部署到生產環境之前驗證資料。

設定檢查清單 setup-checklist

針對您使用的服務,完成標籤為​ 必要 ​的每個步驟。 跳過的步驟很少顯示錯誤。 相反地,資料並未送達。

步驟
Adobe Analytics
Customer Journey Analytics
1. 建立身分名稱空間
必要
必要
2. 建立結構描述
必要
必要
3. 建立資料集
不需要
必要
4. 準備報表套裝
必要
不需要
5. 建立資料串流
必要
必要
6. 啟用Analytics並部署到Stage
必要
必要
7. 建立連線和資料檢視
不需要
必要
8. 驗證資料並部署至生產環境
必要
必要

在同一Experience Platform沙箱中建立名稱空間、結構描述、資料集和資料流。 在生產環境中使用您計畫報告的沙箱和資料流。 在應用程式中儲存資料串流後,請聯絡LLM應用程式團隊進行變更。

開始之前 before-you-begin

您需要:

  • 支援的執行階段和SDK。 您的處理常式存放庫必須使用@adobe/llm-apps-runtime 1.2.0或更新版本。 若是EDS Widget,請使用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並部署後,您的應用程式會傳送兩種事件:

事件
eventType
傳送時間
包括
動作呼叫
mcp.tool_call
LLM平台會呼叫應用程式的其中一個動作,包括失敗或傳回登入提示的呼叫。
動作的程式碼識別碼以及呼叫是否失敗。 使用者意圖(當動作收集且平台提供意圖時)。 平台提供時:平台名稱、交談ID、平台的使用者ID、地區設定和組織,以及使用者的大致位置。
Widget互動
web.webinteraction.linkClicks
有人在Edge Delivery Services Widget中選取連結或按鈕。
連結或按鈕標籤,最多100個字元。 當動作呼叫提供時,其交談ID和結束ID。 Adobe Web SDK也會新增Widget框架URL、畫面和瀏覽器視窗大小、當地時間和時區,以及自己的版本。

在Adobe Analytics中,每個動作呼叫都會計為名為mcp:<code identifier>之頁面的頁面檢視,而每個Widget互動都會計為連結點選。 檢視Adobe Analytics🔗中的Edge Network事件型別。

每個動作呼叫和每個Widget互動都是您Experience Platform資料集裡的一個Adobe Analytics點選和一個事件。 在高流量應用程式中,啟用Analytics之前,請檢查您的合約是否涵蓋此流量。

閱讀報表時,請牢記以下詳細資訊:

  • 失敗的呼叫包含登入提示。 如果某些動作需要登入,預期會有較高的失敗率。
  • 未記錄部分被拒絕的通話。 當ChatGPT以外的平台呼叫需要在沒有有效登入或所需範圍的情況下登入的動作時,呼叫會在動作執行前被拒絕,且不會傳送任何事件。 若應用程式中的每個動作都需要登入,則任何未登入的呼叫都會以相同方式遭到拒絕。
  • 使用者意圖經常遺失。 平台會決定是否提供此功能,因此許多呼叫沒有並會顯示為​未指定。
  • 平台詳細資料不盡相同。 目前,ChatGPT提供所有這些。 對於Claude,僅記錄平台名稱。
  • Widget標籤來自頁面。 若要設定穩定標籤,請新增data-analytics屬性至連結或按鈕。 否則,會使用其可見文字。

若要選擇收集使用者意圖的動作,請參閱設定分析。

NOTE
這些事件可包含平台使用者ID和大概的位置。 啟用Analytics之前,請先檢閱您的隱私權政策和資料控管設定。

事件如何識別人員 identities

事件
主要身分
命名空間
動作呼叫
LLM平台提供的使用者ID時
MCPHOSTUSER
Widget互動
Edge Network在動作呼叫期間發出的Experience Cloud ID (ECID)。 MCPHOSTUSER ID在可用時包含為次要身分識別。
ECID

有些平台(例如Claude)不提供使用者ID。 來自這些平台的動作呼叫沒有身分,因此Customer Journey Analytics會略過它們。

NOTE
每個動作呼叫都會取得新的ECID,而Widget互動會使用顯示Widget之動作呼叫的ECID。 因此:
  • Customer Journey Analytics會將使用者的動作呼叫計為一個人,但將其Widget互動計為每個動作呼叫的不同人。
  • Adobe Analytics可能會將每個動作呼叫計為新訪客。

步驟1:建立身分名稱空間 identity-namespace

需要: Adobe Analytics和Customer Journey Analytics。

動作呼叫會識別MCPHOSTUSER名稱空間中的人員,因此您的沙箱中必須存在名稱空間。 使用下列設定建立自訂名稱空間:

設定
值
顯示名稱
MCP host user或您選擇的其他名稱
身分符號
MCPHOSTUSER,與所示完全相同
身分識別類型
個別跨裝置識別碼

如需程式,請參閱建立自訂名稱空間。

步驟2:建立結構 schema

需要: Adobe Analytics和Customer Journey Analytics。

資料串流和資料集都使用此結構描述。 使用下列設定建立結構描述:

設定
值
結構描述型別
標準,使用​ 手動 ​選項建立
基底類別
體驗活動
欄位群組
代理資訊、交談事件、Web詳細資訊、環境詳細資訊和實作詳細資訊
顯示名稱
任何名稱,例如AEM LLM Apps
IMPORTANT
新增全部五個欄位群組。 LLM Apps需要代理資訊和交談事件才能進行動作呼叫。 其他三個則包含事件也包含的頁面、連結、裝置、環境和實作欄位。 如果欄位群組遺失,Experience Platform可以捨棄這些欄位或拒絕事件。

您不需要Adobe Analytics ExperienceEvent欄位群組。 使用者意圖改為透過處理規則達到Adobe Analytics。 請參閱步驟4。

如需程式,請參閱建立新結構描述和新增欄位群組。

步驟3:建立資料集 dataset

需要: Customer Journey Analytics。

資料集會將您的應用程式事件儲存在Experience Platform中。 使用下列設定建立資料集:

設定
值
建立方法
從結構描述建立資料集
結構描述
來自步驟2的結構描述
名稱
任何名稱,例如AEM LLM Apps

如需程式,請參閱建立資料集。

步驟4:準備報表套裝 report-suite

需要: Adobe Analytics。

Adobe Analytics會自動對應頁面名稱和連結欄位,因此mcp:<code identifier>頁面和Widget連結點選不需要額外設定。 使用者意圖需要eVar和處理規則。

建立或選擇報表套裝 create-report-suite

建立報表套裝,或選擇現有報表套裝。 記下完整的報表套裝ID,包括Adobe Analytics新增的前置詞。 您需要步驟5中的識別碼。

如需此程式,請參閱建立報表套裝。

啟用使用者目的eVar user-intent-evar

在報表套裝的轉換變數中,啟用具有下列設定的eVar:

設定
值
eVar
EVAR3
名稱
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) ​的值。

若沒有此規則,使用者意圖​維度會保持空白。 此規則僅適用於儲存後所收集的資料。 Widget互動沒有使用者意圖,因此規則不會變更這些意圖。

其他欄位(例如呼叫是否失敗或平台名稱)也會以內容資料變數的形式送達。 若要在Adobe Analytics中報告這些規則,請以相同方式建立更多處理規則。

如需程式,請參閱處理規則總覽和處理規則使用案例。

步驟5:建立資料串流 datastream

需要: Adobe Analytics和Customer Journey Analytics。

資料流會接收您應用程式的事件,並將其轉送給您新增的每個服務。

建立資料串流 create-datastream

使用下列設定建立資料流:

設定
值
名稱
任何名稱,例如AEM LLM Apps
對應結構描述
來自步驟2的結構描述

在與結構描述的相同沙箱中建立資料串流。 您不能在建立資料流的沙箱後變更它。

如需程式,請參閱建立資料流。

新增服務 add-services

為每個目的地新增服務:

服務
設定
下列專案需要:
Adobe Analytics
已啟用。 在​ 報表套裝ID ​中,輸入步驟4中的ID。
Adobe Analytics
Adobe Experience Platform
已啟用。 在​ 事件資料集 ​中,從步驟3中選取資料集。 保留其他選項為清除狀態。
Customer Journey Analytics

新增服務 — Adobe Analytics已啟用範例報表套裝ID

Adobe Experience Platform服務 — 已選取事件資料集並清除其他選項

如需程式,請參閱將服務新增至資料流、Adobe Analytics設定和Adobe Experience Platform設定。

然後從資料流詳細資料複製​資料流識別碼。 在步驟6中需要它。

資料流詳細資料 — 已啟用Adobe Analytics和Adobe Experience Platform服務,側面板中有範例資料流ID和對應結構描述

步驟6:啟用Analytics並部署至中繼 enable-analytics

需要: Adobe Analytics和Customer Journey Analytics。

IMPORTANT
儲存後,資料流在「應用程式設定」中為唯讀。 請聯絡LLM應用程式團隊以變更或關閉Analytics。 請先檢查資料串流ID,然後再儲存。 您仍然可以變更資料流本身的報告套裝和資料集。
  1. 開啟您的應用程式,並在左側導覽中選取​設定。

  2. 選取​ Analytics ​索引標籤。

  3. 開啟​啟用分析。

  4. 在​ 資料串流識別碼 ​中,貼上步驟5中的識別碼。

  5. 在​ 需求 ​底下,選取​檢視詳細資料,並確認您的應用程式符合每個需求。

    應用程式設定,Analytics標籤 — 啟用Analytics已開啟,空白的資料流ID欄位和展開的需求清單

  6. 選取​儲存變更。

  7. 將您的應用程式部署到Stage。 此設定會在下次部署到每個環境時生效。

NOTE
資料流會套用至整個應用程式。 「暫存」和「生產」會將事件傳送至相同的資料流,而事件不會記錄傳送它們的環境。 您在Stage上的測試呼叫會出現在與生產流量相同的報表中。

步驟7:建立連線和資料檢視 cja

需要: Customer Journey Analytics。

建立連線 connection

建立連線,並使用這些設定從步驟3新增資料集:

設定
值
沙箱
包含您資料集的沙箱
每日事件平均數量
符合您預期磁碟區的範圍
資料集
來自步驟3的資料集
人員 ID
身分對應
使用主要身分識別命名空間
已選取
時間戳記
時間戳記
資料來源型別
其他
資料來源說明
任何描述,例如LLM Apps events
匯入新資料
匯入所有新資料​已開啟
資料集回填
如果資料集已包含您要分析的事件,則回填所有現有的資料​已開啟
IMPORTANT
開啟​匯入所有新資料。 此設定會建立持續連線,以便在Workspace中自動提供新事件。

透過此人員ID,Customer Journey Analytics會使用每個事件的主要身分做為人員,並略過沒有主要身分的事件。 檢視事件如何識別人員。

如需程式,請參閱建立連線、事件資料集設定和使用身分對應作為人員ID。

建立資料檢視 data-view

使用這些設定在連線上建立資料檢視:

設定
值
連線
您剛才建立的連線
名稱
任何名稱,例如LLM Apps
元件
您要報告的維度和量度。 請參閱下表。

將這些結構欄位新增為元件:

報告
結構描述欄位
新增為
動作
agenticExperience.tools.name
維度
失敗的動作呼叫
agenticExperience.tools.failed
維度
失敗原因
agenticExperience.tools.errorReason
維度
Platform
agenticExperience.agents.name
維度
使用者意圖
conversation.prompt.raw.text
維度
對話
conversation.conversationID
維度
Widget標籤
web.webInteraction.name
維度

新增文字欄位(例如使用者意圖)作為維度。 新增為量度的文字欄位只能計算,依其值劃分時,顯示​無效。

如需程式,請參閱設定資料檢視和元件。

步驟8:驗證資料並部署至生產環境 verify

需要: Adobe Analytics和Customer Journey Analytics。

從支援的LLM平台呼叫中繼應用程式中的動作,然後選取其介面工具集中的連結。 檢視ChatGPT中的測試或Claude中的測試。 然後檢查您設定的每項服務:

服務
檢查位置
有何期望
Experience Platform
從步驟3針對資料集進行的​資料集活動
新擷取的批次,沒有失敗的批次
Adobe Analytics
使用來自步驟4之報表套裝的Workspace專案,並具有自由表格
頁面​名為mcp:<code identifier>的資料列,自訂連結​資料列,用於Widget互動,以及​ 使用者意圖 ​維度中的意圖文字
Customer Journey Analytics
使用步驟7資料檢視的Workspace專案
您的動作呼叫與Widget互動的​事件

每個服務都會延遲處理資料,因此不會立即顯示新事件。

若要建置報表,請參閱在Adobe Analytics中建立專案、自由表格概觀和在Customer Journey Analytics中建立專案。

資料正確時,將應用程式部署至生產環境。

限制 limitations

  • Widget互動會分割成許多人員。 每個動作呼叫都會獲得新的ECID,因此Customer Journey Analytics會將不同動作呼叫的Widget互動計為不同人員。 檢視事件如何識別人員。
  • 沒有您網站的連結。 當有人瀏覽至您網站的Widget連結時,該網站造訪未連結至對話。
  • 中繼和生產共用報告。 兩個環境都會傳送至相同的資料流,而事件不會記錄傳送它們的環境。
  • 某些平台未傳送任何身分。 來自Customer Journey Analytics中不提供使用者ID之平台(例如Claude)的動作呼叫會被略過。
  • 每個動作呼叫一圈。 每個動作呼叫都會記錄為自己的交談輪迴,因此觸發數個動作的提示會計為數個輪迴。

疑難排解 troubleshooting

您所看到的內容
檢查內容
資料集未收到任何批次
將Analytics設定儲存至測試環境後,您便已部署應用程式。 資料串流ID正確。 資料流有​ Adobe Experience Platform ​服務與您的資料集。
批次失敗
結構描述包含步驟2中的所有五個欄位群組。
Adobe Analytics沒有資料
資料流已使用正確的報表套裝ID啟用​ Adobe Analytics ​服務。
頁面​顯示mcp:<code identifier>,但​使用者意圖,而且動作欄位是空的
您的處理常式存放庫使用@adobe/llm-apps-runtime 1.2.0或更新版本,而且您已在升級後部署。 開始之前🔗請參閱。
某些動作的​ 使用者意圖 ​是空的
來自步驟4的處理規則會使用與所示完全相同的內容資料變數(以小寫字母表示),以及正確的eVar。 此動作已開啟​收集使用者意圖。 此規則僅適用於儲存後所收集的資料。
Customer Journey Analytics顯示的事件比資料集還少
匯入所有新資料​已開啟。 系統會略過沒有主要身分的事件,例如來自未提供使用者ID之平台的動作呼叫。
您無法變更資料串流ID或關閉Analytics
啟用後,這些設定在「應用程式設定」中為唯讀。 請連絡LLM應用程式團隊以取得協助。 若要將資料路由到其他地方,請變更資料流本身的報告套裝或資料集。

後續步驟 whats-next

recommendation-more-help
llm-apps-help-main-toc