- Meta, aynı olayların hem Pixel hem Conversions API ile gönderildiği yedekli kurulumu öneriyor.
- Tekilleştirme için iki tarafta olay adı ve olay kimliği birebir aynı olmalı; eşleşme 48 saatlik pencerede yapılıyor.
- Sunucu olayları en fazla 7 gün geriye dönük gönderilebilir; tek bir eski olay tüm isteği düşürür.
- Olay Eşleşme Kalitesi 10 üzerinden puanlanır; e-posta ve telefon gibi bilgiler SHA256 ile şifrelenerek gönderilir.
Reklam panelinde 40 satış görüyorsunuz, e-ticaret panelinizde 55 sipariş var. Ya da tam tersi: Meta, gerçekte olandan fazla satış raporluyor. Bu farkın en yaygın nedeni ölçümün yalnızca tarayıcıya bırakılmasıdır. Meta Pixel, ziyaretçinin tarayıcısında çalışan bir koddur. Sayfa tam yüklenmezse, bağlantı koparsa ya da tarayıcı kodu engellerse olay Meta'ya hiç ulaşmaz. Meta'nın kendi çözümü Conversions API'dir. Ancak bu API'yi Pixel'in yanına eklemek yeni bir risk doğurur: aynı satışın iki kez sayılması. Bu yazıda Meta'nın geliştirici dokümanına dayanarak sistemin nasıl çalıştığını ve tekilleştirmenin nasıl kurulduğunu sade bir dille anlatıyoruz.
Pixel nerede yetersiz kalıyor?
Pixel, sitenize eklenen ve ziyaretçinin tarayıcısında çalışan bir JavaScript kodudur. Sepete ekleme, ödeme başlatma veya satın alma gibi olayları tarayıcıdan Meta'ya iletir. Bu yapının zayıf noktası, her şeyin ziyaretçinin cihazında olup bitmesidir.
Meta'nın önerilen uygulamalar (best practices) sayfası bunu açıkça söylüyor: Conversions API, ağ bağlantısı veya sayfa yükleme sorunları nedeniyle Pixel'in kaçırdığı web sitesi olaylarını yakalayabilir. Buna ek olarak, reklam engelleyiciler ve tarayıcıların gizlilik ayarları da üçüncü taraf kodlarının çalışmasını kısıtlayabilir. Sonuçta Pixel bazı olayları hiç göremez.
Bir de tarayıcının hiç olmadığı olaylar var. Telefonla gelen sipariş, mağazada kapanan satış, CRM'de nitelikli hale gelen bir müşteri adayı. Pixel bunları hiçbir zaman göremez. Meta'ya göre Conversions API bu tür çevrimdışı olayları da taşıyabilir.
Conversions API nedir, ne değildir?
Conversions API, pazarlama verisini tarayıcı yerine sizin sunucunuzdan, e-ticaret altyapınızdan, uygulamanızdan veya CRM sisteminizden doğrudan Meta'ya gönderen bir bağlantıdır. Meta'nın genel bakış sayfasına göre web sitesi, uygulama, işletme mesajlaşması ve çevrimdışı olaylar aynı bağlantı üzerinden gönderilebilir.
Sunucudan gelen olaylar, Pixel'den gelen olaylarla benzer şekilde ölçüm, raporlama ve reklam optimizasyonunda kullanılır. Yani Conversions API ayrı bir reklam ürünü değil, aynı ölçüm sistemine giden ikinci bir yoldur.
Conversions API, Pixel'in yerine geçmek için değil, yanında çalışmak için tasarlandı. Meta'nın önerilen uygulamalar (best practices) sayfası, Satın Alma, Ödeme Başlatma ve İletişim gibi aynı olayların hem Pixel hem Conversions API ile gönderildiği yedekli kurulumu öneriyor.
Kurulum için yeni bir hesap gerekmez. Meta'nın başlangıç rehberine göre sitenizde zaten bir Pixel varsa, tarayıcı ve sunucu olayları için aynı Pixel kimliğini kullanmalısınız. Erişim belirteci (access token) Etkinlik Yöneticisi üzerinden oluşturulabilir. Pixel kullanan işletmeler için Meta, Etkinlik Yöneticisi'nden kod yazmadan ve kurulum ücreti ödemeden bağlantı seçeneği de sunuyor. Meta'nın dokümanı, entegrasyon yöntemlerinin gereken emek, maliyet ve özellikler bakımından farklılaştığını da hatırlatıyor.
Çift sayım sorunu: tekilleştirme nasıl çalışır?
Yedekli kurulumun bir bedeli var. Bir müşteri satın alma yaptığında Pixel bir Purchase olayı, sunucunuz da bir Purchase olayı gönderir. Meta bunların aynı satış olduğunu anlayamazsa raporunuzda iki satış görürsünüz. Algoritma da gerçekte olmayan dönüşümlere göre öğrenmeye başlar. Bunu önleyen işleme tekilleştirme (deduplication) denir.
Önerilen yöntem: olay adı ve olay kimliği
Meta'nın tekilleştirme sayfasına göre iki olayın eşleşmesi için iki koşul birlikte sağlanmalı. Birincisi, Pixel'deki eventID değeri, sunucudaki event_id değeriyle aynı olmalı. İkincisi, Pixel'deki olay adı, sunucudaki event_name ile aynı olmalı. Pixel tarafında eventID, fbq izleme çağrısının dördüncü bağımsız değişkeni olarak gönderilir.
Pratikte bu şu demek: sipariş tamamlandığında siteniz benzersiz bir kimlik üretir, örneğin sipariş numarası. Aynı kimlik hem tarayıcıdaki Pixel çağrısına hem de sunucunun Meta'ya gönderdiği isteğe eklenir. Olay adları da harfi harfine aynı olmalı; bir tarafta Purchase, diğer tarafta purchase yazmak eşleşmeyi bozar.
Hangi olay tutulur? Tekilleştirme sayfasına göre iki sürüm arasında anlamlı bir içerik farkı yoksa Meta genellikle ilk ulaşan olayı tutar. Sunucu olayı parametreleri sayfası ise iki olay birbirine yaklaşık beş dakika içinde ulaşırsa tarayıcı olayının tercih edildiğini belirtiyor.
Alternatif yöntem: fbp veya external_id
İkinci yöntemde olay adının yanında fbp çerezi veya external_id değeri iki tarafta tutarlı gönderilir. Bu yöntemin sınırları var. Yalnızca önce tarayıcı, sonra sunucu sırasıyla çalışır. Önceki 48 saat içinde eşleşen bir tarayıcı olayı gelmemişse sunucu olayı atılmaz; tarayıcı olayı sonradan gelse bile. Ayrıca aynı kaynaktan gelen iki olayı tekilleştirmez. Meta bu nedenle olay kimliği yöntemini öneriyor; önerilen uygulamalar (best practices) sayfası mümkünse tüm anahtarların birlikte gönderilmesini tavsiye ediyor.
Sunucu olaylarında sık yapılan teknik hatalar
Tekilleştirme doğru kurulsa bile sunucu tarafında gözden kaçan birkaç kural, verinin tamamen reddedilmesine yol açabilir.
- event_time, saniye cinsinden ve GMT'ye göre bir Unix zaman damgası olmalı. Bir istekteki herhangi bir olay 7 günden eskiyse tüm istek başarısız olur ve hiçbir olay işlenmez.
- action_source zorunludur. Web sitesi olaylarında event_source_url ve client_user_agent da zorunlu.
- E-posta (em) ve telefon (ph) bilgileri SHA256 ile şifrelenmeden gönderilmemeli. Şifrelemeden önce e-posta küçük harfe çevrilir ve boşluklar temizlenir; telefon numarası ülke koduyla ve semboller atılarak yazılır.
- fbp ve fbc çerez değerleri, IP adresi ve tarayıcı bilgisi ise şifrelenmeden gönderilir. Tarayıcı olaylarında bunlar otomatik eklenir, sunucu olaylarında sizin eklemeniz gerekir.
- Meta, olayların gerçekleştiği anda veya ona yakın gönderilmesini öneriyor; dokümana göre bu, kampanyaların daha iyi sonuç almasına yardımcı olabilir. Gerçek zamanlı ya da gerçek zamana yakın toplu gönderim mümkün.
Müşterilerinize ait e-posta, telefon ve IP adresi gibi verileri şifrelenmiş olsa da bir reklam platformuna aktarıyorsunuz. Aydınlatma metni, açık rıza ve yurt dışına aktarım gibi konularda kişisel verilerin korunması mevzuatı açısından hukuk danışmanınızın görüşünü alın.
Kurulumun işe yarayıp yaramadığını nasıl anlarsınız?
Meta, Etkinlik Yöneticisi'nde ve Dataset Quality API üzerinden kurulum kalitesini gösteren birkaç ölçüt sunuyor. Bunları bilmek, ajansınızın veya yazılımcınızın yaptığı kurulumu denetlemenizi kolaylaştırır.
Olay Eşleşme Kalitesi, sunucudan gönderdiğiniz müşteri bilgilerinin olayları bir Meta hesabıyla eşleştirmede ne kadar etkili olabileceğini gösterir. Puan; hangi parametrelerin gönderildiğine, bunların kalitesine ve eşleşen olay oranına göre hesaplanır. Meta'nın önerilen uygulamalar (best practices) sayfasına göre yalnızca eşleşen olaylar atıf ve reklam dağıtım optimizasyonunda kullanılabiliyor; eşleşmeyenler temel ölçümle sınırlı kalıyor.
Olay kapsamı ise Pixel olaylarının ne kadarının Conversions API ile de gönderildiğini ve tekilleştirme anahtarlarını paylaştığını gösteren 7 günlük ortalama bir yüzdedir. Meta'nın dokümanı, kapsamı yüzde 75 eşiğinin altında kalan olaylar için kapsamı artırmanın getireceği ek dönüşümlerin izlenmesini öneriyor.
Bir diğer ölçüt, Ek Raporlanan Dönüşümler (ACR) adını taşıyor. Bu metrik, Conversions API kurulumunuz sayesinde ölçülebilen ek dönüşüm sayısını tahmin ediyor. Yani yedekli kurulumun size gerçekte ne kazandırdığını sayıyla görmenizi sağlıyor. Veri tazeliği ölçütü de olayın gerçekleşmesiyle Meta'ya ulaşması arasındaki gecikmeyi gösteriyor.
Ne yapmalı? Adım adım kontrol listesi
- Etkinlik Yöneticisi'nde sitenizdeki Pixel kimliğini not edin. Conversions API için de aynı kimliği kullanın.
- Altyapınıza uygun yöntemi seçin: Etkinlik Yöneticisi'nden kodsuz kurulum, e-ticaret platformunuzun iş ortağı entegrasyonu veya yazılımcınızla manuel kurulum.
- Satın Alma, Ödeme Başlatma, Sepete Ekleme ve Potansiyel Müşteri gibi kritik olayları hem Pixel hem sunucu üzerinden gönderin.
- Her olay için benzersiz bir kimlik üretin ve bunu iki tarafa da ekleyin. Olay adlarının harfi harfine aynı olduğunu kontrol edin.
- Sunucu olaylarına action_source, event_source_url, client_user_agent, IP adresi, fbp ve fbc değerlerini ekleyin; e-posta ve telefonu normalize edip SHA256 ile şifreleyin.
- Olayları gerçek zamanlıya yakın gönderin. 7 günden eski olay göndermeyin.
- Kurulumdan sonra Etkinlik Yöneticisi'nde olayların tekilleştirildiğini, Olay Eşleşme Kalitesi puanını ve olay kapsamını birkaç gün boyunca izleyin.
Bu adımlar teknik görünse de sonucu doğrudan bütçenize yansır. Eksik ölçüm, iyi çalışan bir reklamı kapatmanıza; çift sayım ise kötü çalışan bir reklama para akıtmanıza yol açabilir. Arkan Medya olarak reklam hesabı denetimlerinde ilk baktığımız yer de çoğu zaman bu ölçüm katmanıdır.
Kaynaklar
Aşağıdaki bağlantılar yazıdaki rakam ve iddiaların dayandığı kaynaklardır; yazı 29 Ekim 2026 itibarıyla hazırlanmıştır. Platform politikaları ve resmî düzenlemeler değişebilir; karar vermeden önce güncel hâlini kaynağından kontrol edin.
- Meta for Developers: Conversions API genel bakış
- Meta for Developers: Pixel ve sunucu olaylarının tekilleştirilmesi
- Meta for Developers: Conversions API önerilen uygulamalar (best practices)
- Meta for Developers: Sunucu olayı parametreleri
- Meta for Developers: Dataset Quality API
- Meta for Developers: Müşteri bilgisi parametreleri
- Meta for Developers: Conversions API ile başlarken