Unit 2/3 · ~15 phút · +300 điểm
Conversions API: gửi sự kiện từ máy chủ
Mục tiêu học tập
Sau khi hoàn thành bài này, bạn có thể:
- Giải thích Conversions API khác Pixel ở đâu và vì sao nên chạy song song hai đường
- Thiết lập khử trùng sự kiện bằng event_name và event_id giữa Pixel và máy chủ
- Chuẩn hóa và băm dữ liệu khách hàng đúng cách để tăng chất lượng so khớp
Bài trước kết thúc ở một vấn đề: Pixel chạy trong trình duyệt nên luôn bỏ sót một phần sự kiện. Conversions API (gọi tắt là CAPI) là cách Meta cho phép bạn gửi sự kiện trực tiếp từ máy chủ của mình, không phụ thuộc trình duyệt của khách. Google, TikTok, LinkedIn cũng có cơ chế tương tự; bài này dùng Meta làm ví dụ vì đây là kênh nhiều doanh nghiệp B2B Việt Nam đang chạy.
Pixel và Conversions API khác nhau thế nào
| Pixel | Conversions API | |
|---|---|---|
| Gửi từ đâu | Trình duyệt của khách | Máy chủ của bạn (website, CRM, nền tảng trung gian) |
| Bị trình chặn ảnh hưởng | Có | Không trực tiếp |
| Gửi được sự kiện ngoài website | Không | Có, ví dụ lead đủ điều kiện trong CRM |
| Cần lập trình hoặc tích hợp | Ít | Nhiều hơn |
| Dữ liệu để nhận diện người | Cookie, thông tin trình duyệt | Những gì bạn gửi: email, số điện thoại đã băm, IP, user agent, fbp, fbc |
Meta khuyến nghị dùng song song hai đường: Pixel bắt những gì trình duyệt thấy, CAPI bù phần bị mất và thêm sự kiện mà trình duyệt không bao giờ thấy. Cách làm này gọi là thiết lập dư thừa (redundant setup).
Một sự kiện CAPI gồm những gì
Mỗi sự kiện gửi lên Graph API của Meta là một đối tượng JSON. Các trường chính:
event_name: tên sự kiện, ví dụLead. Phải trùng với tên Pixel gửi.event_time: thời điểm xảy ra, dạng Unix timestamp tính bằng giây.event_id: mã duy nhất cho hành động này, dùng để khử trùng.action_source: nơi hành động xảy ra, ví dụwebsite, hoặcsystem_generatedcho sự kiện sinh từ hệ thống như CRM.event_source_url: URL trang xảy ra sự kiện (với sự kiện trên website).user_data: thông tin để so khớp người dùng, nhưem(email),ph(số điện thoại),client_ip_address,client_user_agent,fbp,fbc,external_id.
Việc gửi cần một mã truy cập (access token) tạo trong Events Manager. Mã này là thông tin bí mật, chỉ lưu trên máy chủ, không bao giờ đặt trong mã website hay gửi qua chat.
Khử trùng với event_id
Khi khách gửi form, cả Pixel lẫn máy chủ đều gửi Lead. Nếu không có cách nhận ra đây là cùng một hành động, Meta đếm thành hai. Quy tắc khử trùng: hai sự kiện có cùng event_name và cùng event_id, đến trong khoảng thời gian gần nhau, sẽ được tính một lần.
Cách làm thực tế:
- Khi form gửi thành công, website tạo một mã duy nhất, ví dụ
lead_8f3a21c9, và đẩy vào data layer:dataLayer.push({ event: 'quote_form_success', event_id: 'lead_8f3a21c9' }); - Thẻ Pixel trong GTM gửi mã đó qua tham số thứ tư:
fbq('track', 'Lead', {}, { eventID: 'lead_8f3a21c9' });Lưu ý phía Pixel viết làeventID. - Máy chủ gửi sự kiện CAPI với
event_id: "lead_8f3a21c9"và cùngevent_name: "Lead". - Kiểm tra trong Events Manager: sự kiện
Leadhiện cả hai nguồn (trình duyệt và máy chủ) và có thông báo đã khử trùng.
Sai lầm hay gặp
Dùng mã thời gian hay số thứ tự của form làm event_id, khiến hai khách khác nhau có thể trùng mã, hoặc Pixel và máy chủ tự sinh mã riêng nên không bao giờ khớp. Mã phải được sinh một lần cho mỗi hành động và dùng chung cho cả hai đường.
So khớp bằng dữ liệu đã băm
Để Meta biết sự kiện thuộc về ai, bạn gửi kèm thông tin khách hàng trong user_data. Thông tin nhận dạng như email, số điện thoại, họ tên phải được chuẩn hóa rồi băm SHA-256 trước khi gửi. Băm là biến đổi một chiều: Meta không đọc ngược ra email, nhưng có thể so mã băm với mã băm của tài khoản người dùng.
| Trường | Chuẩn hóa trước khi băm | Ví dụ trước khi băm |
|---|---|---|
em | Chữ thường, bỏ khoảng trắng đầu cuối | lan.nguyen@tanphu.vn |
ph | Chỉ chữ số, có mã quốc gia, bỏ số 0 đầu | 84912345678 |
fn, ln | Chữ thường; xem hướng dẫn của Meta về ký tự có dấu | tên và họ |
client_ip_address, client_user_agent, fbp, fbc | Không băm | lấy từ yêu cầu của trình duyệt và cookie |
Events Manager hiển thị điểm Event Match Quality (chất lượng so khớp sự kiện) cho từng sự kiện. Gửi thêm trường như fbc, fbp, email, số điện thoại thường giúp điểm này cao hơn.
Lưu ý
Băm không làm dữ liệu hết là dữ liệu cá nhân. Bạn vẫn cần căn cứ hợp lệ để chia sẻ thông tin khách với nền tảng quảng cáo, và chính sách quyền riêng tư phải nói rõ việc này. Module cuối chặng sẽ bàn kỹ hơn.
Ba cách triển khai
Tích hợp sẵn
Nền tảng website, form hay CRM có kết nối CAPI dựng sẵn
GTM phía máy chủ
Container server-side nhận sự kiện rồi chuyển tiếp tới Meta, Google
Tự lập trình
Lập trình viên gọi API trực tiếp từ backend
Meta cũng có giải pháp dựng sẵn như Conversions API Gateway. Hãy bắt đầu bằng cách ít tốn công nhất mà nền tảng của bạn hỗ trợ, rồi kiểm tra bằng tab Test Events với mã kiểm tra (test_event_code).
Gửi sự kiện từ CRM: tín hiệu chất lượng
Đây là phần đáng giá nhất với B2B. Quảng cáo tối ưu theo Lead sẽ tìm người hay điền form, kể cả người điền cho vui. Nếu CRM gửi thêm sự kiện khi sales đánh dấu lead là đủ điều kiện hoặc khi có cơ hội, Meta có tín hiệu về lead chất lượng. Với lead từ biểu mẫu quảng cáo của Meta, nền tảng còn có hướng dẫn riêng để gửi các giai đoạn lead từ CRM về. Bạn cần giữ được mã định danh lead (ví dụ lead_id của biểu mẫu quảng cáo, hoặc email và số điện thoại) trong CRM để ghép lại.
Cùng ôn lại
- Conversions API gửi sự kiện từ máy chủ, bù phần Pixel bỏ sót; nên chạy song song hai đường.
- Cùng
event_namevà cùngevent_idlà điều kiện để Meta khử trùng; phía Pixel dùngeventID. - Email, số điện thoại phải chuẩn hóa rồi băm SHA-256; IP, user agent,
fbp,fbckhông băm. - Gửi sự kiện từ CRM giúp quảng cáo tối ưu theo lead chất lượng, không chỉ theo số form.
Pixel và CAPI đều xoay quanh một tài sản: dữ liệu khách hàng do chính bạn thu thập. Bài cuối module sẽ bàn cách xây và dùng tài sản đó, gọi là dữ liệu bên thứ nhất.
Kiểm tra kiến thức
Bạn đang học với tư cách khách: quiz vẫn chấm nhưng điểm không được lưu. Đăng nhập hoặc tạo tài khoản để tích điểm và nhận huy hiệu.
Công ty Bao bì Tân Phú vừa bật Conversions API song song với Pixel. Số sự kiện Lead trên Events Manager bỗng gần gấp đôi số lead thật. Nguyên nhân khả dĩ nhất là gì?
Anh Toàn chuẩn bị gửi số điện thoại 0912 345 678 qua Conversions API. Cách xử lý nào đúng?
Vì sao một doanh nghiệp B2B nên gửi thêm sự kiện từ CRM, ví dụ khi lead được sales xác nhận là đủ điều kiện, về Meta qua Conversions API?