GetMyBot 知識庫

已儲存的事件漏斗

設定步驟並查看有多少人從瀏覽商品走到付款、在哪一步離開。

本頁內容

漏斗呈現客戶逐步前進的情況。例如 100 人看了商品,30 人開始結帳,10 人付款。報告有助於找出人們最常停在哪一步。

漏斗使用平台已收集的事件。你設定事件順序與完成期限,也可納入分析總覽中反應執行以外的事件。

建立漏斗

開啟**「分析 → 漏斗」**,建立 2 至 20 個步驟。替每步命名,選擇一種或多種可替代事件;任一事件符合即算完成該步。

必要時可限制步驟,例如只計入特定受眾區隔。也能選擇已識別客戶、匿名訪客或兩者。事件、屬性和條件從清單選擇,此處不能寫自訂表示式。

步驟順序嚴格:必須先完成步驟 1,才可能到達步驟 2。事件時間相同時,採資料庫中的穩定順序;早於前一步的事件不會完成後續步驟。

時間、個人資料與受眾

報告需提供 UTC 的開始時間 from 和結束時間 to。包含開始時刻,不包含結束時刻;範圍最長 366 天。另需指定轉換視窗,即客戶進入下一步的期限,介於一分鐘與 366 天;超時不計。

報告依統一的客戶資料(標準客戶資料)計人數。若來源支援合併,已合併資料的事件算同一人。匿名事件依所選篩選器計算,但不會自動變成已知客戶的事件。

區隔成員資格取自查詢當下已發佈的區隔版本,不是歷史快照。因此今天改動區隔,今天查同一段歷史期間的報告,受眾可能改變;事件時間範圍本身不變。

請留意轉換模式:

  • 全部目前只顯示每位客戶第一次成功完成的路徑,與首次相同。此模式為相容性保留,尚不會統計所有完成次數。
  • 首次保留第一次有效轉換。
  • 再次會保存第一次之後的成功路徑,但報告目前不會顯示它們。任何模式的數字、分類和人員清單都只使用每位客戶一條最佳路徑,因此目前不適合用「再次」分析回購。

解讀報告

每步顯示人數、相對第一步與前一步的到達比例、離開比例,以及步驟間的時間中位數。中位數表示一半的人更快、一半的人更慢。依事件屬性分類時,最多單獨顯示 25 個值,其餘合併為其他。

每日圖表使用 UTC,涵蓋整個 [from, to) 範圍;第一天可能不是完整一天,其後每天從 UTC 午夜開始。沒有事件的日期顯示零。

警告反映資料特性,不是統計顯著性。zero_denominator 表示第一步無人到達,無法計算比例。high_cardinality_truncated 表示前 25 個分類值以外已合併為其他。沒有 partial_data 警告。沒有分母時介面顯示零,不會顯示錯誤百分比。

群體與區隔

按某步的人數可查看到達該步的人,這群人稱為群體。面板提供簡短客戶資料與分頁清單,不顯示原始事件的系統或敏感欄位。API 使用游標取得下一頁。

已完成某步或停在某步的人可存成動態區隔。每次重新計算都依選定的漏斗版本、步驟、期間與分類篩選更新名單;平台保存的是這些設定,不是一次性的名單。

版本與安全編輯

每次儲存會建立新的版本(revision)。舊報告和區隔可繼續使用舊版。若其他成員先修改了漏斗,請重新整理或複製漏斗。漏斗可以複製、封存或刪除;若仍被其他物件引用,無法刪除。

REST API 範例

查詢報告需有 analytics:read 的個人權杖。下方均為占位值,沒有真實權杖或客戶資料。

curl -X POST "$BASE_URL/api/bots/$BOT_ID/funnels/$FUNNEL_ID/query" \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "revision": 3,
    "from": "2026-07-01T00:00:00Z",
    "to": "2026-08-01T00:00:00Z"
  }'

使用過期版本修改會回傳 409 和 funnel revision conflict;無效或無界的時間範圍可能在不同驗證階段回傳 400 或 422。查詢群體時,傳入相同的有界時間範圍、step_position、completed、limit 和前一頁游標。將群體儲存為區隔另需 segments:write。

相關文章