Nguồn chuyển đổi

Màn hình Attribution (Nguồn chuyển đổi) là nơi chứa webhook nhận lead của workspace, đồng thời cho phép bạn kiểm soát cách các field trong payload thô được chuyển thành các field chuẩn hóa gclid/utm_*/thông tin lead mà mọi đích đến phía sau nhìn thấy.

Nguồn webhook

Ở đầu trang, khối Webhook Source Configuration hiển thị URL endpoint của workspace — dạng https://your-app/api/hooks/<token>. Đây là URL duy nhất mà một form, cửa hàng, hay tích hợp CRM sẽ POST payload lead tới. Bấm biểu tượng copy cạnh ô URL để sao chép.

Nếu workspace chưa có endpoint nào, ô này hiển thị dòng Configure Supabase + seed to generate a webhook URL và nút Test Webhook bị vô hiệu hóa.

Test Webhook

Bấm Test Webhook sẽ POST một payload mẫu cố định thẳng tới URL đó (với timestamp mới mỗi lần bấm) và in ra JSON phản hồi thô ngay bên dưới nút. Payload mẫu như sau:

{
  "event_type": "form_submission",
  "timestamp": "<ISO timestamp, sinh ra khi bấm>",
  "query_params": {
    "gclid": "TeSt_GCLiD_12345",
    "utm_source": "Google",
    "utm_medium": "CPC",
    "utm_campaign": "Search_Brand_NA"
  },
  "user": {
    "name": "Jane Doe",
    "email": "[email protected]",
    "phone": "+15551234567"
  }
}

Cách này hữu ích để xác nhận endpoint có nhận được request không, và xem trọn vẹn cách một payload có GCLID và UTM được trích xuất, gán nguồn — mà không cần một website hay form thật.

Quy tắc trích xuất tham số

Parameter Extraction Rules là bảng ánh xạ giữa payload webhook thô và các field chuẩn hóa mà Averosi hiểu. Mỗi rule gồm hai phần:

• Source path — đường dẫn dot-notation vào JSON body đến, ví dụ query_params.gclid hoặc user.email.
• Canonical field — field đích mà giá trị trích xuất được ghi vào (dropdown liệt kê tập field cố định mà engine attribution hiểu).

Dùng Add mapping rule để thêm dòng mới, sửa trực tiếp source path, hoặc xóa dòng bằng biểu tượng thùng rác. Các dòng có source path rỗng sẽ tự động bị loại bỏ khi lưu. Số rule hiển thị ở header của card chỉ tính các dòng không rỗng. Không có gì được ghi cho đến khi bạn bấm Save rules — dòng trạng thái dưới bảng hiển thị Unsaved changes cho tới lúc đó, và All changes saved sau khi đã lưu. Nếu workspace chưa có attribution config, toàn bộ editor bị vô hiệu hóa kèm thông báo Chỉ xem — workspace chưa sẵn sàng.

Mapping trích xuất mặc định

Một workspace mới được khởi tạo sẵn với các rule sau. Chúng bao phủ các tham số click chuẩn của Google Ads cộng với thông tin liên hệ của lead:

Tập đầy đủ các canonical field trong dropdown còn có utm_term, utm_content, referrer, và landing_page — hãy thêm rule cho các field này nếu payload của bạn có mang chúng.

Cách channel, source, campaign được phân loại

Sau khi các field được trích xuất, Averosi dựng object source chuẩn hóa từ đúng những gì các rule hiện tại bắt được — đây là last-touch: chỉ dùng giá trị có trên payload này, không tra cứu lịch sử click của các event trước ở wedge này. Channel được xác định theo thứ tự ưu tiên đơn giản:

1. Nếu trích xuất được gclid, channel được đặt là google_ads — GCLID được coi là tín hiệu paid Google Ads rõ ràng, không mập mờ.
2. Ngược lại, nếu trích xuất được utm_source, channel nhận giá trị đó.
3. Ngược lại nếu không có cả hai, channel quay về Default source cấu hình trong panel Normalization (mặc định là direct).

Các field UTM còn lại (utm_medium, utm_campaign, utm_term, utm_content) cùng referrer và landing_page được sao chép nguyên vào source, để trống nếu không trích xuất được.

Từ source đó, panel Attribution Model (last-click hoặc first-click, cùng cửa sổ lookback theo ngày) được ghi lại kèm một object attribution suy ra: matched_source lấy theo thứ tự utm_source → channel → "direct", matched_campaign và matched_keyword lấy từ utm_campaign/utm_term, còn gclid được sao chép nguyên. Ở wedge này các giá trị này được lấy trực tiếp từ ngữ cảnh UTM/click của chính payload — một giai đoạn sau sẽ làm giàu matched_* từ Google Ads API dựa trên gclid.

Liên quan

• Webhook & API — cấu trúc payload, header, và đoạn mã form mẫu để gửi lead thật.
• Leads — nơi các lead đã trích xuất/gán nguồn xuất hiện sau khi nhận vào.
• Khái niệm cốt lõi — canonical event, endpoint, và hàng đợi fan-out lead tới các đích đến.