Conversions API (CAPI), dönüşüm verisini tarayıcı yerine doğrudan sunucudan Meta’ya gönderen bir sistemdir. Pixel’in kaçırdığı veriyi tamamlar; ikisi birlikte çalıştığında Meta, aynı olayı iki kaynaktan görüp daha güvenilir bir tablo çıkarır.
Bu yazıda kurulumu ve ölçtüğü şeyi anlatıyoruz, ayrıca yönettiğimiz bir e-ticaret hesabında CAPI kurulumu sonrası eşleşme kalitesinin nasıl değiştiğini gerçek rakamlarla paylaşıyoruz.
Conversions API neden gerekli?
Tarayıcı tabanlı Pixel, kullanıcının cihazına ve tarayıcısına bağımlı çalışır. Reklam engelleyiciler, Safari’nin ITP koruması, iOS 14.5 sonrası gelen izin talepleri; bunların hepsi Pixel’in bazı olayları hiç görmemesine yol açıyor. Kullanıcı sitede gerçekten alışveriş yapmış olsa bile, tarayıcı o veriyi Meta’ya iletmeden engelleyebiliyor.
CAPI bu sorunu farklı bir yoldan çözüyor. Veri tarayıcıdan değil, sitenin kendi sunucusundan gidiyor. Reklam engelleyicinin veya tarayıcı ayarının bu iletişime müdahale etme şansı yok, çünkü kullanıcının cihazı hiç aradan geçmiyor.
Event Match Quality (EMQ) nedir?
EMQ, Meta’nın gönderdiğiniz her dönüşüm eventi için 0 ile 10 arasında verdiği bir puandır. Puan, gönderdiğiniz olayın gerçek bir Meta kullanıcısıyla ne kadar güvenle eşleştiğini gösterir. E-posta, telefon, IP adresi, tarayıcı bilgisi gibi parametreler ne kadar eksiksiz gönderilirse eşleşme o kadar güçlü oluyor.
Düşük EMQ’nun sonucu somut: sistem hangi kullanıcının dönüşüm getirdiğini tam bilemediği için optimizasyon yapamıyor, kampanya daha pahalı sonuç veriyor. Yüksek EMQ ise aynı bütçeyle daha isabetli hedefleme demek.
Gerçek bir hesapta EMQ nasıl değişti?
Yönettiğimiz bir e-ticaret markasında, server taraflı Purchase ve InitiateCheckout event’lerini PII (e-posta, telefon, IP, kullanıcı aracısı gibi eşleştirme verisi) ile zenginleştirdikten sonra ölçtük. Kurulum öncesi Purchase EMQ 6,1’di, kurulum sonrası 9,3’e çıktı. InitiateCheckout aynı dönemde 6,1’den 8,3’e yükseldi.
Bu değişikliği tesadüfe bağlamamak için Meta’nın kendi dataset kalite panelinden takip ettik, kurulum öncesi ve sonrası aynı hesapta, aynı ürün kategorisinde ölçüm yaptık. Fark tek bir değişkenden geldi: gönderilen event’lere eklenen eşleştirme parametreleri.
Conversions API nasıl kurulur?
Üç yol var, hangisinin uygun olduğu sitenin altyapısına göre değişiyor. Shopify veya WooCommerce gibi hazır platformlarda Meta’nın kendi entegrasyonu üzerinden birkaç tıkla kurulabiliyor; teknik bilgi gerektirmiyor.
Orta ölçekli ve özel kodlu sitelerde Google Tag Manager’ın sunucu konteyneri tercih ediliyor. Bu yöntem, birden fazla platforma (Meta, Google, TikTok) aynı anda veri göndermek isteyen markalar için esneklik sağlıyor ama kurulumu GTM bilgisi gerektiriyor.
Yüksek işlem hacimli kurumsal sitelerde doğrudan API entegrasyonu tercih ediliyor; bu yöntem geliştirici gerektirir ama en fazla kontrolü verir. Hangi eventin ne zaman, hangi parametrelerle gönderileceği tamamen elde tutulur.
Sunucu tarafı Purchase eventi nasıl gönderilir?
Sipariş tamamlandığında, sitenin sunucusu Meta’nın API’sine bir istek atıyor: sipariş tutarı, para birimi, ürün bilgisi ve müşterinin (şifrelenmiş) e-posta veya telefon bilgisi bu istekte yer alıyor. Bu istek kullanıcının tarayıcısından bağımsız çalıştığı için, kullanıcı sayfayı kapatsa bile event kaybolmuyor.
En sağlam kurulum, webhook tabanlı olanı. Sipariş platformu (Shopify, WooCommerce) bir sipariş tamamlandığında sunucuya bir bildirim gönderiyor, sunucu da bu bildirimi işleyip Meta’ya iletiyor. Kullanıcının teşekkür sayfasını görüp görmediği, sayfayı kapatıp kapatmadığı bu zinciri etkilemiyor; sipariş veritabanına düştüğü an event de gidiyor.
Hangi eşleştirme parametreleri gönderilmeli?
Meta’nın önerdiği liste geniş ama hepsi aynı ağırlıkta değil. E-posta ve telefon en güçlü ikili; ikisi birden gönderildiğinde eşleşme oranı belirgin şekilde artıyor. IP adresi ve tarayıcı kullanıcı aracısı (user agent) bunları destekleyen ikincil sinyaller.
Ad, soyad, doğum tarihi, şehir gibi alanlar da eşleşmeye katkı sağlıyor ama e-ticaret sitelerinin çoğunda bu veriler checkout formunda zaten toplanıyor; ek bir veri toplama süreci gerekmiyor, sadece mevcut veriyi doğru alanlara eşlemek yeterli. Hiçbir parametre ham halde gönderilmiyor; Meta’nın API’si e-posta ve telefon gibi kişisel verilerin SHA-256 ile şifrelenmiş halini istiyor.
CAPI kurulumunda en sık yapılan hatalar
En sık görülen hata, event_id’nin Pixel ve sunucu tarafında farklı üretilmesi. İkisi eşleşmezse deduplication çalışmaz, aynı satış iki kez sayılır ve raporlanan dönüşüm sayısı gerçekte olduğundan yüksek çıkar.
İkinci hata, test siparişlerinin canlı veriyle karışması. Geliştirme aşamasında atılan test siparişleri, gerçek Purchase eventleriyle aynı akışa gidiyorsa Meta’ya sahte satış bildirilmiş olur; bu da algoritmanın yanlış kullanıcı profiline öğrenmesine yol açar.
Üçüncü hata, eşleştirme parametrelerinin eksik gönderilmesi. Sadece e-posta gönderip telefon ve IP’yi boş bırakmak, CAPI kurulumunu teknik olarak tamamlar ama EMQ’yu beklenen seviyeye çıkarmaz. Kurulumun asıl değeri, gönderilen parametrelerin eksiksizliğinden geliyor.
Pixel ve CAPI birlikte kullanılınca çift sayım olur mu?
Doğru kurulduğunda hayır. Her event’e benzersiz bir event_id atanıyor; Pixel ve CAPI aynı olayı aynı ID ile gönderirse Meta, ikisini tek bir olay olarak birleştiriyor ve hangi kaynağın o kullanıcı için daha güvenilir olduğuna kendisi karar veriyor. Bu birleştirme mekanizması resmi belgelerde deduplication olarak geçiyor.
Sorun, event_id eşleşmediğinde başlıyor. Pixel tarafında bir ID, sunucu tarafında farklı bir ID üretiliyorsa Meta bunları iki ayrı olay sayıyor ve gerçekleşenden fazla dönüşüm raporlanıyor. Kurulumdan sonra Events Manager’daki “Deduplicated Events” oranına bakmak, bu hatanın olup olmadığını gösteriyor.
Conversions API ücretli mi?
Hayır, Meta’nın kendisi ücret almaz. Sunucu tarafı kurulum bir geliştirici zamanı gerektirebilir, bu tek maliyettir.
CAPI kurmak için geliştirici şart mı?
Shopify veya WooCommerce gibi platformlarda hayır, hazır entegrasyon yeterli. Özel kodlu bir sitede genelde bir geliştirici gerekir.
EMQ kaç olmalı?
Meta 8 ve üzerini iyi kabul ediyor. 6’nın altı, eşleştirme verisinin eksik gönderildiğine işaret eder ve iyileştirmeye açıktır.
Pixel’i kaldırıp sadece CAPI kullanabilir miyim?
Teknik olarak evet ama önerilmez. İkisi farklı veri toplama koşullarında güçlü; birlikte kullanıldıklarında toplam veri kalitesi tek başına ikisinden de yüksek çıkıyor.
CAPI kurulumu ne kadar sürer?
Platform entegrasyonuyla (Shopify gibi) birkaç saat, GTM sunucu konteyneriyle birkaç gün, özel API entegrasyonuyla bir hafta veya daha uzun sürebilir.
CAPI kurulumu, Pixel’in üzerine eklenen bir katmandır; önce Pixel’in doğru kurulu olması gerekir. Temel kurulumu atlamadıysanız Meta Pixel kurulum rehberimize göz atabilirsiniz.
Bu tür bir kurulumu kendi ekibinizle yönetmek yerine bize bırakmak isterseniz Meta reklam yönetimi hizmetimize bakabilirsiniz.
Kaynaklar: Meta Conversions API geliştirici dokümantasyonu, Meta Business Yardım Merkezi.
