Facebook Pixel kurulumu: adım adım rehber ve sık hatalar

Facebook Pixel kurulumu, Meta’nın Etkinlik Yöneticisi’nde bir piksel oluşturup bu kodu sitenize eklemek ve satın alma, sepete ekleme gibi etkinlikleri doğru şekilde tetiklemektir. Doğru kurulmuş bir piksel, Meta reklamlarının kime satış yaptığını öğrenmesini, yeniden pazarlama kitlelerini ve dönüşüm raporlarını mümkün kılar. Bu rehberde kurulumu adım adım anlatıyor, hesaplarda en sık gördüğümüz hataları listeliyoruz.

Facebook Pixel (Meta Pixel) nedir, ne işe yarar?

Meta Pixel, sitenize eklenen küçük bir JavaScript kodudur. Ziyaretçi bir sayfayı açtığında, ürün incelediğinde veya satın aldığında bu bilgiyi Meta’ya “etkinlik” olarak gönderir. Facebook adı Meta olarak değiştiği için bugün resmi adı Meta Pixel, ama aramalarda hâlâ çoğunlukla Facebook Pixel olarak geçiyor.

Pixel olmadan Meta reklamları “kör” çalışır. Doğru kurulduğunda üç temel işi görür:

• Ölçüm: Hangi reklamın kaç satış ve ne kadar ciro getirdiğini raporlar.
• Optimizasyon: Satın alma hedefli kampanyalarda algoritma, satın alma ihtimali yüksek kişileri bulmak için piksel verisini kullanır.
• Kitle oluşturma: Sepeti terk edenler, ürün görüntüleyenler veya son 30 günde satın alanlar gibi özel ve benzer kitleler oluşturmanızı sağlar.

Pixel’in gönderdiği veri kalitesi, kampanyanın başarısını doğrudan etkiliyor. Yönettiğimiz hesaplarda performans sorunlarının önemli bir kısmının reklamdan değil, eksik veya hatalı piksel kurulumundan çıktığını görüyoruz.

Facebook Pixel kurulumu öncesi hazırlık

Kuruluma başlamadan önce şu hazırlıkları tamamlamak, sonradan yetki ve veri karmaşasını önler:

• Meta İşletme Portföyü (Business Manager): Pikseli kişisel hesabınızda değil, şirketinize ait işletme portföyünde oluşturun. Ajansla çalışıyorsanız ajansa iş ortağı olarak erişim verin; pikselin sahipliği sizde kalsın.
• Site yönetici erişimi: Kod eklemek veya eklenti kurmak için WordPress, Shopify, ikas, IdeaSoft ya da Ticimax panelinize yönetici erişimi gerekir.
• Mevcut piksel kontrolü: Sitenizde daha önceden eklenmiş bir piksel var mı, Meta Pixel Helper ile kontrol edin. Eski bir ajansın pikseli ile yenisinin aynı anda çalışması sık karşılaşılan bir sorun.
• Çerez onayı: KVKK kapsamında pazarlama çerezleri için bir çerez onay yönetimi kullanıyorsanız, pikselin bu onaya göre çalışacak şekilde ayarlanması gerekir.
• Alan adı doğrulaması: Meta artık etkinlik yapılandırması için alan adı doğrulamasını zorunlu tutmuyor, ancak bağlantı önizlemelerini düzenleme yetkisi ve sahiplik kanıtı için İşletme Ayarları’nda alan adınızı doğrulamanızı yine öneriyoruz.

Facebook Pixel kurulumu adım adım

Meta’nın arayüz adları zaman zaman değişiyor; aşağıdaki adımlar 2026 itibarıyla Etkinlik Yöneticisi’ndeki genel akışı anlatıyor. Resmi teknik ayrıntılar için Meta Pixel geliştirici dokümantasyonuna bakabilirsiniz.

