serkankaya.
English version
Birlikte çalışalım ↗

Meta Pixel Kurulumu: Adım Adım Kurulum ve Event Doğrulama

Meta Pixel kurulumu nasıl yapılır? Temel kod, GTM ve altyapı entegrasyonu, standart olaylar, çerez onayı, Data Advisor ile test ve sık yapılan hatalar.

Meta Pixel kurulumu, Olay Yöneticisi’nde bir piksel oluşturup temel kodunu sitenin her sayfasına eklemek ve ardından satın alma, form ya da randevu gibi dönüşüm olaylarını tanımlamaktan oluşur. Temel kod tek başına sayfa görüntülemelerini ölçer; reklam optimizasyonu için asıl değer, doğru parametrelerle gönderilen dönüşüm olaylarındadır. Kurulum, olaylar Olay Yöneticisi’nde ve test aracında doğrulandığında biter.

Bu yazıda Pixel’in nasıl çalıştığını, üç kurulum yolunu, standart olayları, çerez onayını ve test adımlarını anlatıyorum. Sonda yayına almadan önce kullandığım kontrol listesini paylaşıyorum.

Meta Pixel nedir ve nasıl çalışır?

Meta Pixel, sitenin sayfalarına yüklenen ve ziyaretçi eylemlerini fbq() fonksiyonuyla Meta’ya ileten bir JavaScript kütüphanesidir. Meta’nın geliştirici dokümantasyonuna göre Pixel varsayılan olarak ziyaret edilen URL’leri, alan adlarını ve ziyaretçinin cihazını izler.[1] Eşleşen ziyaretçilerin eylemleri Reklam Yöneticisi’nde (Ads Manager) raporlanır.

Pixel’in eski adı Facebook Pixel’dir; Türkçe arayüzde “Meta pikseli” olarak geçer. Üç işi vardır: dönüşümleri ölçmek, siteyi ziyaret edenlerden özel hedef kitle (custom audience) oluşturmak ve Advantage+ katalog reklamlarını beslemek.[1]

Ziyaretçi eylemi fbq() çağrısı Meta Pixel Olay Yöneticisi
Sayfadaki her eylem fbq() ile Pixel'e verilir; Pixel olayı tarayıcıdan Meta'ya gönderir.

Pixel tarayıcıda çalıştığı için tarayıcının kısıtlarından etkilenir. Reklam engelleyiciler, çerez kısıtları ve onay vermeyen ziyaretçiler bazı olayların Meta’ya hiç ulaşmamasına yol açar. Bu yüzden Pixel’i sunucu taraflı bir kaynakla, yani Meta Conversions API ile tamamlamak gerekir. Tarayıcı ve sunucu taraflı ölçümün farkını server-side tracking yazısında ayrıntılı anlattım.

Meta Pixel kurulumu nasıl yapılır?

Kısa cevap

Meta Pixel kurulumu nasıl yapılır?

Meta Pixel kurulumu için Olay Yöneticisi’nde bir piksel oluşturulur ve temel kod sitenin her sayfasında head etiketleri arasına eklenir. Kod yüklenince PageView olayı otomatik gider. Ardından satın alma, form ya da randevu gibi dönüşümler standart olaylarla tanımlanır ve Olay Yöneticisi’nde doğrulanır.

  1. Meta İşletme hesabında Olay Yöneticisi'ni aç
  2. Web sitesi veri kaynağı olarak yeni bir piksel oluştur
  3. Kurulum yöntemini seç: kod, GTM ya da altyapı entegrasyonu
  4. Temel kodu her sayfanın head bölümüne ekle
  5. Dönüşüm olaylarını fbq('track') ile tanımla
  6. Olayları Olay Yöneticisi ve Data Advisor ile test et

Kuruluma başlamadan önce üç erişimin hazır olması gerekir: sitenin koduna ya da etiket yöneticisine erişim, pikselin temel kodu ya da kimliği ve Reklam Yöneticisi erişimi.[1] Kurumsal yapılarda piksel, kişisel hesapta değil şirketin Meta İşletme Portföyü (Business Manager) altında oluşturulmalıdır. Aksi halde ajans ya da çalışan değiştiğinde verinin sahipliği tartışma konusu olur.

Temel kod

Temel kod, pikselin kimliğini iki yerde taşır ve her yüklemede bir PageView olayı gönderir. Meta bu satırın olduğu gibi bırakılmasını öneriyor.[1] Kodun yapısı şöyledir:

