Meta Pixel kurulumu ve doğrulama: algoritmaya doğru başarıyı anlatmak

Reklam Yöneticisi’nde (Ads Manager) satın alma amacıyla kurulan bir kampanya, neyi büyüteceğini sitenizden gelen olaylardan öğrenir. Bu olayları Meta’ya taşıyan kod pikseldir. Bazı kurulum hataları olay gönderimini keser ve Data Advisor gibi araçlar bunlar için uyarı verebilir. Daha sinsi hatalar kampanyayı durdurmaz. Reklam yayında kalır, raporda rakamlar akmaya devam eder. Raporda sonuç görmek, pikselin doğru çalıştığını kanıtlamaz.

Bu yüzden kurulumu doğrulamadan bitmiş saymayın. Doğrulama, işin kurulum kadar zaman isteyen ikinci yarısıdır.

Meta Pixel nedir, sitenizde neyi kaydeder?

Meta Pixel (eski adıyla Facebook Pixel), sitenizin sayfalarına eklenen kısa bir JavaScript kodudur. Ziyaretçi bir ürün sayfasını açtığında, sepete ürün eklediğinde ya da ödemeyi tamamladığında bu hareketi bir olay olarak Meta’ya gönderir. Meta bu olayları reklamı gören kişilerle eşleştirir. Eşleşen veri, reklam sonuçlarını ölçmeye ve reklamın kime gösterileceğini optimize etmeye yarar. Site ziyaretçilerinden özel hedef kitle de kurabilirsiniz. Kısa tanım için Meta Pixel nedir? maddesine bakabilirsiniz.

Temel kod, her sayfa yüklendiğinde kendiliğinden bir PageView olayı gönderir. Temel koddaki PageView çağrısını değiştirmeyin. Geri kalan olayları kodla ya da altyapınızın Meta entegrasyonuyla eklersiniz. Data Advisor bazı olayları ek kod olmadan site hareketinden otomatik algılayabiliyor. Böyle bir olay görürseniz doğru eylemi ölçtüğünü ayrıca kontrol edin. Meta’nın standart olay listesinde 17 olay var. E-ticarette en çok ViewContent, AddToCart, InitiateCheckout ve Purchase kullanılır. Hizmet satan markalarda Lead, Contact, Schedule ve CompleteRegistration öne çıkar.

Listede olmayan bir hareketi ölçmek isterseniz özel olay tanımlarsınız. Özel olayın adı en fazla 50 karakter olabilir. Temel piksel kuruluysa ek olay kodu yazmadan, yalnızca “/tesekkurler” gibi bir adres parçasına bakan özel dönüşüm de kurabilirsiniz. Her reklam hesabında bunlardan en fazla 100 tane tanımlanabiliyor.

Pikselin bir de sunucu tarafındaki eşi var. Dönüşüm API’si (Conversions API), aynı olayları tarayıcı yerine sizin sunucunuzdan gönderir. Sunucudan gelen olaylarla da reklam sonuçlarını ölçebilir ve kampanyaları optimize edebilirsiniz. Data Advisor eklentisi pikseli ve Dönüşüm API’sini kod yazmadan kurma seçeneği de sunuyor. Aşağıdaki adımlar pikselin kendisini kurar. İki kaynağın birlikte nasıl doğrulanacağı 7. adımda.

Piksel kampanya sonucunu neden doğrudan etkiler?

Advantage+ (Meta’nın kitle, yerleşim ve bütçe kararlarını otomatik veren kampanya ayarları) varsayılan hâle geldikçe kimin reklam göreceğine giderek daha az siz karar veriyorsunuz. Algoritma kimi arayacağını, kendisine tarif edilen başarıya bakarak seçiyor. Bu tarifi piksel olayları yapıyor.

Değer ve para birimi olmadan gönderilen bir Purchase olayı, 200 liralık siparişle 4.000 liralık siparişi aynı sayar. Meta bu yüzden Purchase olayında value ve currency parametrelerini zorunlu tutuyor. Bu alanlar eksik kalırsa değer bazlı optimizasyonun dayanağı kalmaz. ROAS (reklamdan gelen cironun reklam harcamasına oranı) da anlamını yitirir.

