Ölçüm · Meta Pixel · Conversions API

Meta Pixel ve Conversions API: fark ne, ikisini birlikte nasıl kurmalı?

Kısa cevap

Pixel olayı ziyaretçinin tarayıcısından, Conversions API aynı olayı sitenizin sunucusundan Meta'ya yollar. Meta ikisini birlikte kullanmanızı öneriyor. Bunun bir şartı var: iki taraf aynı olayı aynı event_id ile göndermeli ki Meta 48 saat içinde gelen kopyayı ayıklayabilsin. Bu eşleşme yoksa her satış iki kez yazılır ve panel olduğundan iyi görünür.

Ulaş Gökhan GümüşKurucu, İnovatif360 · 17 Ekim 2026 · 5 dk okuma

Pixel nerede kör kalır?

Pixel, sitenize eklenen küçük bir JavaScript kodu. Biri sayfanıza girdiğinde, sepete ürün attığında ya da ödemeyi tamamladığında bunu tarayıcıdan Meta'ya haber veriyor. Yıllarca reklam sistemlerinin öğrendiği sinyalin neredeyse tamamı bu yoldan geldi.

Sorun, bütün yükün tarayıcının sırtında olması. Teşekkür sayfası yüklenmeden sekme kapanırsa, mobil bağlantı o saniye koparsa, tarayıcı çerezleri kısıtlarsa olay yola hiç çıkmaz. Meta da dokümanında yeni veri aktarım kısıtlamalarının çerezlerin ve Pixel'in etkinliğini sınırlayabileceğini açıkça yazıyor9. Para kasaya girer ama reklam sistemi o satışı görmez; bir sonraki alıcıyı eksik bilgiyle aramaya devam eder.

Conversions API neyi değiştirir?

Conversions API aynı olayı sunucunuzdan, doğrudan Meta'ya yollar1. Sipariş sunucuda oluştuğu anda bilgi çıkar; müşterinin tarayıcısında o an ne olduğu önemli değildir. Meta'ya göre bu kanal, bağlantı sorunları ya da sayfa yükleme hataları yüzünden Pixel'in kaçırabileceği olayları taşıyabilir2.

Conversions API'yi "reklam engelleyicileri delen" bir araç gibi anlatan çok içerik var; Meta'nın dokümanlarında böyle bir vaat yok. Elinize geçen şey daha sıradan ve daha değerli: ikinci, daha sağlam bir veri yolu.

İki yol, tek olayTarayıcı yolunda yedi sinyalden ikisi, sekme kapandı ve çerez kısıtı noktalarında sönüyor. Sunucu yolunda yedi sinyal de kesintisiz gidiyor. İki yol Meta tarafında event_id eşleşmesi kapısında birleşiyor.tarayıcısekme kapandıçerez kısıtısunucuevent_ideşleşiyormu?
Şekil 1İki yol, tek olay. Tarayıcı yolunda bazı sinyaller sekme kapandı ve çerez kısıtı noktalarında söner; sunucu yolu kesintisiz akar. İki yol Meta'da event_id eşleşmesi kapısında birleşir.
Grafik verisini tablo olarak göster
İki yolun karşılaştırması
YolSinyalKesinti nedeni
Tarayıcı7 sinyalden 5'i ulaşıyorsekme kapandı · çerez kısıtı
Sunucu7 sinyalin 7'si ulaşıyor—
Meta kapısıiki yol event_id eşleşmesinde birleşir48 saat penceresi

Neden ikisi birden?

Meta'nın önerisi net: Conversions API'yi Pixel'in yerine değil, yanına koyun ve aynı olayları iki araçla da gönderin2. Buna yedekli kurulum deniyor. Tarayıcı yakalarsa iyi, kaçırırsa sunucu yakalar. İkisi de yakalarsa Meta kopyayı ayıklar; yeter ki ayıklayabileceği bir işaret bırakmış olun.

Yalnız Pixel'e güvenmek sinyal kaybını kabullenmek demek. Yalnız sunucuya güvenmek de tarayıcının taşıdığı bazı bağlam bilgilerini masada bırakmak. En eksiksiz resim, ikisi doğru eşlendiğinde ortaya çıkar.

Aynı satış iki kez sayılırsa

Yedekli kurulumun bir bedeli var: aynı satın alma Meta'ya iki kez ulaşır. Meta'nın ikisini tek olay sayması için iki şey eşleşmeli3. Pixel'deki eventID ile Conversions API'deki event_id aynı olmalı; olay adı da iki tarafta aynı olmalı, ikisinde de Purchase gibi.

