Cara Memasang Meta Conversions API (CAPI) di WordPress & Next.js Malaysia

Sejak pengenalan dasar privasi Apple iOS dan pengetatan sekatan kuki pelayar moden, Meta Pixel berasaskan pelayar kehilangan antara 30% hingga 45% data transaksi dan pendaftaran di Malaysia.

Apabila Meta tidak dapat mengesan siapa yang membeli, kos setiap pemerolehan (CPA) anda melambung tinggi kerana algoritma tidak dapat mengoptimumkan sasaran dengan tepat.

Penyelesaiannya adalah Meta Conversions API (CAPI): menghantar data peristiwa penukaran secara langsung daripada pelayan backend anda ke Meta Graph API.

---

1. Bagaimana CAPI Berfungsi (Pelayan vs. Pelayar)

[Pelayar Pengguna] ─── (Ad Blocker / Sekatan iOS) ───> [Pelayan Meta] ❌ HILANG (35%)
        │
        └───> [Pelayan Node / Next.js / PHP Anda] ──(CAPI HTTPS)──> [Meta Graph API] ✅ 100% SAMPAI

---

2. Seni Bina Penyahduplikasian Peristiwa (Deduplication)

Bagi mengelakkan kiraan dua kali apabila kedua-dua Pixel dan CAPI diaktifkan, anda wajib menghantar event_id dan event_name yang serupa:

// Contoh Payload CAPI pada Pelayan Next.js / Node.js
const eventPayload = {
  data: [
    {
      event_name: "Purchase",
      event_time: Math.floor(Date.now() / 1000),
      event_id: `pesanan_${order.id}`, // Sepadan dengan event_id pada pelayar
      user_data: {
        em: hashSha256(customer.email),
        ph: hashSha256(customer.phone), // Sertakan kod negara +60
        client_ip_address: req.headers["x-forwarded-for"],
        client_user_agent: req.headers["user-agent"],
      },
      custom_data: {
        currency: "MYR",
        value: order.totalAmount,
      },
      action_source: "website",
    },
  ],
};

await fetch(`https://graph.facebook.com/v19.0/${PIXEL_ID}/events?access_token=${META_ACCESS_TOKEN}`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(eventPayload),
});

---

3. Mengesahkan Kualiti Padanan Peristiwa (Event Match Quality)

Selepas CAPI dipasang:

1. Buka Meta Events Manager > Test Events.
2. Lakukan transaksi ujian secara langsung.
3. Sahkan bahawa peristiwa memaparkan status "Browser + Server" dengan lencana penyahduplikasian.
4. Pastikan Skor Kualiti Padanan (Event Match Quality) >= 8.0/10.

---

Perlukan Bantuan Integrasi CAPI pada Laman Web Anda?

JagaWeb membina integrasi CAPI gred enterprise pada Cloudflare Workers, Next.js, dan WordPress.

Audit Pemasangan Pixel & CAPI Anda Hari Ini.