Meta Dönüşüm API (CAPI) Nedir, Neden Kurulmalı

Meta Dönüşüm API (Conversions API, kısaca CAPI), sitenizde olan satış ve diğer olay verisini tarayıcı yerine kendi sunucunuzdan Meta’ya gönderen bağlantıdır. Neden kurulmalı sorusunun cevabı şu, Pixel tarayıcıda çalıştığı için olayları kaçırabilir, sunucudan gönderilen veri bu açığı kapatmaya yardım eder. Meta’nın önerisi de Pixel’i bırakmak değil, ikisini birlikte kullanmak.

Bu yazıda Meta’nın kendi geliştirici belgelerinde yazanlara dayanıyoruz. Doğrulayamadığımız iddiaları yazmadık. Reklam maliyetlerinin arkasındaki ölçüm sorununu daha önce Meta reklam maliyetleri yazımızın ölçüm kaybı bölümünde anlatmıştık. Şimdi bu bölümü teknik tarafıyla açıyoruz. Kurulumları BossyDigital ekibi olarak müşteri hesaplarında düzenli yapıyoruz.

Meta Dönüşüm API nedir

Meta’nın dokümanı Conversions API’yi, reklamverenin pazarlama verisi ile Meta sistemleri arasındaki bir bağlantı olarak tanımlıyor. Veri reklamverenin sunucusundan, web sitesi platformundan, uygulamasından ya da CRM’inden geliyor ve reklam hedeflemeyi iyileştirmek ve sonuçları ölçmek için kullanılıyor. Web olayları, uygulama olayları, mesajlaşma olayları ve çevrimdışı dönüşümler desteklenen türler arasında.

Yani ikisi birbirinin alternatifi değil. Pixel tarayıcıdaki davranışı yakalar, Dönüşüm API sunucudaki kaydı gönderir. Meta bu yaklaşıma yedekli kurulum diyor ve Conversions API’nin Pixel’in kaçırdığı olayları da yakalayabildiğini yazıyor. Meta, kaçırılma nedenlerini bu sayfada ayrıntılandırmıyor, o yüzden biz de nedenleri tek tek saymıyoruz.

Neden kurulmalı

Reklam algoritması hangi gösterimin satışa dönüştüğünü gördüğü ölçüde öğrenir. Gördüğü veri eksikse tahminle çalışır. Hesaplarımızda Meta’da 1.000 gösterim maliyeti 2025 Ekim-Aralık döneminde 61,7 TL’ydi, 2026 Temmuz-Eylül döneminde 154,9 TL oldu. Bu artışın tek nedeni ölçüm değil, kur, vergi, konum ücreti ve rekabet de var. Ama ölçüm, bütçe sahibinin doğrudan kontrol edebildiği kısım.

Yazımızda gözlemimizi şöyle yazmıştık. Ölçüm kaybını en sert hisseden hesaplar, Pixel kurulumu zayıf ve Conversions API bağlantısı olmayan hesaplar. Bu bir Meta iddiası değil, bizim hesap gözlemimiz. Meta tarafında doğrulanan şu, bağlantı kurulduğunda olaylar Pixel, SDK ve çevrimdışı kaynaklarla aynı şekilde işleniyor.

BlackBörk çalışmasında da kurulum listesinde yer aldı. Google Ads ve Analytics etiketleriyle birlikte Facebook Pixel ve Dönüşüm API kuruldu. Çalışmanın sonucu Ekim 2023 - Mayıs 2024 arasında web sitesi cirosunda %309 artış oldu. Bu sonucu yalnız Dönüşüm API'ye bağlamıyoruz, pazar analizi, reklam yapısı, site ve e-posta işleri birlikte yürüdü. Ayrıntılar BlackBörk vaka analizinde.

Hangi veriyi gönderirsiniz

Her sunucu olayı belirli parametreler taşır. Meta'nın en iyi uygulamalar sayfasına göre web olaylarında action_source, event_source_url ve client_user_agent gönderilmeli, tüm olaylarda external_id ve event_id eklenmeli. E-posta, telefon, IP adresi ve isim gibi ek müşteri bilgileri Event Match Quality'yi artırmaya yardımcı olabilir.