Sayım hatası daha sinsi bir sorundur. Teşekkür sayfası her yenilendiğinde yeniden tetiklenen bir Purchase olayı, satışı olduğundan fazla gösterir. Algoritma şişkin rakamı başarı sanır ve bütçeyi o kreatife, o kitleye kaydırır. Raporda ROAS yükselir ama sipariş panelindeki ciro yerinde sayar.

Kitleler de aynı veriye dayanır. Satın alanları kampanyadan hariç tutmak için önce satın alanın doğru kaydedilmesi gerekir. Katalog reklamı kullanıyorsanız ViewContent, AddToCart ve Purchase olaylarında ürün kimliği (content_ids ya da contents) isteniyor. Bu kimlik katalogdaki kimlikle eşleşmezse dinamik reklam ziyaretçiye baktığı ürünü gösteremez.

Meta Pixel adım adım nasıl kurulur ve doğrulanır?

Başlamadan önce sitenin koduna ya da e-ticaret altyapınızın yönetim paneline erişebildiğinizden emin olun. Markanın kendi işletme portfolyosunda da yetkili bir hesabınız olmalı. Portfolyo henüz yoksa önce İşletme Yöneticisi kurulumu ve yetkilendirme rehberindeki adımları tamamlayın.

1. Pikseli markanın portfolyosunda oluşturun

Olay Yöneticisi (Events Manager) içinde yeni bir web veri kaynağı açın, pikseli adlandırın ve site adresini girin. Pikseli ajansın ya da serbest çalışanın kendi portfolyosunda açtırmayın. Biriken veri, pikselin bağlı olduğu portfolyoda kalır.

2. Temel kodu her sayfanın head bölümüne ekleyin

Temel kodu izlemek istediğiniz her sayfanın HTML başlık alanına, yani head bölümüne ekleyin. Sitenin kalıcı başlık alanını kullanmak, kodun tarayıcı ya da başka bir yazılım tarafından engellenme ihtimalini azaltıyor. Etiket yöneticisiyle kurulum da çalışır ancak Meta doğrudan kurulumu öneriyor. Yalnızca img etiketiyle kurulumu ise önermiyor. Ayrı bir mobil siteniz varsa kodu oraya da ekleyin.

Hazır bir e-ticaret altyapısı kullanıyorsanız kodu elle yapıştırmadan önce altyapının Meta entegrasyonuna bakın. Tema dosyasına kod yapıştırıp bir de entegrasyonu açarsanız aynı sayfada iki piksel kodu çalışabilir.

3. Ölçeceğiniz olayları seçin ve parametreleriyle ekleyin

Önce listeyi yazın. Kampanyayı hangi olaya optimize edeceğinize kod yazılmadan karar verin. Meta satın alma olayını onay sayfası yüklendiğinde ya da ödeme butonuna tıklandığında tetiklemenize izin veriyor. Onay sayfası daha güvenli bir seçimdir, çünkü butona tıklama ödeme reddedildiğinde de gerçekleşir. Tutarı Türk lirası olan bir siparişi aşağıdaki çağrıyla gönderebilirsiniz.

fbq('track', 'Purchase', {value: 1249.90, currency: 'TRY', content_ids: ['SKU-123'], content_type: 'product'})

Meta’nın kendi örnek kodunda para birimi USD yazıyor. Kopyalanıp düzeltilmeden bırakılan bu satır, Türk lirası siparişleri dolar gibi raporlatır. Para birimini satışı yaptığınız ülke belirlemez. Tutar hangi para birimindeyse currency alanına onun kodunu yazarsınız.

4. Gelişmiş eşleştirmeyi açın

Gelişmiş eşleştirme, olaya e-posta ve telefon gibi müşteri bilgilerini ekler ve Meta’nın olayı doğru kişiyle eşleştirmesine yardım eder. Otomatik sürümünü Olay Yöneticisi’ndeki piksel ayarlarından açarsınız, kod değişikliği gerekmez. Elle kurulumda müşteri bilgilerini fbq('init') çağrısının üçüncü parametresine aktarırsınız. Bu bilgileri sitenizdeki değişkenlerden de sağlayabilirsiniz.

