“Pikseli kurduk, ama Meta satışlarımızın yarısını görmüyor.”
Reklam veren şirketlerde en sık duyduğumuz cümlelerden biri bu. Panelde 40 satış görünüyor, e-ticaret arka ucunda 80 sipariş var. Sorun genellikle reklamda değil, verinin Meta’ya ulaşma biçiminde.
Meta Pikseli tarayıcıda çalışır. Tarayıcıda çalışan her şey gibi reklam engelleyicilerden, tarayıcı kısıtlarından ve bağlantı hatalarından etkilenir. Meta bunu açıkça yazıyor: Dönüşümler API’sinden gelen veriler “tarayıcı yükleme hatalarından, bağlantı sorunlarından ve reklam engelleyicilerden Meta Pikseline göre daha az etkilenir” (Meta İşletme Yardım Merkezi).
Meta Conversions API, Türkçe adıyla Dönüşümler API’si, bu boşluğu kapatmak için var. Piksel tarayıcıdan anlatır; dönüşüm API’si sunucudan anlatır.
Bu rehberde şunları ele alacağız:
- Dönüşümler API’sinin piksel yerine mi, yanına mı kurulduğu
- Pikselin tek başına neden eksik veri ürettiği
- Aynı satışın iki kez sayılmasını önleyen olay tekilleştirme
- Olay eşleştirme kalitesinin reklam maliyetine etkisi
- CAPI kurulumu için dört yol ve hangi şirkette hangisinin doğru olduğu
- Kurulumun doğrulanması ve KVKK tarafında dikkat edilecekler
Biz Brandaft olarak sosyal medya tarafındaki işlerde kampanya kurmadan önce ölçüme bakarız. Çünkü eksik veriyle çalışan bir kampanyayı optimize etmek, bozuk teraziyle diyet yapmaya benzer.
Meta Conversions API Nedir? (Piksel Yerine mi, Yanına mı?)
Dönüşümler API’si, sitenizde ya da sisteminizde gerçekleşen olayları tarayıcı üzerinden değil, kendi sunucunuzdan doğrudan Meta’ya gönderen bir bağlantıdır. Satın alma, form gönderimi, sepete ekleme gibi olaylar bu yolla iletilir.
En sık karıştırılan nokta şu: CAPI pikselin yerine geçmez. Meta, site olayları için ikisinin birlikte kullanılmasını öneriyor; API üzerinden gönderilen site olayları pikselinize bağlıdır ve reklam optimizasyonunda piksel olaylarıyla aynı şekilde davranır (Meta İşletme Yardım Merkezi).
Doğru kurgu şudur: piksel tarayıcıdan gönderir, sunucu taraflı izleme aynı olayı bir de sunucudan gönderir, Meta ikisini eşleştirip tek olay sayar. Biri düştüğünde diğeri veriyi taşımaya devam eder.
Peki piksel tam olarak nerede düşüyor?
Piksel Neden Tek Başına Yetmiyor?
Tarayıcı tarafı son yıllarda ölçüm için giderek daralan bir alan hâline geldi. Dört ana kayıp noktası var:
- Reklam engelleyiciler: piksel isteği hiç gönderilmez, olay Meta’ya ulaşmaz.
- Tarayıcı kısıtları: üçüncü taraf çerezlerin ve kimlik verilerinin ömrü kısalıyor; ilişkilendirme zayıflıyor.
- iOS gizlilik ayarları: izlemeye izin vermeyen kullanıcıda tarayıcı tarafı sinyal daralır.
- Teknik hatalar: sayfa erken kapanır, bağlantı kopar, script yüklenmez; olay kaybolur.
Bunların toplamı panelde gördüğünüz dönüşüm sayısını gerçeğin altına indirir. Sonuç yalnızca eksik rapor değildir: Meta’nın yayın algoritması da eksik veriyle öğrenir, yanlış kitleye gider ve edinme maliyeti yükselir. Maliyet tarafındaki zinciri CPA neden yükseliyor yazımızda ayrıntısıyla anlattık.
Eksik veri, pahalı reklamdır.
Beğeni değil, satış getiren sosyal medya
İçerik planı, topluluk yönetimi ve reklamı tek bir performans sistemi olarak kurguluyoruz. Sonucu takipçiyle değil ciroyla ölçüyoruz.
TEKLİF ALBu yüzden CAPI bir “teknik lüks” değil; kampanya ekonomisini doğrudan etkileyen bir altyapıdır. Ama yanlış kurulduğunda kendi sorununu yaratır.
Olay Tekilleştirme Nasıl Çalışır? (Aynı Satış İki Kez Sayılmasın)
Aynı satın almayı hem piksel hem sunucu gönderiyorsa Meta bunu iki dönüşüm sanabilir. Meta bu durumu önlemek için olayların tekilleştirilmesi mekanizmasını kullanır: iki kayıt aynı olay adını ve aynı olay kimliğini taşıyorsa tek olay sayılır.
Pratikte kural basit: her olay için benzersiz bir kimlik üretilir, aynı kimlik hem tarayıcıdan hem sunucudan gönderilir. Sipariş numarası gibi zaten benzersiz olan bir değer bu iş için uygundur.
Tekilleştirme kurulmadığında iki tipik sonuç görürsünüz: dönüşüm sayısı gerçeğin üzerine çıkar ve maliyet metrikleri olduğundan iyi görünür. Bu da bütçeyi yanlış kampanyaya kaydırır. Reklam metriklerini birlikte okumak için reklam performansı nasıl ölçülür yazımız iyi bir çerçeve verir.
Tekilleştirme çalıştıktan sonra sıradaki konu, gönderdiğiniz verinin kalitesi.
Olay Eşleştirme Kalitesi Neden Önemli?
Meta, gönderdiğiniz olayı bir kişiyle eşleştirebildiği ölçüde işine yarar. Bu eşleşmenin gücünü gösteren ölçüt olay eşleştirme kalitesidir. Meta, API ile daha fazla müşteri bilgisi parametresi göndererek eşleşen olay sayısını ve eşleştirme kalitesini artırabileceğinizi söylüyor.
Uygulamada gönderilebilecek parametreler e-posta, telefon, ad-soyad, şehir, ülke gibi alanlardır. Bunlar Meta’ya açık metin olarak değil, hash’lenmiş yani geri çevrilemez biçimde şifrelenmiş olarak gider. Ek olarak tarayıcı tarafındaki tanımlayıcılar ve IP bilgisi eşleşmeyi güçlendirir.
Sahada gördüğümüz tablo şu: CAPI kurulmuş ama yalnızca olay adı gönderiliyor, müşteri parametresi yok. Bu kurulum teknik olarak çalışır, ama eşleştirme zayıf kaldığı için beklenen iyileşmeyi üretmez.
Kalite kurulumla başlar. Şimdi kurulumun kendisine geçelim.
Meta CAPI Kurulumu İçin Dört Yol Var: Hangisi Size Uygun?
Dönüşümler API’si kurulumunda tek bir doğru yol yok; şirketin teknik kapasitesine göre değişir.
- Hazır platform entegrasyonu: Shopify, WooCommerce gibi platformlarda birkaç ayarla kurulur. Küçük ve orta ölçekli e-ticaret için en hızlı yol.
- Dönüşümler API’si Geçidi: Meta’nın sunucu kurulumu gerektirmeyen çözümüdür; geliştirici kaynağı olmayan ekipler için uygundur.
- Sunucu taraflı etiket yöneticisi: olayların toplandığı kendi sunucu katmanınızı kurarsınız. Hem Meta’ya hem başka platformlara aynı yerden gönderim yapılabilir; orta ve büyük ölçek için en esnek model.
- Doğrudan API entegrasyonu: olaylar arka uçtan koda yazılarak gönderilir. En çok kontrolü verir, en çok geliştirici zamanı ister.
Karar verirken üç soruya bakın: sitede hazır entegrasyonu olan bir platform var mı, geliştirici ayırabiliyor musunuz ve ölçümü yalnız Meta için mi yoksa bütün platformlar için mi kuruyorsunuz? Üçüncü sorunun cevabı “hepsi” ise sunucu taraflı katman uzun vadede en ucuz seçenektir.
Yol seçildikten sonra kurulum sırası her modelde aynıdır: önce hangi olayların gönderileceği belirlenir, sonra olay kimliği planlanır, ardından parametreler eklenir ve en sonunda doğrulama yapılır. Aynı disiplini GA4 tarafında da uyguluyoruz; ayrıntısı GA4 dönüşüm takibi rehberimizde.
Hangi Olayları Göndermelisiniz? (Öncelik Sırası)
Her olayı göndermek iyi bir fikir değil. Meta’nın yayın sistemi hangi olayı optimize ediyorsa onu çoğaltmaya çalışır; listeyi gereksiz kalabalıklaştırmak sinyali zayıflatır.
Pratikte işe yarayan öncelik sırası şu:
- Satın alma ya da teklif talebi: gelirle doğrudan bağlantılı ana olay. Değer ve para birimi mutlaka gönderilmeli.
- Ödeme bilgisi ekleme ve sepete ekleme: satın almaya en yakın iki adım; küçük hesaplarda öğrenme evresini hızlandırır.
- Kayıt ve abonelik: üyelik modeli olan işlerde ana olay yerine geçebilir.
- İçerik görüntüleme: yalnızca yeniden pazarlama kitlesi kurmak için; optimizasyon hedefi yapılmamalı.
Ayda birkaç satış alan bir hesapta doğrudan satın almayı optimize etmek zordur; sistem öğrenmek için yeterli veri bulamaz. Böyle durumlarda satın almaya yakın bir ara olayı hedefleyip satın almayı ölçmeye devam etmek daha iyi çalışır.
Gönderdiğiniz her olayın arkasında bir iş kararı olmalı. “Belki lazım olur” diye eklenen olaylar raporu kalabalıklaştırır, kararı kolaylaştırmaz.
KVKK Tarafında Neye Dikkat Etmelisiniz?
Sunucudan veri göndermek, izin almadan veri gönderebileceğiniz anlamına gelmez. Kişisel veri işleme kuralları CAPI için de geçerlidir.
Üç nokta kritik. Birincisi, kullanıcı verisi hash’lenerek gönderilir; ham e-posta ya da telefon numarası iletilmez. İkincisi, çerez ve izleme izni alınmadıysa pazarlama amaçlı olay göndermek risklidir; izin durumu sunucu tarafına da taşınmalıdır. Üçüncüsü, gizlilik politikanız hangi verinin hangi amaçla Meta’ya aktarıldığını açıkça yazmalıdır.
İzin durumunun ölçümü nasıl değiştirdiğini ve izin alınmadığında verinin nasıl modellendiğini Consent Mode v2 yazımızda anlattık. Aynı mantık Meta tarafı için de geçerlidir.
Kurulumu Nasıl Doğrularsınız?
Kurulum, Events Manager’da olay görünmeye başladığında bitmez. Üç kontrol gerekir.
Önce test olayları ekranında kendi tetiklediğiniz olayın hem tarayıcıdan hem sunucudan geldiğini ve tek olay olarak sayıldığını görün. Tekilleştirme çalışmıyorsa aynı işlem iki satır olarak düşer.
Sonra olay eşleştirme kalitesi skorunu izleyin. Kurulumdan sonraki birkaç gün içinde bu skorun yükselmesi beklenir; yükselmiyorsa gönderdiğiniz müşteri parametreleri eksiktir.
Son olarak panel ile gerçeği karşılaştırın: Meta’nın raporladığı satın alma sayısı, e-ticaret arka ucundaki sipariş sayısına yaklaşmalı. Aradaki fark kapanmıyorsa olay listesinde eksik ya da yanlış eşlenen bir adım vardır. Reklamın satışa dönüşmediği durumlarda ölçümden önce bakılacak diğer noktaları trafik var, satış yok yazımızda topladık.
Meta reklamlarının sonuç üretmesi için gereken süre ve öğrenme evresi de bu tabloyla birlikte okunmalı; onu Meta reklamları ne zaman satış getirir yazımızda ele almıştık.
Sonuç: CAPI Bir Etiket Değil, Veri Altyapısıdır
Dönüşümler API’si kurmak, panele bir kod parçası eklemek değildir. Hangi olayın iş sonucu sayıldığına, o olayın nasıl tekilleştirileceğine ve hangi müşteri verisinin hangi izinle gönderileceğine karar vermektir.
Piksel gördüğünü anlatır. Sunucu, gerçekten olanı anlatır.
Meta kampanyalarınızda panel ile gerçek satış arasında kapanmayan bir fark varsa, önce ölçüm katmanına bakın. Nereden başlayacağınızdan emin değilseniz teşhis raporumuzla mevcut kurulumunuzu birlikte çıkaralım.
Meta Conversions API ile İlgili Sıkça Sorulan Sorular
Meta Conversions API nedir, ne işe yarar?
Meta Conversions API, Türkçe adıyla Dönüşümler API’si, sitenizde veya sisteminizde gerçekleşen olayları kendi sunucunuzdan doğrudan Meta’ya gönderen bağlantıdır. Amacı, tarayıcı kaynaklı veri kayıplarını azaltıp reklam optimizasyonunu daha doğru veriyle beslemektir. Satın alma, form gönderimi ve sepete ekleme gibi olaylar bu yolla iletilir. Meta, en iyi sonucun piksel ile birlikte kullanıldığında alındığını belirtiyor.
Dönüşüm API’si pikselin yerini alır mı?
Hayır, site olayları için ikisi birlikte çalışır. Piksel olayı tarayıcıdan, API aynı olayı sunucudan gönderir; Meta ikisini eşleştirerek tek dönüşüm sayar. Pikseli kaldırırsanız tarayıcı tarafındaki tanımlayıcıları kaybedersiniz ve eşleştirme kalitesi düşer. Doğru kurulum “ya biri ya öteki” değil, ikisinin birlikte çalıştığı kurulumdur.
CAPI kurulumu için geliştirici gerekir mi?
Her zaman gerekmez. Shopify veya WooCommerce gibi platformlarda hazır entegrasyonla, geliştirici olmadan kurulabilir. Meta’nın Dönüşümler API’si Geçidi çözümü de sunucu kurulumu gerektirmez. Ancak özel yazılmış bir sitede, sunucu taraflı izleme katmanı kuruyorsanız veya CRM verisi gönderecekseniz geliştirici desteği gerekir.
Olay tekilleştirme nasıl yapılır?
Aynı olayın hem tarayıcıdan hem sunucudan gönderildiği durumlarda, iki kaydın aynı olay adını ve aynı benzersiz olay kimliğini taşıması gerekir. Meta bu iki alanı eşleştirip kaydı tek dönüşüm olarak sayar. Sipariş numarası gibi zaten benzersiz olan değerler olay kimliği olarak kullanılabilir. Tekilleştirme kurulmazsa dönüşümler şişer ve maliyet metrikleri olduğundan iyi görünür.
Sunucu taraflı izleme KVKK açısından güvenli mi?
Sunucudan göndermek tek başına bir muafiyet sağlamaz; kişisel veri işleme kuralları aynen geçerlidir. Müşteri bilgileri Meta’ya hash’lenerek, yani geri çevrilemez biçimde şifrelenerek gönderilir. Kullanıcıdan pazarlama amaçlı izin alınmadıysa olay göndermek risk taşır, bu yüzden izin durumu sunucu tarafına da taşınmalıdır. Gizlilik politikanızda hangi verinin hangi amaçla aktarıldığı açıkça yazmalıdır.
Meta Conversions API kurulumu ne kadar sürer?
Hazır platform entegrasyonuyla kurulum birkaç saatte tamamlanabilir. Sunucu taraflı bir katman kuruluyorsa olay planı, kimlik eşleşmesi ve test süreciyle birlikte genellikle birkaç gün sürer. Asıl zaman alan kısım teknik kurulum değil, hangi olayların gönderileceğine ve parametrelerin nasıl doldurulacağına karar vermektir. Kurulum sonrası en az bir haftalık veriyle doğrulama yapılması gerekir.
