WebdesizDönüşüm API'si (Conversions API, CAPI) nedir?
Diğer adları: Conversions API, CAPI, Sunucu tarafı olay
Dönüşüm API'si (Conversions API, kısaca CAPI), satın alma ya da form gibi olayları tarayıcı yerine sunucundan, e-ticaret altyapından ya da müşteri kayıt sisteminden Meta'ya gönderen bağlantıdır. Meta'nın belgesine göre bu olaylar pikselden gelen olaylar gibi işlenir; ölçüm, raporlama ve optimizasyonda kullanılır.
Piksel varken neden gerekir?
Piksel ziyaretçinin tarayıcısında çalışır. Reklam engelleyici, tarayıcı gizlilik ayarı ya da sayfanın olay gönderilmeden kapanması piksel olayını kaybettirebilir. Sunucudan gönderilen olay bu kayıplardan etkilenmez, çünkü satış senin sisteminde kesinleştiğinde gönderilir.
Meta'nın amacı da aynı: belgesinde Dönüşüm API'sinin reklam hedeflemesini iyileştiren, sonuç başına maliyeti düşüren ve sonuçları ölçen sistemlere reklamverenin kendi verisini bağladığı yazılıdır. Daha çok olay doğru ulaştıkça optimizasyon daha sağlam veriyle çalışır.
Kurarken dikkat edilecekler
Aynı satın almayı hem pikselden hem sunucudan gönderiyorsan iki olayın aynı olay kimliğini taşıması gerekir; Meta böylece çift saymaz. Kimlik eşleşmezse satış iki kez sayılır ve ROAS olduğundan iyi görünür.
Kişisel veri, Meta'nın istediği biçimde karma (hash) işleminden geçirilerek gönderilir. Meta, siteye piksel kurmuş reklamverenler için Etkinlik Yöneticisi'nden kodsuz, tek tıkla kurulum da sunduğunu belirtiyor; teknik ekip yoksa ilk bakılacak yol budur.
Olayların gerçekten ulaştığını nasıl anlarsın?
Kurulumdan sonraki ilk iş, Etkinlik Yöneticisi'nde olayların geldiğini görmektir. Meta'nın belgesi de kurulumun son adımı olarak olayların alındığını, çift kayıtların birleştirildiğini ve eşleşmenin doğru çalıştığını doğrulamayı öneriyor.
Pratik bir kontrol: bir hafta boyunca mağaza panelindeki sipariş sayısını Etkinlik Yöneticisi'ndeki satın alma olayı sayısıyla karşılaştır. Meta'daki sayı belirgin biçimde yüksekse çift sayım, belirgin biçimde düşükse kaybolan olay vardır.
Sık yapılan hatalar
- Piksel ve sunucu olaylarını ortak olay kimliği olmadan gönderip satışları çift saymak.
- Kişisel veriyi karma işleminden geçirmeden göndermek.
- Kurulumdan sonra Etkinlik Yöneticisi'nde olayların gerçekten ulaştığını kontrol etmemek.
Kaynak
Son kontrol: 2 Kasım 2026
Sık sorulanlar
CAPI ile piksel aynı anda kullanılır mı?
Evet, önerilen kullanım budur. İkisinin aynı olayı aynı olay kimliğiyle göndermesi gerekir ki Meta çift kaydı birleştirebilsin.
Dönüşüm API'si ücretli mi?
Meta'nın kendisi ücret almıyor; belgesinde Etkinlik Yöneticisi üzerinden kurulumun kurulum ücreti olmadan yapılabildiği yazıyor. Kendi sunucunda ya da bir hizmet sağlayıcıyla kurarsan o tarafın maliyeti ayrıdır.
Küçük bir işletme için gerekli mi?
Satış ya da form kampanyası yürütüyorsan faydalıdır, çünkü kaybolan olaylar optimizasyonu bozar. Yalnız bilinirlik kampanyası yürütüyorsan aciliyeti düşüktür.
Bu rakamları tablodan okumak zorunda değilsin
Reklam hesabını Webdesiz'e bağladığında harcama, gösterim, tıklama ve sonuç başına maliyet panele düşer. Yeni reklamı asistana işini anlatarak hazırlarsın; reklam duraklatılmış oluşur, sen onaylamadan harcama başlamaz.