Biçim önemlidir. E-posta küçük harfle, telefon yalnızca rakamla ve ülke koduyla gider. Türkiye’deki bir numara 90 ile başlar. Ülke alanına iki harfli küçük kodla “tr” yazılır. E-postayı düz metin verirseniz piksel onu Meta’ya göndermeden önce SHA-256 ile özetler. Bu işlem geri çözülebilen bir şifreleme sayılmaz.

5. Tarayıcı tarafını Meta Ads Data Advisor ile kontrol edin

Eski adı Pixel Helper olan eklenti artık Meta Ads Data Advisor adıyla Chrome ve Edge’de çalışıyor. Kontrolü aşağıdaki sırayla yapın.

1. Pikselin kurulu olduğu sayfayı açın ve o site için reklam engelleyiciyi kapatın.
2. Eklenti simgesine tıklayın.
3. Test etmek istediğiniz eylemi yapın, örneğin sepete ürün ekleyin.
4. Pikselin algılandığını ve beklenen olayın başarılı göründüğünü kontrol edin.
5. Hata ya da uyarı varsa önerilen düzeltmeye bakın.

Eklenti olayın durumunu Active, Warning, Inactive ya da Error olarak gösterir. Yinelenen olayları ve value, currency, content_ids gibi eksik parametreleri hata olarak işaretleyebilir. Kod yerleşimini ve iframe ya da etiket yöneticisi kaynaklı engelleri siz ayrıca kontrol edin. Buton tıklamasıyla tetiklenen olaylar, sayfayı yenilemiyorsa eklentide her zaman görünmeyebilir. Bunları Test Olayları sekmesinde doğrulayın.

6. Meta’nın gerçekte ne aldığını Olay Yöneticisi’nde görün

Eklenti tarayıcıda ne olduğunu söyler. Meta’ya neyin ulaştığını ise Olay Yöneticisi gösterir. Pikselli bir sayfayı açtıktan sonra yeni bir PageView olayı görmeniz gerekir. Görünmezse birkaç dakika bekleyip sayfayı yenileyin. Test Olayları sekmesi olayları neredeyse anlık listeler. Sunucu olaylarını burada görmek için Meta’nın ürettiği test kodunu test_event_code alanıyla gönderirsiniz. Meta bu alanın yalnızca test için kullanılmasını istiyor. Testten sonra kodu canlı gönderimden çıkarın.

7. Dönüşüm API’si de varsa tekilleştirmeyi doğrulayın

Aynı satın alma hem tarayıcıdan hem sunucudan gelirse Meta’nın onu tek olay sayması gerekir. Bunun için pikseldeki eventID alanı ile sunucudaki event_id alanı aynı olay için aynı değeri taşımalı, olay adları da birebir eşleşmeli. eventID değeri fbq('track') çağrısına doğrudan dördüncü argüman olarak yazılmaz. Dördüncü argümana aşağıdaki gibi eventID alanını içeren bir nesne eklersiniz.

fbq('track', 'Purchase', {value: 1249.90, currency: 'TRY'}, {eventID: 'siparis-123'})

Meta aynı kimliği taşıyan olayları ilk olaydan sonraki 48 saat içinde birleştirir. Sunucu tarafında bir sınır daha var. event_time gönderim anından en fazla yedi gün eski olabilir. Daha eski bir olay içeren isteği Meta bütünüyle reddeder.

8. Rakamı sipariş sistemiyle karşılaştırın

Bir hafta boyunca Olay Yöneticisi’ndeki Purchase sayısını ve toplam değeri sipariş panelinizdeki rakamlarla yan yana koyun. İki tarafta aynı tarih aralığını ve aynı sipariş statülerini kullanın. İptal edilen siparişleri panelde düşüp Meta’da saymaya devam ederseniz fark kendiliğinden büyür. Çerezi reddeden ziyaretçiler ve reklam engelleyiciler yüzünden de sayılar farklı çıkabilir. Farkın nedenini açıklayabildiğiniz sürece kurulumu kabul edebilirsiniz.

