- Conversions API (API Chuyển đổi) gửi sự kiện như mua hàng, gửi form từ máy chủ của bạn thẳng tới Meta, không phụ thuộc hoàn toàn vào trình duyệt như Meta Pixel.
- Meta khuyên chạy song song Pixel và Conversions API, nhưng khi đó bắt buộc phải khử trùng lặp, cách được khuyến nghị là gửi cùng event_id và event_name.
- Có nhiều cách triển khai: bật một chạm trong Trình quản lý sự kiện, dùng Conversions API Gateway, tích hợp qua nền tảng đối tác hoặc tự lập trình.
- Điểm chất lượng so khớp sự kiện từ 0 đến 10 cho biết thông tin khách hàng bạn gửi giúp so khớp sự kiện tốt đến đâu.
Conversions API (CAPI) là kênh để website, máy chủ hoặc CRM của bạn gửi sự kiện chuyển đổi trực tiếp tới Meta qua kết nối máy chủ với máy chủ. Khi trình chặn quảng cáo, cài đặt quyền riêng tư của trình duyệt hay lỗi tải trang làm Meta Pixel bỏ sót sự kiện, dữ liệu gửi từ máy chủ vẫn đến được Meta, nhờ đó hệ thống có đủ tín hiệu để tối ưu và báo cáo. Bài này giải thích CAPI hoạt động thế nào, chọn cách triển khai nào, và hai việc hay làm sai nhất: khử trùng lặp sự kiện và nâng điểm so khớp.
Conversions API là gì và khác Pixel thế nào
Theo tài liệu Conversions API dành cho nhà phát triển, CAPI được thiết kế để kết nối dữ liệu marketing của nhà quảng cáo, như sự kiện trên website, ứng dụng, tin nhắn kinh doanh và chuyển đổi offline, từ máy chủ, nền tảng website, ứng dụng hoặc CRM tới hệ thống của Meta để tối ưu nhắm mục tiêu, giảm chi phí trên mỗi kết quả và đo lường. Sự kiện từ máy chủ được gắn với một ID tập dữ liệu và được xử lý giống sự kiện từ Meta Pixel, nên có thể dùng cho đo lường, báo cáo và tối ưu theo cách tương tự.
| Tiêu chí | Meta Pixel | Conversions API |
|---|---|---|
| Nơi gửi | Trình duyệt của khách (mã JavaScript) | Máy chủ, nền tảng website hoặc CRM của bạn |
| Phụ thuộc trình duyệt | Có: bị ảnh hưởng nếu script bị chặn hoặc không tải | Không phụ thuộc trình duyệt khi gửi |
| Loại sự kiện | Sự kiện trên website | Website, ứng dụng, tin nhắn kinh doanh, offline |
| Công sức triển khai | Thấp | Từ không cần code (tích hợp sẵn) tới cần lập trình viên |
CAPI không thay thế Pixel. Meta gọi việc dùng cả hai là "thiết lập dự phòng" và khuyến nghị cách này để có hiệu quả quảng cáo tốt nhất. Nếu bạn chưa cài Pixel, hãy bắt đầu từ bài sử dụng Facebook Pixel theo dõi chuyển đổi.
Bốn cách triển khai, chọn theo nguồn lực
Bật một chạm trong Trình quản lý sự kiện
Tài liệu của Meta hiện ghi: nếu website đã có Meta Pixel, bạn có thể thiết lập Conversions API cho sự kiện website bằng một cú bấm trong Trình quản lý sự kiện, không cần viết code, cấu hình hay trả phí thiết lập, và không phải tự lưu trữ hay bảo trì máy chủ. Đây là lựa chọn hợp lý nhất cho shop nhỏ chỉ cần gửi sự kiện website.
Conversions API Gateway
Conversions API Gateway là tùy chọn tự cấu hình trong Trình quản lý sự kiện, giúp gửi sự kiện qua cả Pixel và CAPI theo thiết lập dự phòng mà không cần lập trình viên chuyên trách. Gateway chạy trên một máy chủ do chính doanh nghiệp tạo trong tài khoản đám mây của mình; tài liệu hiện liệt kê AWS EKS, AWS ECS Express và GCP. Pixel được cấu hình gửi sự kiện tới Gateway, Gateway chuyển chúng thành sự kiện Conversions API, và khóa khử trùng lặp event_id được tạo, truyền tự động. Meta cho biết chi phí duy nhất là phí tài nguyên đám mây hoặc phí đối tác; Gateway hỗ trợ nhiều tên miền và nhiều Pixel, có trang quản trị để xem lưu lượng sự kiện và tỷ lệ gửi thành công.
Tích hợp qua nền tảng đối tác
Nhiều nền tảng thương mại điện tử có tích hợp đối tác với Meta; Trung tâm trợ giúp doanh nghiệp có hướng dẫn riêng cho tích hợp đối tác dành cho web, ví dụ kết nối Shopify. Nếu website chạy trên nền tảng có sẵn tích hợp, đây thường là đường ngắn nhất.
Tích hợp trực tiếp
Lập trình viên gửi yêu cầu POST từ máy chủ tới endpoint Conversions API. Cách này linh hoạt nhất, gửi được cả sự kiện offline hay từ CRM, như đơn chốt qua điện thoại, nhưng cần người bảo trì khi Meta cập nhật API.
Khử trùng lặp sự kiện bằng event_id
Khi một đơn hàng được gửi cả từ trình duyệt (Pixel) lẫn từ máy chủ (CAPI), Meta cần biết đó là một đơn chứ không phải hai. Trang xử lý sự kiện trùng lặp giữa Pixel và Conversions API nêu rõ nhà quảng cáo dùng thiết lập dự phòng phải thiết lập phương pháp khử trùng lặp; nếu không gửi cùng một sự kiện qua cả hai kênh thì không cần.
Cách được khuyến nghị là dùng event_id và tên sự kiện:
- eventID của Pixel phải khớp event_id của CAPI cho cùng một sự kiện.
- Tên sự kiện của Pixel phải khớp event_name của CAPI, ví dụ cùng là Purchase.
- Với Pixel, eventID là tham số thứ tư trong lệnh fbq track, ví dụ: fbq('track', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'}).
- Nếu cùng cặp khóa được gửi tới cùng ID Pixel trong vòng 48 giờ, Meta loại bỏ các sự kiện đến sau. Khi nội dung hai bên không khác biệt đáng kể, Meta thường giữ sự kiện nhận được trước.
Trong thực tế, event_id nên là giá trị duy nhất sinh ra một lần cho mỗi hành động, như mã đơn hàng, rồi được truyền cho cả mã Pixel trên trang cảm ơn và yêu cầu gửi từ máy chủ. Lỗi thường gặp là mỗi kênh tự sinh một mã ngẫu nhiên khác nhau, khiến Meta không ghép được và số đơn trong báo cáo bị nhân đôi.
Meta cũng mô tả cách thứ hai: dùng event_name kèm fbp và/hoặc external_id nhất quán ở cả hai kênh. Cách này có giới hạn: nhìn chung chỉ khử được khi sự kiện trình duyệt đến trước rồi mới tới sự kiện máy chủ, và không khử trùng lặp khi chỉ dùng một nguồn. Vì vậy nên ưu tiên event_id.
Điểm chất lượng so khớp sự kiện (EMQ)
Gửi được sự kiện mới là một nửa; Meta còn cần ghép sự kiện với đúng tài khoản người dùng. Theo trang giới thiệu về chất lượng so khớp sự kiện, chỉ số này áp dụng cho sự kiện website gửi qua Conversions API với nguồn hành động đặt là Trang web. Meta chấm điểm từ 0 đến 10 dựa trên chất lượng thông tin khách hàng bạn gửi và tỷ lệ sự kiện khớp với tài khoản Meta, dùng dữ liệu 48 giờ gần nhất, nên cần gửi sự kiện đều đặn để điểm luôn cập nhật. Điểm xem được trong Trình quản lý sự kiện, kèm các hành động nên làm để cải thiện.
Meta công bố mức độ ưu tiên của từng thông số thông tin khách hàng:
| Mức ưu tiên | Thông số |
|---|---|
| Cao | Email, ID lượt click |
| Trung bình | ID đăng nhập bằng Facebook, ngày sinh, quốc gia, số điện thoại, ID bên ngoài, ID trình duyệt |
| Thấp | Khách hàng tiềm năng, tên, họ, thành phố, mã bưu chính |
Định dạng và băm dữ liệu
Tài liệu tham số thông tin khách hàng của Meta yêu cầu chuẩn hóa rồi băm SHA-256 với các trường như email (bỏ khoảng trắng đầu cuối, chuyển chữ thường) và số điện thoại (bỏ ký hiệu, chữ cái và số 0 ở đầu, luôn kèm mã quốc gia; với Việt Nam là 84). Ngược lại, địa chỉ IP của trình duyệt và giá trị fbc (ID lượt click lưu trong cookie _fbc) không được băm. Gửi email chưa băm hay số điện thoại thiếu mã quốc gia là nguyên nhân phổ biến khiến điểm thấp.
Về pháp lý, Meta nhắc Điều khoản công cụ kinh doanh yêu cầu bạn có quyền hợp pháp để thu thập, sử dụng và chia sẻ dữ liệu, phải băm thông tin liên hệ theo tài liệu nhà phát triển và không chia sẻ dữ liệu nhạy cảm. Doanh nghiệp tại Việt Nam cần đối chiếu thêm quy định về bảo vệ dữ liệu cá nhân, công bố rõ trong chính sách quyền riêng tư và lấy sự đồng ý phù hợp trước khi gửi dữ liệu khách hàng cho bên thứ ba; khi chưa chắc, hãy hỏi người có chuyên môn pháp lý.
Kiểm tra sau khi thiết lập
- Mở Trình quản lý sự kiện, dùng công cụ kiểm tra sự kiện để xác nhận Meta nhận được sự kiện từ máy chủ.
- Đặt thử một đơn, xem sự kiện Purchase hiện ở cả hai kênh và được ghi nhận là đã khử trùng lặp, không thành hai đơn.
- Theo dõi điểm so khớp của các sự kiện quan trọng sau vài ngày, bổ sung thông số còn thiếu theo gợi ý.
- Đối chiếu số đơn trong Trình quản lý quảng cáo với hệ thống bán hàng; chênh lệch lớn thường do thiếu khử trùng lặp hoặc gửi thiếu sự kiện.
Dữ liệu chuyển đổi đầy đủ giúp bạn đọc đúng CPA thực tế, từ đó lập ngân sách quảng cáo Facebook sát hơn. Để so sánh Meta với các kênh khác trong GA4, hãy gắn tham số UTM thống nhất cho mọi liên kết quảng cáo. Các hướng dẫn đo lường khác có trong chuyên mục quảng cáo hiệu quả.
Câu hỏi thường gặp
Có Pixel rồi có cần cài Conversions API nữa không?
Meta khuyến nghị dùng cả hai theo thiết lập dự phòng để có hiệu quả tốt nhất. Pixel có thể bỏ sót sự kiện khi trình duyệt chặn script, còn CAPI gửi từ máy chủ nên bổ sung phần thiếu. Chỉ cần nhớ khử trùng lặp bằng event_id.
Conversions API có mất phí không?
Tài liệu của Meta cho biết nếu đã có Pixel, bạn có thể bật Conversions API cho sự kiện website trong Trình quản lý sự kiện mà không cần code và không mất phí thiết lập. Nếu dùng Conversions API Gateway, bạn trả phí tài nguyên đám mây hoặc phí đối tác; nếu tự tích hợp, chi phí là công lập trình và máy chủ.
Điểm chất lượng so khớp sự kiện bao nhiêu là ổn?
Meta chấm từ 0 đến 10 và hiển thị gợi ý cải thiện trong Trình quản lý sự kiện thay vì đặt một ngưỡng chung. Cách nâng điểm là gửi thêm thông số ưu tiên cao như email, ID lượt click, định dạng và băm đúng chuẩn.
Số đơn trên Ads Manager cao gấp đôi thực tế là do đâu?
Nguyên nhân thường gặp là cùng một đơn được gửi qua Pixel và CAPI nhưng không có event_id trùng khớp, hoặc tên sự kiện hai bên khác nhau. Kiểm tra lại cách sinh event_id để cả hai kênh dùng chung một giá trị.



