Mist Network

Facebook Piksel Kurulumu ve Conversions API: Adım Adım Rehber

Doğru kurulmamış bir piksel, en iyi kampanyayı bile kör bırakır. Meta Pixel ve Conversions API kurulumunu, test adımlarını ve sık yapılan hataları anlattık.

Güncellendi: 4 dk okuma
Facebook piksel kurulumu ve Conversions API veri akışı şeması

Facebook piksel kurulumu; Meta Olay Yöneticisi'nde bir piksel oluşturmayı, temel kodu sitenize eklemeyi, satın alma ve sepete ekleme gibi standart olayları tanımlamayı ve kurulumu test etmeyi kapsar. Bugün sağlıklı bir ölçüm için piksele ek olarak Conversions API ile sunucu taraflı veri göndermek ve iki kaynağı olay kimliğiyle tekilleştirmek de gerekir.

Meta Pixel ve Conversions API nedir?

Meta Pixel (eski adıyla Facebook pikseli), sitenize eklenen ve ziyaretçinin tarayıcısında çalışan bir kod parçasıdır. Ziyaretçi bir ürünü görüntülediğinde, sepete eklediğinde veya satın aldığında bu bilgiyi Meta'ya iletir. Reklam sistemi bu veriyle hem sonuçları raporlar hem de dönüşüm yapma olasılığı yüksek kişileri bulmayı öğrenir.

Conversions API (CAPI) ise aynı olayların tarayıcı yerine sunucunuzdan doğrudan Meta'ya gönderilmesini sağlar. Reklam engelleyiciler, tarayıcı gizlilik kısıtlamaları ve çerez tercihleri piksel sinyallerinin bir kısmını engelleyebilir; CAPI bu boşluğu azaltır. CAPI pikselin alternatifi değil tamamlayıcısıdır: ikisi aynı piksel kimliğini kullanır ve birlikte çalışır.

Meta PixelConversions API
Nerede çalışır?Ziyaretçinin tarayıcısındaSizin sunucunuzda
Engellenebilir mi?Reklam engelleyici ve tarayıcı kısıtlamalarından etkilenirTarayıcı kısıtlamalarından daha az etkilenir
KurulumKod veya platform entegrasyonuPlatform entegrasyonu, ağ geçidi veya geliştirme
RolüTemel olay takibiSinyal kaybını azaltma, veri kalitesini artırma

Facebook piksel kurulumu: adım adım

  1. Business hesabınızı hazırlayın — Pikseli işletmenize ait Meta Business hesabında oluşturun. Piksel ve reklam hesabı sahipliğinin işletmenizde kalması, ileride ajans değiştirdiğinizde veri kaybını önler.
  2. Olay Yöneticisi'nde veri kaynağı oluşturun — Olay Yöneticisi'nde yeni bir web veri kaynağı (piksel) ekleyin ve sitenizin alan adını girin.
  3. Temel kodu ekleyin — Shopify, WooCommerce, ikas, Ticimax gibi altyapılarda genellikle hazır entegrasyonla piksel kimliğini girmek yeterlidir. Özel yazılımlı sitelerde temel kod tüm sayfaların head bölümüne eklenir veya Google Tag Manager ile yönetilir.
  4. Standart olayları tanımlayın — ViewContent, AddToCart, InitiateCheckout, Purchase, Lead ve CompleteRegistration gibi standart olayları ilgili sayfa ve butonlara bağlayın.
  5. Parametreleri ekleyin — Purchase olayında sipariş değeri (value) ve para birimi (currency) mutlaka gönderilmeli; e-ticarette ürün kimlikleri (content_ids) katalog eşleşmesi için gereklidir.
  6. Alan adını doğrulayın — Business ayarlarından alan adı doğrulaması yapın; bu, olay yapılandırması üzerinde kontrolü sizde tutar.
İpucu: Sadece "teşekkürler" sayfasında Purchase tetiklemek yaygın bir yöntemdir; ancak sayfa yenilendiğinde olayın tekrar gönderilmediğinden emin olun. Aksi halde satışlar çift sayılır ve ROAS yapay olarak şişer.

Conversions API kurulumu için 3 yol

