Meta Pixel ölçümü yalnızca bir kod parçacığı eklemekten ibaret değildir. Bu rehberde standart olayları doğru tetiklemeyi, Conversions API ile ölçümü güçlendirmeyi ve Events Manager’da doğrulama yapmayı adım adım bulabilirsiniz.
Meta piksel kurulumu, reklam hesabına bir kod ekleyip unutulacak teknik bir işlem değildir. Doğru olay tanımı yapılmadığında kampanya öğrenmesi, raporlama ve yeniden hedefleme listeleri eksik sinyallerle çalışır. Bu rehber, Meta Pixel ile Conversions API’yi birlikte kullanarak ViewContent, AddToCart ve Purchase gibi olayları daha sağlıklı ölçmek isteyen işletmeler için hazırlanmıştır.
Kampanya yapısı, hedefleme ve kreatif ayrı bir planlama konusudur. Burada odağımız ölçüm altyapısıdır: hangi olay ne zaman tetiklenir, hangi parametreler gönderilir, sunucu tarafı veri nasıl eşleştirilir ve Events Manager’da kurulum nasıl doğrulanır?
Meta piksel kurulumu neden yalnız kod eklemek değildir?
Pixel tarayıcı tarafında çalışır; ziyaretçi sayfayı açtığında veya bir eylem yaptığında Meta platformuna olay gönderir. Conversions API ise sunucu tarafında çalışan bir bağlantıdır ve sipariş, form, üyelik veya sepet gibi olayları doğrudan sisteminizden iletmeyi sağlar.
Tarayıcı tarafında çerez tercihleri, reklam engelleyiciler, bağlantı kesintileri ve sayfa yapısı gibi etkenler ölçümü etkileyebilir. CAPI bu etkileri azaltmaya yardımcı olur; fakat kullanıcı tercihlerini veya izin yönetimi süreçlerini geçersiz kılan bir yöntem değildir. Doğru yaklaşım, tarayıcı ve sunucu sinyallerini aynı ölçüm planında birleştirmektir.
KepezWeb olarak bu kurulumu üç katmanda ele alırız: olayın iş hedefi, teknik tetikleme noktası ve doğrulama süreci. Bu üçlü netleşmeden yapılan kurulumlarda reklam panelinde veri görünse bile karar almak zorlaşır.
- İş hedefi: Satın alma mı, teklif formu mu, sepete ekleme mi ölçülecek?
- Tetikleme noktası: Olay sayfa açılışında mı, başarılı işlemden sonra mı çalışacak?
- Doğrulama: Olay Events Manager’da doğru parametrelerle görünüyor mu?
Kurulum öncesi ölçüm planını çıkarın
Teknik kuruluma başlamadan önce hangi olayların hangi sayfalarda ve hangi veriyle gönderileceği belirlenmelidir. Bu plan, geliştirici, reklam yöneticisi ve işletme tarafının aynı dili konuşmasını sağlar.
| Olay | Ne zaman tetiklenmeli? | Önemli parametreler | Sık hata |
|---|---|---|---|
| PageView | Her sayfa görüntülemesinde | Sayfa URL’si, kaynak sayfa bilgisi | Tek sayfa uygulamalarda rota değişiminde çalışmaması |
| ViewContent | Ürün veya detay içeriği görüntülendiğinde | content_ids, content_type, value, currency | Kategori sayfasında ürün detayı gibi tetiklenmesi |
| AddToCart | Ürün sepete başarıyla eklendiğinde | content_ids, contents, value, currency, num_items | Buton tıklanınca işlem başarılı olmadan çalışması |
| Purchase | Ödeme onayı veya sipariş kaydı tamamlandığında | value, currency, contents, order_id, event_id | Sayfa yenilenince aynı satın almanın tekrar gönderilmesi |
| Lead | Form başarıyla gönderildiğinde | Form türü, sayfa, müşteri adayı kategorisi | Form hata verdiği halde lead olayı oluşması |
Ölçüm planına URL yapısı, ürün kimlikleri, sepet veri kaynağı, ödeme başarı sayfası, form başarı mesajı ve izin yönetimi davranışı eklenmelidir. Böylece reklam panelinde görünen olayların sitedeki gerçek işlemlerle uyumu kontrol edilebilir.
Web sitesinde Meta Pixel temel kurulum adımları
- Events Manager içinde işletmeye ait veri kaynağını oluşturun ve doğru reklam hesabıyla ilişkilendirin.
- Base Pixel kodunu site genelinde çalışan alana ekleyin. Etiket yöneticisi kullanılıyorsa tüm sayfalarda tetiklenen temel etiket kurgulanmalıdır.
- Alan adı doğrulama, hesap erişimleri ve veri kaynağı izinlerini kontrol edin.
- Standart olayları ölçüm planındaki sayfa ve eylemlere göre ayrı ayrı tanımlayın.
- Ürün kataloğu kullanılıyorsa sitedeki ürün ID’leri ile katalogdaki ID’lerin aynı mantıkta olduğundan emin olun.
- Canlı ortamdan önce test ortamında veya kontrollü senaryolarda olayların doğru çalıştığını doğrulayın.
Bir e-ticaret sitesi için en kritik nokta, ürün ve sipariş verisinin reklam olaylarına tutarlı biçimde taşınmasıdır. Sepette görünen tutar, ödeme sonrası sipariş tutarı ve Purchase olayındaki value alanı farklı kaynaklardan geliyorsa raporlar yorumlanamaz hale gelir.
Özel yazılmış sitelerde tek sayfa uygulama, AJAX sepet, modal form veya üçüncü taraf ödeme yönlendirmesi gibi yapılar ayrıca incelenmelidir. Bu yapılarda klasik sayfa yüklenmesine bağlı kurulumlar eksik olay üretebilir.
Standart olayları doğru tetikleme: ViewContent, AddToCart, Purchase
ViewContent: Ürün verisi hazır olduğunda çalışmalı
ViewContent olayı, ziyaretçi ürün detayını gerçekten görüntülediğinde tetiklenmelidir. Olay, ürün bilgileri yüklenmeden çalışırsa content_ids veya value gibi alanlar boş gidebilir. Katalog reklamları kullanıyorsanız content_ids değerinin katalogdaki ürün kimliğiyle eşleşmesi özellikle önemlidir.
AddToCart: Buton tıklaması değil, başarılı ekleme ölçülmeli
AddToCart olayını yalnızca sepete ekleme işlemi başarılı olduğunda göndermek gerekir. Stok hatası, varyasyon seçilmemesi veya teknik hata nedeniyle ürün sepete eklenmediyse olay tetiklenmemelidir. Aksi halde reklam sistemi, satın alma niyeti oluşmamış eylemleri sepet sinyali olarak okuyabilir.
Sepete eklenen ürünün ID’si, adet bilgisi, para birimi ve değer alanı mümkün olduğunca net gönderilmelidir. Çoklu ürün ekleme, paket ürün veya varyasyonlu ürünlerde contents alanının doğru modellenmesi ölçüm kalitesini artırır.
Purchase: Yalnızca tamamlanan sipariş için gönderilmeli
Purchase olayı ödeme onayı veya sipariş kaydı tamamlandığında çalışmalıdır. Ödeme sayfasına gelmek, ödeme butonuna basmak veya banka ekranına yönlenmek tek başına Purchase değildir. Başarısız ödeme, iptal edilen işlem veya hata sayfası satın alma olayı üretmemelidir.
Tekrarlı Purchase verisi en sık görülen sorunlardan biridir. Teşekkür sayfası yenilendiğinde aynı olay tekrar gidiyorsa sipariş ID’si ve event_id kontrolüyle tekrar gönderim engellenmelidir. Sunucu tarafında da aynı siparişin ikinci kez iletilmemesi için işlem durumu kontrol edilmelidir.
Conversions API ile tarayıcı kısıtlamalarını azaltma
Conversions API, web sitenizde gerçekleşen olayların sunucu üzerinden Meta platformuna iletilmesini sağlar. Pixel ile birlikte kullanıldığında tarayıcı tarafında kaçabilecek bazı sinyaller desteklenir. Ancak CAPI, Pixel’in yerine otomatik olarak geçmez; doğru yapılandırmada ikisi birlikte çalışır.
En önemli konu olay eşleştirme ve tekilleştirmedir. Aynı satın alma hem tarayıcıdan hem sunucudan gönderiliyorsa Meta tarafında bunun tek işlem olarak anlaşılması gerekir.
- Tarayıcı ve sunucu olayında aynı event_name kullanılmalıdır.
- Her işlem için benzersiz event_id üretilmeli ve iki tarafta aynı değer gönderilmelidir.
- Sunucu olayındaki zaman, değer ve para birimi gerçek işlemle uyumlu olmalıdır.
- İzin verilen alanlarda e-posta veya telefon gibi eşleştirme verileri normalize edilip hashlenerek iletilmelidir.
- Başarısız ödeme, test siparişi veya iptal edilmiş işlem sunucu tarafından Purchase olarak gönderilmemelidir.
Hazır altyapılarda partner entegrasyonları kullanılabilir; özel geliştirilmiş sistemlerde ise ödeme, sepet, CRM veya ERP akışlarına göre entegrasyon planlanır. Bu noktada yazılım geliştirme desteği, reklam ölçümünü gerçek iş süreçleriyle uyumlu hale getirmek için önemlidir.
KepezWeb projelerinde CAPI genellikle ödeme, sipariş ve müşteri adayı akışıyla birlikte planlanır. Böylece reklam ölçümü yalnızca panelde çalışan bir etiket değil, işletmenin veri akışına bağlı bir altyapı haline gelir.
Events Manager’da test ve doğrulama kontrol listesi
Kurulumdan sonra ilk bakılacak yer Events Manager’dır. Burada olayların gelip gelmediği, hangi kaynaktan geldiği, parametre eksikleri ve olası uyarılar görülebilir. Test aşamasında yalnızca olay adı değil, olayın doğru anda ve doğru veriyle tetiklenip tetiklenmediği kontrol edilmelidir.
- Test Events: Ürün görüntüleme, sepete ekleme, form gönderme ve satın alma senaryolarını test edin.
- Diagnostics: Eksik parametre, tekrarlı olay veya eşleştirme uyarılarını inceleyin.
- Event Match Quality: Sunucu tarafı olaylarda eşleştirme alanlarının yeterli olup olmadığını değerlendirin.
- Deduplication: Pixel ve CAPI aynı olayı gönderiyorsa event_id ile tekilleştirme çalışıyor mu kontrol edin.
- Tarayıcı kontrolü: Etiket yöneticisi, ağ istekleri ve tarayıcı eklentileriyle olayın gerçekten gönderildiğini doğrulayın.
Pratik bir test senaryosu şu sırayla ilerleyebilir: ürün detayına girin, sepete ekleyin, ödeme adımına geçin, başarılı sipariş oluşturun, teşekkür sayfasını yenileyin ve başarısız ödeme senaryosunu deneyin. Bu akışta ViewContent, AddToCart ve Purchase olaylarının yalnızca doğru adımlarda çalışması beklenir.
KepezWeb’in sosyal medya reklamları çalışmalarında ölçüm kontrolü, kampanya yayına çıkış sürecinin teknik parçası olarak ele alınır. Çünkü hatalı veriyle başlayan kampanyalarda sonraki optimizasyon kararları da zayıflar.
Sıkça Sorulan Sorular
Meta Pixel ile Conversions API aynı anda kullanılmalı mı?
Birçok projede birlikte kullanmak daha sağlıklı bir ölçüm yapısı sağlar. Önemli olan aynı olayın iki kez sayılmaması için event_id ile tekilleştirme yapılmasıdır.
Purchase olayı hangi sayfada çalışmalı?
Purchase yalnızca ödeme onaylandıktan veya sipariş başarıyla oluştuktan sonra çalışmalıdır. Ödeme adımına gelmek veya ödeme butonuna basmak Purchase için yeterli değildir.
AddToCart butona tıklayınca mı tetiklenmeli?
Hayır. AddToCart, ürün sepete gerçekten eklendiğinde tetiklenmelidir. Buton tıklanmış ama işlem hata vermişse olay gönderilmemelidir.
Events Manager’da olay görünmüyorsa ne kontrol edilmeli?
Base Pixel kodu, etiket tetikleyicileri, tarayıcı izinleri, consent davranışı, ağ istekleri ve sunucu yanıtları kontrol edilmelidir. CAPI kullanılıyorsa sunucu logları ve event_id alanı da incelenmelidir.
Birden fazla Pixel kullanmak doğru mu?
Aynı sitede birden fazla Pixel ancak net bir hesap sahipliği ve ölçüm amacı varsa kullanılmalıdır. Kontrolsüz çoklu Pixel kurulumu raporlamayı ve hata ayıklamayı zorlaştırabilir.
Ölçümü netleştirip reklam kararlarını güçlendirin
Meta piksel kurulumu ve Conversions API için site yapınızı, olay planınızı ve doğrulama adımlarınızı birlikte değerlendirmek istiyorsanız KepezWeb ekibinden destek alabilirsiniz. Ölçüm altyapınızı netleştirmek için teklif alın formunu doldurun; ihtiyaçlarınıza göre uygulanabilir bir yol haritası hazırlayalım.
