Postback là gì? – Affiliate Top Help Center

Postback là gì

Postback là một yêu cầu HTTP tự động được gửi từ hệ thống của chúng tôi (Affiliate TOP) đến công cụ giám sát hiệu suất của bạn (ví dụ: Keitaro, Voluum, RedTrack) hoặc CRM khi người dùng thực hiện một hành động: đăng ký, nạp tiền, rút tiền, cài đặt ứng dụng, giao dịch, v.v.

Với postback, tất cả dữ liệu chuyển đổi sẽ được gửi đến công cụ theo dõi của bạn mà không cần bất kỳ thao tác thủ công nào.

Postback cho phép bạn:

• Phân tích lưu lượng truy cập theo thời gian thực

• Nhanh chóng điều chỉnh quảng cáo và chiến lược của bạn để cải thiện kết quả chiến dịch và tăng lợi nhuận

• Tìm kiếm và mở rộng quy mô các gói và nguồn lưu lượng truy cập sinh lời nhanh hơn

Postback URL là gì

Đây là một liên kết đặc biệt mà hệ thống của chúng tôi gửi dữ liệu chuyển đổi đến. Nó chứa các tham số – "ô" được điền giá trị trong một sự kiện: click ID, số tiền nạp, ID nhà giao dịch, ID chiến dịch, v.v. Khi một sự kiện xảy ra, hệ thống của chúng tôi sẽ tự động gửi yêu cầu đến URL này cùng với dữ liệu.

Tìm Postback URL ở đâu?

Lấy từ công cụ giám sát hiệu suất hoặc CRM của bạn (Keitaro, Voluum, RedTrack, v.v.). Kiểm tra tài liệu hoặc giao diện của chúng trong mục thiết lập theo dõi postback / S2S.

Ví dụ về Postback URL từ 3 trình theo dõi hàng đầu

Tìm hiểu xem chúng thường trông ra sao và làm quen với việc thêm các tham số của chúng ta.

Keitaro

Ví dụ Postback URL: http://your-keitaro.com/postback?clickid={click_id}&status=approved&payout={sumdep}

Tên tham số clickid được lấy từ tài liệu của Keitaro
{click_id}, {sumdep} là trình giữ chỗ

Voluum

Ví dụ Postback URL: https://your-voluum.com/postback?cid={click_id}&payout={sumdep}

Tên tham số cid là tên Click ID tiêu chuẩn cho trình theo dõi Voluum
{click_id}, {sumdep} là trình giữ chỗ

RedTrack

Ví dụ Postback URL:

https://your-redtrack.com/postback?clickid={click_id}&revenue={sumdep}&status=approved

Tên tham số clickid và revenue được lấy từ tài liệu của RedTrack
{click_id}, {sumdep} là trình giữ chỗ

Quan trọng: Tên tham số (clickid, cid, revenue) phải khớp chính xác với yêu cầu của trình theo dõi của bạn. Các trình giữ chỗ trong dấu ngoặc nhọn ({click_id}, {sumdep}) là của chúng tôi.

Cách thức hoạt động của Postback URL và Tham số

Mỗi tham số bao gồm hai phần:

tên tham số – phần mà trình theo dõi / CRM của bạn yêu cầu (lấy từ tài liệu của trình theo dõi đó)
trình giữ chỗ của chúng tôi trong dấu ngoặc nhọn – phần mà chúng tôi tự động chèn vào.

Ví dụ – visitor_id={click_id}

Vị trí:

visitor_id – tên tham số từ tài liệu của trình theo dõi. Được gửi nguyên trạng. Đây chính xác là tên mà trình theo dõi của bạn yêu cầu
{click_id} – trình giữ chỗ của chúng tôi. Sẽ được thay thế bằng Click ID thực trong suốt sự kiện.

Bên trái (visitor_id, campaign_id, sub_id) – yêu cầu của trình theo dõi.
Bên phải ({click_id}, {campaign_id}) – dữ liệu AffiliateTop.

Tìm Postback URL và Tên tham số ở đâu

