Cevap-önce özet
Meta Pixel, web sitenizde gerçekleşen eylemleri (ürün görüntüleme, sepete ekleme, form, satın alma) ziyaretçinin tarayıcısından Meta’ya bildiren bir JavaScript kodudur. Conversions API (CAPI) aynı olayları sizin sunucunuzdan gönderir; böylece bağlantı sorunu ya da sayfa yükleme hatası yüzünden tarayıcıda kaybolan olayların bir kısmı yine Meta’ya ulaşır. Meta ikisinin birlikte kullanılmasını, aynı olayın iki kez sayılmaması için de olay adı ve event_id ile tekilleştirme yapılmasını öneriyor. Doğru kurulmuş ölçüm, reklam bütçesinin hangi kampanyada işe yaradığını görmenizi sağlar; tek başına satış garantisi değildir.

Meta Pixel nedir?
Instagram ve Facebook reklamlarında en sık duyduğum soru şu: “Reklama para veriyoruz ama işe yarıyor mu, bilmiyoruz.” Bu sorunun cevabı çoğu zaman kreatifte ya da hedeflemede değil, ölçümde saklıdır. Meta Pixel (eski adıyla Facebook Pixel), sitenizin her sayfasına eklenen küçük bir JavaScript kodudur. Ziyaretçi bir sayfayı açtığında, bir ürüne baktığında ya da satın alma yaptığında bu bilgiyi “olay” olarak Meta’ya gönderir.
Meta’nın geliştirici belgelerine göre Pixel’in topladığı olaylar Reklam Yöneticisi’nde dönüşüm olarak görünür ve üç iş için kullanılır:
- Hangi reklamın satış, form ya da kayıt getirdiğini ölçmek,
- sitenizi ziyaret edip satın almayanlar gibi özel hedef kitleler oluşturmak (yeniden pazarlama),
- Meta’nın reklam sistemine “benim için değerli olan kişi budur” sinyalini vererek optimizasyonu beslemek.
Son madde en az konuşulan ama en önemli olanı. Satış hedefli bir kampanya, satın alma olaylarını doğru göremiyorsa kime reklam göstereceğini de doğru öğrenemez. Ölçüm eksikse bütçe, “tıklayan ama almayan” kişilere akmaya başlar.
Conversions API (CAPI) nedir?
Conversions API, Türkçe arayüzde “Dönüşümler API’si”, olayları ziyaretçinin tarayıcısından değil, sizin sunucunuzdan ya da kullandığınız platformdan doğrudan Meta’ya gönderen bağlantıdır. Pixel tarayıcıda çalıştığı için tarayıcıda yaşanan her aksaklıktan etkilenir. Meta, en iyi uygulama rehberinde CAPI’nin, Pixel’in ağ bağlantısı sorunları ya da sayfa yükleme hataları nedeniyle kaçırabileceği olayları paylaşmayı sağladığını yazıyor. Buna tarayıcıların giderek sıkılaşan gizlilik ayarları da eklendiğinde, yalnızca Pixel’e dayanan ölçümün eksik kalma ihtimali artıyor.
CAPI’nin bir avantajı daha var: satış sitede değil de telefonda, mağazada ya da sonradan onaylanan bir siparişte gerçekleşiyorsa, bu olayı da sunucudan Meta’ya bildirebilirsiniz. Meta’nın belgelerine göre sunucudan gelen olaylar Pixel olaylarıyla aynı şekilde işlenir; ölçümde ve optimizasyonda aynı biçimde kullanılır.
Pixel, müşterinin tarayıcısında olanı anlatır; Conversions API, işletmenizin kesin olarak bildiğini. Reklam sistemi en iyi ikisini birlikte duyduğunda öğrenir.
Pixel ve CAPI neden birlikte kullanılmalı?
CAPI, Pixel’in yerine geçen bir araç değil, onun tamamlayıcısıdır. Meta’nın önerisi açık: Conversions API’yi Pixel’e ek olarak kullanın ve aynı olayları iki araçla da paylaşın. Pixel’in yakaladığını sunucu doğrular, Pixel’in kaçırdığını sunucu tamamlar.
| Meta Pixel | Conversions API | |
|---|---|---|
| Nerede çalışır? | Ziyaretçinin tarayıcısında | Sizin sunucunuzda ya da platformunuzda |
| Kurulum | Kodu ya da eklentiyi eklemek yeterli | Sunucu tarafı entegrasyon gerekir |
| Kayıp riski | Bağlantı, sayfa yükleme ve tarayıcı kısıtlarından etkilenir | Tarayıcı aksaklıklarından daha az etkilenir |
| Site dışı olaylar | Gönderemez | Telefonla satış, mağaza, sonradan onaylanan sipariş gönderilebilir |
| Yeniden pazarlama ve tarayıcı bilgisi | Güçlü | Pixel’in çerez değerleriyle birlikte gönderildiğinde güçlü |
Apple’ın iOS 14.5 ile getirdiği uygulama takibi izni de ölçümü değiştirdi. Meta, iOS 14.5 ve sonrası cihazlardan gelen web ve uygulama olaylarını Aggregated Event Measurement (Toplu Olay Ölçümü) adlı protokolle işliyor. Bu protokolün ayarları yıllar içinde birkaç kez değişti; eski rehberlerde anlatılan ekranlar bugün Olaylar Yöneticisi’nde aynı biçimde karşınıza çıkmayabilir. Kurulumu her zaman güncel ekrana göre yapın.
Hangi olaylar ve parametreler gönderilmeli?
Meta’nın tanımlı standart olayları vardır ve mümkün olduğunca bunları kullanmak gerekir; çünkü reklam sistemi bu adları tanır. Özel bir eylemi ölçmek isterseniz özel olay da tanımlayabilirsiniz. Sitenizin türüne göre temel liste kabaca şöyle:
- E-ticaret: ViewContent (ürün görüntüleme), AddToCart (sepete ekleme), InitiateCheckout (ödemeye geçiş), AddPaymentInfo ve Purchase (satın alma). Purchase olayında value (tutar) ve currency (para birimi, ör. TRY) Meta’ya göre zorunludur; katalog reklamları için ürün kimlikleri (content_ids ya da contents) da gönderilmelidir.
- Hizmet işletmesi: Lead (form gönderimi), Contact (iletişim), Schedule (randevu), CompleteRegistration (kayıt).
- İçerik ve topluluk: Subscribe (abonelik), Search (site içi arama).
E-ticaret sitesi kuruyorsanız bu olayları altyapı seçerken düşünmek, sonradan eklemekten çok daha kolaydır. Bunu e-ticaret sitesi projelerimizde baştan planlıyoruz. Henüz kendi siteniz mi, pazaryeri mi kararını vermediyseniz, ölçüm farkını da anlattığımız e-ticaret sitesi mi, pazaryeri mi yazımıza bakabilirsiniz.
Olay Eşleştirme Kalitesi (Event Match Quality)
Meta bir olayı alır, ama o olayın hangi Meta hesabına ait olduğunu eşleştirebilirse işe yarar. Meta’nın belgelerine göre yalnızca eşleşen olaylar atıf ve reklam optimizasyonu için kullanılabilir. Olaylar Yöneticisi’nde web olayları için 10 üzerinden bir Olay Eşleştirme Kalitesi puanı gösterilir. Bu puan, gönderdiğiniz müşteri bilgilerinin eşleştirmede ne kadar etkili olduğunu anlatır.
Puanı yükselten şey, sunucu olaylarına eklenen müşteri bilgisi parametreleridir: e-posta, telefon, ad-soyad, IP adresi, tarayıcı bilgisi ve Pixel’in tarayıcıda oluşturduğu fbp ve fbc değerleri. E-posta ve telefon gibi bilgiler gönderilmeden önce SHA-256 ile karma (hash) hâline getirilir; telefon ülke koduyla, e-posta küçük harfle ve boşluksuz yazılır. IP adresi, tarayıcı bilgisi, fbp ve fbc ise karmasız gönderilir. Meta, olayların gerçekleştiği anda ya da buna çok yakın gönderilmesini öneriyor; sunucu olayının zamanı en fazla 7 gün geriye gidebilir.
Tekilleştirme: aynı satış iki kez sayılmasın
Pixel ve CAPI birlikte çalıştığında aynı satın alma Meta’ya iki kez ulaşır: biri tarayıcıdan, biri sunucudan. Tekilleştirme (deduplication) yapılmazsa raporlarınızda satışlar şişer, reklam sistemi de yanlış öğrenir.
Meta’nın önerdiği yöntem basit: iki kanaldan giden olaylarda olay adı aynı olmalı (ör. ikisinde de Purchase) ve her iki olay da aynı event_id değerini taşımalı. Pixel tarafında bu değer eventID, sunucu tarafında event_id olarak gönderilir. Meta, aynı ad ve kimliğe sahip olayları, ilk olayı aldıktan sonraki 48 saat içinde gelirse tek olay sayar. Alternatif olarak olay adıyla birlikte fbp ya da external_id değerleri de kullanılabilir; ancak bu yöntem yalnızca tarayıcı olayı önce, sunucu olayı sonra geldiğinde çalışır. Bu yüzden sipariş numarasından türetilen bir event_id kullanmak daha sağlam bir yoldur.
İlgili hizmet
Meta reklam yönetimi
Instagram ve Facebook reklamlarınızı Pixel ve Conversions API ölçümüyle kuruyor, kreatifleri ekibimizde üretiyor, bütçeyi mesaj, form ve satış maliyetine göre yönetiyoruz.
Kurulum yolları ve test
Pixel ve CAPI’yi kurmanın tek bir doğru yolu yok; sitenizin altyapısı, teknik ekibiniz ve bütçeniz belirler. Başlıca üç yol var:
- Platform ve ortak entegrasyonları: Pek çok e-ticaret altyapısı ve WordPress eklentisi Meta ile hazır bağlantı sunar; Pixel’i ve sunucu olaylarını birlikte gönderebilir. Meta da Pixel’i olan reklamverenlerin web olayları için Conversions API’yi Olaylar Yöneticisi’nden birkaç tıkla kurabildiğini belirtiyor. En hızlı yoldur; ama hangi olayların, hangi parametrelerle ve tekilleştirmeyle gittiğini mutlaka kontrol edin.
- Google Tag Manager sunucu tarafı: Etiketlerinizi kendi alan adınızda çalışan bir sunucu kapsayıcısından yönetirsiniz. Meta, Google Ads ve GA4 olaylarını tek yerden düzenlemek isteyenler için esnektir; kurulumu ve barındırma maliyeti daha fazla teknik iş ister. Google Ads yönetimi tarafında da aynı ölçüm altyapısından yararlanırız.
- Conversions API Gateway ya da doğrudan entegrasyon: Meta’nın Gateway çözümü, işletmenin kendi bulut hesabında çalışan ve kod yazmadan kurulan bir ara katmandır. Doğrudan entegrasyonda ise yazılımcınız olayları sunucudan Meta’nın API’sine kendisi gönderir; en esnek ama en çok emek isteyen yoldur.
Olayları test etmeden kampanya açmayın
Kurulum bitti diye iş bitmez. Olaylar Yöneticisi’ndeki Olayları Test Et (Test Events) aracı, sitenizde yaptığınız deneme işlemlerinin Meta’ya tarayıcıdan mı, sunucudan mı ulaştığını ve tekilleştirilip tekilleştirilmediğini anlık gösterir. Sunucu olayları için araç bir test kodu verir; bu kodu yalnızca test sırasında gönderin, canlıya geçerken kaldırın. Meta’ya göre olaylar gönderildikten sonra yaklaşık 20 dakika içinde Olaylar Yöneticisi’nde doğrulanabilir. Test sırasında gerçek bir sipariş akışını baştan sona denemek; tutar, para birimi ve ürün kimliklerinin doğru gittiğini tek tek kontrol etmek gerekir.
Çerez onayı ve KVKK
Ölçümü güçlendirmek, ziyaretçinin iznini atlamak anlamına gelmez. Kişisel Verileri Koruma Kurumu’nun (KVKK) Temmuz 2025 tarihli “Çerez Uygulamaları Hakkında Rehber”i, davranışsal reklamcılık için kullanılan çerezlerin açık rıza gerektirdiğini açıkça yazıyor. Rehber ayrıca iyi uygulama olarak, siteye girildiğinde açılan çerez panelinde “Kabul et”, “Reddet” ve “Tercihler” butonlarının renk, büyüklük ve punto bakımından eşit sunulmasını öneriyor; siteyi kullanmaya devam etmenin ya da kullanım koşullarına gömülmüş bir onayın açık rıza sayılmayacağını belirtiyor.
Rehberin piksel benzeri teknolojiler için ayrıca yönlendirme yapmadığını da not edelim. Ancak Meta Pixel ziyaretçinin tarayıcısında reklam amaçlı çerez değerleri oluşturur; bu yüzden pratikte pazarlama çerezleriyle aynı onay kuralına bağlamak en güvenli yoldur. Uygulamada şunlara dikkat ediyoruz:
- Pixel, ziyaretçi pazarlama çerezlerine onay verene kadar veri göndermez. Meta’nın kendi belgeleri bunun için Pixel’i “onay geri alındı” durumunda başlatıp onay gelince açma yöntemini anlatıyor.
- Sunucudan giden olaylar da kişisel veri taşır. Onay vermemiş bir ziyaretçinin verisini CAPI ile “arka kapıdan” göndermek çözüm değildir; sunucu tarafı da aynı onay durumuna bağlanmalıdır.
- Meta’ya giden veri yurt dışına aktarılır. Çerez aydınlatma metninizde bu aktarımı ve amaçlarını açıkça anlatın.
Meta da her işletmenin uyumdan kendisinin sorumlu olduğunu belirtiyor. Çerez metinlerinizin ve hukuki dayanağınızın son kontrolünü KVKK alanında çalışan bir hukukçuyla yapmanızı öneririm.
Sık yapılan hatalar
- Pixel’i iki kez kurmak: Hem tema koduna hem eklentiye eklenen Pixel, her olayı iki kez gönderir ve tekilleştirme bunu çözmez.
- event_id göndermemek: Pixel ve CAPI birlikte çalışırken satışlar şişer; rapor güzel görünür ama gerçek değildir.
- Tutarı ve para birimini yanlış göndermek: Kuruşla lira karışır, KDV’li ve KDV’siz tutar karışır, para birimi eksik kalır. Değere göre optimizasyon yanlış öğrenir.
- Satın almayı teşekkür sayfasının yenilenmesiyle tekrar saymak: Sayfa her açıldığında yeni bir Purchase olayı gider.
- Onay olmadan veri göndermek ya da onay panelini yanlış kurmak: Hem hukuki risk hem de “Reddet” butonu çalışmadığı için güven kaybı.
- Kurup unutmak: Tema güncellemesi, ödeme altyapısı değişikliği ya da yeni bir eklenti olayları sessizce bozabilir. Olaylar Yöneticisi’ndeki uyarıları düzenli kontrol edin.
Ölçümü sağlam kurmak, reklam bütçenizi daha bilinçli harcamanın ön koşuludur; ama tek başına sonuç garantisi değildir. Kreatif, teklif, hedef kitle ve sitenizin kendisi de sonucu belirler. Reklam hesabınızın ölçüm altyapısını gözden geçirmek ya da sıfırdan kurmak isterseniz bize yazın; hesabınızın durumuna göre kapsamı ve teklifi birlikte netleştirelim.
Sıkça sorulan sorular
Meta Pixel ile Facebook Pixel aynı şey mi?
Evet. Facebook’un şirket adı Meta olarak değişince Facebook Pixel’in adı da Meta Pixel oldu. Eski rehberlerde “Facebook Pixel kurulumu” olarak geçen işlem bugün Meta Pixel kurulumudur.
Yalnızca Conversions API kullanıp Pixel’i kaldırabilir miyim?
Teknik olarak mümkündür, ama Meta’nın önerisi ikisini birlikte kullanmaktır. Pixel tarayıcıdaki davranışı ve çerez değerlerini, CAPI ise sunucunun kesin bildiği olayları getirir. İkisi birlikte, tekilleştirme yapılarak kullanıldığında ölçüm daha eksiksiz olur.
Olay Eşleştirme Kalitesi puanım düşük, ne yapmalıyım?
Sunucu olaylarına, kullanıcının onayı ve aydınlatma metniniz çerçevesinde, karma hâline getirilmiş e-posta ve telefon ile IP, tarayıcı bilgisi, fbp ve fbc değerlerini eklemek puanı yükseltir. Biçim hatalarını (ülke kodu eksik telefon, büyük harfli e-posta) da Olaylar Yöneticisi’ndeki uyarılardan kontrol edin.
Conversions API kurulumu reklam sonuçlarımı kesin olarak iyileştirir mi?
Kesin bir sonuç vaat edilemez. CAPI, kaybolan olayların bir kısmını geri getirerek ölçümü ve reklam sisteminin öğrenmesini iyileştirmeye yardım eder. Sonuç, kreatife, hedeflemeye, teklife ve sitenizin kendisine de bağlıdır.
Çerez onayı vermeyen ziyaretçiler ölçümde görünür mü?
Pazarlama çerezlerine onay vermeyen ziyaretçinin verisi Meta’ya gönderilmemelidir; bu ziyaretçiler reklam raporlarında görünmez. Bu kaybı kabul etmek, hukuka uygun ölçümün parçasıdır. Onay oranını, dürüst ve anlaşılır bir çerez paneliyle artırmak mümkündür.
Pixel ve CAPI kurulumu ne kadar sürer ve neye mal olur?
Sitenizin altyapısına, gönderilecek olay sayısına ve seçilen kurulum yoluna göre değişir. Hazır entegrasyonu olan bir sitede iş daha kısadır; özel yazılım ya da sunucu tarafı etiketleme daha fazla emek ister. Süre ve ücret teklifte netleşir.