Pencere 48 saat. Kopya bu sürenin içinde gelirse ayıklanır3. event_id kullanamadığınız durumlar için Meta ikinci bir yol da tanımlıyor: olay adıyla birlikte fbp ya da external_id değerini iki taraftan tutarlı göndermek3.

Eşleşme kurulmamışsa ne olur? Her satış iki kez yazılır, paneldeki ROAS şişer ve bütçe gerçekte olmayan bir başarıya göre artırılır. Bunun kâr tarafındaki sonucunu ROAS yazımızda hesapladık.

event_id eşleşiyor

tarayıcısunucukapı1

Meta sayacı 1: iki olay tek satış sayılır.

event_id yok

tarayıcısunucukapı22

Meta sayacı 2: aynı satış iki kez yazılır.

48 saat penceresi · örnek kimlik A-1042

Şekil 2Tekilleştirme kapısı. event_id eşleşirse tarayıcı ve sunucu olayı kapıda birleşir, Meta sayacı 1 gösterir; eşleşme yoksa iki olay ayrı geçer ve sayaç 2 olur. Pencere 48 saat.

Sahada en sık takıldığımız üç yer

Bir hesabı incelemeye aldığımızda sorun nadiren tek bir yerde çıkıyor. En sık üç yerde takılıyoruz.

Birincisi satın alma değeri. Meta, Purchase olayında value ve currency'yi zorunlu alan sayar; currency, ISO 4217'deki üç harfli kodla (TRY) gider410. Değer burada üç iş görür: olayın kurala uygun sayılması, değere göre optimizasyon (value, değer optimizasyonu kullanan her olayda da zorunlu)10 ve ROAS raporu. Değer eksikse olay panelde görünse bile kampanya hangi satışın daha değerli olduğunu öğrenemez; ROAS da anlamını yitirir. Değerin hiç gitmediği, hep aynı sabit sayının gittiği ya da KDV ve kargonun bir yerde dahil bir yerde hariç gittiği kurulumlarla sık karşılaşıyoruz.

İkincisi satın almanın kendisi: eksik gönderilmesi, çift gönderilmesi ya da reklam ve analitik tarafında farklı sayılması.

Üçüncüsü huninin önceki adımları. AddToCart, InitiateCheckout ve Purchase birbirinden farklı mantıkla kurulduğunda, parametreleri birbirini tutmadığında huni okunamaz hale gelir; satın alma sayısı sepete eklemeden fazla bile görünebilir. Bu yüzden yalnız son dönüşüm sayısına bakmıyoruz; transaction_id ve event_id'yi, value ve currency'yi, ürün verisini birlikte kontrol ediyoruz.

Hazır entegrasyon mu, sıfırdan kurulum mu?

Meta üç yol tanır: doğrudan API entegrasyonu, bir ortak (partner) entegrasyonu ve Conversions API Gateway97. Gateway, Events Manager'dan kod yazmadan kurulur; ama işletmenin kendi AWS ya da GCP hesabında çalışır, maliyeti de bulut kaynakları ya da ortak ücretleridir7.

