Tracking (Meta Pixel + CAPI)
Penting kalau anda run iklan Facebook/Instagram dan nak measure ROI. Aranis sokong dual-tracking: browser pixel + server-side Conversions API.
1.Apa itu Meta Pixel
Meta Pixel adalah JavaScript snippet dari Facebook yang dipasang dalam website anda. Bila visitor buka site atau buat action (klik CTA, submit form), pixel hantar event ke Facebook supaya:
- FB tahu siapa convert dari iklan anda (attribution).
- FB boleh optimize iklan anda untuk audiens yang lebih convert (lookalike).
- Anda dapat data dalam Ads Manager untuk ROI calculation.
2.Apa itu CAPI (Conversions API)
CAPI adalah server-side fallback untuk pixel. Penting sejak iOS 14.5+ (Apple Tracking Transparency) — ramai pengguna iPhone block pixel dalam browser, jadi conversion data hilang.
Dengan CAPI, event dihantar ke FB dari server kami(bukan browser visitor). Lebih reliable, lebih banyak conversions captured.
💡 Best practice: pasang kedua-dua pixel + CAPI. FB auto-deduplicate event yang dihantar dari kedua-dua channel.
3.Cara setup di Aranis
- Editor → PromptPanel → accordion Tracking (atau kadang-kadang dipanggil Pixel).
- Paste Pixel ID anda. Format: 15-16 digit angka (cth:
1234567890123456). - Paste CAPI access token anda. Format: string panjang dengan
EAA...di depan. - Save. Apply masa Publish — pixel + CAPI dipasang dalam HTML live anda.
⚠ CAPI access token tidak boleh dikongsi. Aranis encrypt token sebelum simpan menggunakan AES-256-GCM dengan PAYMENT_ENCRYPTION_KEY server-side. Tak boleh dilihat semula selepas save (mesti generate yang baru di FB kalau hilang).
4.Cara dapat Pixel ID dari Facebook
- Pergi ke business.facebook.com → login dengan akaun Business Manager anda.
- Side nav → Events Manager → Data Sources.
- Kalau belum ada pixel: klik Create → pilih Web → beri nama → save. Pixel ID muncul.
- Kalau dah ada: klik nama pixel anda → ID di kanan atas (besar + font-mono).
- Copy ID itu, paste di Aranis.
5.Cara dapat CAPI access token
- Same pixel page → click Settings tab.
- Scroll ke section Conversions API.
- Klik Generate access token.
- Token muncul SEKALI sahaja. Copy serta-merta, paste di Aranis.
⚠ Sekali keluar dari page itu, anda tak boleh lihat token semula. Kalau hilang sebelum simpan, generate yang baru.
6.Verify pixel berfungsi
- Publish site anda dengan Pixel ID terisi.
- Buka site dalam incognito window (untuk elakkan cached pixel anda sendiri).
- Buka Events Manager → Test Events → pilih pixel anda → set Test Browser to your incognito session.
- Refresh site dalam incognito. Patut nampak
PageViewevent masuk dalam Test Events real-time.
7.Conversion events yang Aranis fire
- PageView — auto, setiap kali visitor buka page.
- ViewContent — bila visitor view section pricing / product details.
- InitiateCheckout — bila visitor klik CTA bayar.
- Purchase — bila payment provider confirm success. Server-side via CAPI dari /api/capi/track.
- Lead — bila visitor submit contact form.
💡 Tak perlu set apa-apa untuk events ini — Aranis auto-attach pada element yang sesuai dalam published HTML. Selagi Pixel ID + CAPI token dah disetting, semua akan fire automatically.
