Tích hợp Conversions API (CAPI)

Hướng dẫn này giúp bạn kích hoạt Conversions API (CAPI) để BettaMax gửi dữ liệu đơn hàng trực tiếp từ server về Facebook, bổ sung cho browser pixel. CAPI khắc phục tình trạng mất conversion data do ad blocker và Safari ITP. Hướng dẫn này dành cho cửa hàng đã có Facebook Pixel hoạt động và muốn nâng cao độ chính xác của tracking. Thực hiện trong khoảng 15 phút.

Trước khi bắt đầu:

  • Facebook Pixel đã được thiết lập và xác nhận hoạt động (xem Cách gắn Facebook Pixel qua Events Manager).
  • Không thiết lập CAPI trước khi có browser pixel. CAPI bổ sung cho pixel, không thay thế.
  • Tài khoản BettaMax có quyền Admin.
  • Quyền Admin trên Facebook Business Manager của cửa hàng.

CAPI là gì và tại sao cần dùng #

Hiểu rõ cơ chế giúp bạn quyết định đúng thời điểm cần nâng lên CAPI.

Browser PixelConversions API
Dữ liệu gửi từTrình duyệt khách hàngServer BettaMax
Bị ad blocker chặnCó (mất 10-30% data)Không
Bị Safari ITP ảnh hưởngKhông
Thiết lậpDễ (chỉ cần Pixel ID)Phức tạp hơn (cần Access Token)
Khuyến nghị kết hợpDùng cùng CAPIDùng cùng browser pixel

Nên kích hoạt CAPI khi gặp một trong các tình huống sau:

  • Chi quảng cáo Facebook trên $100/ngày.
  • Thấy chênh lệch lớn giữa đơn hàng thực tế và Purchase event Facebook báo cáo.
  • Chạy quảng cáo nhắm vào người dùng Safari (iOS/Mac).
Lưu ý: Nếu số Purchase trong Facebook Ads Manager thấp hơn đơn thực tế trên BettaMax từ 20% trở lên, CAPI sẽ giúp cải thiện đáng kể độ chính xác của báo cáo.

Lấy Access Token từ Facebook #

CAPI yêu cầu Access Token để xác thực. Token này cấp quyền cho BettaMax gửi dữ liệu trực tiếp về Pixel của bạn.

  1. Đăng nhập business.facebook.com.
  2. Vào Events Manager, chọn Pixel đang dùng cho cửa hàng.
  3. Chọn tab Settings.
  4. Cuộn xuống mục Conversions API, tìm phần Generate Access Token.
  5. Nhấn Generate Access Token.
  6. Copy toàn bộ token hiển thị. Đây là chuỗi ký tự dài, cần dùng ở bước tiếp theo.

Cảnh báo: Access Token có quyền gửi dữ liệu vào Pixel của bạn. Không chia sẻ token với bên thứ ba. Nếu token bị lộ, quay lại Events Manager và nhấn Generate Access Token lại ngay để vô hiệu hóa token cũ.

Kích hoạt CAPI trên BettaMax #

Sau khi có Access Token, kích hoạt CAPI trong BettaMax Settings để bắt đầu gửi dữ liệu server-side về Facebook.

  1. Đăng nhập admin.bettamax.com.
  2. Từ sidebar, chọn Settings > Facebook Pixel
  3. Tìm mục Conversion API key (Optional)
  4. Nhập Pixel ID vào trường tương ứng. Đây là Pixel ID đã dùng khi gắn browser pixel.
  5. Nhấn Add Pixel vừa tạo ở bước trên.

Lưu ý: Nếu không thấy mục Facebook Conversions API trong Settings, tính năng này có thể chưa được kích hoạt cho tài khoản. Liên hệ @btmcsmax trên Zalo/Telegram để yêu cầu kích hoạt.

Cấu hình deduplication để tránh đếm đôi #

Khi dùng cả browser pixel và CAPI, Facebook cần biết 2 nguồn đang gửi cùng 1 sự kiện để loại bỏ bản trùng. Deduplication dùng Event ID để ghép cặp giữa browser event và server event.

BettaMax tự động xử lý deduplication bằng cách gửi cùng Event ID từ cả browser pixel và CAPI. Xác nhận cấu hình đúng bằng các bước sau.

  1. Vào Facebook Events Manager, chọn Pixel đang dùng.
  2. Chọn tab Overview.
  3. Xem mục Event Match Quality trong bảng event breakdown.
  4. Kiểm tra cột Deduplicated. Con số này cho biết bao nhiêu event đã được Facebook khớp thành công giữa browser và server.

Mẹo: Event Match Quality (EMQ) cao, trên 6/10, cho thấy CAPI đang gửi đủ thông tin để Facebook match đúng khách hàng với conversion. EMQ thấp thường do thiếu thông tin nhận dạng như email hoặc số điện thoại.

Kiểm tra CAPI hoạt động #

Sau khi kích hoạt, xác nhận CAPI đang gửi dữ liệu đúng về Facebook trước khi chạy quảng cáo thực.

  1. Tạo 1 đơn hàng test trên cửa hàng của bạn.
  2. Vào Events Manager, chọn tab Test Events.
  3. Chọn tab Server Events (khác với tab Browser Events).
  4. Xác nhận Purchase event xuất hiện với nguồn là Server.
  5. Kiểm tra cột Deduplicated. Nếu CAPI và browser pixel cùng fire, Facebook sẽ merge thành 1 conversion duy nhất thay vì đếm 2 lần.

Lưu ý: Server Events có thể xuất hiện trễ 1-2 phút sau khi đặt hàng. Nếu không thấy event sau 5 phút, kiểm tra lại Pixel ID và Access Token trong Settings > Analytics Tools.

Bài viết liên quan #