<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
document,'script','https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'PIXEL_ID');
fbq('track', 'PageView');
</script>
<!-- End Meta Pixel Code -->

Olay Yöneticisi’nin verdiği kodda bunun altında bir de noscript bloğu bulunur. Bu blok, JavaScript’i kapalı tarayıcılarda PageView’ı 1x1 piksellik bir görsel isteğiyle gönderir; onu da kodla birlikte olduğu gibi ekle.

Meta, temel kodun ölçüm yapılacak her sayfada açılış ve kapanış <head> etiketleri arasına eklenmesini öneriyor.[1] Kodun head içinde olması, başka scriptlerin Pixel’i engelleme ihtimalini azaltır. Kod erken çalıştığı için ziyaretçi sayfadan ayrılmadan olayın gitme şansı da artar. Mobil site masaüstünden ayrıysa Pixel iki sürüme de eklenmelidir.

Üç kurulum yolu

Meta Pixel’i siteye eklemenin üç yaygın yolu vardır: kodu doğrudan şablona yazmak, Google Tag Manager gibi bir etiket yöneticisi kullanmak ya da Shopify, WooCommerce, ikas, Ticimax gibi altyapıların hazır Meta entegrasyonunu açmak.

YöntemKime uygunDikkat edilecek nokta
Doğrudan kodKendi şablonu olan, geliştiriciye erişimi olan siteHer olay için kod değişikliği ve yayın gerekir
Google Tag ManagerBirden çok reklam platformunu tek yerden yöneten ekipOnay ve tetikleyici sırası doğru kurulmalı
Altyapı entegrasyonuHazır e-ticaret altyapısı kullanan mağazaHangi olayların hangi parametrelerle gittiğini kontrol et

Meta, Pixel’in çoğu etiket yöneticisinde çalıştığını, ama önerdiği yöntemin doğrudan head içine eklemek olduğunu belirtiyor.[1] Ben çoğu projede GTM’yi tercih ediyorum. Sebep, Google Ads, GA4 ve Meta etiketlerinin aynı veri katmanından (dataLayer) ve aynı onay durumundan beslenmesi.

Hangi Meta Pixel olayları kurulmalı?

Kurulması gereken olaylar, işletmenin gerçek dönüşüm adımlarına karşılık gelen standart olaylardır: e-ticarette ViewContent, AddToCart, InitiateCheckout ve Purchase; lead toplayan sitelerde Lead, Contact, Schedule ya da CompleteRegistration. Meta dönüşümleri üç yolla izler: standart olaylar, özel olaylar ve özel dönüşümler.[2]

Standart olay (standard event), Meta’nın önceden tanımladığı ve sabit bir adla gönderilen eylemdir. fbq('track', 'Purchase', {...}) biçiminde çağrılır. Özel olay (custom event) ise senin belirlediğin bir adla fbq('trackCustom', ...) ile gönderilir. Özel dönüşüm (custom conversion), Olay Yöneticisi’nde URL ya da olay kuralıyla tanımlanır ve ek kod istemez.[2]

Standart olayNe zaman tetiklenirÖnemli parametreler
ViewContentÜrün ya da hizmet sayfası görüntülendiğindecontent_ids, content_type, value, currency
AddToCartÜrün sepete eklendiğindecontents, value, currency
InitiateCheckoutÖdeme akışına girildiğindenum_items, value, currency
PurchaseÖdeme tamamlandığındavalue ve currency zorunlu
LeadForm başarıyla gönderildiğindevalue, currency (isteğe bağlı)
ScheduleRandevu oluşturulduğundaisteğe bağlı

Meta’nın standart olaylar referansına göre Purchase olayında currency ve value zorunludur. Advantage+ katalog reklamları kullanılıyorsa contents ya da content_ids de gönderilmelidir.[3] Bir satın alma olayı şöyle görünür:

fbq('track', 'Purchase', {
  value: 1250.00,
  currency: 'TRY',
  content_ids: ['SKU-1042'],
  content_type: 'product'
}, { eventID: 'order-10482' });

Son parametredeki eventID, aynı olay Conversions API’den de gönderiliyorsa tekilleştirme için kullanılır. Meta, Pixel ile Conversions API birlikte çalışırken bu kimliğin fbq('track') çağrısına dördüncü parametre olarak eklenmesini öneriyor.[3] Aynı değer sunucu olayında event_id alanına yazılır.

