Conversions API (CAPI) İleri

📚 Seviye 3 — Uzmanlaşma ⏱ ~15 dakika

1. Neden CAPI Gerekli?

Meta Pixel tarayıcı tarafında çalışır ve modern web ortamında ciddi sınırlamalarla karşı karşıyadır. Conversions API (CAPI), sunucu tarafından Meta'ya doğrudan veri göndererek bu boşlukları kapatır.

a) Tarayıcı Tarafı Sınırlamaları

Reklam engelleyiciler (Ad Blockers): Kullanıcıların %30-40'ı reklam engelleyici kullanır; Pixel ateşlenemez.
ITP / ETP (Intelligent Tracking Prevention): Safari ve Firefox birinci taraf çerezleri 7 güne, üçüncü taraf çerezleri anında sıfırlar.
iOS 14.5+ ATT: Kullanıcı izni vermezse IDFA paylaşılmaz, Pixel verisi kısıtlanır.
Tarayıcı çökmeleri / yavaş bağlantı: Sayfa tam yüklenmeden kapatılırsa event kaybolur.

🎯 Benzetme: Pixel, mağazanın kapısındaki güvenlik kamerasına benzer — müşteri kapıyı açmadan geçerse (ad blocker) kayıt yapamaz. CAPI ise kasadaki POS sistemidir; müşteri ödeme yaptığında doğrudan merkeze bildirir. İkisini birlikte kullanmak en güvenilir sonucu verir.

b) CAPI'nin Çözdüğü Problemler

Veri kaybını minimize eder (tarayıcı bağımsız çalışır).
Event Match Quality (EMQ) skorunu artırır.
Daha doğru attribution ve optimizasyon sağlar.
iOS kısıtlamalarının etkisini azaltır.

2. Sunucu Tarafı vs Tarayıcı Tarafı: İkili Kurulum

En iyi uygulama, Pixel ve CAPI'yi paralel çalıştırmaktır. Meta bunu "redundant setup" olarak adlandırır ve resmi olarak önerir.

graph LR USER["👤 Kullanıcı"] --> BROWSER["🌐 Tarayıcı"] BROWSER -->|"Pixel (JS)"| META["📊 Meta Sunucuları"] USER --> WEBSITE["🖥 Web Sunucusu"] WEBSITE -->|"CAPI (HTTP)"| META META --> DEDUP["🔄 Event Deduplication"] DEDUP --> ADS["📈 Ads Manager\nRaporlama + Optimizasyon"] style BROWSER fill:#E8F6FC,stroke:#29ABE2 style WEBSITE fill:#DCFCE7,stroke:#22C55E style META fill:#F5F7FA,stroke:#2D3A4A

a) Paralel Çalışma Mantığı

Pixel ve CAPI aynı event'i gönderdiğinde Meta, event_id ve event_name eşleşmesi ile tekrar sayımı engeller. Bu sayede:

Pixel çalıştığında: İki kaynak doğrular, veri güvenilir.
Pixel engellendiğinde: CAPI tek başına event'i yakalar.
Hiçbir durumda çift sayım olmaz (deduplication).

b) Yalnızca CAPI Kullanımı

Bazı senaryolarda (offline satış, CRM verisi, çağrı merkezi) yalnızca CAPI kullanılır. Bu durumda Pixel gerekmez çünkü event tarayıcıda oluşmaz.

3. CAPI Kurulum Yöntemleri

CAPI'yi entegre etmenin birden fazla yolu vardır; her biri farklı teknik seviye ve esneklik sunar.

graph TD CAPI["🔧 CAPI Kurulum Yöntemleri"] --> PARTNER["🤝 Partner Entegrasyonu\nShopify, WooCommerce, vb."] CAPI --> SGTM["📦 GTM Server-Side\nOrta-İleri Teknik"] CAPI --> DIRECT["💻 Doğrudan API\nİleri Teknik (Geliştirici)"] CAPI --> GATEWAY["🌐 Conversions API Gateway\nMeta'nın Managed Çözümü"] PARTNER --> P1["Tek tıkla kurulum\nDüşük özelleştirme"] SGTM --> S1["GTM server container\nEsnek ve kontrollü"] DIRECT --> D1["graph API endpoint\nTam kontrol"] GATEWAY --> G1["AWS/GCP üzerinde\nMeta yönetimli"] style PARTNER fill:#DCFCE7,stroke:#22C55E style SGTM fill:#E8F6FC,stroke:#29ABE2 style DIRECT fill:#FEF3C7,stroke:#F59E0B style GATEWAY fill:#F5F7FA,stroke:#2D3A4A

a) Partner Entegrasyonu

Shopify, WooCommerce, Magento gibi platformlar yerleşik CAPI desteği sunar. Kurulum genellikle platform ayarlarından birkaç adımda tamamlanır.