Đăng nhập vào công cụ giám sát hiệu suất của bạn (trình theo dõi hoặc CRM)
Tìm mục theo dõi Postback / Server-to-Server (S2S)
Sao chép Postback URL cơ bản và tên tham số từ giao diện hoặc tài liệu
Dán URL vào mục cài đặt của chúng tôi và thêm các trình giữ chỗ: visitor_id={click_id}, amount={sumdep}, v.v.

Ví dụ về cấu trúc Postback URL đầy đủ

Trước sự kiện (với các trình giữ chỗ) – https://your-tracker.com/postback?visitor_id={click_id}&site_id={site_id}&trader={trader_id}&amount={deposit_amount}&campaign_id={campaign_id}

Sau sự kiện (giá trị thực) – https://your-tracker.com/postback?visitor_id=1234567&site_id=4458&trader=902134&amount=23.22&campaign_id=YT_BR_01

Các tham số Postback: Định dạng, Ví dụ và Mục đích

1. Click ID

Trình giữ chỗ của chúng tôi: {click_id}
Trong URL trình theo dõi: visitor_id={click_id} → visitor_id=1234567
Mục đích: Liên kết chuyển đổi với một lần nhấp chuột cụ thể vào quảng cáo. Trình theo dõi biết nguồn lưu lượng truy cập nào đã chuyển đổi
Ý nghĩa: Mã số nhấp chuột duy nhất nhận được từ trình theo dõi của bạn khi sự kiện nhấp chuột xảy ra

2. ID trang web

Trình giữ chỗ của chúng tôi: {site_id}
Trong URL: site_id={site_id} → site_id=4458
Mục đích: Cho biết trang web / vị trí nào đã tạo ra lưu lượng truy cập chuyển đổi. Giúp tối ưu hóa việc mua lưu lượng truy cập
Ý nghĩa: ID của trang web hoặc vị trí hiển thị trong mạng quảng cáo của bạn

3. ID nhà giao dịch

Trình giữ chỗ của chúng tôi: {trader_id}
Trong URL: trader={trader_id} → trader=902134
Mục đích: Liên kết tất cả các hoạt động của một người dùng (nhiều tài khoản, tiền nạp, giao dịch) vào thống kê thống nhất
Ý nghĩa: Mã số định danh nhà giao dịch vĩnh viễn được cấp khi đăng ký lần đầu

4. ID tài khoản của bạn

Trình giữ chỗ của chúng tôi: {a}
Trong URL: account={a} → account=a182haj2nn
Mục đích: Xác định liên kết giới thiệu của bạn. Hữu ích nếu bạn quản lý nhiều tài khoản
Ý nghĩa: Mã giới thiệu của đối tác. Thường mỗi đối tác có một mã

5. Số tiền nạp

Trình giữ chỗ của chúng tôi: {sumdep}
Trong URL: amount={sumdep} → amount=23.22
Mục đích: Hiển thị chính xác số tiền nạp (lần đầu hoặc định kỳ). Dùng để tính toán tỷ suất lợi nhuận đầu tư (ROI) và phân tích giá trị vòng đời khách hàng (LTV)
Ý nghĩa: Số tiền nạp bằng đơn vị tiền tệ đã chọn ($ hoặc ¢). Chỉ hiển thị trong các sự kiện nạp tiền, chẳng hạn như FTD hoặc Nạp tiền lại

6. ID giao dịch

Trình giữ chỗ của chúng tôi: {transaction}
Trong URL: tx_id={transaction} → tx_id=81283192873
Mục đích: Xác định duy nhất từng lượt chuyển đổi. Ngăn ngừa trùng lặp và cho phép phân bổ chính xác
Ý nghĩa: ID nội bộ của sự kiện cụ thể (nạp tiền, rút tiền, v.v.)

7. ID chiến dịch quảng cáo

Trình giữ chỗ của chúng tôi: {ac}
Trong URL: campaign_id={ac} → campaign_id=YT_BR_01
Mục đích: Phân tách thống kê giữa các chiến dịch khác nhau (theo khu vực địa lý, nội dung quảng cáo, trang đích)
Ý nghĩa: Tên hoặc ID của chiến dịch quảng cáo của bạn từ liên kết giới thiệu

8. ID postback tài khoản phụ