Olay nerede tetiklenmeli?

Olay, eylemin gerçekten tamamlandığı yerde tetiklenmelidir. Meta’nın dönüşüm takibi dokümantasyonu iki örnek veriyor: satın alma onay sayfası yüklendiğinde ya da bir butona tıklandığında.[2] Ben buton tıklamasını yalnızca niyet ölçmek için kullanıyorum; Purchase ve Lead gibi optimizasyon olaylarını başarı onayına bağlıyorum.

Yanıltıcı tetikleme

  • Lead, form butonuna tıklanınca gider
  • Purchase, teşekkür sayfası her yenilendiğinde tekrar gider
  • value sabit bir sayı olarak yazılır
  • Para birimi gönderilmez ya da yanlış gönderilir

Doğru tetikleme

  • Lead, sunucu formu kabul ettikten sonra gider
  • Purchase, sipariş başına bir kez ve sipariş numarasıyla gider
  • value, siparişin gerçek tutarından okunur
  • currency, ödemenin alındığı para birimiyle aynıdır
Optimizasyon olayı başarı onayına bağlanmazsa Meta, gerçekleşmemiş dönüşümlere göre teklif verir.

Çerez onayı ve KVKK ile Meta Pixel nasıl kurulur?

Çerez onayı gereken sitelerde Meta Pixel, ziyaretçi onay verene kadar veri göndermeyecek şekilde kurulur. Meta bunun için bir onay API’si sunuyor: fbq('consent', 'revoke') çağrısı init’ten önce yapılır, ziyaretçi onay verdiğinde fbq('consent', 'grant') çağrılır.[4] Meta, revoke çağrısının her sayfada yapılması gerektiğini belirtiyor.

fbq('consent', 'revoke');
fbq('init', 'PIXEL_ID');
fbq('track', 'PageView');

// Ziyaretçi çerez bannerında pazarlama çerezlerini onayladığında:
fbq('consent', 'grant');

GTM kullanıyorsan aynı mantığı onay yönetim platformunun (CMP) sinyaline bağlayabilirsin. Google tarafındaki karşılığını Consent Mode v2 yazısında anlattım. İki platformun onay durumunu aynı banner’dan beslemek, birinin onay beklerken diğerinin veri göndermesini önler.

Meta’nın GDPR sayfasına göre Pixel; HTTP başlıklarını, piksel kimliğini ve Facebook çerezini, buton tıklamalarını ve form alanı adlarını alır. Form alanlarının değerleri ise gelişmiş eşleştirme ya da dönüşüm takibiyle açıkça gönderilmedikçe alınmaz.[4] Gelişmiş eşleştirme (advanced matching), e-posta ya da telefon gibi bilgileri fbq('init') çağrısına ekleyerek olayların eşleşmesini güçlendirir. Pixel bu değerleri tarayıcıda SHA-256 ile hashler.

Sağlık turizminde ölçümün nasıl kurgulandığını sağlık turizmi pazarlaması sayfasında ve sağlık turizminde offline dönüşüm yazısında ayrıca ele aldım. Bu sektörde değerli olay çoğu zaman sitede değil, CRM’de oluşur.

Meta Pixel doğru çalışıyor mu, nasıl test edilir?

Meta Pixel iki yerden test edilir: tarayıcıda Meta Ads Data Advisor eklentisiyle ve Meta tarafında Olay Yöneticisi’yle. Meta, temel kodu ekledikten sonra Pixel’li bir sayfanın açılmasını ve Olay Yöneticisi’nde yeni bir PageView olayı görülüp görülmediğinin kontrol edilmesini öneriyor. Olay görünmüyorsa birkaç dakika beklenip sayfa yenilenmelidir.[1]

