
Meta reklamlarının başarısı büyük ölçüde algoritmaya ne kadar doğru veri gönderdiğinize bağlıdır. Tarayıcıda çalışan Meta Pikseli; reklam engelleyiciler, tarayıcıların çerez kısıtlamaları ve sayfa tamamen yüklenmeden çıkan kullanıcılar yüzünden dönüşümlerin bir kısmını kaçırır. Dönüşüm API’si (Conversions API, kısaca CAPI) aynı olayları sunucunuzdan doğrudan Meta’ya göndererek bu boşluğu kapatır. İkisini birlikte kurmak bugün standart uygulamadır, ancak yanlış kurulduğunda satışlar iki kez sayılır ve kampanyalar yanlış sinyalle optimize olur. Bu yazıda kurulumu baştan sona, kontrol noktalarıyla birlikte anlatıyoruz.
Piksel ve Dönüşüm API’si Birlikte Neden Gerekli?
Piksel, kullanıcının tarayıcısında çalışan bir JavaScript kodudur ve sayfa görüntüleme, sepete ekleme, satın alma gibi olayları Meta’ya bildirir. Tarayıcıda çalıştığı için kullanıcının tıklama kimliği, çerezleri ve cihaz bilgisi gibi zengin sinyalleri kolayca toplar. Zayıf yanı da buradadır: reklam engelleyici kullanan, çerezleri kısıtlayan ya da ödeme sonrası teşekkür sayfası yüklenmeden sekmeyi kapatan kullanıcının satın alması hiç kaydedilmeyebilir. Mobil tarayıcılardaki gizlilik özellikleri bu kaybı daha da artırır.
Dönüşüm API’si ise olayı sizin sunucunuz gönderir. Sipariş veritabanına düştüğü anda Meta’ya bildirildiği için tarayıcıdaki aksaklıklardan etkilenmez. Ancak sunucu, tarayıcının bildiği bazı bilgileri kendiliğinden bilmez; bu yüzden en iyi sonuç ikisinin birlikte çalışmasıyla alınır. Piksel tarayıcı sinyallerini, CAPI ise kesinleşmiş işlem verisini taşır ve Meta aynı olayı iki kaynaktan aldığında bunları tek olayda birleştirir. Konunun genel mantığını sunucu taraflı ölçüm yazımızda daha geniş açıdan ele aldık.
Hazırlık: Veri Kümesi, Alan Adı ve Olay Planı
Kuruluma başlamadan önce Meta Business Manager’da işletme hesabınızın size ait olduğundan ve Etkinlik Yöneticisi’nde (Events Manager) tek bir veri kümesi (eski adıyla piksel) kullanacağınızdan emin olun. Farklı ajansların yıllar içinde açtığı birden fazla piksel, verinin bölünmesine yol açar. Ardından alan adınızı Business Manager üzerinden DNS kaydı ya da meta etiketiyle doğrulayın; doğrulama, olayların sizin alan adınıza ait olduğunu kanıtlar ve olay yapılandırmasını sizin kontrolünüze bırakır.
Sonra bir olay planı çıkarın: hangi kullanıcı davranışı hangi standart olayla eşleşecek, hangi parametreler gönderilecek? E-ticaret için temel set PageView, ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo ve Purchase olaylarıdır; hizmet işletmeleri için Lead, Contact ve CompleteRegistration öne çıkar. Purchase olayında value, currency (TRY), content_ids ve content_type parametrelerini mutlaka gönderin. Bu planı bir tabloya yazmak, sonradan geliştiriciyle yaşanacak yanlış anlaşılmaları baştan önler.
- Tek veri kümesi, sahibi siz olan Business Manager
- Doğrulanmış alan adı
- Olay adı, tetiklenme anı ve parametreleri yazan olay tablosu
- Çerez onay aracınızın hangi kategoride çalışacağı kararı
- Test için kullanılacak bir ürün ve ödeme yöntemi
Adım 1: Pikseli Doğru Yerleştirin
Pikseli kurmanın en kontrollü yolu Google Tag Manager’dır. Temel kodu tüm sayfalarda tetiklenecek şekilde ekleyin, ardından her standart olay için ayrı etiket oluşturun ve bu etiketleri veri katmanındaki (dataLayer) olaylara bağlayın. Örneğin sepete ekleme olayı, düğmeye tıklanmasıyla değil, ürünün sepete gerçekten eklendiğini bildiren dataLayer olayıyla tetiklenmelidir; aksi hâlde stok dışı ürüne yapılan tıklamalar da sayılır. GTM ile çalışmaya yeniyseniz Google Tag Manager kurulumu yazımız iyi bir başlangıç olur.
Shopify, WooCommerce ya da ikas gibi hazır altyapılarda Meta’nın resmî entegrasyonu veya uygulaması pikseli otomatik ekleyebilir. Bu kolaylık işe yarar, ancak aynı anda temanıza elle eklenmiş eski bir piksel kodu ya da GTM’de ikinci bir etiket varsa olaylar mükerrer tetiklenir. Kurulumdan sonra Meta Pixel Helper tarayıcı eklentisiyle her sayfada pikselin tek kez yüklendiğini ve olayların doğru parametrelerle gittiğini kontrol edin.
İşinize özel planı birlikte çıkaralım. 24 saat içinde size özel teklifimizi hazırlıyoruz.
Adım 2: Dönüşüm API’sini Bağlayın
Dönüşüm API’sini bağlamanın dört yaygın yolu vardır. Birincisi altyapınızın hazır entegrasyonudur; Shopify ve benzeri platformlarda birkaç tıklamayla açılır ve çoğu işletme için yeterlidir. İkincisi Meta’nın kendi bulut hesabınızda çalışan Conversions API Gateway çözümüdür. Üçüncüsü sunucu taraflı Google Tag Manager’dır; tek bir sunucu kapsayıcısından hem Meta’ya hem diğer platformlara veri göndermenizi sağlar. Dördüncüsü yazılım ekibinizin doğrudan API çağrısı yazmasıdır; en esnek ama bakımı en çok emek isteyen yoldur.
Hangi yolu seçerseniz seçin, sunucudan giden olayda müşteri bilgisi parametrelerini mümkün olduğunca eksiksiz gönderin: e-posta, telefon, ad, soyad, şehir ve posta kodu, Meta’ya gönderilmeden önce SHA-256 ile karma (hash) hâline getirilmelidir. Bunlara ek olarak kullanıcının IP adresi, tarayıcı bilgisi (user agent) ve tarayıcıdaki _fbp ve _fbc çerez değerleri gönderilmelidir. Telefon numarasını ülke koduyla ve boşluksuz, e-postayı küçük harfle normalize etmeden hash’lerseniz eşleşme gerçekleşmez.
Adım 3: Tekilleştirmeyi Kurun
Aynı satın alma hem pikselden hem sunucudan gönderildiğinde Meta’nın bunları tek olay sayabilmesi için iki bilgiye ihtiyacı vardır: aynı olay adı (event_name) ve aynı olay kimliği (event_id). En pratik yöntem, sipariş numarasını ya da her olay için üretilen benzersiz bir kimliği hem tarayıcıdaki piksel çağrısına hem sunucu çağrısına eklemektir. Olay kimliği bir tarafta “12345”, diğer tarafta “order_12345” olarak giderse tekilleştirme çalışmaz ve rapordaki satış sayınız gerçeğin iki katına çıkar.
Tekilleştirme yalnızca Purchase için değil, iki kaynaktan gönderdiğiniz tüm olaylar için gereklidir. Sepete ekleme ve ödeme başlatma gibi olaylarda sipariş numarası henüz yoktur; bu durumda tarayıcıda rastgele bir kimlik üretip dataLayer üzerinden hem piksel etiketine hem sunucuya taşımanız gerekir. Kurulumdan birkaç gün sonra Etkinlik Yöneticisi’nde her olayın ayrıntısına girin; tarayıcı ve sunucu olaylarının tekilleştirilme oranını burada görebilirsiniz. Oran beklenenden düşükse kimliklerin nerede farklılaştığını bulana kadar test edin.
Adım 4: Test Edin ve Eşleşme Kalitesini İzleyin
Etkinlik Yöneticisi’ndeki Test Olayları sekmesi, kurulumun canlı sınamasıdır. Burada üretilen test kodunu sunucu çağrınıza geçici olarak ekleyin, sitenizde gerçek bir sipariş akışını baştan sona tamamlayın ve her olayın hem tarayıcıdan hem sunucudan geldiğini, parametrelerin doğru dolduğunu ve iki kaydın birleştirildiğini izleyin. Testten sonra test kodunu kaldırmayı unutmayın; unutulan test kodu canlı olayların raporlara düşmesini engelleyebilir.
Kurulum oturduktan sonra her olay için Etkinlik Eşleşme Kalitesi (Event Match Quality) puanını takip edin. Bu puan, gönderdiğiniz müşteri bilgilerinin Meta kullanıcılarıyla ne kadar iyi eşleştiğini gösterir. Puan düşükse genellikle e-posta ya da telefon gönderilmiyordur, _fbc değeri eksiktir veya normalizasyon hatalıdır. Purchase gibi kritik olaylarda puanı iyi seviyeye çekmek, hem raporlanan dönüşüm sayısını hem de Advantage+ alışveriş kampanyaları gibi otomatik kampanyaların öğrenme hızını doğrudan etkiler.
Kurulumda En Sık Karşılaştığımız Hatalar
Hesap denetimlerinde en çok gördüğümüz sorun, satın alma olayının teşekkür sayfasının her yenilenmesinde yeniden tetiklenmesidir. Kullanıcı sipariş onay sayfasını yer imine ekleyip tekrar açtığında ya da sayfayı yenilediğinde aynı satış yeniden sayılır. Bunu önlemek için Purchase olayını sipariş numarasına bağlayın ve aynı numara için olayın yalnızca bir kez gönderilmesini sağlayan bir kontrol ekleyin. İkinci sık hata, value parametresinin kargo ve vergi dahil mi hariç mi gönderildiğinin belirsiz olmasıdır; bunu bir kez karar verip bütün kanallarda aynı tutun.
Üçüncü hata, para biriminin yanlış ya da eksik gönderilmesidir. Fiyatı “1.250,00” gibi Türkçe biçimli bir metin olarak gönderirseniz Meta bunu doğru okuyamaz; değer nokta ondalıklı bir sayı olmalı ve currency alanı TRY olarak dolu olmalıdır. Dördüncüsü, ödeme sayfasının farklı bir alan adında (ödeme kuruluşunun sayfası gibi) tamamlanması ve kullanıcının sitenize dönmeden ayrılmasıdır. Bu senaryoda satışı yalnızca sunucu tarafı yakalayabilir; CAPI’nin asıl değeri burada ortaya çıkar.
Sonuç: Veri Kalitesi, Kampanya Performansının Temelidir
Piksel ve Dönüşüm API’si kurulumu bir kerelik bir teknik iş gibi görünse de aslında reklam hesabınızın temelidir. Algoritma, kimin satın alacağını tahmin ederken sizin gönderdiğiniz olaylardan öğrenir; eksik ya da mükerrer veriyle çalışan bir kampanya, en iyi kreatifle bile yanlış kitleye harcama yapar. Kurulumu tamamladıktan sonra tema değişikliği, ödeme altyapısı güncellemesi ya da yeni bir eklenti kurulumu gibi her değişiklikte olayları yeniden test etmeyi rutininize ekleyin.
Özetle sıralama şöyledir: tek veri kümesi ve doğrulanmış alan adı, yazılı olay planı, GTM veya resmî entegrasyonla piksel, uygun yöntemle CAPI, ortak event_id ile tekilleştirme, Test Olayları ile sınama ve eşleşme kalitesi takibi. E-ticaret işletmeleri için bu yapı, ürün kataloğu ve dinamik reklamlarla birlikte çalıştığında asıl değerini gösterir. Kurulumu ve sonrasındaki kampanya yönetimini birlikte ele almak isterseniz Meta ve TikTok reklam hizmetimizi inceleyebilirsiniz.
Sık Sorulan Sorular
Sadece Dönüşüm API’si kullanıp pikseli kaldırabilir miyim?
Teknik olarak mümkündür, ancak önerilmez. Piksel, tarayıcıdaki tıklama kimliği ve çerez gibi sinyalleri toplayarak eşleşmeyi güçlendirir. En iyi sonuç ikisinin tekilleştirilmiş biçimde birlikte çalışmasıyla alınır.
Shopify kullanıyorum, ayrıca bir şey yapmam gerekiyor mu?
Resmî Meta entegrasyonunu en yüksek veri paylaşım seviyesinde açmanız çoğu durumda yeterlidir. Yine de temanızda eski bir piksel kodu kalıp kalmadığını ve olayların mükerrer gitmediğini Test Olayları ekranında kontrol etmelisiniz.
Etkinlik Eşleşme Kalitesi puanı neden düşük görünüyor?
En sık sebep, sunucu olaylarında e-posta veya telefon bilgisinin gönderilmemesi ya da hatalı biçimde hash’lenmesidir. Misafir ödeme akışında bu bilgilerin alınıp olaya eklendiğinden emin olun ve _fbp ile _fbc değerlerinin sunucuya taşındığını kontrol edin.
Çerez onayı vermeyen kullanıcıların verisini gönderebilir miyim?
Bu, KVKK ve onay yönetimi tercihinize bağlı hukuki bir karardır. Pazarlama çerezlerine onay vermeyen kullanıcılar için olay gönderimini sınırlamak en güvenli yaklaşımdır. Kesin karar için hukuk danışmanınızla aydınlatma ve rıza metinlerinizi birlikte değerlendirin.