Meta, fbp ve fbc'nin değişebilen birinci taraf çerez değerleri olduğunu, bu yüzden düzenli yenilenmesi gerektiğini yazıyor. Business SDK kullanmıyorsanız kullanıcı parametrelerini kendiniz hash'lemelisiniz, SDK bunu otomatik yapıyor. Event Match Quality puanı Events Manager'da her olay için on üzerinden gösteriliyor.

Veriyi gönderme zamanlaması da önemli. Meta, sunucu olaylarının gerçek zamanlı ya da gerçek zamana yakın gruplar halinde gönderilebileceğini söylüyor, belirli bir saniye sınırı vermiyor. Günde bir kez toplu gönderim yapan bir düzen bu öneriden uzak kalır.

Çift sayımı önlemek

Aynı satışı hem Pixel hem API gönderirse Meta'nın bunu tek olay saymasını sağlamak gerekir. Meta'ya göre Pixel'in eventID değeri ile sunucunun event_id değeri ve olay adları eşleşmeli. Aynı Pixel kimliğine ilk olaydan sonra 48 saat içinde gelen eşleşen olaylar tekilleştiriliyor. Event_id kullanılmıyorsa olay adı ile fbp ve external_id eşleşmesi yedek yol, ama bu genellikle önce tarayıcıdan sonra sunucudan gelen olaylar için çalışıyor.

Kurulum kontrol listesi

• Pixel kimliği, erişim belirteci ve Meta Business Suite erişimi hazır mı. Tarayıcı ve sunucuda aynı Pixel kimliği kullanılıyor mu
• Sunucu olaylarında olay adları Pixel'dekiyle birebir aynı mı
• Her olayda event_id var mı, değer Pixel ve sunucuda aynı mı
• E-posta ve telefon hash'lenerek mi gidiyor, IP ve user agent hash'lenmeden mi
• Events Manager'da Event Match Quality puanı ve tekrar oranı kontrol edildi mi
• Satış sayısı mağaza panelindeki siparişle yan yana karşılaştırıldı mı

Kurulumun hangi yolla yapılacağı altyapıya göre değişir. Pixel varsa Events Manager'dan tek tıkla kurulum seçeneği, kendi sunucunuz varsa API çağrısı, mağaza platformunuzda hazır bir entegrasyon varsa o yol açılabilir. Hangisini seçerseniz seçin sonda mağaza verisiyle eşleşmeyi doğrulayın. Kurulumu bizim yapmamızı isterseniz ölçüm altyapısı kurulumu sayfamıza bakın. Reklamı bu ölçümün üzerinde yönetmek için Meta Ads yönetimi sayfamıza bakabilirsiniz.

Ne bekleyeceksiniz

Dönüşüm API'yi kurunca ROAS'ın hemen yükseleceğini vaat etmiyoruz, Meta da böyle bir şey söylemiyor. Gerçekçi beklenti, olayların daha eksiksiz ve daha az gecikmeyle gelmesi. Bunun reklamınıza etkisi hesaba, kreatife ve ürüne göre değişiyor. Etkiyi görmek için kurulumdan önce son 30 günün satış sayısını ve Meta'nın raporladığı satış sayısını not alın, kurulumdan 30 gün sonra aynı karşılaştırmayı yapın.

Ölçüm tek başına yetmez. Reklam hesabındaki satış ile mağazanızdaki gerçek satışı yan yana okumak gerekir. Mağazası panele bağlı markalarımızda Temmuz-Eylül 2026'da Google ve Meta harcaması başına mağazaya giren satış 4,49 TL oldu. Bu rakam platform raporlarının satışı kendi lehine sayabildiğini hatırlatıyor. Kurulumun reklam, site ve mağaza verisini tek düzende toplaması için e-ticaret ajansı ve performans pazarlama sayfalarımıza bakabilirsiniz. Ajansın bu ölçümü neden en başa koyduğunu dijital pazarlama ajansı nedir yazımızda anlattık.

Meta Dönüşüm API, SSS