Performans Pazarlama
Kısa cevap: Meta Dönüşüm API’si (Conversions API, kısaca CAPI), sitenizde ya da müşteri sisteminizde gerçekleşen satış, sepete ekleme ve form gönderme gibi olayları tarayıcı yerine doğrudan sunucudan Meta’ya ileten bağlantıdır. Piksel tarayıcıda çalıştığı için reklam engelleyiciler ve çerez kısıtları yüzünden olay kaçırabilir. Meta, pikseli kapatmadan ikisini birlikte kullanmayı ve aynı olayı tekilleştirmeyi öneriyor.
Son güncelleme: Kasım 2026 · Ritz Marketing ekibi
Reklam Yöneticisi’nde gördüğünüz satış sayısı ile e-ticaret panelinizdeki sipariş sayısı birbirini tutmuyorsa yalnız değilsiniz. Bursa’da ev tekstili satan bir mağaza düşünün: kampanya iyi gidiyor, siparişler geliyor, ama Meta bunların bir kısmını hiç görmüyor. Algoritma da görmediği satıştan öğrenemiyor ve bütçeyi daha az verimli kitlelere ve reklamlara kaydırıyor.
Bunun en yaygın nedeni, ölçümün yalnızca Meta pikseline dayanması. Piksel hâlâ gerekli, ama tek başına eksik kalıyor. Kasım ve aralıktaki yoğun indirim döneminde her kaçan olay, reklam bütçenizin daha pahalı çalışması anlamına geliyor.
Bu yazıda Dönüşüm API’sinin ne olduğunu, pikselden farkını, Shopify, ikas ve WordPress’te hangi yoldan kurulduğunu, olay eşleştirme kalitesini nasıl yükselteceğinizi ve KVKK açısından nelere dikkat etmeniz gerektiğini anlatıyoruz. Pikselin temel kurulumunu ise Meta Piksel Kurulumu rehberimizde adım adım ele aldık.
Meta Dönüşüm API’si (CAPI) nedir?
Dönüşüm API’si, işletmenizin sunucusundan, e-ticaret altyapısından ya da müşteri ilişkileri yönetimi (CRM) sisteminden Meta’ya olay verisi gönderen resmî bağlantıdır. Meta’nın geliştirici dokümanına göre amaç, reklam hedeflemesini iyileştirmek, sonuç başına maliyeti düşürmek ve sonuçları daha doğru ölçmektir.
Olay, sitenizde ölçmek istediğiniz bir davranış demektir: ürün görüntüleme, sepete ekleme, ödeme başlatma, satın alma ya da form gönderme gibi. Piksel bu olayları ziyaretçinin tarayıcısından yakalar. Dönüşüm API’si ise aynı olayı siparişin kaydedildiği yerden, yani sunucudan gönderir. Meta’ya göre sunucudan gelen olaylar ölçüm, raporlama ve optimizasyonda piksel olaylarıyla aynı şekilde işlenir.
Piksel ile Dönüşüm API’si arasındaki fark nedir?
Kısaca piksel tarayıcıdan, Dönüşüm API’si sunucudan veri gönderir. Bu fark, hangi olayların Meta’ya ulaşabildiğini doğrudan belirler.
Konu | Piksel | Dönüşüm API’si |
Veri kaynağı | Tarayıcı | Sunucu ya da CRM |
Reklam engelleyici | Etkiler | Etkilemez |
Telefonla kapanan satış | Göremez | Gönderebilir |
Kurulum | Eklenti | Altyapı ayarı ya da geliştirici |
Doğru kullanım | CAPI ile birlikte | Pikselle birlikte |
Shopify’ın veri paylaşımı yardım sayfası bu farkı açıkça yazıyor: yalnızca pikselle çalışan düzeyde tarayıcı tabanlı reklam engelleyiciler pikselin veri paylaşmasını durdurabiliyor; sunucudan sunucuya giden veri ise bu engelleyicilerce durdurulamıyor.
Piksel neden artık tek başına yetmiyor?
Çünkü tarayıcı, ölçüm için eskisi kadar güvenilir bir ortam değil. Reklam engelleyiciler, tarayıcıların çerezlere getirdiği kısıtlar, Apple’ın 2021’de uygulama izleme izniyle başlattığı değişiklikler ve çerez onay pencereleri, pikselin bazı olayları görmesini engelliyor.
İkinci neden, satışın her zaman sitede bitmemesi. Bir mobilya üreticisi formdan gelen talebi telefonda satışa çeviriyorsa bu satış piksel için görünmezdir. Dönüşüm API’si, CRM’deki “satış kapandı” bilgisini de Meta’ya iletebilir.
Bu yüzden Meta, en iyi uygulamalar sayfasında Dönüşüm API’sini pikselin yerine değil yanına kurmayı öneriyor ve aynı olayların iki kanaldan da gönderilmesini istiyor. Meta bu yapıya yedekli kurulum diyor.
Pratik öneri: Pikseli kaldırmayın. Önce Olay Yöneticisi’nde (Events Manager) hangi olayların yalnızca tarayıcıdan geldiğine bakın. Satın alma, ödeme başlatma ve form gönderme olaylarını öncelikle sunucudan da gidecek şekilde kurun; ürün görüntüleme gibi olaylar sonra gelebilir.
Shopify, ikas ve WordPress’te Dönüşüm API’si nasıl kurulur?
Kurulum yolu altyapınıza göre değişir. Hazır e-ticaret altyapılarında çoğu zaman kod yazmanız gerekmez; özel yazılım sitelerde ise geliştirici desteği gerekir.
Shopify: Meta’nın Facebook ve Instagram uygulamasını bağlayın ve müşteri veri paylaşımı düzeyini seçin. Shopify’a göre Standart düzey yalnızca pikseli kullanır; Gelişmiş ve Maksimum düzeyler pikselin yanında Dönüşüm API’sini de çalıştırır. Temanıza elle eklenmiş eski piksel kodu varsa kaldırın, çünkü Shopify bunun çift ya da hatalı veri üretebileceği konusunda uyarıyor.
ikas: ikas yardım sayfasına göre önce Olay Yöneticisi’ndeki veri kümesi kimliğini (Dataset ID) Satış Kanalı > Uzantılar bölümündeki Facebook Pixel Code alanına girersiniz. Ardından Olay Yöneticisi > Ayarlar > Dönüşüm API’si yolundan bir erişim jetonu oluşturup aynı bölümdeki Facebook Conversion API alanına yapıştırırsınız. ikas ayrıca alan adınızı izin verilen alan adları listesine eklemenizi öneriyor.
WordPress ve WooCommerce: Meta’nın resmî Meta for WooCommerce eklentisi pikseli kurar ve ürün kataloğunuzu bağlar. Eklentiyi kurduktan sonra Olay Yöneticisi’nde sunucu olaylarının gelip gelmediğini mutlaka kontrol edin; yalnızca tarayıcı görünüyorsa kurulum yarım kalmıştır.
Diğer altyapılar ve özel siteler: Sitenizde piksel kuruluysa Meta, Olay Yöneticisi’nden kodsuz ve kurulum ücreti olmadan tek tıkla Dönüşüm API’si kurulumu sunuyor. Daha fazla kontrol istiyorsanız geliştiriciniz sunucunuzu doğrudan Meta’ya bağlayabilir ya da sunucu taraflı bir etiket yöneticisi kullanabilir.
Olay eşleştirme kalitesi nedir, nasıl yükseltilir?
Olay eşleştirme kalitesi, sunucudan gönderdiğiniz olayların Meta’daki hesaplarla ne kadar iyi eşleştiğini gösteren, 10 üzerinden verilen puandır. Puanı Olay Yöneticisi’nde olay bazında görürsünüz. Meta’ya göre yalnızca eşleşen olaylar raporlamada ve reklam gösterimi optimizasyonunda kullanılabiliyor; puan şimdilik yalnızca web olayları için hesaplanıyor.
Puanı yükselten şey, olayla birlikte gönderdiğiniz müşteri bilgisidir. Meta’nın en iyi uygulamalar sayfası şunları sıralıyor:
Tarayıcı bilgisi (kullanıcı aracısı) tüm web olaylarında zorunludur; olay kimliği (event_id) ve harici kimlik (external_id) her olayda gönderilmelidir.
E-posta, telefon, ad ve soyad ile IP adresi, eşleşmeyi en çok güçlendiren bilgiler arasında sayılıyor.
fbp ve fbc çerez değerleri de gönderilebilir; Meta bu değerlerin düzenli olarak yenilenmesini istiyor.
Yalnızca ad ve cinsiyet gibi zayıf bilgilerle giden olaylar geçersiz sayılıyor.
Kişisel bilgiler Meta’ya gitmeden önce karma (hash) işleminden geçirilmeli. Meta’nın yazılım geliştirme kiti bunu kendiliğinden yapıyor.
Pratik öneri: Ödeme sayfanızda telefon ve e-posta zaten alınıyor. Bu bilgileri satın alma olayına eklemek, çoğu e-ticaret sitesinde eşleşmeyi artırmanın en kısa yoludur. Yeni bir veri toplamaya başlamadan önce elinizdeki bilgiyi doğru gönderip göndermediğinize bakın.
Aynı satış iki kez sayılmasın: tekilleştirme nasıl yapılır?
Piksel ve Dönüşüm API’si aynı satışı ayrı ayrı gönderdiğinde Meta’nın bunların tek bir satış olduğunu anlaması gerekir. Buna tekilleştirme denir. Meta’nın tekilleştirme dokümanı iki kanalı birlikte kullanan reklamverenlerin bir tekilleştirme yöntemi kurmasını şart koşuyor.
Önerilen yöntem: Piksel olayındaki olay kimliği ile sunucu olayındaki event_id aynı olmalı; olay adları da (ör. Purchase) birebir eşleşmeli.
Alternatif yöntem: İki kanalda da aynı olay adıyla fbp ya da external_id değerini göndermek. Bu yöntem yalnızca önce tarayıcıdan, sonra sunucudan gelen olaylarda çalışıyor.
Süre: Meta, aynı olay kimliğiyle gelen olayları ilk olayın ulaşmasından sonraki 48 saat içinde tekilleştiriyor.
Kurulumdan sonra Olay Yöneticisi’nde satın alma olayının hem tarayıcıdan hem sunucudan geldiğini ve tekilleştirme uyarısı olmadığını kontrol edin. Reklam raporundaki satış sayısı bir anda siparişlerinizin üzerine çıktıysa ilk bakılacak yer burasıdır. Bu sayının bütçe kararlarına nasıl yansıdığını ROAS optimizasyonu yazımızda anlattık.
KVKK açısından nelere dikkat etmelisiniz?
Dönüşüm API’si ile Meta’ya e-posta ve telefon gibi kişisel veriler gider. Karma işleminden geçmiş olsalar da bunları kişisel veri gibi ele almak en güvenli yaklaşımdır. Kurulumdan önce üç konuyu hukuk danışmanınızla netleştirin:
Aydınlatma metni: Ziyaretçilere hangi verinin, hangi amaçla ve hangi şirketlerle paylaşıldığını açık dille anlatın. Shopify da yardım sayfasında satıcılara gizlilik politikalarını güncel tutmalarını hatırlatıyor.
Çerez onayı: KVKK’nın Çerez Uygulamaları Hakkında Rehberi reklam ve pazarlama amaçlı çerezleri zorunlu çerezlerden ayırır; bu tür çerezler için kural olarak açık rıza aranır. Onay vermeyen ziyaretçinin verisini sunucu üzerinden göndermek, bu kuralı dolanmanın yolu olmamalı. Onay yönetim aracınızın kararını sunucu olaylarına da uygulayın.
Yurt dışına aktarım: Meta’ya gönderilen veri yurt dışına aktarılmış olur. KVKK’nın 9. maddesi 2024’te değişti; aktarımın hangi dayanakla yapılacağını danışmanınızla belirleyin.
Veri yönetimini daha geniş ele aldığımız KVKK uyumlu pazarlama yazımız bu adımları planlarken işinize yarar.
En sık yapılan hatalar
Pikseli kapatıp yalnızca Dönüşüm API’sine geçmek. Meta iki kanalın birlikte çalışmasını öneriyor. Pikseli kaldırmak, tarayıcıdan gelen sinyalleri ve fbp gibi eşleşmeye yardım eden değerleri kaybetmenize yol açar.
Tekilleştirme kurmamak. Olay kimlikleri eşleşmezse aynı satış iki kez sayılır. Raporlar şişer, reklam getirisi olduğundan iyi görünür ve bütçeyi yanlış kampanyaya aktarırsınız.
Aynı olayı iki ayrı entegrasyondan göndermek. Temaya elle eklenmiş piksel, altyapının uygulaması ve bir ajansın kurduğu etiket aynı anda çalışabilir. Shopify bu durumun çift ya da hatalı veri ürettiği konusunda uyarıyor. Her olay için tek bir kaynak seçin.
Erişim jetonunu güvensiz paylaşmak. Dönüşüm API’si erişim jetonu, adınıza Meta’ya veri göndermeye yetkilidir. Jetonu e-postayla, mesajla ya da ekran görüntüsüyle paylaşmayın; ajansınıza Meta İş Paketi üzerinden kullanıcı yetkisi verin.
Ritz Marketing olarak Meta reklam hesaplarında ölçüm kurulumunu kampanyadan önce ele alıyoruz. Piksel ve Dönüşüm API’si kurulumu, tekilleştirme kontrolü ve olay eşleştirme kalitesinin takibi Meta reklam yönetimi hizmetimizin bir parçası. Altyapınız ya da ödeme akışınız ölçümü zorlaştırıyorsa e-ticaret danışmanlığı kapsamında birlikte bakabiliriz. Hesabınızın mevcut durumunu konuşmak için bizimle iletişime geçin.
Sıkça Sorulan Sorular
Meta Dönüşüm API’si ücretli mi?
Meta, Dönüşüm API’sinin kullanımı için ücret almıyor. Pikseli kurulu sitelerde Olay Yöneticisi’nden yapılan tek tıklı kurulum da kodsuz ve kurulum ücreti olmadan sunuluyor. Maliyet, kurulumu nasıl yaptığınıza bağlı: sunucu taraflı bir etiket yöneticisi ya da iş ortağı çözümü kullanırsanız barındırma veya abonelik ücreti, özel entegrasyonda ise geliştirici emeği ortaya çıkabilir.
Dönüşüm API’sini kurunca pikseli kaldırmalı mıyım?
Hayır. Meta’nın önerisi, aynı olayları hem pikselden hem Dönüşüm API’sinden göndermek ve bunları olay kimliğiyle tekilleştirmek. Piksel, tarayıcı tarafındaki davranışı ve eşleşmeye yardım eden çerez değerlerini toplamaya devam eder. Sunucu tarafı ise tarayıcının kaçırdığı olayları tamamlar. İkisi birlikte daha eksiksiz bir veri akışı sağlar.
Dönüşüm API’sinin çalıştığını nasıl anlarım?
Olay Yöneticisi’nde veri kümenizi açın ve olayların hangi yöntemle geldiğine bakın. Satın alma gibi kritik olaylarda hem tarayıcı hem sunucu görünmeli. Test olayları sekmesinden bir deneme siparişi verip sunucu olayının geldiğini anlık izleyebilirsiniz. Ardından olay eşleştirme kalitesi puanını ve tekilleştirme uyarılarını kontrol edin.
Olay eşleştirme kalitesi puanı kaç olmalı?
Meta herkes için geçerli bir hedef puan vermiyor; 10 üzerinden verilen puan yükseldikçe sonuçların iyileştiğini söylüyor. En önemli olayınız olan satın alma ya da form gönderme için puanı düzenli takip edin. E-posta, telefon, IP adresi ve tarayıcı bilgisini eksiksiz gönderdiğinizde puanın yükselmesi beklenir; düşük kalıyorsa hangi bilginin eksik gittiğine bakın.
Küçük bir işletmenin Dönüşüm API’sine ihtiyacı var mı?
Meta reklamlarını satış ya da form hedefiyle çalıştırıyorsanız evet. Ölçülemeyen her satış, algoritmanın öğrenebileceği veriyi azaltır ve bu etki az sayıda dönüşüm alan küçük hesaplarda daha belirgin hissedilir. Shopify, ikas veya WooCommerce kullanıyorsanız kurulum çoğu zaman birkaç ayarla tamamlanır. Yalnızca etkileşim ya da erişim hedefli kampanya yürütüyorsanız öncelik daha düşüktür.
Bu yazıdaki KVKK bilgileri genel bilgilendirme amaçlıdır; hukuki danışmanlık yerine geçmez. Kendi veri işleme süreçleriniz için bir hukuk uzmanına danışın.
Kaynaklar
