iOS 14+ Sonrası Meta CAPI ve Dönüşüm API Kurulum Hataları

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 Ads ekosistemini kökten değiştirdi. Tarayıcı tabanlı piksel tek başına artık yetersiz kalmakta; Conversions API (CAPI) 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):

• Kullanıcının tarayıcısından (JavaScript) Meta'ya veri gönderir
• iOS 14+ sonrası Apple cihazlarda büyük ölçüde engellenir
• Safari ITP (Intelligent Tracking Prevention) 7 gün sonra çerezleri siler
• Adblocker'lar tarafından kolaylıkla bloke edilir

Conversions API (Server-Side):

• Web sitenizin sunucusundan Meta'ya direkt veri gönderir
• Tarayıcı engellerine takılmaz
• Daha güvenilir ve doğru veri
• GDPR/KVKK uyumlu veri işleme imkanı

İ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ş ROAS 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.

Shopify 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 CPA

EMQ Artırma Yöntemleri:

Sunucudan CAPI'ye şu veri noktalarını gönderin (hepsini doldurun):

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ı:

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:

1. Test Event Code alın
2. Web sitenizde gerçek bir satın alma işlemi yapın
3. Events Manager'da piksel VE CAPI olaylarının aynı event_id ile geldiğini doğrulayın

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 Pixel & 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

Shopify

1. Meta uygulamasını App Store'dan yükleyin
2. Facebook Business Manager hesabınızı bağlayın
3. Pixel seçin veya yeni oluşturun
4. Conversions API'yi "On" konumuna getirin
5. Test Events ile doğrulayın

Kontrol edilmesi gerekenler:

• Uygulama kurulu mu? (Shopify Apps paneli)
• Pixel aktif mi? (Meta Events Manager)
• Olay eşleştirmesi doğru mu? (Satın alma → Purchase)

Ticimax

Ticimax'ta CAPI genellikle pixel ile entegre çalışır:

1. Ticimax yönetici → Entegrasyonlar → Meta Pixel bölümü
2. Pixel ID ve CAPI Access Token girin
3. Hangi eventlerin tetikleneceğini seçin

Dikkat: Ticimax'ta bazı versiyonlarda event_id deduplication otomatik değildir. Kontrol edin.

IdeaSoft

IdeaSoft için genellikle manuel kurulum gerekir:

1. Meta Events API Access Token oluşturun (Business Manager → Data Sources)
2. IdeaSoft'a JavaScript Pixel kodu ekleyin (<head>)
3. Sunucu tarafı için bir middleware veya webhook geliştirin ya da Segment/Stape gibi aracı bir çözüm kullanın

WooCommerce / WordPress

PixelYourSite Pro eklentisi en kapsamlı CAPI desteğini sağlar:

1. Eklentiyi yükleyin
2. Facebook CAPI Access Token ve Pixel ID girin
3. WooCommerce entegrasyonunu aktifleştirin
4. Server-side events toggle'ını açın

Olayların Kalitesini İzleme

Events Manager Dashboard

Meta Business Manager → Events Manager → Pixel seçin

İzlemeniz gereken metrikler:

• Event Match Quality Skoru: 7+ iyi, 5-6 kabul edilebilir, 5 altı sorunlu
• Deduplication Rate: Deduplication yüzdesi. Çok düşük → hatalı setup
• Sunucu Olayları: CAPI üzerinden gelen olay sayısı
• Tarayıcı Olayları: Pixel üzerinden gelen olay sayısı

Haftalık Kontrol Checklist'i

• [ ] Events Manager'da Purchase event sayısı GA4 ile uyuşuyor mu?
• [ ] EMQ skoru 7'nin üzerinde mi?
• [ ] Deduplication çalışıyor mu? (Aynı olay 2 kez sayılmıyor mu?)
• [ ] Test Events ile son kurulum doğrulandı mı?
• [ ] fbp ve fbc değerleri CAPI'de var mı?

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:

• Google Tag Manager Server Container ile çalışır
• Meta CAPI, TikTok Events API, GA4 entegrasyonu tek yerden
• Veri zenginleştirme (data enrichment) özelliği ile EMQ skoru artırılır
• Aylık $50-200 arası paketler

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.