WooCommerce Meta Pixel ve Conversions API Kurulumu (2026 Rehberi)

Kısa Cevap

WooCommerce sitesinde, tarayıcıda çalışan Meta Pixel'i ve olayları sunucudan gönderen Conversions API'yi (CAPI) kurmanın resmi yolu Meta'nın Meta for WooCommerce eklentisidir (eski adıyla Facebook for WooCommerce). Eklenti Meta varlıklarınıza bağlandığında CAPI ek ayar gerektirmeden çalışır; aynı olayın tarayıcı ve sunucu kopyaları ortak bir olay kimliğiyle (event_id) tek olay sayılır. Çift sayımı önlemek için Meta olaylarını yalnızca bu eklenti göndermeli; başka piksel eklentileri, tema kodları ve Google Tag Manager'daki (GTM) Meta etiketleri kapatılmalıdır. Kurulumu gerçek bir test siparişiyle doğrulayın. Ajans reklam hesabı kullanıyorsanız eklentiyi markanızın işletme portföyüne (birçok rehberde Business Manager diye geçer) bağlayıp olayların biriktiği veri setini ajansla partner olarak paylaşın.

Meta for WooCommerce ile Adım Adım Kurulum

WooCommerce.com'daki eklenti dokümanı artık güncellenmiyor; eklentiyi WordPress dizininden kurun ve sürüm gereksinimlerini sitenizle karşılaştırın. Meta'nın kurulum makalesine göre WordPress'te yönetici rolü, işletme portföyünde tam kontrol ya da ilgili varlıkları yönetme izni ve iki adımlı doğrulama gerekiyor. Menü adlarını İngilizce arayüze göre veriyoruz; Türkçe panelde çevrilmiş görünebilirler.

1. WordPress panelinde Plugins > Add New Plugin ekranında Meta for WooCommerce'i aratın; Install Now'a, kurulum bitince Activate'e tıklayın.
2. Marketing > Facebook yolunu izleyin, Get started ile Facebook hesabınıza giriş yapın.
3. İşletme portföyünü, Facebook Sayfasını, Instagram profilini, kataloğu, reklam hesabını ve Meta Pixel'i seçin ya da oluşturun. Meta'ya göre Pixel'in topladığı olaylar bir veri setinde düzenlenir.
4. Mağaza bilgilerini girip WooCommerce ile Meta arasındaki bağlantıyı yetkilendirin.

Meta'ya göre Conversions API eklentiye yerleşiktir ve kurulumla otomatik devreye girer; ayrı bir erişim anahtarı adımı tarif edilmiyor.

Tek Kaynak İlkesi: event_id ile Tekilleştirme

Pixel ve CAPI aynı olayı birlikte gönderdiğinde her satın alma Meta'ya iki kopya hâlinde ulaşır. Meta'nın tekilleştirme belgesine göre tarayıcıdaki eventID ile sunucudaki event_id ve olay adları aynıysa, kopyalar ilk olaydan sonraki 48 saat içinde geldiğinde tek olay sayılır.

Eklenti aynı event_id değerini iki kanala da kendisi ekler: güncel kaynak koduna göre PageView, ViewContent, Search, AddToCart, InitiateCheckout ve Purchase bu şekilde gidiyor (liste sürüme göre değişebilir). Eklenti dışındaki ikinci bir Meta kaynağının olayları bu değerleri taşımadığından aynı satın alma iki kez raporlanabilir. WordPress'te bu kaynak şunlar olabilir:

• Hâlâ etkin olan başka bir Meta piksel eklentisi.
• Tema ayarlarına ya da bir header/footer kod eklentisine yapıştırılmış piksel kodu.
• GTM'de yayında kalan Meta Pixel etiketi.
• Events Manager'dan kodsuz kurulan CAPI Gateway gibi ikinci bir sunucu çözümü. Meta, Pixel'i CAPI destekli bir e-ticaret partneri yönetiyorsa o partneri kullanmayı öneriyor; Meta for WooCommerce varken ayrıca sunucu çözümü kurmayın.

Geçişte önce bunları kapatıp önbelleği temizleyin, sonra eklentiyi bağlayın. Başka bir çözümde kalacaksanız eklentinin Pixel ve CAPI gönderimini birlikte kapatmalısınız: WooCommerce dokümanında verilen ve güncel kaynak kodunda da bulunan facebook_for_woocommerce_integration_pixel_enabled filtresini bir geliştiriciye uygulatın.

Test Siparişiyle Doğrulama ve Eşleşme Puanı

1. Events Manager'da eklentinin bağlandığı veri setini seçip Test events sekmesine geçin.
2. Site adresinizi yazıp Open website ile açın; Meta'ya göre bu ekran web etkinliğini yalnızca sayfa açıkken listelediği için sekmeyi kapatmayın.
3. Eklentinin kaynak koduna göre mağazayı yönetme yetkisi olan kullanıcıların siparişlerinde web Purchase olayı gönderilmez; bu yüzden oturumu kapalı ya da gizli bir pencerede ürün, sepet ve ödeme adımlarını gezip küçük tutarlı gerçek bir sipariş verin.
4. Tarayıcıdan gelen Purchase olayının işlendiğini ya da tekilleştirildiğini kontrol edin. Meta iki kopyadan önce ulaşanı tuttuğu için tarayıcı kopyasının tekilleştirilmiş görünmesi hata değildir.

