iOS 14.5+ Apple Tracking Transparency (ATT) sonrası Meta Ads performansı düşüşe geçti. Sebep basit: browser-side Meta Pixel kullanıcının izin vermediği event’leri yakalayamıyor ve Meta algoritması yetersiz sinyalle optimize etmek zorunda kalıyor. Çözüm: Conversions API (CAPI) ile server-side event gönderimi. Bu rehberde meta pixel capi kurulumunu adım adım, farklı platformlar için anlatıyoruz.
Bu yazı, Meta Ads Rehberi 2026 hub’ının teknik kurulum parçasıdır. Genel strateji için hub’a, detaylı CAPI implementasyonu için bu rehbere odaklanabilirsiniz.
Meta Pixel + CAPI Nedir?
Meta Pixel, web sitenize eklediğiniz bir JavaScript kod parçasıdır; kullanıcı etkileşimlerini (sayfa görüntüleme, ürün bakma, sepete ekleme, satın alma) Meta’ya bildirir. Conversions API (CAPI) ise aynı etkinlikleri browser yerine doğrudan sunucunuzdan Meta sunucusuna gönderen bir protokoldür.
| Özellik | Meta Pixel | CAPI |
|---|---|---|
| Yayın | Browser (client-side) | Server (server-side) |
| Ad blocker etkisi | Engellenebilir | Etkilenmez |
| iOS 14.5 kaybı | %20-35 kayıp | Etkilenmez |
| Gerçek zamanlı | Anlık | Anlık veya batch |
| First-party data | Sınırlı | Tam kontrol |
Neden CAPI 2026’da Zorunlu?
Three büyük sebep: (1) iOS 14.5 ATT kaybını geri kazanmak, (2) ad blocker ve browser gizlilik araçlarına karşı bağışıklık, (3) server-side verisinin kullanıcı-eşleştirme (identity matching) için daha zengin sinyal içermesi. Meta’nın EMQ (Event Match Quality) skoru CAPI ile 5-8 puan artar, bu da algoritma kalitesine direkt yansır.
Temel Event’ler ve Parametreler
- PageView: Sayfa görüntüleme
- ViewContent: Ürün sayfası — content_ids, value, currency
- AddToCart: Sepete ekleme — content_ids, value, currency
- InitiateCheckout: Ödeme başlatma
- AddPaymentInfo: Ödeme bilgileri girme
- Purchase: Satın alma — value, currency, content_ids (en kritik event)
- Lead: Lead form gönderimi
- CompleteRegistration: Üyelik tamamlama
Kurulum Seçenekleri
Seçenek 1: Shopify Native CAPI
Shopify admin → Online Store → Preferences → Meta Pixel bölümünde Meta Pixel kurulumu yapıp “Conversions API” seçeneğini açmak yeterli. Shopify tüm e-ticaret event’lerini otomatik gönderir, deduplication hallolmuş gelir. En kolay seçenek.
Seçenek 2: WooCommerce + Plugin
PixelYourSite Pro, Facebook for WooCommerce, veya Pixel Cat gibi plugin’ler WooCommerce siteler için CAPI kurulumu sağlar. Access Token ve Pixel ID girildikten sonra tüm event’ler otomatik akmaya başlar. Plugin fiyatları yıllık 70-150 USD arasıdır.
Seçenek 3: GTM Server-Side Container
Google Tag Manager server-side container en esnek ve kontrol sağlayan çözümdür. Google Cloud Run veya benzeri server üzerinde GTM server container çalıştırılır, browser event’leri buraya gönderilir, GTM bu event’leri CAPI formatına çevirip Meta’ya iletir. Kurulum zaman alır ama uzun vadede en temiz çözümdür.
Seçenek 4: Custom Server Implementation
Node.js, Python, PHP veya başka backend dillerde Meta’nın Graph API’sine doğrudan POST istek atarak CAPI implement edilebilir. En esnek ama en çok iş gerektiren seçenek. Büyük e-ticaret siteleri için önerilir.
Deduplication: Çift Sayım Önlemi
Pixel ve CAPI aynı event’i iki kez gönderdiğinde Meta’nın bunu tek event olarak saymasını sağlamak deduplication’dır. Mekanizma basittir: her event’e benzersiz bir event_id eklenir. Aynı event_id ile gelen ikinci event tekil sayılır.
Event ID üretme örnekleri: UUID v4, order_id + timestamp, user_id + timestamp. Pixel tarafında fbq(‘track’, ‘Purchase’, {value: 100, currency: ‘TRY’}, {eventID: ‘order_12345’}) şeklinde, CAPI tarafında event_id: ‘order_12345’ olarak gönderilir.
Kullanıcı Verisi Hash’leme
CAPI’de kullanıcı verileri (email, telefon, isim, IP adresi) mutlaka SHA-256 ile hash’lenerek gönderilmeli. Gizlilik standartları gereği hash’lenmemiş PII kabul edilmez. Meta SDK’ları (node-js-business-sdk, python-business-sdk) hash işlemini otomatik yapar.
Event Match Quality (EMQ) Skoru
Meta, her event için kullanıcı eşleştirme kalitesini 1-10 arası skorla değerlendirir. 2026’da hedef skor 8+ olmalı. Skoru artırmak için:
- Email mutlaka gönder
- Telefon numarası mümkünse gönder (E.164 format)
- fbp (Facebook browser ID) cookie ekle
- fbc (Facebook click ID) URL’den oku, ekle
- client_ip_address ve client_user_agent server tarafından ekle
- First name, last name, city, state, country mümkünse ekle
Test ve Doğrulama
Events Manager → Test Events sekmesinde test kodu alınır. Bu kod her CAPI payload’a test_event_code olarak eklendiğinde gerçek zamanlı event akışı görünür. İlk kurulumda şu kontroller yapılmalı:
- Pixel + CAPI event’leri deduplicate oluyor mu?
- Purchase event’te value ve currency doğru mu?
- content_ids değerleri Commerce Manager kataloğuyla uyuşuyor mu?
- EMQ skoru 7+ mı?
- Diagnostics sekmesinde uyarı var mı?
Yaygın Hatalar
- event_id eksikliği: Çift sayım, veri şişmesi
- Hash’siz email: Event reddedilir
- Value parametresi eksik Purchase: ROAS hesaplanamaz
- currency yanlış kod: “TL” yerine “TRY” kullan
- Test modunda prod’a geçmek: test_event_code’u üretimde kullanmak
- CAPI olmadan Pixel’i kaldırmak: İkisi birlikte çalışır
CAPI Kurulduktan Sonra Beklenen Kazanımlar
Doğru kurulmuş CAPI sonrası tipik kazanımlar: %20-35 dönüşüm veri kazanımı, EMQ skoru 5-8 puan artış, Advantage+ kampanyalarda %15-25 ROAS iyileşmesi, attribution doğruluğunda görünür düzelme. İlk hafta sonuçları görülmeye başlar.
CAPI kurulum desteği için Meta Ads hizmetlerimizi inceleyebilirsiniz. Ayrıca Dynamic Product Ads rehberimiz ve Instagram reklam maliyetleri rehberimiz ilgili içeriklerdir.
Kaynak: Meta Conversions API Docs, Meta CAPI Setup Guide.
Meta Pixel CAPI Entegrasyonunun Teknik Mimarisi
Meta Pixel CAPI (Conversions API), tarayıcı taraflı piksel takibinin yanı sıra sunucu taraflı olay gönderimi yapılmasını sağlar. Bu çift katmanlı yaklaşım, tarayıcı kısıtlamaları (iOS 14+, ad blocker, çerez reddetme) nedeniyle kaybolan dönüşümleri kurtarır. Teknik mimari açısından: tarayıcıdan piksel → Meta’ya giderken, sunucudan CAPI → Meta’ya gider; her iki yol paralel işler.
Meta Pixel CAPI entegrasyonunda en kritik adım, deduplication (yineleme giderme) işlemidir. Hem pikselden hem CAPI’den gelen aynı olay Meta’ya ulaştığında, event_id eşleşmesi ile tekrarlanan sayım önlenir. Event_id, her olay için unique (benzersiz) bir string olmalı ve hem piksel hem CAPI gönderiminde identik kullanılmalıdır. Bu adım atlandığında reklam performans raporlarında yapay şişme meydana gelir.
CAPI Kurulumu: WooCommerce ve Shopify için Adım Adım
WooCommerce için Meta CAPI entegrasyonunda iki ana seçenek bulunur: Meta for WooCommerce eklentisi (resmi, ücretsiz) veya özel sunucu taraflı geliştirme. Resmi eklenti kurulumu şu adımları içerir: eklenti kurulumu → Facebook Business hesabı ile bağlantı → piksel seçimi → CAPI erişim tokenı oluşturma → olayların eşleştirilmesi (Purchase, AddToCart, ViewContent, InitiateCheckout).
Shopify için Meta’nın native entegrasyonu güçlüdür: Shopify Admin → Satış Kanalları → Facebook & Instagram. Bu entegrasyon hem piksel hem CAPI’yi otomatik olarak yapılandırır ve deduplication’ı kutudan çıkar çıkmaz yönetir. Veri kalitesi skorunu (EMQ) düzenli izleyin; 6+ skorunu sürdürmek reklam optimizasyonu için kritiktir.
Meta Pixel ile CAPI Arasındaki Kapsama Farkını Ölçmek
CAPI kurulumunun etkinliğini ölçmek için Events Manager’da “Olay Karşılaştırması” aracını kullanın. Bu araç, yalnızca pikselden gelen, yalnızca CAPI’den gelen ve her iki kanaldan gelen olay sayılarını karşılaştırır. Sağlıklı bir entegrasyonda CAPI’nin kapsama katkısı (yani piksel olmadan yakalanan olaylar) toplam olayların %15-35’ine ulaşır.
Bu oran düşükse (<%10), CAPI'nin tetiklenme koşulları yanlış yapılandırılmış olabilir. Yüksekse (%50+), piksel kurulumunda sorun olabilir ya da CAPI deduplication eksik çalışıyor olabilir. Her iki durumda Events Manager'daki tanılama araçları adım adım kılavuzluk sağlar. Daha fazla bilgi için Meta Ads rehberimize bakabilirsiniz.
Meta Pixel CAPI ile Veri Kalitesi Nasıl İzlenir?
Meta Pixel CAPI entegrasyonunun başarısını ölçmek için Events Manager’ın “Olay Sağlığı” bölümünü izleyin. Burada her olay için “Event Match Quality” (EMQ) skoru görüntülenir; 6-10 arası “İyi”, 4-5 “Orta”, 1-3 “Zayıf” olarak değerlendirilir. Yüksek EMQ, müşteri verilerinin (e-posta, telefon) doğru şekilde iletildiğini ve Meta’nın kullanıcı eşleştirmesini başarıyla tamamladığını gösterir.
EMQ’yu artırmak için: müşteri verisini (e-posta, telefon) hash’lenmiş şekilde CAPI payload’una ekleyin. Formatlama önemlidir — e-posta küçük harf + trim, telefon uluslararası format (+90…) olmalıdır. Birden fazla veri parametresi (hem e-posta hem telefon) göndermek, tek parametre göndermekten daha yüksek eşleştirme oranı verir.
Server-Side Tracking: Meta Pixel CAPI ile Gizlilik Uyumu
KVKK ve GDPR kapsamında Meta Pixel CAPI kullanımında dikkat edilmesi gereken iki temel nokta bulunur: kullanıcı rızası ve veri minimizasyonu. Yalnızca çerez rızası verilmiş kullanıcılar için CAPI olayları Meta’ya gönderilmelidir. Bunu uygulamak için Consent Mode (rıza modu) entegrasyonu gereklidir: kullanıcı rızası yoksa, CAPI tetikleyicisi çalışmamalıdır.
Veri minimizasyonu ilkesi uyarınca yalnızca gerçekten gerekli müşteri verisini gönderin. Örneğin bir satın alma olayı için e-posta + toplam sipariş değeri yeterlidir; tüm müşteri demografisini aktarmaya gerek yoktur. Bu yaklaşım hem yasal uyum sağlar hem de kullanıcı güvenini korur. Daha fazlası için Meta Ads rehberimize bakabilirsiniz.
Meta Pixel CAPI Hata Ayıklama: Sık Karşılaşılan Sorunlar
Meta Pixel CAPI entegrasyonunda en sık karşılaşılan sorunlar şunlardır: event gönderiminin tetiklenmemesi, yanlış event parametreleri ve deduplication hatası. Event gönderimini test etmek için Events Manager’daki “Test Events” aracını kullanın; bu araç sunucudan gelen ham olayları gerçek zamanlı listeler ve eksik parametreleri gösterir.
Yanlış event parametrelerinin en yaygın örneği currency formatıdır — Meta’nın beklediği format ISO 4217 (örneğin “TRY”, “USD”) iken bazı sistemler “₺” veya “TL” gönderebilir. Bu durum event’in işlenip işlenmediğini etkiler. Deduplication hatasında ise event_id tutarsızlığı tipik sorundur: piksel ve CAPI’nin farklı event_id değerleri kullanması çift sayıma yol açar. Meta Pixel CAPI sorunları için destek alın.
Meta Pixel CAPI Başarı Metrikleri ve KPI Takibi
Meta Pixel CAPI entegrasyonunun başarısını ölçmek için izlemeniz gereken başlıca KPI’lar şunlardır: Event Match Quality (EMQ) skoru 6 üzeri olmalı; tarayıcı pikseline ek CAPI katkısı (incremental coverage) en az %15 olmalı; Purchase olayı için CAPI ile piksel arasındaki deduplication oranı %90 üzerinde kalmalı. Bu üç metrik, entegrasyonun sağlıklı çalışıp çalışmadığını objektif biçimde gösterir.
Aylık bazda Meta Pixel CAPI raporlaması yaparken “Karşılaştırmalı Dönem” analizine dikkat edin: CAPI öncesi ve sonrası dönemlerde reklam harcama verimliliği (ROAS) karşılaştırması, entegrasyonun gerçek iş değerini ortaya koyar. Çoğu hesapta CAPI devreye alındıktan 4-8 hafta sonra makine öğrenmesi olgunlaşır ve bu noktadan itibaren reklam başına maliyet belirgin biçimde düşer. Detaylı kurulum için Meta Ads hizmetimize bakın.
Sunucu Taraflı Takibin Geleceği
Çerez tabanlı üçüncü taraf takibinin giderek kısıtlandığı bir ortamda sunucu taraflı veri gönderimi, dijital reklamcılığın temel altyapısı olmaya devam edecek. iOS güncellemeleri ve tarayıcı politikaları değiştikçe, yalnızca piksel taabanlı çalışan hesaplar dönüşüm görünürlüğünü giderek kaybeder. Sunucu taraflı entegrasyon, bu değişimlere karşı dayanıklı bir ölçüm altyapısı kurar ve algoritmaların doğru veriyle öğrenmesini güvence altına alır. Kurulum desteği için bizimle iletişime geçin.
Sunucu taraflı veri iletimi, tarayıcı kısıtlamalarına karşı en dayanıklı çözümdür. Bu altyapıyı doğru kuran işletmeler, gizlilik ekosistemi değiştikçe reklam optimizasyonu kalitesini koruma avantajına sahip olur. Destek için iletişime geçin.
Sunucu taraflı entegrasyon, dijital pazarlamanın gizlilik merkezli geleceğine hazırlanmanın en stratejik adımlarından biridir. Erken uygulayan markalar, tarayıcı ve platform politikaları değiştikçe avantajlı konumda kalır.
Ücretsiz Dijital Pazarlama Analizi
11+ yıl deneyim, 120+ marka referansı. Projenizi 48 saat içinde analiz ediyoruz.
