Bài 01 — Conversions API (CAPI) & chất lượng dữ liệu

Phần: 05 Nâng cao · Thời lượng gợi ý: 90 phút

Bạn sẽ làm được gì sau bài này

• Giải thích browser vs server events và deduplication bằng `event_id`.
• Chọn luồng CAPI: Gateway, partner, GTM server, custom API.
• Đọc Event Match Quality (EMQ) và cải thiện parameters.
• Lập roadmap CAPI cho shop VN (Shopify/Woo/Haravan).

Chuẩn bị trước khi học

• Pixel đã hoạt động (Bài Pixel).
• Quyền Events Manager trên dataset.
• (Tuỳ chọn) Server hoặc plugin hỗ trợ CAPI — không bắt buộc code ngày 1.

Mục tiêu học tập

1. Giải thích browser vs server events và deduplication.
2. Chọn luồng CAPI: Gateway, partner, custom API.
3. Đọc EMQ và cải thiện parameters.
4. Lập roadmap CAPI cho shop VN.

Kiến thức cốt lõi

1. Vì sao cần CAPI?

• iOS ATT, ad blockers, cookie ITP → mất pixel events.
• Server gửi Purchase/Lead tin cậy hơn cho optimization.
• Pixel + CAPI song song — dedup bằng cùng `event_id`.

2. Luồng triển khai

• Cách — Độ khó — Ghi chú VN
• Meta Conversions API Gateway — Trung bình — Hosted Meta
• Shopify / Woo plugin — Dễ — Shop online phổ biến
• GTM server-side — Cao — Cần cloud server
• Custom API — Cao — Dev in-house

3. Parameters quan trọng

• `em`, `ph` — email/SĐT hashed SHA-256.
• `fbc`, `fbp` — cookie click ID.
• `client_ip_address`, `client_user_agent`.
• `event_id` — trùng với pixel event cùng hành động.
• `event_name`, `event_time`, `custom_data` (value, currency).

4. Event Match Quality (EMQ)

• Score cao → attribution & optimization tốt hơn.
• Cải thiện: truyền đủ hashed PII khi có consent, fbc/fbp từ URL/cookie.

5. Consent tại VN

• Form tick marketing — mới hash email gửi server.
• Không gửi PII plaintext qua log.

Hướng dẫn từng bước

1. Events Manager → dataset → tab Settings — xem Conversions API.
2. Chọn hướng: Partner integration (Woo/Shopify) nếu có — đọc doc plugin.
3. Vẽ sơ đồ: User action → Pixel (browser) + Server (CAPI) → Meta dedup.
4. Generate access token CAPI (System User BM) — lưu secret, không commit Git.
5. Cấu hình plugin: bật server-side + nhập Pixel ID + token.
6. Implement `event_id` UUID — pixel và server cùng ID một purchase.
7. Test: đặt hàng test → Events Manager Overview — 1 Purchase, không double count.
8. Mở Event Match Quality — ghi score Purchase/Lead.
9. Thêm `ph` hash SĐT checkout — retest EMQ sau 24h.
10. Diagnostics — sửa warning missing fbp (script lấy cookie `_fbp`).
11. Document consent flow trên form checkout.
12. (Nâng cao) Gateway: follow Meta wizard deploy cloud.
13. Roadmap 30 ngày: tuần 1 partner CAPI, tuần 2 EMQ, tuần 3 dedup audit.
14. Chụp screenshot EMQ hoặc checklist nếu chưa cài.

Ví dụ thực tế

Haravan shop mỹ phẩm “Glow Lab” — 200 đơn/ngày.

• Bật CAPI qua app partner — Purchase server-side + pixel browser.
• Ban đầu EMQ 4,2/10 — thiếu phone hash.
• Thêm field SĐT bắt buộc checkout + hash → EMQ 7,1 — CPA Purchase ads ổn định hơn 12% (so 14 ngày trước).
• `event_id` sync — Events Manager không còn 2× Purchase một đơn.

Lỗi thường gặp & cách xử lý

1. Double Purchase — Thiếu dedup event_id. → UUID chung pixel/server.
2. CAPI only, không pixel — Mất fbp browser. → Dùng cả hai.
3. Token leak GitHub — Bảo mật. → Rotate token, env vars.
4. EMQ thấp — Thiếu PII hashed. → Consent + checkout fields.
5. Server time sai timezone — Event rejected. → UTC epoch đúng.
6. Gửi plaintext email — Vi phạm policy. → SHA-256 only.

Bài tập thực hành

1. Vẽ sơ đồ Pixel + CAPI + dedup.
2. Check EMQ trong Events Manager (hoặc mô tả bước nếu chưa cài).
3. List 5 event parameters gửi server-side.

Checklist nộp bài

• Sơ đồ kiến trúc
• Screenshot EMQ hoặc checklist cài đặt
• Consent/privacy note ngắn
• Luồng CAPI đã chọn (partner/gateway/custom)

Câu hỏi ôn tập

1. CAPI bù đắp hạn chế gì của Pixel browser?
2. `event_id` dùng để làm gì?
3. EMQ thấp thường do thiếu parameter nào?
4. Khi nào nên chọn partner plugin thay custom API?
5. Consent ảnh hưởng gì đến hashed PII?

Tài liệu mở rộng

• Meta Conversions API documentation
• Meta: Event Match Quality
• Meta Conversions API Gateway