
iOS 14+ Sonrası Meta CAPI ve Dönüşüm API Kurulum Hataları
Meta Conversions API kurulumunda sık yapılan deduplication (tekilleştirme) ve Event Match Quality (Etkinlik Eşleşme) hataları ve çözümleri.
iOS 14+ Sonrası Meta CAPI ve Dönüşüm API Kurulum Hataları
Apple'ın 2021'de iOS 14.5 ile getirdiği App Tracking Transparency (ATT) güncellemesi, Meta AdsMeta Ads (Facebook & Instagram Reklamları)Meta Ads; Facebook, Instagram, Messenger ve Audience Network platformlarında yayınlanan reklam modelidir. Yapay zeka hedeflemesi ile e-ticaret (D2C) siteleri için temel hacim kanalıdır.Detaylı Bilgi Oku → ekosistemini kökten değiştirdi. Tarayıcı tabanlı piksel tek başına artık yetersiz kalmakta; Conversions API (CAPICAPI (Conversions API (Sunucu Tarafı İzleme))CAPI (Conversions API), Meta'nın sunucu tarafından veri gönderme teknolojisidir. Tarayıcı engelleyicileri ve iOS gizlilik kurallarını aşarak %95+ veri doğruluğu sağlar. Facebook Pixel ile birlikte kullanıldığında veri kaybını minimuma indirir.Detaylı Bilgi Oku →) kurulumu olmadan Meta reklam hesaplarında gerçek dönüşümlerin %30-50'si görünmez hale gelmektedir.
Bu rehberde, e-ticaret mağazalarında sıkça karşılaşılan CAPI kurulum hatalarını, deduplication sorunlarını ve Event Match Quality (EMQ) optimizasyonunu detaylıca ele alıyoruz.
TechData Reklam Uyarısı: CAPI kurulmadan yönetilen bir Meta hesabı körü körüne uçuş yapıyor demektir. Veri yoksa optimizasyon da yok.
CAPI Nedir ve Neden Şarttır?
Geleneksel Piksel vs. CAPI
Tarayıcı Piksel (Client-Side):
Conversions API (Server-Side):
İki Katmanlı Strateji
Optimal ölçüm için Piksel + CAPI birlikte kullanılmalıdır. Sadece CAPI de yeterli değildir; her ikisi de farklı kullanıcı veri noktalarını yakalar.
En Sık Yapılan CAPI Kurulum Hataları
Hata 1: Deduplication (Tekilleştirme) Yapılmaması
Bu, CAPI kurulumunun en kritik adımıdır ve en sık atlanan kısımdır.
Problem:
Piksel ve CAPI aynı anda çalışıyorsa, bir satın alma olayı hem tarayıcıdan hem sunucudan Meta'ya iletilir → Meta aynı dönüşümü iki kez sayar → Yapay şişirilmiş ROASROAS (Return on Ad Spend)ROAS (Return on Ad Spend), reklam harcamalarının getirisini ölçen temel performans metriğidir. Formülü: Reklam Geliri / Reklam Maliyeti. Örneğin 5x ROAS, harcadığınız her 1₺ için 5₺ gelir elde ettiğiniz anlamına gelir. E-ticaret reklamcılığında en kritik KPI'dır. Reklam kârlılığınızı ve başabaş sınırınızı Kârlılık & ROAS Hesaplayıcı aracımızla simüle edebilirsiniz.Detaylı Bilgi Oku → ve bütçe israfı.
Çözüm — Event ID Kullanımı:
Her dönüşüm olayı için benzersiz bir event_id oluşturun. Piksel ve CAPI, aynı event_id ile gönderildiğinde Meta sadece birini sayar.
Piksel tarafında: fbq('track', 'Purchase', { value: 499.90, currency: 'TRY' }, { eventID: 'order_12345_1720000000' });
CAPI sunucu tarafında: event_name: Purchase, event_id: order_12345_1720000000 (AYNI ID!), event_time: Unix timestamp.
ShopifyShopify (Shopify E-Ticaret Platformu)Shopify, dünya genelinde 4 milyon+ mağazanın kullandığı SaaS (Servis Olarak Yazılım) tabanlı e-ticaret platformudur. Kolay kurulum, geniş uygulama ekosistemi ve uluslararası satış desteğiyle öne çıkar. Shopify Plus versiyonu kurumsal markalar için tasarlanmıştır.Detaylı Bilgi Oku → için TikTok/Meta uygulaması bu ID'yi otomatik yönetir. Özel altyapılarda developer müdahalesi şarttır.
Hata 2: Düşük Event Match Quality (EMQ) Skoru
EMQ, Meta'nın müşteri verilerini kendi kullanıcı tabanıyla ne ölçüde eşleştiirebildiğini 0-10 skalasında gösterir.
Neden Önemli:
EMQ skoru düşük = Meta hangi kullanıcının satın aldığını bilemiyor = Algoritma optimizasyonu zayıf = Daha yüksek CPACPA (Cost Per Acquisition)CPA (Cost Per Acquisition), bir müşteri veya spesifik bir eylem (satın alma, lead) elde etme maliyetidir. Bütçenin toplam dönüşüme bölünmesiyle hesaplanır.Detaylı Bilgi Oku →
EMQ Artırma Yöntemleri:
Sunucudan CAPI'ye şu veri noktalarını gönderin (hepsini doldurun):
| Veri Noktası | EMQ Etkisi | Türkçe |
|---|---|---|
| em (email hash) | Çok Yüksek | E-posta |
| ph (phone hash) | Çok Yüksek | Telefon |
| fn (first name hash) | Orta | Ad |
| ln (last name hash) | Orta | Soyad |
| ct (city hash) | Orta | Şehir |
| country | Düşük | Ülke |
| client_ip_address | Orta | IP adresi |
| client_user_agent | Orta | Tarayıcı bilgisi |
| fbc | Yüksek | Facebook click cookie |
| fbp | Yüksek | Facebook browser cookie |
Kritik: E-posta ve telefon verileri SHA-256 ile hash'lenerek gönderilmeli (GDPR/KVKK uyumu için).
Hata 3: Yanlış Event Eşleme
Hangi URL veya aksiyonda hangi event'in tetikleneceği yanlış kurulursa Meta yanlış optimize eder.
Doğru Event Haritası:
| Sayfa/Aksiyon | Event |
|---|---|
| Ürün sayfası görüntüleme | ViewContent |
| Sepete ekleme | AddToCart |
| Ödeme sayfasına geçiş | InitiateCheckout |
| Ödeme bilgisi girme | AddPaymentInfo |
| Sipariş tamamlama | Purchase |
| Form doldurma | Lead |
| Arama yapma | Search |
Hata 4: Test Olmadan Canlıya Geçme
CAPI kurulumunu test etmeden canlıya almak veri güvenilirliğini riske atar.
Test Aracı: Meta Business Manager → Events Manager → Test Events
Test Events ekranında:
Hata 5: fbp ve fbc Cookie'lerini Yakalamamak
fbp (Facebook browser ID) ve fbc (Facebook click ID) CAPI'de çok kritik iki parametredir.
fbp: Kullanıcının tarayıcısında _fbp cookie'sinde saklanır. Piksel otomatik oluşturur.
fbc: Kullanıcı Facebook reklamına tıkladığında URL'ye eklenen fbclid parametresidir.
Bu değerler sunucu tarafı CAPI isteğine eklenmezse EMQ skoru düşer.
Shopify için çözüm: TikTok/Meta PixelMeta Pixel (Facebook Pixel İzleme Kodu)Web sitenize yerleştirilen ve ziyaretçilerin eylemlerini (sayfa görüntüleme, sepete ekleme) izleyip bunu reklam hesabına ileten veri takip kodudur.Detaylı Bilgi Oku → & Events API uygulaması otomatik yakalar.
Özel altyapı için: Login/sipariş flowunda bu cookie'leri okuyup CAPI isteğine dahil edin.
Platform Bazlı CAPI Kurulum Rehberi
💡 Bu konuda yardıma ihtiyacınız var mı?
Uzman ekibimiz reklam stratejinizi ücretsiz analiz etsin.
Shopify
Kontrol edilmesi gerekenler:
Ticimax
TicimaxTicimax (Ticimax E-Ticaret Altyapısı)Ticimax, Türkiye'nin en yaygın kullanılan yerli e-ticaret altyapı sağlayıcılarından biridir. Pazaryeri entegrasyonları (Trendyol, Hepsiburada, N11), ERP bağlantıları ve yerel ödeme çözümleriyle Türkiye pazarına özel çözümler sunar.Detaylı Bilgi Oku →'ta CAPI genellikle pixel ile entegre çalışır:
Dikkat: Ticimax'ta bazı versiyonlarda event_id deduplication otomatik değildir. Kontrol edin.
IdeaSoft
IdeaSoft için genellikle manuel kurulum gerekir:
WooCommerce / WordPress
PixelYourSite Pro eklentisi en kapsamlı CAPI desteğini sağlar:
Olayların Kalitesini İzleme
Events Manager Dashboard
Meta Business Manager → Events Manager → Pixel seçin
İzlemeniz gereken metrikler:
Haftalık Kontrol Checklist'i
Gelişmiş CAPI: Stape.io Kullanımı
Özelleştirilmiş altyapılar için Stape.io gibi server-side tagging platform çözümleri developer ihtiyacını azaltır:
Sıkça Sorulan Sorular
CAPI kurulumu olmadan reklam çalışır mı?
Evet, çalışır. Ancak iOS 14+ sonrası gerçek dönüşümlerin %30-50'si görünmez. Meta yanlış optimize eder, CPA artar ve ROAS düşer.
CAPI için developer şart mı?
Shopify ve WooCommerce için hayır — uygulamalar otomatik kurar. Ticimax ve IdeaSoft gibi Türk altyapılar için kısmi developer müdahalesi gerekebilir. Stape.io gibi çözümler developer bağımlılığını azaltır.
Event Match Quality'yi hızlıca artırmanın yolu nedir?
En hızlı yol: Sunucudan CAPI isteğine e-posta hash'i ve telefon hash'i eklemek. Bu iki alan EMQ üzerinde en büyük etkiyi yaratır. Müşterinin ödeme sırasında girdiği e-posta/telefon, SHA-256 ile hash'lenerek CAPI isteğine dahil edilmelidir.
Reklam Hesabınızı
Ücretsiz Analiz Edelim
Meta Ads ve Google Ads hesaplarınızda kaçırdığınız fırsatları, bütçe sızıntılarını ve ROAS potansiyelinizi keşfedin.
Kurucu & Büyüme Uzmanı
Meta Blueprint ve Google Ads sertifikalı. 6 yılı aşkın süredir 50+ e-ticaret markasını veri odaklı performans pazarlama ve otomasyon stratejileriyle büyütmekte, ₺100M+ reklam bütçesi yönetim deneyimine sahiptir.
📑 İçindekiler
📬 Bu Tarz İçerikleri Kaçırmayın
Haftalık e-ticaret büyüme ipuçları ve Ücretsiz Audit Fırsatları için hemen abone olun
İlgili Yazılar
Facebook Pixel ve CAPI Kurulum Rehberi 2026
iOS 14.5 sonrası Meta Ads veri kaybını önleyen Conversions API (CAPI) kurulumu. Shopify, Ticimax ve WooCommerce için adım adım teknik rehber.
Meta AdsMeta Ads'de 5 Büyük Bütçe Hatası (2026)
Yapay zeka döneminde Advantage+ (ASC) kampanyalarını kurup unutmak bütçenizi tüketir. ROAS artırıcı Meta kampanya sırlarını ve ajans pratiklerini keşfedin.
Meta AdsMeta Ads Maliyetleri 2026: Bütçe Rehberi
Facebook ve Instagram reklam maliyetleri ne kadar? CPC, CPM ve CPA karşılaştırması ile bütçenizi nasıl planlarsınız? Sektörel benchmark verileri.
Meta AdsInstagram Reklam Maliyetleri 2026: Bütçe Rehberi
Instagram reklamları ne kadar? Reels, Stories ve Feed reklam maliyetleri, sektörel CPC benchmark verileri ve bütçe optimizasyon stratejileri.
Meta AdsAdvantage+ Shopping (ASC) Rehberi 2026
ASC nasıl kurulur ve optimize edilir? E-ticaret markaları için AI destekli kampanya yönetimi ve ölçekleme taktikleri.
Meta AdsKadın Giyim E-Ticaretinde Kreatif Test ve Advantage+ Reklamları
Kadın giyim markalarında CPA düşüren reklam kancaları (hook), Advantage+ (ASC) campaigns ve haftalık kreatif test etme metodolojisi.