Truyền tham số và postback
Một nguồn kết nối nền tảng và Qubix theo cả hai chiều:
- Từ đường dẫn vào Qubix — khi một khách truy cập nhấp vào quảng cáo, Qubix lấy các tham số cần thiết từ đường dẫn (mã định danh quảng cáo, pixel, v.v.) và gắn chúng vào lượt truy cập.
- Từ Qubix đến nền tảng — khi một sự kiện xảy ra (đăng ký, nạp tiền), Qubix gửi một postback đến nền tảng để nền tảng biết được kết quả.
Cài đặt cho cả hai chiều được thiết lập trong nguồn — xem Tạo một nguồn.
Tham số trong đường dẫn quảng cáo
Việc lấy giá trị nào từ đường dẫn được thiết lập bằng bảng Tham số của nguồn. Với mỗi tham số, bạn chỉ định:
- Khóa URL — giá trị đến trong đường dẫn dưới khóa nào;
- Placeholder — nền tảng sẽ thay thế gì vào giá trị (macro riêng của nó hoặc một giá trị cố định).
Ví dụ về một đường dẫn cho quảng cáo Facebook:
https://your-domain/?pixel=123456789&ad_id={{ad.id}}
Ở đây {{ad.id}} là một macro của Facebook: khi hiển thị quảng cáo, nền tảng tự thay thế nó bằng mã định danh thực. Đường dẫn hoàn chỉnh cho nguồn của bạn được Qubix lắp ráp trong khối URL mẫu cho một quảng cáo trên biểu mẫu nguồn — bạn có thể sao chép và dán nó vào trường URL của quảng cáo trên nền tảng.
Tham số Ad ID cần thiết để liên kết các lượt nhấp với quảng cáo và xem thống kê theo chúng. Không có nó nguồn vẫn tiếp tục hoạt động, nhưng phân tích chi tiết theo từng quảng cáo sẽ không khả dụng.
Về các tham số ở phía đường dẫn chiến dịch — Đường dẫn chiến dịch và tham số.
Postback S2S: thông báo cho nền tảng
Postback (server-to-server, S2S) là một yêu cầu mà Qubix gửi đến nền tảng khi một sự kiện xảy ra. Mẫu yêu cầu được thiết lập trong trường Postback S2S của nguồn. Các macro được chèn vào mẫu — Qubix sẽ thay thế giá trị thực vào chúng trước khi gửi:
| Macro | Giá trị |
|---|---|
{external_id} | Mã định danh lượt truy cập/lead ở phía nền tảng. |
{status} | Trạng thái sự kiện (ví dụ, đăng ký, nạp tiền, từ chối). |
{revenue} | Doanh thu của sự kiện. |
{payout} | Khoản chi trả của sự kiện. |
{currency} | Loại tiền tệ. |
{sub_id_N} | Các nhãn bổ sung (sub_id_1, sub_id_2, v.v.). |
{tid} | Mã định danh giao dịch. |
Ví dụ về mẫu postback:
https://source.com/postback?subid={external_id}&status={status}&payout={revenue}
Facebook: Conversions API thay cho postback
Đối với một nguồn theo mẫu facebook, postback thông thường không được sử dụng. Thay vào đó, Qubix gửi các sự kiện trực tiếp đến Facebook Conversions API. Bạn chỉ thiết lập ánh xạ sự kiện: sự kiện Qubix nào tương ứng với sự kiện Facebook nào (ví dụ, nạp tiền → Purchase). Mã định danh pixel được lấy từ đường dẫn nhấp, còn access token — từ sổ đăng ký pixel.
Thêm — Facebook Conversions API và Pixels.