1. Etkinlik Yöneticisi’ni açın. business.facebook.com üzerinden Etkinlik Yöneticisi’ne (Events Manager) girin ve doğru işletme portföyünü seçtiğinizden emin olun.
2. Yeni veri kaynağı bağlayın. “Veri kaynaklarını bağla” seçeneğinden “Web”i seçin. Piksele işletme adınızı içeren anlaşılır bir ad verin (ör. “MarkaAdı – Web Pikseli”).
3. Site adresini girin. Meta, sitenizin kullandığı altyapıyı algılayıp uygun entegrasyonu önerebilir.
4. Kurulum yöntemini seçin. İş ortağı entegrasyonu, manuel kod veya Google Etiket Yöneticisi. Hangisinin size uygun olduğunu aşağıdaki tabloda karşılaştırdık.
5. Temel kodu ekleyin. Temel kod (base code), sitenin her sayfasında, <head> etiketinin içinde bir kez yüklenmeli. PageView etkinliği bu kodla otomatik gönderilir.
6. Standart etkinlikleri ekleyin. ViewContent, AddToCart, InitiateCheckout ve Purchase gibi etkinlikleri ilgili sayfalara veya butonlara bağlayın.
7. Değer ve para birimini gönderin. Purchase etkinliğinde value ve currency: "TRY" parametreleri olmadan ROAS ve dönüşüm değeri raporlanamaz.
8. Test edin. Etkinlik Yöneticisi’ndeki “Etkinlikleri Test Et” sekmesi ve Meta Pixel Helper ile her etkinliğin bir kez ve doğru değerle tetiklendiğini doğrulayın.
9. Reklam hesabına bağlayın. İşletme Ayarları’nda pikseli kullanacak reklam hesaplarına erişim verin.

Hangi kurulum yöntemi size uygun?

Türkiye’deki e-ticaret altyapılarının çoğu panelde “Facebook Pixel ID” ya da “Meta Pixel” alanı sunuyor; piksel kimliğini bu alana yazmak temel kurulumu tamamlıyor. Yine de altyapının hangi etkinlikleri, hangi parametrelerle gönderdiğini test ederek doğrulamak gerekiyor.

Hangi standart etkinlikler kurulmalı?

Meta’nın önceden tanımladığı standart etkinlikleri kullanmak, hem raporlamayı hem optimizasyonu kolaylaştırır. İşletme türüne göre öncelikli etkinlikler:

E-ticaret sitelerinde ViewContent, AddToCart ve Purchase etkinliklerinde content_ids parametresinin ürün kataloğundaki ürün kimlikleriyle birebir eşleşmesi gerekir. Eşleşmezse dinamik ürün reklamları ve Advantage+ Shopping kampanyaları doğru ürünü gösteremez.

Daha önce Meta, her alan adı için sekiz etkinliği önceliklendirmeyi (Toplu Etkinlik Ölçümü) zorunlu tutuyordu. Bu zorunluluk kaldırıldı; artık etkinlik önceliklendirmesi yapmanız gerekmiyor. Eski rehberlerde bu adımı görürseniz atlayabilirsiniz.

Pixel’i test etme ve doğrulama

Kurulumun en çok atlanan kısmı test. Bizim her kurulumda uyguladığımız kontrol listesi:

1. Etkinlikleri Test Et: Etkinlik Yöneticisi’nde site adresini girin, açılan pencerede bir ürünü görüntüleyin, sepete ekleyin ve ödeme sayfasına ilerleyin. Her adımın listede bir kez göründüğünü kontrol edin.
2. Gerçek bir test siparişi verin: Kapıda ödeme ya da düşük tutarlı bir ürünle siparişi tamamlayın. Purchase etkinliğinin doğru tutar ve TRY para birimiyle geldiğini görün, ardından siparişi iptal edin.
3. Meta Pixel Helper: Chrome eklentisi, sayfadaki piksel sayısını ve uyarıları gösterir. “Pixel loaded twice” gibi uyarılar çift kurulumun işaretidir.
4. Teşekkür sayfasını yenileyin: Sayfayı yenilediğinizde Purchase tekrar tetikleniyorsa satışlar şişer.
5. Tanılama sekmesini izleyin: Etkinlik Yöneticisi’ndeki tanılama (diagnostics) bölümü, eksik parametre ve eşleşme sorunlarını birkaç gün içinde raporlar.

Facebook Pixel kurulumunda en sık yapılan hatalar

Yönettiğimiz ve devraldığımız hesaplarda en sık karşılaştığımız hatalar:

• Çift piksel veya çift etkinlik: Hem tema koduna hem eklentiye eklenen piksel, her satışı iki kez sayar. Raporlarda ROAS gerçeğin iki katı görünür.
• Purchase’ın yanlış sayfada çalışması: Etkinliğin teşekkür sayfası yerine ödeme sayfasında ya da her sayfada tetiklenmesi.
• Değer veya para birimi eksikliği: value boş, metin olarak ya da yanlış para birimiyle gönderiliyorsa dönüşüm değeri anlamsızlaşır.
• KDV ve kargo belirsizliği: Gönderilen değerin KDV ve kargo dahil mi hariç mi olduğunu bilmemek, ROAS hesabınızı yanıltır. Hangi kuralı seçerseniz seçin, tüm platformlarda aynısını uygulayın.
• Piksel sahipliğinin ajansta olması: Ajans değiştiğinde piksel ve geçmiş veri kaybolabilir. Pikseli kendi işletme portföyünüzde oluşturun.
• Ödeme sağlayıcısı yönlendirmesi: Ödeme harici bir sayfada tamamlanıp siteye dönülmüyorsa Purchase hiç tetiklenmeyebilir. Ödeme sonrası müşterinin sitenizdeki teşekkür sayfasına döndüğünden emin olun.
• Çerez onayının pikseli tamamen kapatması: Onay yönetimi yanlış yapılandırıldığında piksel onay veren kullanıcılar için bile çalışmayabilir.
• Yalnızca piksele güvenmek: Tarayıcı kısıtlamaları ve reklam engelleyiciler nedeniyle piksel tek başına bazı dönüşümleri kaçırır.

Kurulumdan sonra ilk hafta ne yapılmalı?

Piksel çalışmaya başladığı andan itibaren veri biriktirir, ama geçmişe dönük veri toplamaz. Bu yüzden pikseli reklam vermeye başlamadan önce, mümkünse birkaç hafta önceden kurmanızı öneriyoruz. İlk hafta için pratik bir sıra:

1. Özel kitleleri hemen oluşturun. Son 30 günde siteyi ziyaret edenler, ürün görüntüleyip satın almayanlar, sepete ekleyip ödeme yapmayanlar ve son 180 günde satın alanlar. Kitleler piksel verisiyle dolmaya başlar ve yeniden pazarlamaya hazır olur.
2. Satın alanları hariç tutma kitlesi hazırlayın. Yeni müşteri kampanyalarında mevcut müşterilere bütçe harcamamak için bu kitleyi hariç tutma listesi olarak kullanabilirsiniz.
3. Etkinlik hacmini izleyin. Purchase etkinliği haftada yalnızca birkaç kez tetikleniyorsa, ilk aşamada daha sık gerçekleşen bir etkinlikle (AddToCart veya InitiateCheckout) optimize etmeyi değerlendirin.
4. Mağaza verisiyle karşılaştırın. Bir haftalık Purchase sayısını panel siparişleriyle kıyaslayın. Belirgin fark varsa kurulumu yeniden test edin.

Pixel yeterli mi? Conversions API ile birlikte kullanım

Pixel tarayıcı tarafında çalıştığı için, iOS gizlilik ayarları, reklam engelleyiciler ve çerez izni vermeyen ziyaretçiler nedeniyle bazı etkinlikler Meta’ya ulaşmaz. Bu boşluğu kapatmanın yolu Conversions API (CAPI): aynı etkinlikleri sitenizin sunucusundan Meta’ya göndermek.

Pixel ve CAPI birlikte kullanıldığında aynı satış iki kez gelir; Meta bunu ortak event_id ile tekilleştirir. Bu yüzden her iki kaynakta da aynı etkinlik adı ve aynı etkinlik kimliği gönderilmeli. Etkinlik Yöneticisi’ndeki etkinlik eşleşme kalitesi (Event Match Quality) puanı, gönderdiğiniz müşteri bilgilerinin (hash’lenmiş e-posta, telefon vb.) yeterli olup olmadığını gösterir.

Kurulum seçeneklerini ve faydalarını Meta Conversions API rehberimizde ayrıntılı anlattık.

Pixel ve CAPI kurulumunu kampanya kurgusuyla birlikte ele almak isterseniz Meta Ads yönetimi sayfamıza göz atabilirsiniz.

Kısaca

• Facebook Pixel kurulumu, Etkinlik Yöneticisi’nde piksel oluşturup kodu veya altyapı entegrasyonunu sitenize eklemektir.
• Pikseli kendi işletme portföyünüzde oluşturun, ajansa yalnızca erişim verin.
• E-ticarette en az ViewContent, AddToCart, InitiateCheckout ve Purchase kurulmalı; Purchase değer ve TRY para birimi içermeli.
• Kurulumu Etkinlikleri Test Et, Pixel Helper ve gerçek bir test siparişiyle doğrulayın; çift sayım en sık hata.
• Eksik ölçümü azaltmak için Pixel’i Conversions API ile birlikte, ortak etkinlik kimliğiyle kullanın.