Meta’daki sayı sipariş sayısını aşıyorsa önce çift sayımı ve yanlış yerde tetiklenen Purchase olaylarını araştırın. Kampanyaya bütçe eklemeden önce bu sorunu çözün. Meta’nın kendi ürettiği sayfalarda ölçümün nasıl kayabileceğini yapay zekâ açılış sayfası testi yazısında ayrıca ele alınıyor.

Türkiye’de piksel kurarken KVKK ve çerez onayı neyi değiştirir?

Meta Pixel Türkiye’deki reklamverenlere de aynı araçlarla açık. Kurulumu farklılaştıran hukuki çerçevedir. KVK Kurumunun Çerez Uygulamaları Hakkında Rehberi, davranışsal reklamcılık için kullanılan çerezleri açık rıza gerektiren çerezler arasında sayıyor. Rehberin görüşe açılan taslağı da aynı çizgideydi. Taslakta sepet, oturum açma ve güvenlik çerezleri gibi kesinlikle gerekli çerezler bu yükümlülüğün dışında kalıyordu. Reklam ve takip amaçlı sosyal eklenti çerezleri bu istisnaya girmiyordu. Önceden işaretlenmiş kutular rıza sayılmıyor, açık rıza gerektiren çerezlerin yönetim panelinde ilk görünümde kapalı durması bekleniyordu. Bu taslak ayrıntılarının son metindeki karşılığını resmî rehberden kontrol edin.

Rehber çerezleri konu alır ve piksel gibi benzer teknolojiler için ayrıca yönlendirme yapmaz. Bize göre bundan pikselle ilgili açık bir kural çıkıyor. Reklam çerezleri kullanan bir Meta Pixel kurulumunda açık rıza gerektiren çerezleri onaydan önce çalıştırmayın. Piksel üzerinden yapılan diğer veri işlemlerinin hukuki dayanağını da ayrıca değerlendirin.

Etiket yöneticisi kullanıyorsanız piksel etiketini pazarlama çerezi onayına bağlayın. Doğrudan kurulumda da çerez yönetim aracınızın pikseli onaydan sonra yüklediğini Data Advisor’la kontrol edin. Onay penceresini reddettiğiniz bir oturumda eklenti piksel görmemeli.

Onay şartı tarayıcıdan gelen sinyali azaltır. Bu kaybın bir kısmını Dönüşüm API’siyle telafi etmeye çalışırken sunucu tarafındaki veri gönderiminin hukuki dayanağını da ayrıca netleştirin. Bu yazı hukuki görüş yerine geçmez. Aydınlatma metninizi ve çerez kurgunuzu hukukçunuzla birlikte kurun.

Türkiye’ye özgü bir ayrıntı daha var. Meta şehir alanının küçük harfle ve boşluksuz yazılmasını istiyor ancak Türkçe karakterlerin nasıl normalize edileceğini belgede açıkça yazmıyor. Bu alanı kullanmadan önce eşleşme sonucunu Olay Yöneticisi’nde izleyin.

Sağlık ve finans gibi hassas alanlarda çalışıyorsanız özel dönüşümlere ayrıca dikkat edin. Meta, kurallarına aykırı bilgi içerdiğini belirlediği özel dönüşümleri işaretleyebiliyor. 2 Eylül 2025’ten itibaren bu durum API’de is_unavailable alanıyla da bildiriliyor. İşaretlenen özel dönüşüm, yeni kampanya oluştururken kullanılamıyor. Yayına çıkmış bir kampanyada özel dönüşümü değiştiremediğiniz için çözüm, kampanyayı kopyalayıp işaretlenmemiş bir dönüşüm seçmek oluyor. Klinik ya da kredi danışmanlığı sitesinde sayfa adreslerine ve özel olay adlarına hastalık ya da borç bilgisi yazmayın.

Görüşümüz

Piksel kurulumu bir pazarlama kararıdır. Hangi olayı hangi değerle göndereceğiniz, algoritmaya başarının neye benzediğini tarif eder. Yazılımcıya “pikseli kur” deyip geçen marka, bu tarifi kodu yapıştıran kişinin tahminine bırakır.