Avantaj: Hızlı kurulum, geliştirici gerektirmez.
Dezavantaj: Gönderilen parametreler sınırlıdır, özelleştirme zordur.

b) GTM Server-Side

Google Tag Manager server container üzerinden Meta CAPI tag'i kullanılır. GA4 gibi diğer araçlarla birlikte merkezi bir sunucu yapısı oluşturulur.

Avantaj: Esnek, birden fazla platform için tek altyapı.
Dezavantaj: Cloud hosting maliyeti, teknik kurulum gerektirir.

c) Doğrudan API Entegrasyonu

Geliştirici ekibiniz Meta Graph API'ye doğrudan HTTP POST istekleri gönderir. En yüksek kontrol seviyesini sunar.

Avantaj: Tam parametre kontrolü, özel veri akışları.
Dezavantaj: Geliştirici kaynağı gerekir, bakım yükü yüksek.

d) Conversions API Gateway

Meta'nın sunduğu yönetimli bir çözümdür. AWS veya Google Cloud üzerinde Meta tarafından yönetilen bir endpoint kurulur.

Avantaj: Meta yönetimli, güncellemeler otomatik.
Dezavantaj: Cloud maliyeti, sınırlı özelleştirme.

4. Event Deduplication (Çift Sayım Önleme)

Pixel ve CAPI paralel çalıştığında aynı event'in iki kez sayılmaması kritik öneme sahiptir.

a) Deduplication Mekanizması

Meta, iki parametre çiftiyle deduplication yapar:

event_name: Event türü (ör. Purchase, AddToCart)
event_id: Her event instance'ına özgü benzersiz tanımlayıcı (ör. purchase_12345_1680000000)

Aynı event_name + event_id çifti 48 saat içinde hem Pixel hem CAPI'den gelirse, Meta bunu tek event olarak sayar.

💡 İpucu: event_id oluştururken sipariş numarası + timestamp kombinasyonu kullanın. Örnek: "order_5678_" + Date.now(). Böylece her event benzersiz olur ama aynı siparişin Pixel ve CAPI kaydı eşleşir.

b) Deduplication Doğrulama

Events Manager > Test Events sekmesinde gönderilen event'leri kontrol edin. Her event'in yanında "Browser" veya "Server" etiketi görünür. Aynı event_id ile eşleşen event'ler "Deduplicated" olarak işaretlenir.

5. Event Match Quality (EMQ) Skoru

EMQ, CAPI üzerinden gönderilen kullanıcı bilgilerinin Meta kullanıcılarıyla ne kadar iyi eşleştiğini gösteren 1-10 arasında bir puandır.

a) EMQ'yu Etkileyen Parametreler

Yüksek etkili: em (e-posta), ph (telefon), fn + ln (ad + soyad)
Orta etkili: ct (şehir), st (eyalet), zp (posta kodu), country
Düşük etkili: db (doğum tarihi), ge (cinsiyet), external_id
Özel: fbp (Facebook Pixel çerezi), fbc (Facebook click ID)

⚠️ Uyarı: EMQ skoru 6'nın altındaysa optimizasyon performansı önemli ölçüde düşer. Hedef her zaman 8+ olmalıdır. En etkili iyileştirme: em (hash'lenmiş e-posta) ve fbp/fbc parametrelerini eklemektir.

b) EMQ Kontrol ve İyileştirme

Events Manager > Data Sources > Pixel'inizi seçin.
"Event Match Quality" sekmesine gidin.
Her event için EMQ skorunu ve eksik parametreleri inceleyin.
Düşük skorlu event'lere ek kullanıcı parametreleri ekleyin.

6. Pixel + CAPI Paralel Mimari

Aşağıdaki diyagram, bir e-ticaret satın alma akışında Pixel ve CAPI'nin nasıl paralel çalıştığını gösterir.

sequenceDiagram participant U as Kullanıcı participant B as Tarayıcı participant S as Web Sunucusu participant M as Meta U->>B: Satın alma tamamla B->>M: Pixel Purchase event
event_id: "purch_123" B->>S: Sipariş verisi (POST) S->>S: Sipariş kaydet + event_id oluştur S->>M: CAPI Purchase event
event_id: "purch_123"
+ em, ph, fbp M->>M: Deduplication
(aynı event_id = tek event) M-->>M: Optimizasyon + Raporlama

💡 İpucu: CAPI implementasyonu sonrası mutlaka Events Manager'daki "Overview" sekmesinden event hacmini izleyin. CAPI öncesi ve sonrası event sayılarını karşılaştırarak ne kadar veri kurtardığınızı ölçebilirsiniz.

📝 Quiz — Bilgini Test Et

← Önceki Ders Sonraki Ders →