Meta Ads Data Advisor, eski adı Meta Pixel Helper olan ücretsiz tarayıcı eklentisidir. Meta’nın dokümantasyonuna göre Chrome ve Edge’de çalışır ve sayfada tetiklenen Pixel olaylarının sayısını eklenti simgesinde gösterir.[5] Yan panelde olay adları, parametreler ve content_ids, value, currency gibi eksik alanlar listelenir. Pixel Helper kullananlar için eklenti otomatik olarak Data Advisor’a güncellenir.

  1. Temel kodu doğrula

    Sitenin birkaç farklı sayfa şablonunu aç. Data Advisor her sayfada tek piksel ve bir PageView göstermeli.

  2. Olay akışını uçtan uca dene

    Ürünü görüntüle, sepete ekle, ödemeyi ya da formu tamamla. Her adımda beklenen olayın bir kez tetiklendiğini gör.

  3. Parametreleri kontrol et

    Purchase olayında value ve currency değerlerinin siparişle aynı olduğunu, content_ids alanının katalogdaki kimliklerle eşleştiğini doğrula.

  4. Olay Yöneticisi'ne bak

    Olayların Meta tarafına ulaştığını, Test Events ekranında ve olay listesinde gör; tarayıcı ve sunucu olayları birlikte geliyorsa tekilleştirildiğini kontrol et.

  5. Onay senaryosunu test et

    Çerezleri reddederek siteyi gez. Onay verilmeden Pixel isteği gitmemeli; onay verince olaylar başlamalı.

Test sırasında kendi siparişlerini ve form gönderimlerini ayrı tut. Canlı hesapta test verisi, raporları ve optimizasyonu kısa süreliğine de olsa etkiler.

Meta Pixel kurulumunda sık yapılan hatalar nelerdir?

Meta Pixel kurulumunda en sık yapılan hatalar; pikselin iki kez yüklenmesi, dönüşüm olaylarının yanlış anda tetiklenmesi, değer ve para birimi eksikliği ve onay yönetiminin atlanmasıdır. Bu hataların çoğu kod eklendiğinde görünmez; ancak raporlardaki dönüşüm sayısı arka uçtaki sipariş ya da lead sayısıyla karşılaştırıldığında ortaya çıkar.

  • Çift piksel: Altyapı entegrasyonu ve elle eklenen kod aynı anda çalışır, her olay iki kez sayılır.
  • Yanlış piksel kimliği: Test ya da eski bir piksel canlı sitede kalır, veri başka bir hesaba akar.
  • Yenilemeyle tekrar eden olay: Teşekkür sayfası her yenilendiğinde Purchase ya da Lead yeniden gider.
  • Sabit değer: value her siparişte aynı sayı olarak gönderilir, ROAS raporu anlamsızlaşır.
  • Para birimi uyumsuzluğu: TL ile satış yapılan sitede currency: 'USD' kalır.
  • Hassas bilgi içeren olay adı: Özel olay adında ya da URL’de tedavi, hastalık ya da finansal durum bilgisi geçer.
  • Tek kaynağa güvenmek: Yalnızca Pixel kullanılır; tarayıcıda kaybolan olaylar hiç telafi edilmez.

Pixel ile Conversions API birlikte çalışıyorsa ölçümün sunucu tarafı da aynı disiplini ister. Server-side GTM kurulumu yazısında sunucu kapsayıcısının nasıl kurulduğunu anlattım. WhatsApp’a yönlenen trafiği ölçmek istiyorsan WhatsApp dönüşüm takibi yazısı aynı mantığı o kanala uyguluyor.

Yayına almadan önce kontrol listesi

Pixel’i canlıya almadan önce aşağıdaki maddelerin her birini tek tek doğruluyorum. Liste, kurulum yönteminden bağımsız olarak geçerli.

Meta Pixel yayın öncesi kontrol0/8

Sonuç

Meta Pixel kurulumu; pikseli doğru hesapta oluşturmak, temel kodu her sayfaya tek kaynaktan eklemek ve gerçek dönüşüm adımlarını standart olaylarla, doğru parametrelerle göndermekten oluşur. Çerez onayı ve hassas veri kuralları, özellikle sağlık alanında, kurulumun ayrılmaz parçasıdır. Kurulum, olaylar Data Advisor’da ve Olay Yöneticisi’nde doğrulandığında tamamlanır.

Bir sonraki adım, Pixel’in kaçırdığı olayları sunucudan tamamlamak. Bunun için Conversions API yazısıyla devam edebilir, ölçüm altyapısının reklam stratejisine nasıl bağlandığını performans pazarlama sayfasında inceleyebilirsin. E-ticaret tarafındaki kurguyu e-ticaret SEO ve reklam yönetimi sayfasında anlattım.

Bu yazıdaki terimler

