Meta Pixel ve Dönüşüm API'si (CAPI) nedir, nasıl kurulur?

Doğru ölçüm, Meta reklamlarının temelidir: platform hangi reklamın satış getirdiğini bilemezse, satış odaklı kampanyalar kime reklam göstereceğini öğrenemez. Bu yazıda iki aracı, neden birlikte kullanıldıklarını ve Shopify ile WooCommerce'te nasıl kurulduklarını anlatıyoruz. Arayüz adları yazım anındaki (Ekim 2026) hâline göre genel tarif edilmiştir.

Meta Pixel nedir?

Meta Pixel, sitene yerleştirilen ve ziyaretçinin yaptığı eylemleri olay (event) olarak Meta'ya gönderen bir JavaScript kodudur. Meta'nın Meta Pixel yardım sayfası aracı ayrıntılı anlatır.

E-ticarette en sık kullanılan standart olaylar:

• PageView: Sayfa görüntüleme.
• ViewContent: Ürün sayfası görüntüleme.
• AddToCart: Sepete ekleme.
• InitiateCheckout: Ödeme adımını başlatma.
• Purchase: Satın alma; tutar ve para birimiyle birlikte gönderilmelidir.

Piksel, bu olaylarla üç iş yapar: reklamların sonuçlarını ölçer, satın alma gibi olaylar için optimizasyonu besler ve siteni ziyaret edenlerden yeniden hedefleme kitleleri oluşturmanı sağlar.

Dönüşüm API'si (CAPI) nedir?

Dönüşüm API'si, olayları ziyaretçinin tarayıcısı yerine senin sunucundan ya da mağaza platformundan doğrudan Meta'nın sunucularına gönderen bir entegrasyon yöntemidir. Sunucudan sunucuya iletildiği için tarayıcıda çalışan reklam engelleyicilerden, çerez kısıtlarından ve sayfanın yarıda kapanması gibi durumlardan etkilenmez.

CAPI ayrıca tarayıcının göremeyeceği olayları da iletebilir: örneğin ödemesi sonradan onaylanan bir sipariş ya da telefonla tamamlanan bir satış.

Meta Pixel ve Dönüşüm API'si neden birlikte kullanılmalı?

Piksel ve Dönüşüm API'si birlikte kullanılmalıdır, çünkü her biri diğerinin kör noktasını kapatır. Piksel tarayıcıdaki davranışı ve tarayıcıya özgü bilgileri iyi yakalar; CAPI ise tarayıcı kısıtlarından etkilenmeden güvenilir bir ikinci kanal sağlar.

Tarayıcı tarafı ölçüm son yıllarda zorlaştı:

• Reklam engelleyiciler piksel kodunun çalışmasını engelleyebilir.
• Tarayıcıların üçüncü taraf çerez ve izleme kısıtları kullanıcıyı tanımayı zorlaştırır.
• iOS'taki uygulama izleme izni (App Tracking Transparency), kullanıcı izin vermediğinde uygulamalar arası izlemeyi sınırlar; bu da Facebook ve Instagram uygulamalarından gelen ziyaretçilerin ölçümünü etkiler.

Bu kısıtlar nedeniyle yalnızca piksele dayanan bir kurulum, satışların bir kısmını Meta'ya hiç bildiremeyebilir. Shopify'ın veri paylaşımı yardım sayfası da bunu açıkça belirtir: tarayıcı tabanlı reklam engelleyiciler pikselin veri paylaşmasını durdurabilir, sunucudan sunucuya gönderilen olaylar ise bu engelleyicilerden etkilenmez.

Olay tekilleştirme (deduplication) nasıl çalışır?

Olay tekilleştirme, aynı olayın hem pikselden hem Dönüşüm API'sinden gelen iki kopyasının tek olay olarak sayılmasıdır; Meta bunu olay adı ve olay kimliği eşleştiğinde yapar. Tekilleştirme kurulmazsa her satın alma iki kez sayılabilir ve raporların gerçekte olduğundan iyi görünür.

Meta'nın tekilleştirme dokümantasyonuna göre önerilen yöntem şöyle çalışır:

1. Aynı olay adı: Pikseldeki olay adı (ör. Purchase) ile CAPI'deki event_name aynı olmalı.
2. Aynı olay kimliği: Pikseldeki eventID ile CAPI'deki event_id aynı olmalı. Genellikle sipariş numarası ya da her olay için üretilen benzersiz bir kimlik kullanılır.
3. Zaman aralığı: Aynı piksel kimliği için, aynı event_id ile gelen ikinci olay belirli bir süre içinde (dokümantasyonda 48 saat) gelirse mükerrer kabul edilip atılır.

Örnek: Müşteri 10482 numaralı siparişi tamamladı. Tarayıcıdaki piksel Purchase olayını eventID: "order_10482" ile, sunucun da event_name: "Purchase" ve event_id: "order_10482" ile gönderir. Meta iki olayı eşleştirir ve bir satış sayar.

Eşleşme kalitesi neden önemli?

Dönüşüm API'si ile gönderilen olaylara, Meta'nın olayı doğru kişiyle eşleştirebilmesi için müşteri bilgileri (ör. e-posta, telefon) karma (hash) biçiminde eklenir. Olay Yöneticisi'nde her olay için bir eşleşme kalitesi göstergesi bulunur. Daha iyi eşleşme, daha çok satışın doğru reklama atfedilmesi demektir. Bu veriyi paylaşırken gizlilik politikanın ve yürürlükteki veri koruma mevzuatının (Türkiye'de KVKK) gereklerini karşıladığından emin ol.

Meta Pixel ve Dönüşüm API'si nasıl kurulur?

Kurulum, mağaza altyapına göre değişir; hazır bir e-ticaret platformu kullanıyorsan resmî entegrasyon en kolay ve en az hatalı yoldur. Genel akış şöyledir:

1. Olay Yöneticisi'nde bir veri kümesi (piksel) oluştur ve işletme portföyüne bağla.
2. Alan adını doğrula. İşletme portföyündeki marka güvenliği bölümünden sitenin alan adını doğrulamak, olay yapılandırmasını yönetmeni sağlar.
3. Pikseli siteye ekle. Platform entegrasyonu, etiket yöneticisi ya da elle kodla.
4. Dönüşüm API'sini bağla. Platform entegrasyonu, iş ortağı entegrasyonu ya da kendi sunucundan doğrudan entegrasyonla.
5. Tekilleştirmeyi kur. Her olayda tarayıcı ve sunucu tarafının aynı olay adını ve olay kimliğini gönderdiğinden emin ol.
6. Satın alma olayına değer ekle. value (tutar) ve currency (para birimi) olmadan ROAS hesaplanamaz.
7. Test et. Olay Yöneticisi'ndeki test olayları aracıyla sitede gerçek bir akış dene.

Shopify'da nasıl kurulur?

Shopify'da kurulum, Facebook ve Instagram satış kanalı uygulaması üzerinden yapılır. Uygulamayı kurup Meta hesabını, işletme portföyünü ve pikseli bağladıktan sonra veri paylaşımı ayarından bir seviye seçersin. Shopify yardım sayfasına göre üç seviye vardır:

• Standart: Yalnızca Meta pikseli kullanılır.
• Gelişmiş: Piksel ve Dönüşüm API'si birlikte kullanılır; satın alma olayları sunucudan sunucuya gönderilir ve eşleşme için müşteri bilgileri paylaşılır.
• Maksimum: Piksel ve Dönüşüm API'si birlikte, Meta'nın güncel reklam teknolojisiyle güncellenmiş biçimde kullanılır.

Ölçüm kaybını azaltmak için Standart yerine Dönüşüm API'sini içeren seviyelerden birini tercih etmek mantıklıdır. Temada elle eklenmiş eski bir piksel kodu varsa, olayların iki kez gönderilmemesi için onu kaldırmayı unutma.

WooCommerce'te nasıl kurulur?

WooCommerce'te resmî yol, "Meta for WooCommerce" uzantısıdır. Uzantının dokümantasyonuna göre piksel kurulumunu destekler ve Dönüşüm API'si kutudan çıktığı gibi entegre gelir. Uzantıyı kurup Meta hesabını bağladıktan sonra Olay Yöneticisi'nde olayların hem tarayıcıdan hem sunucudan geldiğini ve tekilleştirildiğini kontrol et. Aynı anda başka bir piksel eklentisi kullanıyorsan çakışmayı önlemek için yalnızca birini açık bırak.