CAPI'yi kurmanın en uygun yolu, sitenizin altyapısına ve teknik kaynaklarınıza bağlıdır:

  • Platform entegrasyonu: Birçok e-ticaret altyapısı, CAPI'yi birkaç tıklamayla etkinleştiren hazır bağlantılar sunar. Teknik ekibi olmayan işletmeler için en hızlı yoldur.
  • Sunucu taraflı etiket yönetimi veya ağ geçidi: Sunucu taraflı Google Tag Manager veya Meta'nın ağ geçidi çözümleri, kod yazmadan daha fazla kontrol sağlar.
  • Doğrudan geliştirme: Kendi sunucunuzdan Meta'nın API'sine olay gönderirsiniz. En esnek yöntemdir; geliştirici kaynağı gerektirir. Teknik ayrıntılar için Meta'nın Conversions API dokümantasyonu başvuru kaynağıdır.

Hangi yolu seçerseniz seçin, CAPI ile e-posta veya telefon gibi müşteri bilgileri gönderiliyorsa bunlar Meta'nın belirttiği şekilde karma (hash) yöntemiyle gönderilmeli ve kişisel verilerin korunması mevzuatına (Türkiye'de KVKK) uygun bir aydınlatma ve çerez politikası bulunmalıdır.

Olay tekilleştirme: en sık atlanan adım

Piksel ve CAPI aynı satın almayı iki kez gönderdiğinde Meta'nın bunların aynı olay olduğunu anlaması gerekir. Bunun için her iki kaynaktan gelen olayda aynı event_name ve aynı event_id değeri bulunmalıdır. Tekilleştirme kurulmazsa dönüşümler çift sayılır, sonuç başı maliyet olduğundan düşük, ROAS ise olduğundan yüksek görünür.

Dikkat: Çift sayılan dönüşümler yalnızca raporu bozmaz; algoritma da yanlış sinyale göre optimize eder. Kurulumdan sonra Olay Yöneticisi'nde tekilleştirme durumunu mutlaka kontrol edin.

İşletme tipine göre olay planı

Her işletmenin aynı olaylara ihtiyacı yoktur. Kurulumdan önce hangi olayların sizin için anlamlı olduğunu belirlemek, hem kurulumu sadeleştirir hem de kampanyanın doğru olaya optimize edilmesini sağlar:

İşletme tipiTemel olaylarOptimizasyon olayı
E-ticaretViewContent, AddToCart, InitiateCheckout, PurchasePurchase (veri azsa geçici olarak InitiateCheckout)
Hizmet / leadViewContent, Lead, Contact, ScheduleLead veya nitelikli lead
Üyelik / SaaSCompleteRegistration, StartTrial, SubscribeStartTrial veya Subscribe
İçerik / toplulukViewContent, özel katılım olayıKatılım veya kayıt olayı

Standart olayların karşılamadığı durumlarda özel olaylar veya URL kurallarına dayanan özel dönüşümler kullanılabilir. Ancak mümkün olduğunca standart olaylara bağlı kalmak, raporlamayı ve platformun öğrenmesini kolaylaştırır.

Değer ve kalite sinyalleri

Lead toplayan işletmelerde tüm lead'ler aynı değerde değildir. CRM'inizde satışa dönen lead'leri işaretleyip bu bilgiyi Conversions API ile geri göndermek, sistemin yalnızca form dolduran değil, müşteriye dönüşen kişileri bulmayı öğrenmesine yardım eder. Bu adım teknik olarak daha ileri seviyedir ama lead kalitesi sorunu yaşayan işletmeler için büyük fark yaratabilir.

Kurulumu test etme ve veri kalitesini izleme

  1. Test olayları aracı — Olay Yöneticisi'ndeki test olayları sekmesinde sitenizi gezip olayların gerçek zamanlı geldiğini görün.
  2. Tarayıcı eklentisi — Meta Pixel Helper eklentisiyle her sayfada hangi olayların tetiklendiğini kontrol edin.
  3. Gerçek bir test siparişi — Küçük bir test siparişi verip Purchase olayının doğru değer ve para birimiyle, tek sefer geldiğini doğrulayın.
  4. Olay eşleştirme kalitesi — Olay Yöneticisi'ndeki eşleştirme kalitesi puanını izleyin; daha fazla uygun müşteri parametresi göndermek bu puanı yükseltebilir.

Kişisel veriler, KVKK ve çerez onayı