Gelişmiş eşleştirme
Gelişmiş eşleştirme (advanced matching), ziyaretçinin e-posta, telefon ya da ad gibi bilgilerinin Pixel olaylarıyla birlikte gönderilmesini sağlayan Meta özelliğidir. Pixel bu değerleri tarayıcıda SHA-256 ile hashler; amaç olayların Meta hesaplarıyla daha doğru eşleşmesidir.
Meta Ads Data Advisor
Meta Ads Data Advisor, eski adı Meta Pixel Helper olan ve Chrome ile Edge için sunulan ücretsiz bir tarayıcı eklentisidir. Sayfada tetiklenen Pixel olaylarını, parametreleri ve hataları gösterir; Pixel, Conversions API ve katalog bağlantılarının kurulmasına da yardım eder.
Meta Pixel
Meta Pixel, web sitesine eklenen ve ziyaretçi davranışını Meta'ya gönderen bir JavaScript kod parçasıdır. Facebook çerezleri üzerinden ziyaretçiyi Meta hesabıyla eşleştirir; dönüşüm ölçümü, özel hedef kitle oluşturma ve katalog reklamları için veri sağlar. Eski adı Facebook Pixel'dir.
Özel dönüşüm
Özel dönüşüm, Olay Yöneticisi'nde URL ya da olay kuralına göre tanımlanan ve sitede ek kod gerektirmeyen dönüşüm türüdür. Örneğin adresinde /tesekkurler/ geçen sayfaları ziyaret eden kullanıcıları dönüşüm olarak sayar. Meta, sağlık durumu gibi izin verilmeyen bilgiye işaret eden özel dönüşümleri kısıtlar.
Standart olay
Standart olay, Meta'nın önceden tanımladığı ve Purchase, Lead, AddToCart ya da Schedule gibi sabit adlarla gönderilen dönüşüm eylemidir. Pixel'de fbq('track') fonksiyonuyla tetiklenir, parametre taşıyabilir ve reklam optimizasyonunda doğrudan hedef olarak seçilebilir.
Tüm sözlük ↗

Sık sorulan sorular

Meta Pixel kurulumu ücretli mi?

Hayır, Meta Pixel oluşturmak ve sitene eklemek ücretsizdir. Pixel'i Olay Yöneticisi'nden oluşturursun, kodu siteye eklersin ve ek bir lisans ödemezsin. Maliyet, kurulumu yapan kişinin zamanı ve reklam bütçesidir.

Meta Pixel kodu sitenin neresine eklenir?

Meta, temel kodun ölçüm yapılacak her sayfada açılış ve kapanış head etiketleri arasına eklenmesini öneriyor. Çoğu sitede bu, tüm sayfalarda ortak kullanılan üst bilgi (header) şablonudur. Kodun head içinde olması erken çalışmasını sağlar ve ziyaretçi sayfadan ayrılmadan olayın gitme şansını artırır.

Meta Pixel'in çalışıp çalışmadığını nasıl anlarım?

Pixel kurulu bir sayfayı açtıktan sonra Olay Yöneticisi'nde pikselin ayrıntılarına bak; yeni bir PageView olayı görüyorsan temel kod çalışıyor demektir. Olay birkaç dakika gecikebilir. Tarayıcı tarafında Meta Ads Data Advisor eklentisi, sayfada hangi olayların hangi parametrelerle tetiklendiğini gösterir.

Google Tag Manager ile Meta Pixel kurulabilir mi?

Evet. Meta, Pixel'in çoğu etiket yöneticisinde çalıştığını belirtiyor; yine de önerdiği yöntem kodun doğrudan head içine eklenmesidir. GTM kullanıyorsan temel kodu tüm sayfalarda tetikle, olayları ayrı etiketlerle gönder ve çerez onayını aynı kapsayıcıda yönet.

Meta Pixel, Conversions API olmadan yeterli mi?

Küçük bir site için başlangıç noktası olabilir, ancak tarayıcı kısıtları ve reklam engelleyiciler yüzünden bazı olaylar Meta'ya ulaşmaz. Meta, Pixel'in yanında Conversions API kullanılmasını öneriyor. İkisini birlikte kullanırken aynı olayı event_id ile eşleştirmek gerekir.

Kaynaklar

  1. Meta for Developers: Meta Pixel Get Started
  2. Meta for Developers: Conversion Tracking
  3. Meta for Developers: Standard Events Reference
  4. Meta for Developers: General Data Protection Regulation
  5. Meta for Developers: Meta Ads Data Advisor