教學｜Web SDK 安裝驗證與事件追蹤檢查

本文說明兩個 Web SDK 狀態檢查工具的使用方式：

• 安裝狀態檢查：確認 SDK 是否正確載入網站
• 事件追蹤狀態檢查：確認系統是否有收到網站的行為事件

兩個工具各自負責不同層面，若功能運作異常，建議依序確認。

📌 若您同時有使用 WebSDK Identify，請留意：本文的兩個檢查工具主要用於確認 SDK 是否載入 與 網站事件是否有送出。若您要排查會員身分識別是否正常，仍需另外確認網站是否已在登入、註冊或其他已確認身分的流程後主動呼叫 clSdk.identify。

---

確認 Web SDK 是否已正確安裝在網站上。完成 SDK 安裝後可用此工具驗證，日後功能異常時也可隨時回來排查。

如何執行檢查

1. 進入管理中心 > 渠道設定 > Web Channel
2. 點擊「安裝」分頁
3. 在「連接的域名」清單中，找到要檢查的網域，點擊右側的放大鏡圖示
4. 系統會開始執行檢查，約需等待 10–60 秒
5. 檢查完成後，畫面會彈出「安裝驗證結果」視窗

檢查結果

狀態	代表意思	需要處理嗎？
✅ 通過	設定正確	不需要
❌ 失敗	有錯誤，功能無法正常運作	需要立即處理
⚠️ 警告	SDK 核心正常，但背景有小錯誤	建議交工程師排查
ℹ️ 資訊	某項功能目前關閉中，非錯誤	不需要
⏭️ 略過	前面有致命錯誤，此項未執行	修好前面的失敗後重新檢查

當所有項目皆通過（沒有任何「失敗」），視窗頂端會顯示綠色勾勾，代表 SDK 安裝驗證完成。

出現【❌ 失敗】代表什麼

失敗代表 SDK 安裝有根本性的問題，聊天或追蹤功能可能完全無法運作。請截圖結果後聯繫漸強客戶成功團隊：

以下為範例截圖

⚠️ 處理完成後，請重新點擊放大鏡執行一次檢查，確認問題已解決。

出現【⚠️ 警告】代表什麼

警告代表 SDK 核心安裝正常，聊天室通常可以正常顯示，但可能導致部分追蹤事件漏發，或網頁腳本與 SDK 有些微衝突。

不需要立即處理，但建議將結果截圖後交給內部工程團隊排查，確保追蹤資料完整。

出現【ℹ️ 資訊提示】代表什麼

資訊提示不是錯誤，只是通知你某項功能目前處於關閉狀態：

• 網頁對話關閉中：聊天室不會顯示在網頁上
• 網頁追蹤關閉中：網頁行為事件不會被記錄
• 網站導流工具關閉中：SRT 功能未啟用
• 聊天室按鈕未顯示：可能是刻意隱藏或透過特定方式呼叫，非錯誤

如果這些功能是你預期要使用的，請至管理中心確認是否已開啟。

工具二：事件追蹤狀態檢查

SDK 安裝正確，不代表事件追蹤也一定有在運作。此工具用來確認系統是否有收到來自網站的行為事件，可在安裝完成後使用，也可在追蹤相關功能異常時進行排查。

如何執行檢查

1. 進入管理中心 > 渠道設定 > 網站
2. 點擊「一般設定」分頁
3. 找到對應網域，點擊檢查網站追蹤事件
4. 系統會查詢過去 1 小時內是否有收到事件，並顯示結果

系統會檢查哪些事件

事件	觸發時機
page_view	用戶進入任意頁面
add_to_cart	用戶將商品加入購物車
purchase	用戶完成結帳付款

每個事件會顯示「已收到」或「未收到」。若已收到，系統會一併顯示最後一次收到的時間。

顯示「未收到」怎麼辦

請依照以下常見原因逐一排查：

可能原因	建議做法
過去 1 小時內網站沒有對應的使用者行為	請自行前往網站操作一次（例如將商品加入購物車），等待 1–2 分鐘後重新檢查
沒有埋設事件代碼	請工程師確認是否已在對應頁面或操作節點埋設事件追蹤碼
GTM 設定錯誤或未發布	請工程師確認觸發條件是否正確，並確認 GTM 容器已發布
追蹤功能在後台被關閉	請至管理中心確認頻道的「追蹤功能」是否已開啟

為什麼事件追蹤很重要

若系統長期收不到事件，以下功能將無法正常運作：

• 購物車未結帳推播、瀏覽未購買推播：收不到 add_to_cart 或 page_view，系統無法判斷使用者行為，自動化推播無法觸發
• 營收追蹤與推播成效分析：收不到 purchase，系統無法計算轉換率與 ROAS，推播成效無從評估
• 行為分眾：無法依據使用者行為（例如加購過某商品、近期完成購買）建立分眾標籤，精準再行銷將受影響

若排查後問題仍未解決，請聯繫漸強客戶成功團隊，並提供事件檢查結果截圖。

若您要進一步排查 WebSDK Identify，建議同時提供：登入或註冊後前端是否有呼叫 clSdk.identify、Console / Network 截圖，以及是否已依照技術規格設定 customerId 或 email。

💬 需要協助？
安裝或排查過程中如有任何問題，請聯繫漸強實驗室客戶成功團隊，並附上檢查結果的截圖，以便加快排查。