Eklentinin güncel kaynak koduna göre sunucu istekleri test kodu (test_event_code) taşımıyor; Meta'nın Conversions API belgesine göre sunucu olayları Test events'te ancak bu kodla görünür. Yani Server events bölümünün boş kalması tek başına CAPI'nin çalışmadığını göstermez. Sunucu tarafını olay ayrıntılarından izleyin: Purchase olayında View details'i açın; Event overview sekmesi Pixel ve Conversions API'den alınan olay sayılarını, Event deduplication sekmesi tekilleştirme anahtarlarını gösterir.

Ardından Diagnostics bölümünde Redundant purchase events, Multiple events on an action ya da Pixel ile CAPI arasında değer veya para birimi uyuşmazlığı uyarısı çıkarsa ikinci bir kaynak arayın.

Meta'ya göre olay eşleşme kalitesi (EMQ), Conversions API'den gelen web olaylarına 10 üzerinden verilen bir puandır; müşteri bilgisinin kalitesine ve Meta hesaplarıyla eşleşen olay oranına göre son 48 saatin verisiyle hesaplanır. Meta for Developers mümkün olduğunda 6,0 ve üzerini hedeflemeyi öneriyor. Eklentinin kaynak koduna göre siparişin fatura bilgilerindeki e-posta, telefon, ad, soyad, şehir ve posta kodu karma (hash) biçiminde gönderiliyor; puan düşükse bu alanların ödeme formunda toplandığını kontrol edin.

Sık Yapılan Hatalar

• Önbellek eklentisinde JavaScript gruplamayı açık bırakmak: WooCommerce'in artık güncellenmeyen dokümanına göre bazı önbellek eklentilerinin JS gruplama ayarı piksel koduyla çakışıp ViewContent gibi olayları engelleyebiliyor. Olay eksikse bu ayarı kapatıp önbelleği temizleyin ve testi tekrarlayın.
• Teşekkür sayfasını atlayan ödeme akışı: Eklentinin kaynak koduna göre tarayıcı Purchase olayı sipariş onay (teşekkür) sayfasında tetiklenir; müşteri bu sayfaya dönmüyorsa ya da sayfa bir yönlendirme veya sayfa oluşturucu eklentisiyle değiştirilmişse olay gitmeyebilir. Event overview'da Purchase yalnızca Conversions API'den geliyorsa önce bu akışı kontrol edin.
• Eklentiyi güncellememek: Değişiklik kaydında çift Purchase, AddToCart ve InitiateCheckout olaylarına yönelik düzeltmeler var.

Ajans Reklam Hesabı Kullanıyorsanız: Eklentiyi Hangi Veri Setine Bağlamalı?

Sihirbazda seçtiğiniz portföy ve Pixel, olayların hangi veri setinde birikeceğini belirler. Meta'ya göre veri seti silinemiyor ve başka bir portföye devredilemiyor; Meta, reklamlarınızı başkası yönetiyorsa veri setini kendi işletme portföyünüzde oluşturmanızı öneriyor. Bu yüzden sihirbazda markanın portföyünü ve ona ait veri setini seçin.

AdsManager ile çalışan WooCommerce mağazalarında iki portföy yan yana durur: ajans reklam hesabının bulunduğu bizim portföyümüz ve olayların biriktiği marka portföyü. Bağlantı, veri setinin partner olarak bizimle paylaşılmasıyla kurulur; veri setinin sahibi değişmez. Meta'ya göre bir işletmeyle ilk kez paylaşım yaptığınızda iş ilişkinizin türünü belirtir ve Meta Business Tools Şartları'nı yeniden onaylarsınız; karşı taraf da isteği kabul eder. Ekran adımları ajans reklam hesabını Business Manager'a bağlama rehberimizde.

Ajans hesabı da Meta'nın reklam politikalarına ve kullanım şartlarına tabidir; eşleşme puanını ya da ölçümü kendiliğinden iyileştirmez. Başvuru koşulları Meta ajans reklam hesabı sayfamızda.

Sonuç

WooCommerce'te Meta ölçümünü üç soruyla denetleyebilirsiniz: olayları yalnızca Meta for WooCommerce mi gönderiyor, Purchase hem Pixel'den hem Conversions API'den gelip tekilleştiriliyor mu ve eklenti markanın kendi veri setine mi bağlı? Bu kontrolü her eklenti güncellemesinden ve yeni kurulumdan sonra tekrarlayın. Ajans hesabını ve ölçümü birlikte planlamak için WooCommerce reklam hesabı sayfamıza bakın; Shopify kullanıyorsanız Shopify Pixel ve Conversions API rehberimiz kanala özgü ayarları anlatıyor.