Bizim varsayılanımız, mevcut yapıyı kopyalamak yerine kurulumu sitenin olay mimarisine göre sıfırdan ve doğrulanabilir biçimde yapmak. Dokümantasyonu ve veri akışı açık, güvenebildiğimiz platformlarda (Shopify'ın kendi Meta bağlantısı gibi) yerleşik entegrasyonu kullanıyoruz; yine de tarayıcı ve sunucu olaylarını, eşleşmeyi ve tekilleştirmeyi tek tek test ediyoruz. Hazır entegrasyonun güven vermediği ya da ihtiyacı karşılamadığı projelerde server-side GTM'e ya da altyapıya uygun özel bir kuruluma geçiyoruz. Araç ikinci soru. İlk soru, kurulumun denetlenebilir olup olmadığı.

Her durumda temel kural aynı: Pixel ve CAPI çiftinin event_name ve event_id ile tekilleştiğini doğrulamak; tema kodu, uygulama ve etiket yöneticisi gibi farklı kurulumların aynı olayı kontrolsüz biçimde tekrar göndermesine izin vermemek. Shopify'ın kendi yardım sayfası da temaya elle eklenen Pixel kodunun yinelenen ya da yanlış raporlamaya yol açabileceği konusunda uyarıyor8.

Kurulumu, doğrulamayı ve kayıtlarla karşılaştırmayı tek iş olarak ele alıyoruz; kapsamı ölçüm altyapısı hizmetimizde anlatıyoruz.

Meta, olayın kime ait olduğunu nasıl anlar?

Sunucudan gelen bir olayın kampanyaya yaraması için Meta'nın onu bir kişiyle eşleştirebilmesi gerekir. Events Manager her olay için 10 üzerinden bir Event Match Quality puanı gösterir2. Puanı belirleyen, olayla birlikte giden müşteri bilgisi.

E-posta, telefon, ad ve soyad SHA-256 ile özetlenerek gider; telefon ülke koduyla yazılır5. IP adresi, tarayıcı bilgisi (user agent), fbp ve fbc ise özetlenmeden gönderilir; web olaylarında tarayıcı bilgisi zorunludur5. external_id ve event_id'nin tüm olaylarda bulunması öneriliyor2.

Hangi bilginin hangi ziyaretçi için gönderileceği, sitenizin rıza kurgusuna bağlı. Bu, kurulumdan önce verilmesi gereken bir karar.

Müşteri bilgisi alanları, kaynakları ve özetlenip özetlenmedikleri
AlanNeredenNasıl gider
E-postaformdanSHA-256 ile özetlenir
TelefonformdanSHA-256 ile özetlenir
Ad ve soyadformdanSHA-256 ile özetlenir
IP adresiistektenözetlenmez
User agentistektenözetlenmez
fbp · fbcçerezdenözetlenmez
Şekil 3Bilgi nereden gelir, nasıl gider? Formdan gelen üç alan SHA-256 ile özetlenir; istekten ve çerezden gelen dört alan özetlenmeden gider.

Çalıştığını varsaymayın, görün

Test Events aracı bir test kodu üretir; bu kodla gönderilen olaylar yaklaşık 20 dakika içinde ekrana düşer6. Overview ekranı her olayın hangi yoldan geldiğini, tarayıcıdan mı sunucudan mı yoksa ikisinden mi olduğunu gösterir6.

Bir olayın Events Manager'da görünmesini kurulumu tamamlamak için yeterli saymıyoruz. Olayın hangi kanaldan geldiğini, tekilleşip tekilleşmediğini ve bir haftalık adet ile değer toplamının sipariş kayıtlarıyla ilişkisini birlikte kontrol ediyoruz. Meta'nın haftalık sayısı belirgin biçimde büyükse çift sayma, belirgin biçimde küçükse sinyal kaybı arıyorsunuz. Üç platformun neden hiçbir zaman birebir tutmayacağını platform farkı yazımızda ayrıca anlattık.

Belirtiden nedene

Belirti ve önce bakılacak yer
Panelde gördüğünüzÖnce bakılacak yer
Meta’daki satış, sipariş kayıtlarından belirgin biçimde fazlaevent_id eşleşmesi; temada ikinci Pixel kodu; teşekkür sayfasının yenilenmesi
Meta’daki satış belirgin biçimde azSunucu olayları gidiyor mu; Test Events’te bağlantı yöntemi
ROAS anlamsız ya da sabitPurchase’ta value ve currency; değerin KDV/kargo tanımı
Satın alma, sepete eklemeden fazlaAddToCart ve InitiateCheckout olaylarının kurulumu
Eşleşme kalitesi düşükSunucu olayında e-posta/telefon (özetlenmiş), IP, user agent, fbp, fbc var mı

Panelinizdeki satış sipariş kayıtlarınızla tutmuyorsa sorun kampanyada değil, sinyalde olabilir.
GA4, GTM ve Conversions API kurulumunu teşhis edip düzeltiyoruz.

Ölçüm altyapısını inceleyin

Kaynaklar

  1. Meta for Developers — Conversions API
  2. Meta for Developers — Conversions API: Best Practices
  3. Meta for Developers — Handling Duplicate Pixel and Conversions API Events
  4. Meta for Developers — Meta Pixel: Reference
  5. Meta for Developers — Customer Information Parameters
  6. Meta for Developers — Conversions API: Using the API
  7. Meta for Developers — Conversions API Gateway
  8. Shopify Help Center — Meta pixel
  9. Meta for Developers — Conversions API End-to-End Implementation
  10. Meta for Developers — Conversions API: Standard Parameters (custom_data)
Ulaş Gökhan Gümüş

İnovatif360 Dijital Pazarlama ve AI Otomasyon Ajansı ile Gökhan Gümüş Akademi'nin kurucusu. Acunmedya Akademi Dijital Bölüm Başkanı; 2021'den bu yana yapay zeka destekli dijital reklamcılık ve e-ticaret eğitimleri veriyor.