Piksel kurulumunda en sık yapılan hatalar nelerdir?

En sık hata, aynı pikseli birden fazla yoldan kurmaktır: temaya elle eklenmiş kod, bir eklenti ve platform entegrasyonu aynı anda çalıştığında olaylar iki ya da üç kez gönderilir. Tekilleştirme yalnızca tarayıcı ile sunucu kopyalarını eşleştirmek için tasarlanmıştır; aynı tarayıcıdan iki kez gelen olaylar raporları bozabilir.

Diğer yaygın hatalar:

• Purchase olayının teşekkür sayfası yenilendikçe tekrar tetiklenmesi: Müşteri sayfayı yenilediğinde ya da geri döndüğünde aynı satış yeniden sayılabilir. Olay kimliği olarak sipariş numarasını kullanmak bu riski azaltır.
• Yanlış para birimi: Türk lirası satışın başka bir para birimiyle gönderilmesi, gelir ve ROAS raporlarını anlamsız kılar.
• Tutarın tutarsız gönderilmesi: Bir yerde kargo dahil, bir yerde hariç tutar göndermek, mağaza ile reklam paneli arasında açıklanamayan farklar yaratır.
• Ödeme sayfasının farklı alan adında olması: Ödeme adımı başka bir alan adına geçiyorsa olayların orada da tetiklendiğini kontrol et.
• Test olaylarının canlı veriye karışması: Kurulum denemelerini test olayları aracıyla yap; gerçek siparişlerle karışmasın.
• Çerez onayı akışını unutmak: Sitende çerez onayı kullanıyorsan, pikselin onay tercihlerine uygun çalıştığından emin ol.

Bu hataların ortak sonucu aynıdır: reklam paneli gerçeği yansıtmaz ve bütçe kararları yanlış veriye dayanır. Kampanyayı büyütmeden önce ölçümü düzeltmek, sonradan kaybedilecek bütçeden çok daha ucuzdur.

Kurulum doğru mu, nasıl kontrol edilir?

Kurulumun doğruluğu, sitende gerçek bir alışveriş akışı deneyip olayların Olay Yöneticisi'ne doğru adla, doğru değerle ve tek kez düştüğünü görerek kontrol edilir.

Kontrol listesi:

• Her olay geliyor mu? ViewContent, AddToCart, InitiateCheckout ve Purchase.
• Purchase olayında tutar ve para birimi doğru mu? Kargo dahil mi, hariç mi; tutarlı mı?
• Olaylar hem tarayıcıdan hem sunucudan geliyor ve tekilleştiriliyor mu?
• Eşleşme kalitesi makul mü?
• Mağazadaki sipariş sayısı ile Meta'daki satın alma sayısı kabaca örtüşüyor mu? Tam eşitlik beklenmez, ama büyük fark bir sorunun işaretidir.

Ölçüm oturduktan sonra ROAS ve CPA gibi metrikler anlam kazanır; bunları ROAS nedir, nasıl hesaplanır rehberinde anlattık. 14ads gibi reklam araçları da raporlarındaki satış ve gelir verisini bu olaylardan okur; bağlantılar hakkında bilgi için entegrasyonlar sayfasına bakabilirsin.

Özet

• Meta Pixel olayları tarayıcıdan, Dönüşüm API'si sunucudan Meta'ya gönderir; ikisi birlikte kurulmalıdır.
• Reklam engelleyiciler, çerez kısıtları ve iOS izin ayarları yalnızca piksele dayanan ölçümde satış kaybına yol açar.
• Tekilleştirme için piksel ve CAPI aynı olay adını ve aynı event_id'yi göndermelidir.
• Shopify'da Facebook ve Instagram uygulamasında Dönüşüm API'sini içeren veri paylaşımı seviyesini, WooCommerce'te Meta for WooCommerce uzantısını kullan.
• Purchase olayına mutlaka tutar ve para birimi ekle ve kurulumu Olay Yöneticisi'nin test aracıyla doğrula.