Facebook Conversions API (CAPI)

Nerede bulunur: Mağaza yönetim paneli → Entegrasyonlar → Facebook Conversions API Kimler için: Facebook/Instagram reklamı veren ve dönüşümlerini (satın alma, sepete ekleme, ödeme başlatma) daha eksiksiz ölçmek isteyen mağazalar. Kısaca: Tarayıcıdaki Facebook Pixel'e ek olarak, önemli olayları doğrudan sunucunuzdan Facebook'a gönderir. Reklam engelleyiciler, çerez kısıtları ve iOS gizlilik değişiklikleri yüzünden kaybolan veriyi geri kazandırır. Aynı olay hem tarayıcıdan hem sunucudan gittiğinde Facebook bunları tekilleştirir (çift saymaz).

Ne işe yarar?

Klasik Facebook Pixel yalnızca tarayıcıda çalışır. Reklam engelleyiciler, üçüncü taraf çerez kısıtları ve iOS'taki gizlilik değişiklikleri bu verinin bir kısmının Facebook'a hiç ulaşmamasına yol açar. Conversions API (CAPI) ise olayları sunucunuzdan gönderir — tarayıcıdan bağımsızdır, bu yüzden çok daha güvenilirdir.

Treyza şu olayları sunucudan gönderir:

Sayfa görüntüleme (PageView) tarayıcıdaki Pixel tarafından gönderilir; çift sayımı önlemek için sunucudan ayrıca gönderilmez.

Neden hem Pixel hem CAPI?

En iyi sonuç ikisinin birlikte kullanılmasıdır. Aynı olay iki kanaldan gidince Facebook, her olaya iliştirilen ortak bir event_id sayesinde bunların aynı olay olduğunu anlar ve tek sefer sayar. Böylece ne veri kaybı ne de çift sayım olur.

• Facebook Pixel entegrasyonunu açın (Pixel ID girin) — tarayıcı tarafı.
• Facebook Conversions API entegrasyonunu açın (aynı Pixel ID + Access Token) — sunucu tarafı.

Nasıl açılır?

1. Entegrasyonlar sayfasını açın ve Facebook Conversions API'yi bulun.
2. Aşağıdaki bilgileri girin:
   • Pixel ID: Reklam hesabınızdaki pixel kimliği (yalnızca rakam). Facebook Pixel ile aynı olmalıdır.
   • Access Token: Meta Events Manager → veri kaynağı (pixel) → Ayarlar → Conversions API → Erişim belirteci oluştur ile alınan belirteç. Bu değer gizli saklanır ve şifrelenir; vitrine asla gönderilmez.
   • Test Event Code (opsiyonel): Meta Events Manager → Test Events sekmesindeki kod. Yalnızca kurulum doğrulaması içindir; canlıya alırken boş bırakın.
3. Kaydedin ve entegrasyonu açık duruma getirin.
4. Facebook Pixel entegrasyonunun da açık ve aynı Pixel ID ile ayarlı olduğundan emin olun.

Kurulumu doğrulama

1. Meta Events Manager → pixel'iniz → Test Events sekmesini açın, size verilen Test Event Code'u entegrasyona girin.
2. Mağazanızda bir ürünü sepete ekleyin, ödeme adımına geçin ve test siparişi tamamlayın.
3. Test Events ekranında olayların "Server" kaynağıyla düştüğünü görmelisiniz.
4. Aynı olay hem tarayıcıdan hem sunucudan geldiğinde, olayın yanında "Deduplicated" (tekilleştirildi) etiketi görünür — dedup'ın çalıştığının kanıtıdır.
5. Doğrulama bitince Test Event Code'u kaldırın.

Gizlilik ve çerez onayı

• Müşteri verisi (e-posta, telefon, ad, adres) Facebook'a gönderilmeden önce SHA256 ile geri döndürülemez şekilde şifrelenir (hash'lenir). Ham kişisel veri hiçbir zaman düz metin olarak gönderilmez.
• Tarayıcı olayları ve Pixel, mağazanızdaki çerez onay penceresinin pazarlama iznine bağlıdır: ziyaretçi pazarlama çerezlerini kabul etmezse ne tarayıcı ne de sunucu bu olayları gönderir.
• Kayıtlı müşteri pazarlama iletişimini reddetmişse, o müşterinin satın alma olayı sunucudan gönderilmez.

Sık sorulanlar

Pixel'im zaten var, CAPI şart mı? Şart değil ama şiddetle önerilir. Yalnız Pixel ile reklam engelleyiciler ve iOS yüzünden dönüşümlerin bir kısmı kaybolur; CAPI bu boşluğu kapatır.

Access Token'ı nereden alırım? Meta Events Manager → veri kaynağınız (pixel) → Ayarlar → Conversions API → "Erişim belirteci oluştur".

Çift sayım olur mu? Hayır. Tarayıcı ve sunucu olayları ortak event_id taşır; Facebook bunları tek olay sayar.

Bir sorun olursa sitem yavaşlar mı? Hayır. CAPI gönderimi arka planda, zaman aşımı korumasıyla yapılır; Facebook'a erişilemese bile ödeme akışı ve sayfa etkilenmez.