Meta Pixel ve Conversions API Kurulumu: Adım Adım Rehber

Meta Pixel, web sitenizdeki ziyaretçi davranışlarını (sayfa görüntüleme, sepete ekleme, satın alma gibi) tarayıcı üzerinden Meta'ya bildiren bir koddur; Conversions API (CAPI) ise aynı olayları doğrudan sunucunuzdan gönderir. İkisi birlikte kurulduğunda, tarayıcı kısıtlamaları ve reklam engelleyiciler nedeniyle kaybolan dönüşümlerin önemli bir kısmı geri kazanılır ve Meta'nın reklam yapay zekâsı daha eksiksiz veriyle optimize olur.

Bu rehberde Pixel ile Conversions API'nin neden birlikte kullanılması gerektiğini, kurulum seçeneklerini, en sık yapılan hataları ve kurulumun doğru çalıştığını nasıl test edeceğinizi adım adım anlatıyoruz.

Pixel tek başına neden yetmiyor?

Pixel, ziyaretçinin tarayıcısında çalışan bir JavaScript kodudur. Bu yüzden tarayıcının izin verdiği ölçüde veri gönderebilir. Safari ve Firefox gibi tarayıcıların izleme kısıtlamaları, reklam engelleyiciler, kullanıcının çerezleri reddetmesi ya da sayfanın yüklenmesi tamamlanmadan kapanması gibi durumlarda olaylar Meta'ya hiç ulaşmaz.

Bunun iki somut sonucu vardır:

• Raporlar eksik kalır: Reklam yöneticisinde gördüğünüz satış sayısı gerçek satışlarınızdan düşük olur.
• Optimizasyon zayıflar: Meta, kimin satın aldığını daha az örnekten öğrenir; bu da benzer kişileri bulma başarısını düşürür ve maliyetleri artırabilir.

Conversions API bu boşluğu, olayları tarayıcıya bağımlı olmadan sunucudan göndererek kapatır.

Conversions API kurulum seçenekleri

CAPI'yi kurmanın teknik bilgi düzeyine göre üç yolu vardır:

1. Platform entegrasyonu (en kolay): Shopify, WooCommerce, Ticimax, İkas gibi pek çok e-ticaret altyapısı Meta ile hazır entegrasyon sunar. Panelden Meta hesabınızı bağladığınızda hem Pixel hem de Conversions API otomatik kurulur. Önce altyapınızın bu desteği verip vermediğini kontrol edin.
2. Conversions API Gateway: Meta'nın sunduğu, kendi bulut hesabınızda çalışan hazır bir sunucu çözümüdür. Kod yazmadan kurulabilir, ancak küçük bir bulut barındırma maliyeti vardır.
3. Manuel (sunucu tarafı) kurulum: Yazılım ekibiniz, siparişi oluşturan sunucu kodundan olayları doğrudan Meta'nın API'sine gönderir. En esnek yöntemdir; özel bir altyapınız varsa genellikle tek seçenek budur. Google Tag Manager'ın sunucu tarafı sürümü de bu yolun bir uygulamasıdır.

Adım adım kurulum

1. Olaylar Yöneticisi'nde Pixel oluşturun

Meta Business Suite'te Olaylar Yöneticisi'ne girin, yeni bir veri kaynağı olarak web sitenizi ekleyin ve Pixel'i reklam hesabınıza bağlayın. Birden fazla reklam hesabınız varsa Pixel'in hangi hesaplarla paylaşıldığını da bu ekrandan yönetebilirsiniz.

2. Alan adınızı doğrulayın

Business Manager'da Marka Güvenliği → Alan Adları bölümünden sitenizin alan adını DNS kaydı ya da meta etiketiyle doğrulayın. Alan adı doğrulaması, olaylarınızın size ait olduğunu kanıtlar ve bazı ölçüm özelliklerinin çalışması için gereklidir.

3. Takip edeceğiniz olayları belirleyin

Her olayı değil, iş hedefinizi anlatan olayları kurun. Meta'nın standart olayları arasında en sık kullanılanlar şunlardır:

Satış yapan sitelerde Purchase olayına mutlaka sipariş tutarını (value) ve para birimini (currency) ekleyin; aksi hâlde reklam harcamasının getirisi (ROAS) hesaplanamaz.

4. Conversions API'yi kurun ve olayları tekilleştirin

Pixel ve Conversions API aynı olayı iki kez gönderdiğinde Meta'nın bunu tek olay olarak sayması gerekir. Bunun için her olayda iki alanın eşleşmesi şarttır:

• event_name: Her iki kaynakta aynı olay adı (ör. Purchase)
• event_id: Aynı olay için aynı benzersiz kimlik (ör. sipariş numarası)

Tekilleştirme yapılmazsa satışlar iki kez sayılır, ROAS olduğundan yüksek görünür ve bütçe kararları yanlış verilir. Hazır platform entegrasyonları bunu genellikle otomatik yapar; manuel kurulumda en sık atlanan adım budur.

5. Müşteri bilgilerini güvenli şekilde gönderin

Conversions API, sunucudan gönderilen olayı doğru kişiyle eşleştirmek için e-posta, telefon gibi bilgileri kullanabilir. Bu bilgiler gönderilmeden önce SHA-256 ile şifrelenmiş (hash'lenmiş) olmalıdır. Kişisel verilerin bu amaçla işlenmesinin KVKK kapsamında aydınlatma metninizde ve çerez/onay süreçlerinizde yer aldığından emin olun.

Kurulumu nasıl test edersiniz?

Olaylar Yöneticisi'ndeki Test Olayları sekmesi, sitenizde yaptığınız işlemlerin Meta'ya anlık olarak ulaşıp ulaşmadığını gösterir. Bir test siparişi verin ve şunları kontrol edin:

• Olay hem Tarayıcı hem Sunucu kaynağından görünüyor mu?
• Olay bir kez mi sayılıyor (tekilleştirme çalışıyor mu)?
• Purchase olayında tutar ve para birimi doğru mu?

Kurulum tamamlandıktan sonra birkaç gün içinde her olay için bir Olay Eşleştirme Kalitesi puanı görünür. Bu puan, gönderdiğiniz müşteri bilgilerinin Meta hesaplarıyla ne kadar iyi eşleştiğini gösterir; düşükse gönderilen bilgi alanlarını artırmak (e-posta, telefon, ad-soyad gibi) puanı yükseltir.

En sık yapılan hatalar

• Olayı yanlış sayfada tetiklemek: Purchase olayının sipariş onay sayfası yerine ödeme sayfasında tetiklenmesi, tamamlanmamış siparişleri satış gibi gösterir.
• Tekilleştirmeyi atlamak: Çift sayılan satışlar, gerçekte kârsız kampanyaları kârlı gösterebilir.
• Tutar göndermemek: ROAS hesaplanamaz, değer odaklı optimizasyon kullanılamaz.
• Test etmeden yayına almak: Kurulum hataları ancak haftalar sonra, bütçe harcandıktan sonra fark edilir.

Ölçümleme altyapınızın denetlenmesi ve doğru kurulması için Ölçümleme ve Raporlama hizmetimizi inceleyebilirsiniz. Kurulumdan sonra kampanya sonuçlarınızı yorumlarken ROAS hesaplama aracımız da işinize yarayacaktır.

Sıkça Sorulan Sorular

Conversions API kurmak zorunlu mu?

Zorunlu değildir; Meta reklamları yalnızca Pixel ile de çalışır. Ancak tarayıcı kısıtlamaları nedeniyle yalnızca Pixel ile yapılan ölçüm eksik kalır. Conversions API, kaybolan olayların bir kısmını sunucu üzerinden geri kazandırarak hem raporların hem de kampanya optimizasyonunun daha doğru olmasını sağlar.

Pixel ve Conversions API birlikte kullanılınca satışlar iki kez sayılır mı?

Olaylar doğru tekilleştirilirse sayılmaz. Bunun için tarayıcıdan ve sunucudan gönderilen aynı olayda event_name ve event_id değerlerinin aynı olması gerekir. Meta bu iki alan eşleştiğinde olayı tek kez sayar.

Olay Eşleştirme Kalitesi nedir?

Olay Eşleştirme Kalitesi, sunucudan gönderdiğiniz olayların Meta'daki kullanıcı hesaplarıyla ne kadar iyi eşleştiğini gösteren puandır. E-posta ve telefon gibi şifrelenmiş müşteri bilgileri ne kadar eksiksiz gönderilirse puan o kadar yükselir.

E-ticaret altyapım Conversions API'yi destekliyor mu?

Shopify, WooCommerce ve Türkiye'de yaygın kullanılan birçok e-ticaret altyapısı Meta ile hazır entegrasyon sunar. Altyapınızın uygulama mağazasında ya da entegrasyon ayarlarında Meta veya Facebook entegrasyonunu arayın; destek yoksa Conversions API Gateway ya da sunucu tarafı kurulum seçeneklerine bakılmalıdır.