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

PixelConversions API
Gửi từ đâuTrình duyệt của kháchMáy chủ của bạn (website, CRM, nền tảng trung gian)
Bị trình chặn ảnh hưởngCóKhông trực tiếp
Gửi được sự kiện ngoài websiteKhôngCó, ví dụ lead đủ điều kiện trong CRM
Cần lập trình hoặc tích hợpÍtNhiều hơn
Dữ liệu để nhận diện ngườiCookie, thông tin trình duyệtNhữ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ặc system_generated cho 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ế:

  1. 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' });
  2. 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.
  3. Máy chủ gửi sự kiện CAPI với event_id: "lead_8f3a21c9" và cùng event_name: "Lead".
  4. Kiểm tra trong Events Manager: sự kiện Lead hiệ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ườngChuẩn hóa trước khi bămVí dụ trước khi băm
emChữ thường, bỏ khoảng trắng đầu cuốilan.nguyen@tanphu.vn
phChỉ chữ số, có mã quốc gia, bỏ số 0 đầu84912345678
fn, lnChữ thường; xem hướng dẫn của Meta về ký tự có dấutên và họ
client_ip_address, client_user_agent, fbp, fbcKhông bămlấ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_name và cùng event_id là điều kiện để Meta khử trùng; phía Pixel dùng eventID.
  • Email, số điện thoại phải chuẩn hóa rồi băm SHA-256; IP, user agent, fbp, fbc khô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

Trả lời đúng ngay lần đầu được 100 điểm mỗi câu, lần thứ hai 50, từ lần thứ ba 25.

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.

  1. 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ì?

  2. 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?

  3. 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?