05 Eyl 2026 · 5 dk okuma · Lunor Medya · Güncelleme 20 Kas 2026
Meta Pixel ve Conversions API Kurulum Kontrol Listesi: Olay Planından Doğrulamaya
Piksel ve Conversions API kurulumunu sırayla yapmak için kontrol listesi: olay planı, parametreler, event_id ile tekilleştirme, alan adı doğrulama ve test adımları.
Ölçüm kurulumu çoğu zaman "kodu siteye ekledik" diye tamamlanmış sayılır; sorunlar ise haftalar sonra raporlar tutmayınca fark edilir. Bu kontrol listesi, Meta Pixel ve Conversions API kurulumunu planlama, uygulama ve doğrulama aşamalarına ayırarak her adımda neyin kontrol edileceğini gösteriyor. Kavramların kendisini merak ediyorsanız önce Meta Pixel ve Conversions API nedir yazısını okuyabilirsiniz.
Aşama 1: Hazırlık
- Varlık sahipliği: Piksel (Meta arayüzünde veri kümesi olarak da geçer), reklam hesabı ve alan adı işletmenin kendi işletme portföyünde olmalı. Ajans veya geliştiriciye yalnızca erişim verilmeli.
- Tek piksel ilkesi: Aynı site için birden fazla eski piksel varsa hangisinin kullanılacağına karar verin. Farklı kodların aynı olayı farklı piksellere göndermesi raporları böler.
- Erişimler: Site yönetim paneline, etiket yönetim aracına ve gerekiyorsa sunucuya erişimi olan kişiyi belirleyin.
- Çerez onay yapısı: Sitede bir çerez onay aracı varsa piksel ve sunucu tarafı olayların onay durumuna göre nasıl davranacağını baştan planlayın.
Aşama 2: Olay planı
Koda dokunmadan önce hangi olayların, hangi anda ve hangi bilgilerle gönderileceğini bir tabloya yazın. Örnek bir e-ticaret planı:
| Olay | Tetiklendiği an | Parametreler |
|---|---|---|
| ViewContent | Ürün sayfası açıldığında | content_ids, content_type, value, currency |
| AddToCart | Sepete ekle tıklandığında ve işlem başarılı olduğunda | content_ids, value, currency |
| InitiateCheckout | Ödeme sayfası açıldığında | value, currency, num_items |
| Purchase | Sipariş onaylandığında (bir kez) | value, currency, content_ids, order_id |
Hizmet işletmesi için plan daha kısa olabilir: iletişim sayfası görüntüleme, form gönderimi (Lead) ve randevu (Schedule). Önemli kural, olayın kullanıcı eylemi başarıyla tamamlandığında tetiklenmesidir; butona tıklanması değil, formun gerçekten gönderilmesi sayılmalıdır.
Aşama 3: Piksel kurulumu
- Temel kodu tüm sayfalarda, sayfa başına bir kez yükleyin (doğrudan, eklentiyle veya etiket yönetim aracıyla; ama yalnızca bir yöntemle).
- Olay planındaki standart olayları ekleyin; standart adlar varken özel ad uydurmayın.
- Parametrelerin dinamik geldiğinden emin olun: tutar sabit "0" ya da her üründe aynı olmamalı, para birimi doğru kodla (TRY) gönderilmeli.
- Teşekkür sayfası yenilendiğinde Purchase olayının tekrar tetiklenmediğini kontrol edin.
Aşama 4: Conversions API kurulumu
- Yöntemi seçin: Altyapınıza göre doğrudan API entegrasyonu, platform eklentisi, sunucu tarafı etiket yönetimi veya iş ortağı entegrasyonu. Laravel veya özel yazılım kullanan sitelerde doğrudan entegrasyon genellikle en çok kontrolü sağlar.
- Erişim belirteci: API için oluşturulan erişim belirtecini kodun içine açık biçimde yazmayın; sunucu ortam değişkenlerinde saklayın ve yalnızca gerekli kişilerle paylaşın.
- Müşteri bilgisi parametreleri: E-posta, telefon, ad gibi bilgileri Meta'nın belirttiği biçimde normalize edip SHA-256 ile karma (hash) uygulayarak gönderin. IP adresi, tarayıcı bilgisi (user agent) ve tarayıcıdaki Meta çerez değerleri (fbp, fbc) varsa ekleyin; bunlar eşleşme kalitesini artırır.
- event_source_url ve action_source: Olayın hangi sayfada ve hangi kanalda (web sitesi) gerçekleştiğini belirtin.
Aşama 5: Tekilleştirme
- Aynı olay hem pikselden hem sunucudan gidiyorsa her ikisinde de aynı olay adı ve aynı event_id kullanılmalı.
- event_id her olay için benzersiz olmalı; satın almada sipariş numarası iyi bir temel olur.
- event_id tarayıcıda üretiliyorsa sunucuya, sunucuda üretiliyorsa sayfaya aktarılmalı; iki tarafın ayrı ayrı rastgele kimlik üretmesi tekilleştirmeyi bozar.
Aşama 6: Alan adı ve hesap ayarları
- Alan adını işletme portföyünde doğrulayın (DNS kaydı, HTML dosyası veya meta etiketiyle).
- Web olaylarının önceliklendirilmesi ve iOS kaynaklı ölçüm kısıtlamalarıyla ilgili gereklilikler zaman içinde değişti; Events Manager'da güncel durumda hâlâ bir yapılandırma istenip istenmediğini kontrol edin.
- Kampanyada optimize edilecek olayın veri kümesinde aktif ve düzenli geldiğinden emin olun.
Aşama 7: Doğrulama
- Test olayları: Events Manager'daki test aracıyla siteye girip her olayı elle tetikleyin; hem tarayıcı hem sunucu olaylarının geldiğini görün.
- Tarayıcı eklentisi: Meta'nın piksel yardımcı eklentisiyle sayfada hangi olayların çalıştığını ve hata olup olmadığını kontrol edin.
- Tekilleştirme kontrolü: Olay ayrıntılarında tarayıcı ve sunucu olaylarının tekilleştirildiğine dair göstergeye bakın.
- Parametre kontrolü: Tutar, para birimi ve ürün kimliklerinin doğru geldiğini birkaç gerçek sipariş üzerinden doğrulayın.
- Karşılaştırma: Bir hafta sonra Meta'daki satın alma sayısını kendi sipariş sisteminizle kıyaslayın. Birebir eşleşme beklenmez, ama büyük ve açıklanamayan farklar bir sorun olduğunu gösterir.
Kurulum sonrası
Kurulum tamamlandıktan sonra ortaya çıkan eşleşme kalitesi, eksik veya çift olay ve onay sorunlarını Meta piksel ve Dönüşüm API'si sorun giderme yazısında ele aldık. Sunucu tarafı entegrasyon için geliştirme desteği gerekiyorsa özel yazılım geliştirme, kampanya tarafı için Meta Ads reklam yönetimi sayfalarına göz atabilirsiniz.
İlgili hizmetler