iOS 14+ Sonrası Meta CAPI ve Dönüşüm API Kurulum Hataları - TechData Reklam Blog
← Blog'a Dön
Meta Ads1 Temmuz 202615 dk okuma

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


    Veri NoktasıEMQ EtkisiTürkçe
    em (email hash)Çok YüksekE-posta
    ph (phone hash)Çok YüksekTelefon
    fn (first name hash)OrtaAd
    ln (last name hash)OrtaSoyad
    ct (city hash)OrtaŞehir
    countryDüşükÜlke
    client_ip_addressOrtaIP adresi
    client_user_agentOrtaTarayıcı bilgisi
    fbcYüksekFacebook click cookie
    fbpYüksekFacebook 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/AksiyonEvent
    Ürün sayfası görüntülemeViewContent
    Sepete eklemeAddToCart
    Ödeme sayfasına geçişInitiateCheckout
    Ödeme bilgisi girmeAddPaymentInfo
    Sipariş tamamlamaPurchase
    Form doldurmaLead
    Arama yapmaSearch

    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:

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


  • 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

    💡 Bu konuda yardıma ihtiyacınız var mı?

    Uzman ekibimiz reklam stratejinizi ücretsiz analiz etsin.

    Ücretsiz Görüşme →

    Shopify


  • Meta uygulamasını App Store'dan yükleyin
  • Facebook Business Manager hesabınızı bağlayın
  • Pixel seçin veya yeni oluşturun
  • Conversions API'yi "On" konumuna getirin
  • 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:

  • Ticimax yönetici → Entegrasyonlar → Meta Pixel bölümü
  • Pixel ID ve CAPI Access Token girin
  • 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:

  • Meta Events API Access Token oluşturun (Business Manager → Data Sources)
  • IdeaSoft'a JavaScript Pixel kodu ekleyin (<head>)
  • 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:

  • Eklentiyi yükleyin
  • Facebook CAPI Access Token ve Pixel ID girin
  • WooCommerce entegrasyonunu aktifleştirin
  • 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.


    ÜCRETSİZ HİZMET

    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.

    50+
    Aktif Marka
    5.2x
    Ort. ROAS
    %40
    CPA Düşüşü
    👨‍💻
    Yazar
    Muhammet Akif Çontay

    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.

    📘 Meta Blueprint🔍 Google AdsLinkedIn Profil →

    📬 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