Ölçümleme kurarken yasal yükümlülükleri de atlamamak gerekir. Türkiye'de kişisel verilerin işlenmesi KVKK kapsamındadır; sitenizde ziyaretçileri hangi verilerin hangi amaçla toplandığı konusunda bilgilendiren bir aydınlatma metni ve çerez politikası bulunmalıdır. Avrupa'daki kullanıcılara da hizmet veriyorsanız GDPR kapsamındaki onay kuralları ayrıca geçerlidir. Çerez onay aracınızın pikselle doğru entegre olması, yani kullanıcının tercihine göre pikselin davranışını ayarlaması önemlidir. Conversions API ile müşteri bilgisi gönderiyorsanız yalnızca gerekli alanları, karma yöntemiyle ve aydınlatma metninizle uyumlu biçimde gönderin. Hukuki değerlendirme için bir uzmana danışmanız en doğrusudur.

Sık yapılan 6 kurulum hatası

  • Pikselin ajansa veya serbest çalışana ait bir Business hesabında oluşturulması.
  • Purchase olayında değer veya para birimi gönderilmemesi.
  • Aynı sayfaya iki farklı piksel kodunun eklenmesi.
  • Pixel ve CAPI'nin tekilleştirme olmadan birlikte çalıştırılması.
  • Test siparişlerinin canlı veriden ayrılmaması.
  • UTM düzeninin olmaması; bu durumda analitik aracınızda reklam trafiğini ayırt etmek zorlaşır.

mistBOOST'ta ölçümleme kurulumu

mistBOOST'ta kurulum ve ölçümleme hizmetin standart parçasıdır: Pixel, Conversions API, UTM ve dönüşüm olaylarıyla doğru veri altyapısı kampanya yayına girmeden önce kurulur. Bu altyapı üzerine kitle ve yeniden pazarlama kurgusu oluşturulur; harcama, sonuç ve birim maliyet ise müşteri panelinizde grafiklerle raporlanır. Ölçümün neden bu kadar önemli olduğunu ROAS nedir ve e-ticaret reklam ajansı yazılarımızda ayrıntılı anlattık.

Özetle: Pikseli kendi Business hesabınızda oluşturun, standart olayları değerleriyle gönderin, Conversions API ekleyin, event_id ile tekilleştirin ve gerçek bir test siparişiyle doğrulayın. Doğru veri, düşük maliyetin ön şartıdır.

Kurulum tamamlandıktan sonra da ölçümü düzenli kontrol edin. Site temasında, ödeme sayfasında veya altyapı eklentilerinde yapılan bir güncelleme olayların çalışmasını bozabilir. Ayda bir kez test siparişi vermek ve Olay Yöneticisi'ndeki uyarıları izlemek, sorunları erken yakalamanın en kolay yoludur.

Ölçümleme altyapınızı kampanya kurulumuyla birlikte uzmanlara bırakmak isterseniz teklif alın; sorularınız için iletişim sayfasından bize ulaşın.

Sık sorulan sorular

Facebook piksel kurulumu nasıl yapılır?
Meta Olay Yöneticisi'nde piksel oluşturulur, temel kod siteye veya altyapı entegrasyonuna eklenir, standart olaylar tanımlanır ve kurulum test olayları aracıyla doğrulanır.
Conversions API nedir?
Dönüşüm olaylarını tarayıcı yerine sunucudan doğrudan Meta'ya gönderen bağlantıdır. Pikselle birlikte çalışır ve tarayıcı kısıtlamalarından kaynaklanan sinyal kaybını azaltır.
Pixel varken Conversions API gerekli mi?
Zorunlu değildir ama önerilir. Reklam engelleyiciler ve gizlilik ayarları piksel verisinin bir kısmını kaybettirebilir; CAPI bu boşluğu kapatmaya yardımcı olur.
Olay tekilleştirme nedir?
Pixel ve CAPI aynı olayı gönderdiğinde, Meta'nın bunu tek olay saymasını sağlayan eşleştirmedir. Her iki kaynakta aynı event_name ve event_id gönderilerek yapılır.
Pikselin çalıştığını nasıl anlarım?
Olay Yöneticisi'ndeki test olayları sekmesini ve Meta Pixel Helper eklentisini kullanın; ardından küçük bir test siparişiyle Purchase olayının tek sefer ve doğru değerle geldiğini doğrulayın.

İlgili yazılar

Mist NetworkMist Network