Bize göre kurulum olay listesiyle başlamalı. Satın alma değeri ve para birimiyle gider. Ürün kimliği katalogdaki kimlikle aynıdır. Kampanyanın hangi olaya optimize edileceğini kod yazılmadan önce kâğıda yazın. Algoritma sepete ekleme olayıyla beslenirse sepete ekleyen insan bulur. Satın alma ve değerle beslenirse kasaya para bırakan insanı arar.

Data Advisor’daki yeşil işaret, kodun tetiklendiğini gösterir. Kodun doğru şeyi saydığı ise bir haftalık Purchase sayısı sipariş panelinin yanına konduğunda anlaşılır. Meta’daki sayı siparişi aşıyorsa o hesaba bütçe eklemeyin.

Çerez onayı tarayıcı sinyalini azaltıyor. Bunu kabul etmek gerekir. Onay penceresini kullanıcıyı “kabul et”e iten bir tasarımla süslemeyin. Sunucudan göndermeye hukuken dayanağınız olan olayları Dönüşüm API’siyle iletin ve tarayıcı olaylarıyla tekilleştirin. Bu, kaybın tamamını geri getirmez. Herkesin aynı otomatik ayarlarla yarıştığı açık artırmada rakibinden temiz veri gönderen marka, kendi müşterisini algoritmaya daha net tarif eder.

Küçük işletmede kural esner. Haftada birkaç sipariş alan bir sitede ilk iş, altyapının hazır entegrasyonuyla pikseli ve değerli bir satın alma olayını kurmaktır. Dönüşüm API’si için dış destek almayı ondan sonra düşünmek yeterli. Dönüşüm API’sini eklemeden önce satın alma olayının para birimini düzeltin.

42kraft

Piksel kurulumunda hangi hatalar veriyi sessizce bozar?

Çift kod, ilk bakılacak kurulum hatalarından biridir. Tema dosyasına elle yapıştırılmış piksel ile altyapının Meta entegrasyonu birlikte çalışıyorsa bazı olaylar iki kez gönderilebilir. Data Advisor yinelenen olayları hata olarak gösterebilir. Kodlardan birini kaldırmadan kampanya kurmayın.

Satın alma olayının yanlış yere bağlanması da sık görülür. Ödeme butonuna bağlanan olay, kart reddedildiğinde de satış sayar. Onay sayfasına bağlanan olay ise sayfa yenilendiğinde yeniden tetiklenebilir. Altyapınız izin veriyorsa olayı her sipariş için bir kez gönderin ve sipariş numarasını eventID olarak kullanın.

Para birimi hatası kolay gözden kaçar. Örnek koddan kalan USD ya da hiç gönderilmeyen currency, ROAS’ı ve değer bazlı optimizasyonu baştan bozar. Kurulumdan sonra Olay Yöneticisi’nde bir test siparişinin değerini ve para birimini kendi gözünüzle görün.

Dönüşüm API’sini tekilleştirme olmadan eklemek, aynı satın almanın hem tarayıcıdan hem sunucudan sayılmasına yol açabilir. Rapor birden iyileşir ve bu iyileşme bütçe artışına gerekçe yapılır. Sunucu entegrasyonunu açtığınız hafta Meta’daki satın alma sayısı belirgin biçimde arttıysa önce pikseldeki eventID ile sunucudaki event_id değerlerini kontrol edin.

Data Advisor’ın her hatayı yakaladığını varsaymayın. Temel kodun yerleşimini ve canlı gönderimde test_event_code kalıp kalmadığını ayrıca inceleyin. Aynı sayfada birden fazla olay görmek tek başına hata sayılmaz. Meta, buton tıklaması gibi farklı kullanıcı eylemleriyle tetiklenen ek olaylara izin veriyor. İlk kontrolü eklentiyle yapın. Sonucu Test Olayları sekmesi ve gerçek sipariş kayıtlarıyla doğrulayın.

Kurulumu bir kez yapıp bırakmak da veriyi bozar. Tema güncellemesi, yeni bir ödeme adımı ya da çerez aracının değişmesi pikseli habersizce bozabilir. Purchase sayısını sipariş paneliyle her ay yan yana koyun. Rakamlar ayrıştığında kampanyaya dokunmadan önce kurulumu açıp bakın.