實驗與歸因
比較訊息或流程版本,讓客戶持續看到同一版本,並了解報告、收入及限制。
本頁內容
實驗可比較不同版本,例如彈出視窗的兩種優惠文字,或活動的兩條分支。你設定各版本的受眾比例和目標,例如付款,再由報告查看結果。
版本會固定指派給客戶或一次活動執行。即使同一事件重複送入,同一參與者也不會換到其他版本。這稱為決定性分配。
設定版本
加入 2 至 5 個版本,分配全部受眾,總計必須正好 100%。API 使用基點:100 基點為 1%,總和必須是 10,000。可設定對照組,例如不向其顯示訊息。接著選擇指派的單位:
- 使用者:同一人始終留在同一版本。
- 流程:同一次活動執行留在同一分支;同一客戶下次執行可能取得另一版本。
指派會連同實驗版本和識別碼保存,因此重複的按鈕回呼(callback)不會使參與者換組。
啟動前設定受眾、主要與次要目標、報告收入金額的來源,以及歸因視窗:互動後多久內發生的結果算入本次互動。金額可依設定來自固定值、事件屬性、付款或 CRM 商機。實驗版本可參照相容的內容。
版本與生命週期
狀態包括草稿、執行中、已暫停、已完成、已取消、已封存。啟動使用當前不可變版本;暫停不改變既有指派。完成或取消後可以封存。
首次向參與者展示(exposure)後,修改文字或分配比例會建立新版本;舊版本仍可在報告中查看。比較時請選對版本編號。勝出版本只可手動指定一次,封存後仍能看到。指定勝出版本本身不能證明差異具有統計可靠性。
事件與歸因
報告包括版本指派、展示、送達、開啟、點擊、回覆、目標完成(轉換)、退訂和投訴。同一事件重送不會重複計入,因為每筆資料都有固定的來源事件 ID。
收入按幣別分開,以最小貨幣單位保存。例如 1250 與 EUR 表示 €12.50。整合應以有號 64 位整數傳金額、ISO 4217 代碼傳幣別。EUR、RSD、USD 不會默默相加;跨幣別比較需另行依指定時點匯率換算。
報告一次選擇一種歸因模型:
- 首次接觸:轉換歸給第一個符合條件的接觸。
- 最後接觸:轉換歸給最後一個符合條件的接觸。
- 實驗指派:轉換歸給版本指派。
介面與 API 回應會明示所選模型及不可變版本的歸因視窗,不會將多種模型混入同一總計。
警告與群體
警告可提示資料問題:實驗仍在進行、某版本展示少於 30 次、已指派但無展示記錄、實際受眾比例嚴重偏離設定,或點擊與轉換數多於展示數。選擇勝出版本前,請檢查送達與事件紀錄。這些警告不會評估統計顯著性。
這裡的群體是被指派某版本的人,可分頁查看;API 使用游標取得下一頁。若按區隔篩選報告,使用的是目前已發佈的成員名單,不是實驗當時的快照。
彈出視窗與活動的相容性
從舊彈出視窗計數系統遷移時,必須先遷移舊事件。回訪者會保留已看過的版本,避免同一流程中途換優惠。彈出視窗統計暫時保持舊回應格式,並沿用舊計數,直到新舊結果一致。
活動分支(split)遷移會保存切換時間(cutover)。較早開始的活動執行仍採舊分配;其完成後才會提供整合報告,因為缺少的舊指派無法可靠地重建。
API 與 MCP 範例
REST 報告需要 experiments:read 的 PAT 和機器人的「分析」權限。時間須為有界的 RFC3339 UTC;範例沒有真實權杖或客戶資料。
curl -X POST "$BASE_URL/api/bots/$BOT_ID/experiments/$EXPERIMENT_ID/report" \
-H "Authorization: Bearer $PAT" \
-H "Content-Type: application/json" \
-d '{
"version": 2,
"attribution_model": "assignment",
"from": "2026-07-01T00:00:00Z",
"to": "2026-08-01T00:00:00Z",
"segment_id": "00000000-0000-4000-8000-000000000000"
}'
400 表示報告請求無效。404 表示此機器人無法存取該實驗或指定版本。409 用於版本衝突或勝出版本選擇衝突,不表示報告版本不存在。讀取指派群體時,使用 version、可選 variant、limit 及前一頁游標。
MCP 只提供共用實驗的唯讀工具,同樣需要 experiments:read:
{"name":"get_experiment_report","arguments":{"bot_id":"<bot-id>","experiment_id":"<experiment-id>","version":2}}
另有 list_experiments 和 get_experiment。MCP 不會啟動、暫停或編輯實驗,也不能選勝出版本、建立指派或記錄事件。