Trình giữ chỗ của chúng tôi: {sa}
Trong URL: sub_id={sa} → sub_id=teaser_01
Mục đích: Phân tích bổ sung của bạn (loại lưu lượng truy cập, nội dung quảng cáo, quản trị viên web)
Ý nghĩa: Bất kỳ giá trị nào từ liên kết giới thiệu của bạn (sub1, sub2, v.v.)

9. Lợi nhuận

Trình giữ chỗ của chúng tôi: {profit}
Trong URL: profit={profit} → profit=15.75
Mục đích: Hiển thị số tiền lãi/lỗ từ các giao dịch thực. Cần thiết cho việc theo dõi doanh thu và phân tích hiệu suất
Ý nghĩa: Lợi nhuận ròng (dương hoặc âm) từ hoạt động giao dịch thực của người dùng. Có trong các sự kiện giao dịch thực

Sự kiện kích hoạt cho Postback

Affiliate TOP hỗ trợ postback cho các hành động của người dùng được liệt kê bên dưới. Một postback = một sự kiện. Hãy quyết định sự kiện bạn muốn theo dõi và nhập hoặc nhấp vào các tham số cần thiết để thêm chúng vào Postback URL của bạn.

Đăng ký – người dùng hoàn tất đăng ký tài khoản
Xác nhận email – người dùng xác minh địa chỉ email
Nạp tiền lần đầu (FTD) – khoản tiền nạp đầu tiên của người dùng
Nạp lại tiền – mọi khoản tiền nạp tiếp theo (nạp tiền lặp lại)
Ứng dụng đã được cài đặt – người dùng cài đặt ứng dụng trên điện thoại di động
Giao dịch demo đầu tiên – giao dịch đầu tiên của người dùng trên tài khoản demo
Rút tiền – người dùng hoàn tất rút tiền
Giao dịch thực – người dùng thực hiện giao dịch trên tài khoản giao dịch thực

Mỗi sự kiện đều có bộ tham số khả dụng riêng, như đã đề cập ở trên.

Hướng dẫn thiết lập postback (Hướng dẫn giao diện)

Nhấp vào “Thêm” để bắt đầu quá trình thiết lập postback và điền các trường bắt buộc theo sở thích của bạn.

Tên postback – hãy nhập một tên rõ ràng và duy nhất cho mỗi postback của bạn để tránh nhầm lẫn. (ví dụ: "FTD_YT_BR")
Sự kiện – chọn từ menu thả xuống (Đăng ký, Nạp tiền lần đầu, v.v.)
Postback URL – dán URL từ trình theo dõi của bạn (xem các ví dụ ở trên)
Tham số – nhấp vào các tùy chọn màu xanh dương bên dưới trường “Postback URL” (“Click ID”, “Số tiền nạp”) để tự động thêm tham số
Phương thức – GET (mặc định)
Đơn vị tiền tệ – chọn $ hoặc ¢ cho số tiền

7. Bộ lọc phân đoạn

Cài đặt này cho phép bạn quyết định thời điểm gửi postback — tùy thuộc vào chiến dịch hoặc tài khoản phụ mà nó liên quan. Bạn có thể điền vào một hoặc cả hai trường này.

Tại sao cần sử dụng bộ lọc phân đoạn?

Chúng giúp bạn quản lý lưu lượng truy cập chính xác hơn:

Tối ưu hóa các nguồn lưu lượng truy cập khác nhau một cách độc lập – nếu bạn sử dụng nhiều hơn một công cụ giám sát hiệu suất, bạn có thể gửi các sự kiện cơ bản đến một công cụ và các sự kiện có thêm tham số đến một công cụ khác.
Chạy thử nghiệm A/B – phân đoạn giúp bạn thấy được nguồn nào mang lại nhiều chuyển đổi hơn và các chiến dịch, mẫu quảng cáo hoặc trang đích khác nhau hoạt động như thế nào.
Kiểm tra hoặc di chuyển các công cụ một cách an toàn – bạn có thể bắt đầu gửi postback đến một công cụ giám sát hiệu suất mới song song với công cụ cũ và so sánh các số liệu trước khi chuyển đổi hoàn toàn.

Cách thức hệ thống quyết định thời điểm gửi postback:

Không có chiến dịch hoặc tài khoản phụ nào được chỉ định
Postback được gửi cho sự kiện kích hoạt đã chọn bất kể chiến dịch hoặc tài khoản phụ nào.
Chỉ chiến dịch được chỉ định
Postback chỉ được gửi cho sự kiện kích hoạt nếu liên kết theo dõi của nhà giao dịch bao gồm chiến dịch cụ thể này.
Chỉ tài khoản phụ được chỉ định
Postback chỉ được gửi nếu liên kết theo dõi của nhà giao dịch bao gồm tài khoản phụ cụ thể này, bất kể nó thuộc chiến dịch nào.
Cả chiến dịch và tài khoản phụ đều được chỉ định
Postback chỉ được gửi khi cả hai giá trị trong liên kết của nhà giao dịch khớp với chiến dịch và tài khoản phụ mà bạn đã nhập.

(Lưu ý khi kích hoạt: sau khi postback được kích hoạt, nó sẽ được gửi trong vòng 15 giây bất cứ khi nào sự kiện và điều kiện đã chọn được đáp ứng.)

8. Kích hoạt nếu cần và nhấp vào "Thêm"

Các trạng thái postback

Các postback trải qua nhiều trạng thái khác nhau trong suốt vòng đời của chúng. Dưới đây là ý nghĩa của từng trạng thái và những yếu tố nào gây ra sự thay đổi trạng thái:

Kiểm tra (~15 giây) – chúng tôi kiểm tra postback của bạn để phát hiện mọi sự cố khi nó được tạo, chỉnh sửa hoặc sao chép lần đầu
- Nếu postback đúng → nó sẽ trở thành trạng thái Hoạt động.
- Nếu xảy ra lỗi → postback chuyển sang trạng thái Không hoạt động và hiển thị thông báo lỗi trên giao diện.
- Không thể chỉnh sửa hoặc tạm dừng postback – chỉ có thể xóa
Hoạt động – postback đang hoạt động chính xác và thu thập dữ liệu.
- Nếu chỉnh sửa → trạng thái tạm thời trở lại Đang kiểm tra.
- Nếu nhận được 10 lỗi HTTP 3xx/4xx liên tiếp → tự động vô hiệu hóa, hiển thị lỗi trên giao diện, và gửi thông báo qua email.
Không hoạt động – postback bị vô hiệu hóa do lỗi xác thực, vô hiệu hóa thủ công hoặc đạt đến ngưỡng lỗi. Cần phải khắc phục và xác thực lại để trở lại trạng thái Hoạt động.

Các hành vi chính:

Sau 10 lần xác thực không thành công, để kích hoạt cần sự hỗ trợ của quản lý
Postback hoạt động tự giám sát và ngăn ngừa các lỗi gửi dữ liệu liên tục

Nhật ký Postback

Tại đây bạn có thể tìm thấy tất cả các postback được thực hiện trong 30 ngày qua. Điều này giúp bạn xác định các vấn đề về thiết lập và biết cần khắc phục gì.

Danh sách các lỗi có thể xảy ra:

Khi không thể tạo postback, hãy kiểm tra mục Nhật ký để xem mã trạng thái.

Lỗi 3xx – Lỗi chuyển hướng

Máy chủ thông báo: "Hãy truy cập địa chỉ khác này."

Kết quả: Postback của bạn được gửi đến một nơi khác.

Nguyên nhân hàng đầu:

- Postback URL tự động chuyển hướng (HTTP→HTTPS, www/không có www, liên kết theo dõi)

- Máy chủ hoặc trình theo dõi chuyển tiếp yêu cầu đến một địa chỉ khác

- Máy chủ của bạn bí mật thay đổi URL trong quá trình này

Làm thế nào để khắc phục?

1. Sao chép postback URL của bạn

2. Dán vào thanh địa chỉ của trình duyệt và nhấn Enter

3. Chờ cho đến khi trang tải xong (hoặc ngừng chuyển hướng)

4. Sao chép những gì bạn thấy trong thanh địa chỉ — đây là postback URL của bạn

Lỗi 4xx – Lỗi phía khách hàng

Máy chủ thông báo: "Yêu cầu của bạn có lỗi."

Kết quả: Thông thường đó là vấn đề về thiết lập.