E-Ticaret için Meta Piksel ve CAPI Entegrasyonu: Shopify ve WooCommerce Kurulumu

E-ticaret mağazası işleten hemen her marka sahibi, bir noktada aynı soruyla karşılaşır: “Meta Piksel’i mağazama nasıl doğru kurarım?” Bu soru kulağa basit gelse de, Shopify ve WooCommerce gibi platformlarda pikselin genel JavaScript mantığından çok daha fazlasını içerir — platformun kendi native entegrasyon katmanı, tema dosyalarına manuel kod ekleme riskleri, sepete ekleme ve satın alma olaylarının doğru parametrelerle tetiklenmesi, Conversion API (CAPI) için sunucu tarafı erişim anahtarı yönetimi ve dynamic ads (dinamik ürün reklamları) için gereken ürün katalog feed’i.

Bu rehber, pikselin ne olduğunu veya standart olayların genel mantığını yeniden anlatmayacak; bu konuda zaten kapsamlı bir kaynağımız var ve genel kurulum mantığı, iOS 14 sonrası sinyal kaybı ile deduplication (tekilleştirme) konularını orada derinlemesine işledik. Burada tek odak: Shopify ve WooCommerce’e özgü platform entegrasyon adımları — hangi menüye tıklanacağı, hangi eklentinin kurulacağı, native entegrasyonun manuel kuruluma göre neden tercih edilmesi gerektiği ve ürün katalogların Meta’ya nasıl bağlanacağı.

Genel piksel kurulumu, kod mantığı ve olay yapısı için önce Meta Pixel kurulumu ve dönüşüm takibi rehberimizi okumanızı öneririz; bu yazı o temelin üzerine, e-ticaret platformuna özgü katmanı ekler.

1. Neden Platforma Özel Kurulum Önemli?

Meta Piksel’in genel mantığı her sitede aynıdır: bir JavaScript kodu tarayıcıya yüklenir, olayları dinler ve Meta sunucularına sinyal gönderir. Ancak Shopify ve WooCommerce gibi hazır e-ticaret altyapılarında bu kodu doğrudan tema dosyasına yapıştırmak, göründüğünden çok daha riskli bir iştir.

Tema güncellemeleri kodu siler. Shopify’da theme.liquid dosyasına manuel eklenen bir piksel kodu, tema güncellendiğinde veya değiştirildiğinde sessizce kaybolur. Aynı durum WooCommerce’te functions.php içine yazılan kod için de geçerlidir; çocuk tema (child theme) kullanılmadan yapılan her değişiklik bir sonraki tema güncellemesinde silinir.

Olay parametreleri eksik kalır. Genel bir piksel kodu yalnızca PageView olayını otomatik tetikler. AddToCart, InitiateCheckout ve Purchase gibi e-ticaret için kritik olan olayları doğru ürün ID’si, fiyat, para birimi ve içerik türü parametreleriyle tetiklemek için platformun ürün ve sepet verisine erişmeniz gerekir. Bu veriyi manuel olarak her sayfada yeniden yazmak hataya son derece açıktır.

Katalog senkronizasyonu ayrı bir sistemdir. Dynamic ads (kullanıcının baktığı veya sepetine eklediği ürünü otomatik olarak reklamda gösteren format) çalıştırmak istiyorsanız, piksel kurulumunun ötesinde bir ürün katalog feed’inin Meta Commerce Manager’a bağlı olması gerekir. Bu, platformun stok ve fiyat verisini gerçek zamanlı güncelleyen ayrı bir entegrasyon katmanıdır.

Bu üç neden, native (platformun kendi sunduğu) entegrasyonun neden manuel kuruluma göre neredeyse her zaman tercih edilmesi gerektiğini açıklar. Native entegrasyon, tema güncellemelerinden etkilenmez, olay parametrelerini platformun kendi veri modelinden otomatik çeker ve genellikle katalog bağlantısını da aynı akış içinde sunar.

2. Shopify Meta Piksel Kurulumu

Shopify, 2021’den bu yana Meta ile resmi bir ortaklık üzerinden “Facebook & Instagram” satış kanalı uygulamasını sunuyor. Bu uygulama hem piksel kurulumunu hem de CAPI bağlantısını tek ekranda yönetir; ayrı bir geliştirici işlemi gerektirmez.

Adım 1: Facebook & Instagram Kanalını Ekleyin

1. Shopify admin panelinde sol menüden Sales Channels (Satış Kanalları) bölümüne gidin.
2. Kanal listesinde Facebook & Instagram uygulamasını arayın; yoksa Shopify App Store üzerinden ekleyin (resmi Meta uygulamasıdır, ücretsizdir).
3. Uygulamayı açıp Get started (Başla) butonuna tıklayın.
4. Meta Business Manager hesabınızla giriş yapmanız istenecektir. Mağazanızı yönettiğiniz Business Manager hesabını seçin.

Adım 2: Piksel ve Business Manager Bağlantısını Yapın

1. Açılan ekranda mevcut bir Meta Pixel’i seçebilir veya yeni bir tane oluşturabilirsiniz. Zaten Events Manager’da kayıtlı bir pikseliniz varsa (örneğin genel kurulum rehberimizde oluşturduğunuz), “Connect an existing Pixel” seçeneğini işaretleyip o pikseli seçin.
2. Mağazanızın hangi Facebook Sayfası ve Instagram hesabıyla ilişkilendirileceğini onaylayın.
3. ”Finish setup” ile bağlantıyı tamamlayın.

Bu adımdan sonra Shopify, piksel kodunu sizin adınıza otomatik olarak her sayfaya enjekte eder. Tema dosyalarına elle kod eklemenize gerek kalmaz; aksine, theme.liquid içine ayrıca manuel piksel kodu eklerseniz çift sayım (double counting) riski oluşur ve raporlarınızdaki dönüşüm rakamları şişer.

Adım 3: CAPI Bağlantısını Aktifleştirin

Shopify’ın Facebook & Instagram uygulaması, Conversion API bağlantısını piksel kurulumuyla aynı akışın içine gömmüştür — ayrı bir sunucu tarafı kod yazmanıza gerek yoktur.

1. Uygulama içinde Settings > Data sharing (Ayarlar > Veri paylaşımı) bölümüne gidin.
2. ”Maximum” veri paylaşım seviyesini seçin. Bu seviye, tarayıcı pikseli ile sunucu tarafı CAPI sinyalini otomatik olarak eşleştirir (deduplication genel rehberimizde ayrıntılı anlatıldığı gibi event_id üzerinden yürür).
3. Değişikliği kaydedin.

Bu adımı tamamladığınızda Shopify, her sipariş, sepete ekleme ve ürün görüntüleme olayını hem tarayıcı pikseli hem de sunucudan (doğrudan Shopify’ın kendi sunucularından, tarayıcı engelleyicilerinden etkilenmeden) Meta’ya gönderir. Bu, iOS 14 sonrası yaşanan sinyal kaybını telafi etmenin platforma özgü en pratik yoludur.

Shopify’da Otomatik Tetiklenen Olaylar

Native entegrasyon kurulduğunda Shopify aşağıdaki standart olayları otomatik olarak, doğru parametrelerle tetikler:

Bu tablodaki en kritik satır Purchase’dır; çünkü CAPI’nin sunucu tarafı avantajı en çok bu olayda hissedilir. Shopify sipariş tamamlandığı anda sunucusundan doğrudan Meta’ya bu sinyali gönderdiği için, kullanıcının reklam engelleyici kullanması veya tarayıcı çerezlerini reddetmesi bu veriyi etkilemez.

Shopify’da Sık Karşılaşılan Sorunlar

Checkout sayfasında piksel görünmüyor: Shopify’ın standart (Shopify Plus olmayan) planlarında checkout sayfası tema dosyalarından bağımsızdır; bu yüzden manuel piksel kodları checkout adımında çalışmaz. Native Facebook & Instagram kanalı bu sınırlamayı aşar çünkü Shopify altyapısının kendisi tarafından enjekte edilir — bu da native kurulumun manuel koddan üstün olduğu en somut örnektir.

Çift piksel kurulumu: Bazı mağaza sahipleri hem native kanalı kurar hem de tema düzenleyicisinden manuel piksel kodu ekler (genellikle eski bir kurulumdan kalma). Bu durumda Events Manager’da aynı olay iki kez görünür ve reklam raporlarındaki maliyet-başı-sonuç rakamları yanıltıcı hale gelir. Events Manager > Test Events aracıyla bir test siparişi vererek yalnızca tek bir Purchase olayının düştüğünü doğrulayın.

Test modunda sipariş verirken piksel tetiklenmiyor: Shopify’ın “Bogus Gateway” test ödeme yöntemiyle verilen siparişler bazı durumlarda Purchase olayını tetiklemez. Gerçek (küçük tutarlı) bir sipariş ile test yapmak daha güvenilir sonuç verir.

Shopify Plus ve Checkout Extensibility Farkı

Shopify Plus kullanan mağazalar için piksel ve CAPI kurulumu, standart plana göre bir kademe daha esnektir. Standart planda checkout sayfası tamamen Shopify’ın kendi altyapısı tarafından render edilir ve mağaza sahibinin bu sayfaya doğrudan kod ekleme yetkisi yoktur; native Facebook & Instagram kanalı bu kısıtlamayı Shopify’ın kendi sunucu tarafı entegrasyonu üzerinden aşar.

Shopify Plus’ta ise “Checkout Extensibility” adı verilen bir yapı üzerinden, checkout sürecine ek özel kod parçacıkları (Shopify Functions veya UI Extensions aracılığıyla) eklenebilir. Bu, ajans veya geliştirici ekibinin özel bir dönüşüm olayı veya ek parametre göndermesi gerektiğinde kullanılan ileri düzey bir seçenektir; çoğu mağaza için gerekli değildir çünkü native kanal zaten standart olayları eksiksiz kapsar. Plus müşterisi olmayan mağazaların bu farkı bilmesi, “checkout’a neden manuel kod ekleyemiyorum” sorusuna netlik getirir.

3. WooCommerce Meta Piksel Kurulumu

WooCommerce, WordPress üzerinde çalışan açık kaynaklı bir e-ticaret eklentisi olduğu için Shopify’daki gibi tek bir resmi “kanal” yapısı yoktur. Bunun yerine iki geçerli yol vardır: Meta’nın resmi “Facebook for WooCommerce” eklentisi (native, önerilen) veya WordPress genelinde çalışan üçüncü taraf piksel eklentileri üzerinden manuel yapılandırma.

Yöntem A: Facebook for WooCommerce Eklentisi (Önerilen)

Bu eklenti Meta tarafından resmi olarak geliştirilir ve desteklenir; hem piksel hem CAPI hem de katalog bağlantısını tek panelde toplar.

1. WordPress admin panelinde Eklentiler > Yeni Ekle bölümüne gidin.
2. ”Facebook for WooCommerce” araması yapın ve eklentiyi kurup aktifleştirin.
3. Aktivasyon sonrası WooCommerce menüsü altında beliren Facebook sekmesine girin.
4. ”Get Started” butonuyla kurulum sihirbazını başlatın; Meta Business Manager hesabınızla giriş yapın.
5. Mevcut bir pikseliniz varsa seçin, yoksa sihirbaz sizin için yeni bir tane oluşturur.
6. Facebook Sayfanızı ve (varsa) Instagram hesabınızı bağlayın.
7. Kurulumun son adımında “Enable advanced matching” (gelişmiş eşleştirme) seçeneğini açık bırakın; bu seçenek, giriş yapmış veya form dolduran kullanıcıların e-posta/telefon bilgisini hashed biçimde ileterek Event Match Quality skorunu yükseltir.

Yöntem B: CAPI’yi Erişim Anahtarıyla Manuel Bağlama

Facebook for WooCommerce eklentisinin CAPI bölümünde bazen sihirbaz otomatik bağlanmaz; bu durumda erişim anahtarını (access token) elle girmeniz gerekir:

1. Meta Events Manager’da ilgili pikseli açın, Settings sekmesine gidin.
2. ”Conversions API” bölümünde “Generate access token” (erişim anahtarı oluştur) butonuna tıklayın.
3. Oluşan uzun karakter dizisini kopyalayın.
4. WooCommerce > Facebook > Settings ekranında “Conversions API” alanına bu anahtarı yapıştırıp kaydedin.

Bu erişim anahtarı hassas bir bilgidir; kimseyle paylaşmayın ve mağaza yöneticiniz değiştiğinde Events Manager üzerinden anahtarı iptal edip yenisini oluşturun.

WooCommerce’te Otomatik Tetiklenen Olaylar

Facebook for WooCommerce eklentisi kurulduğunda, WooCommerce’in kendi ürün ve sepet verisinden beslenen şu olaylar otomatik tetiklenir:

WooCommerce’te Purchase olayının tam olarak hangi sipariş durumunda tetiklendiği önemlidir. Varsayılan olarak eklenti, ödeme başarıyla tamamlanıp sipariş “processing” veya “completed” durumuna geçtiğinde olayı gönderir; “pending payment” veya “failed” durumundaki siparişler için tetiklenmez. Havale/EFT gibi manuel ödeme yöntemi kullanan mağazalarda sipariş uzun süre “on-hold” durumunda kalabilir — bu durumda Purchase olayı gecikebilir veya hiç tetiklenmeyebilir; bu yöntemi kullanan mağazaların eklenti ayarlarından hangi sipariş durumlarının dönüşüm sayılacağını kontrol etmesi gerekir.

WooCommerce’te Sık Karşılaşılan Sorunlar

Önbellek (cache) eklentisi piksel kodunu geciktiriyor: WP Rocket, W3 Total Cache gibi önbellekleme eklentileri, sayfa HTML’ini önceden oluşturup sakladığı için bazen piksel kodunun güncel sürümünü değil eski bir kopyasını sunar. Piksel ayarlarında değişiklik yaptıktan sonra site önbelleğini temizlemeyi alışkanlık haline getirin.

Sayfa oluşturucu eklentileri (Elementor, WPBakery) sepete ekleme olayını bozuyor: Bazı sayfa oluşturucular WooCommerce’in standart “Add to Cart” AJAX davranışını değiştirir. Bu durumda Facebook for WooCommerce eklentisinin dinlediği standart olay tetiklenmeyebilir. Meta Pixel Helper ile sepete ekleme testinde AddToCart olayı görünmüyorsa, önce sayfa oluşturucunun sepet butonunu “varsayılan WooCommerce davranışı” moduna aldığından emin olun.

Çoklu para birimi eklentileri fiyat parametresini yanlış gönderiyor: WooCommerce Multi-Currency gibi eklentiler kullanıyorsanız, dönüştürülmüş fiyatın değil orijinal (temel) para birimindeki fiyatın piksele gönderildiği durumlar olabilir. Bu, ROAS (reklam harcaması getirisi) raporlarını yanlış hesaplatır; Test Events aracıyla farklı para birimi seçili durumdayken bir test siparişi vererek value ve currency parametrelerini karşılaştırın.

WooCommerce mağazanızın genel arama motoru performansı da bu teknik kurulumdan ayrı, ama ilişkili bir konudur; bu konuyu WooCommerce SEO hizmetimizde ayrıca ele alıyoruz.

4. Meta Katalog Entegrasyonu: Dynamic Ads’in Temeli

Piksel ve CAPI kurulumu tamamlandıktan sonra, e-ticaret mağazalarının reklam stratejisinde bir sonraki adım genellikle dynamic ads (dinamik ürün reklamları) olur. Bu format, kullanıcının sitenizde baktığı veya sepetine eklediği tam ürünü — görseli, fiyatı ve ürün adıyla birlikte — otomatik olarak reklamda gösterir. Bunu çalıştırabilmek için piksel yetmez; Meta’nın ürün kataloğunuzu görmesi gerekir.

Katalog Nedir, Piksel’den Farkı Ne?

Piksel, kullanıcı davranışını (kim neye baktı, kim sepete ekledi) izler. Katalog ise mağazanızdaki ürünlerin kendisini — ID, isim, fiyat, stok durumu, görsel URL’si, kategori gibi bilgileri — Meta’ya bildiren ayrı bir veri kaynağıdır. Dynamic ads, piksel verisindeki “kullanıcı X, ürün ID 4521’e baktı” sinyalini, katalogdaki “ürün ID 4521 şu görsel ve fiyata sahip” bilgisiyle eşleştirerek reklamı otomatik oluşturur. İkisi birbirini tamamlar; biri olmadan diğeri işlevsizdir.

Shopify’da Katalog Bağlantısı

Shopify’da katalog entegrasyonu genellikle ekstra bir işlem gerektirmez: 2. bölümde anlatılan Facebook & Instagram satış kanalını kurduğunuzda, Shopify ürün kataloğunuzu otomatik olarak Meta Commerce Manager’a senkronize eder. Stok veya fiyat değişiklikleri gerçek zamanlıya yakın bir gecikmeyle (genellikle birkaç dakika içinde) Meta tarafına yansır. Commerce Manager’da Catalog > Data Sources bölümünden senkronizasyonun aktif olduğunu ve ürün sayısının mağazanızdaki gerçek ürün sayısıyla eşleştiğini kontrol edin.

WooCommerce’de Katalog Bağlantısı

Facebook for WooCommerce eklentisi, kurulum sihirbazının son adımlarında bir katalog oluşturma seçeneği sunar. Eklenti bunu iki şekilde yapabilir:

Otomatik senkronizasyon (önerilen): Eklenti, WooCommerce ürün veritabanınızı doğrudan okuyup Meta Commerce Manager’a aktarır. Ürün eklediğinizde, fiyat değiştirdiğinizde veya stok tükendiğinde bu değişiklik otomatik olarak katalog tarafına yansır. Ekstra bir dosya yönetmeniz gerekmez.

Feed URL yöntemi (alternatif): Bazı mağaza sahipleri, WooCommerce Product Feed gibi ayrı bir eklenti kullanarak XML veya CSV formatında bir ürün feed’i oluşturur ve bu feed’in URL’sini Commerce Manager > Catalog > Data Sources > Add Items > “Use a data feed” seçeneğinden Meta’ya tanıtır. Bu yöntem, otomatik senkronizasyonun bazı özel ürün alanlarını (örneğin özel etiketler veya varyasyon bazlı GTIN kodları) doğru aktarmadığı durumlarda tercih edilir.

Katalog Feed’inde Bulunması Gereken Zorunlu Alanlar

Meta’nın katalogu kabul edip dynamic ads’i çalıştırabilmesi için her üründe şu alanların eksiksiz olması gerekir:

• id: Her ürün için benzersiz, değişmeyen bir kimlik (SKU veya ürün ID).
• title: Ürün adı, 100 karakteri geçmeyecek şekilde ve anlamlı.
• description: Ürünün kısa açıklaması.
• availability: Stok durumu (in stock, out of stock, preorder).
• condition: Ürün durumu (new, used, refurbished).
• price: Para birimi kodu ile birlikte (örn. “450.00 TRY”).
• link: Ürün detay sayfasının tam URL’si.
• image_link: Ana ürün görselinin doğrudan erişilebilir URL’si.
• brand: Marka adı (bazı kategorilerde zorunlu).

Bu alanlardan biri eksik veya hatalı biçimlendirilmişse Commerce Manager, ilgili ürünü katalogdan reddeder ve dynamic ads’te o ürün görünmez. Katalog kurulumundan sonra Catalog > Diagnostics sekmesinden reddedilen ürün sayısını ve reddedilme nedenlerini düzenli kontrol etmek, dynamic ads kapsamının daralmasını önler.

Katalog ile Piksel Olaylarının Eşleşme Testi

Katalog kurulduktan sonra, piksel olaylarındaki content_id değerinin katalogdaki id alanıyla birebir aynı olduğunu doğrulamak kritik bir adımdır. Bu iki değer eşleşmezse, kullanıcı bir ürüne baktığında Meta bu ürünü kataloğunda bulamaz ve dynamic ads o kullanıcıya hiçbir ürün göstermez — kurulum “başarılı” görünse bile reklamlar sessizce çalışmaz.

Bu testi yapmak için Events Manager > Test Events aracında bir ürün sayfası ziyaret edin, tetiklenen ViewContent olayının content_ids parametresini not edin, ardından Commerce Manager > Catalog içinde aynı ID’ye sahip bir ürün olup olmadığını arayın. Shopify ve güncel Facebook for WooCommerce sürümlerinde bu eşleşme native entegrasyon sayesinde otomatik sağlanır; sorun genellikle özel tema düzenlemeleri veya üçüncü taraf feed eklentileri kullanıldığında ortaya çıkar.

5. Yapay Zeka Boyutu: 2026’da Katalog Kalitesi Neden Daha Kritik?

2026 itibarıyla Meta’nın reklam sistemleri, katalog verisini yalnızca dynamic ads’i doldurmak için değil, Advantage+ Catalog Ads gibi otomasyon katmanlarında kreatif üretimi ve hedef kitle eşleştirmesini de yönlendirmek için kullanıyor. Bu sistemler, ürün başlığı, açıklama ve görsel kalitesinden makine öğrenmesiyle sinyal çıkarıyor; eksik veya düşük kaliteli katalog verisi artık yalnızca “ürün gösterilmiyor” sonucu değil, algoritmanın o ürünü yanlış kitleye eşleştirmesi gibi dolaylı bir performans kaybına da yol açabiliyor.

Bunun e-ticaret mağazaları için pratik karşılığı üç noktada toplanıyor:

Ürün başlığı ve açıklama kalitesi doğrudan eşleştirmeyi etkiliyor. Meta’nın otomatik kreatif optimizasyonu, ürün açıklamasındaki anahtar nitelikleri (renk, malzeme, kullanım amacı) okuyarak reklamı hangi kullanıcı segmentine göstereceğine karar veriyor. Shopify ve WooCommerce’de ürün açıklamalarını yalnızca insan okuyucu için değil, bu otomatik sistemlerin de anlayabileceği netlikte yazmak (belirsiz pazarlama dili yerine somut ürün nitelikleri kullanmak) katalog performansını iyileştiriyor.

GTIN/MPN gibi standart tanımlayıcılar önem kazanıyor. Meta’nın ürün eşleştirme algoritmaları, aynı ürünü farklı kaynaklarda (örneğin Google Alışveriş feed’i ile Meta kataloğu arasında) tanımak için GTIN (Global Trade Item Number) veya MPN (Manufacturer Part Number) alanlarına giderek daha fazla güveniyor. Bu alanlar katalogda boş bırakıldığında, ürün eşleştirme kalitesi düşüyor ve bazı otomasyon özellikleri (örneğin çapraz platform kreatif testleri) o ürün için devre dışı kalabiliyor.

AI destekli görsel arama, ürün görseli kalitesini reklam performansına bağlıyor. Meta’nın görsel tanıma sistemleri, katalogdaki ürün fotoğraflarını analiz ederek benzer görsel özelliklere sahip kullanıcı ilgi alanlarıyla eşleştirme yapabiliyor. Düşük çözünürlüklü, aşırı kırpılmış veya ürünü net göstermeyen görseller bu eşleştirmeyi zayıflatıyor; Commerce Manager’ın görsel kalite uyarılarını (Catalog > Diagnostics içinde) dikkate almak, özellikle dynamic ads ve Advantage+ Catalog Ads kampanyaları için artık isteğe bağlı bir ayrıntı değil.

Bu üç nokta, katalog kurulumunu tek seferlik bir teknik işlem olarak değil, sürekli bakım gerektiren bir veri kalitesi süreci olarak ele almayı gerektiriyor. Shopify ve WooCommerce’in native entegrasyonları bu alanları otomatik doldursa da, alan içeriğinin kalitesi (başlık netliği, görsel çözünürlüğü, GTIN doluluğu) mağaza sahibinin sorumluluğunda kalıyor.

6. Native Entegrasyon mu, Manuel Kurulum mu? Karar Tablosu

Tablodan çıkan sonuç nettir: standart bir Shopify veya WooCommerce mağazası işletiyorsanız native entegrasyon, hem kurulum hem bakım açısından neredeyse her durumda daha güvenlidir. Manuel kurulum yalnızca headless (başlıksız) mimari kullanan veya standart eklentinin desteklemediği çok özel bir teknik senaryoda gündeme gelmelidir — o düzeyde bir mimari değişikliği zaten genel bir geliştirici kararı gerektirir.

7. Kurulum Sonrası Doğrulama Kontrol Listesi

Kurulumu “bitti” saymadan önce aşağıdaki maddelerin her birini tek tek doğrulayın:

1. Events Manager > Test Events aracında canlı bir ürün sayfası ziyaretinde ViewContent olayının düştüğünü görün.
2. Sepete bir ürün ekleyin; AddToCart olayının doğru value ve currency parametreleriyle geldiğini kontrol edin.
3. Küçük tutarlı gerçek bir test siparişi verin; Purchase olayının hem tarayıcı hem sunucu (CAPI) kaynağından geldiğini Test Events ekranında “Browser” ve “Server” etiketleriyle doğrulayın.
4. Event Match Quality skorunu kontrol edin; Shopify ve WooCommerce native entegrasyonlarında bu skorun genellikle “Good” veya üzeri olması beklenir.
5. Commerce Manager > Catalog > Diagnostics bölümünde reddedilen ürün olup olmadığına bakın.
6. Bir ürün sayfasında tetiklenen ViewContent olayının content_id’sinin katalogdaki ürün ID’siyle eşleştiğini doğrulayın.
7. Meta Pixel Helper eklentisiyle sitenin farklı sayfalarında (anasayfa, kategori, ürün, sepet, checkout) piksel kodunun yalnızca bir kez ve doğru pixel ID ile yüklendiğini kontrol edin.
8. Reklam hesabında yeni oluşturulacak bir dynamic ads kampanyası için katalogun “Ready” durumda göründüğünü Commerce Manager’dan teyit edin.

8. Vaka Kurgusu: Orta Ölçekli Bir Giyim Markasının Shopify’dan WooCommerce’e Geçiş Sürecinde Piksel Kurulumu

İstanbul merkezli, aylık ortalama 1.200 sipariş alan orta ölçekli bir kadın giyim markası, Shopify’dan WordPress/WooCommerce altyapısına geçiş yaptıktan sonra reklam performansında belirgin bir düşüş yaşadı. Geçiş öncesi Shopify’da native Facebook & Instagram kanalı üzerinden kurulu olan piksel ve CAPI entegrasyonu, platform değişikliğiyle birlikte tamamen sıfırlanmıştı; yeni sitede yalnızca genel bir piksel kodu tema dosyasına elle eklenmiş, CAPI ve katalog bağlantısı ise hiç kurulmamıştı.

Tespit edilen durum: Geçişten sonraki ilk üç haftada Meta reklam hesabındaki raporlanan dönüşüm sayısı, gerçek sipariş sayısının yaklaşık yüzde 45’i seviyesinde kalmıştı. Dynamic ads kampanyaları hiç ürün göstermiyordu çünkü katalog bağlantısı yoktu; mevcut kampanyalar statik görsellerle devam ediyordu ama optimizasyon sinyali zayıftı.

Uygulanan adımlar:

• Facebook for WooCommerce eklentisi kuruldu ve resmi sihirbaz üzerinden mevcut (Shopify döneminden kalma, silinmemiş) piksel ID’sine bağlandı.
• Conversions API erişim anahtarı Events Manager’dan oluşturulup eklenti ayarlarına tanımlandı.
• Tema dosyasına elle eklenmiş eski piksel kodu kaldırıldı; çift sayım riski ortadan kaldırıldı.
• WooCommerce ürün kataloğu otomatik senkronizasyon yöntemiyle Commerce Manager’a bağlandı; ilk senkronizasyonda 340 üründen 12’si eksik image_link alanı nedeniyle reddedildi, bu ürünlerin görselleri düzenlenip yeniden gönderildi.
• Havale ile ödeme seçeneği kullanan siparişlerde Purchase olayının “on-hold” durumunda tetiklenmediği fark edildi; eklenti ayarlarından bu sipariş durumu da dönüşüm sayılacak durumlar listesine eklendi.

Sonuç penceresi (kurulumdan sonraki 4 hafta): Raporlanan dönüşüm oranı gerçek sipariş sayısının yaklaşık yüzde 91’ine yükseldi. Dynamic ads kampanyaları katalog bağlantısı kurulduktan 6 gün sonra (Meta’nın öğrenme aşaması tamamlandıktan sonra) aktif hale geldi ve bu kampanyaların maliyet-başı-satın-alma rakamı, statik kampanyalara kıyasla yaklaşık yüzde 28 daha düşük gerçekleşti. Event Match Quality skoru “Fair” seviyesinden “Good” seviyesine çıktı.

(Vaka temsilidir.)

9. Sık Yapılan Hatalar

1. Platform değişikliğinde piksel kurulumunu sıfırdan yapılandırmamak. Shopify’dan WooCommerce’e (veya tersine) geçen mağazalar, çoğu zaman eski platformdaki native kurulumun otomatik taşınacağını varsayar. Piksel ID aynı kalabilir ama CAPI bağlantısı, katalog senkronizasyonu ve olay tetikleme mantığı platforma özgüdür ve yeniden kurulmalıdır.

2. Hem native kanalı hem manuel kodu aynı anda aktif bırakmak. Bu, Events Manager’da her olayın iki kez sayılmasına yol açar. Reklam raporlarındaki dönüşüm sayısı gerçekte olduğundan yüksek görünür ve optimizasyon kararları yanlış veriye dayanır.

3. Katalog feed’ini kurup bir daha kontrol etmemek. Stok tükenmesi, fiyat değişikliği veya yeni ürün eklenmesi durumlarında feed’in güncel kaldığını varsaymak risklidir; özellikle üçüncü taraf feed eklentileri kullanılıyorsa periyodik senkronizasyon hatası oluşabilir. Commerce Manager Diagnostics sekmesi haftalık kontrol edilmelidir.

4. CAPI erişim anahtarını hiç yenilememek. Erişim anahtarları süresiz görünse de, hesap değişiklikleri veya Meta’nın güvenlik politikası gereği zaman zaman geçersiz hale gelebilir. Events Manager’da “Conversions API” bölümündeki bağlantı durumunu ayda bir kontrol etmek, sessizce kesilen bir veri akışını erken fark etmenizi sağlar.

5. content_id tutarsızlığını fark etmemek. Piksel olaylarındaki ürün ID’si ile katalogdaki ürün ID’sinin farklı formatta olması (örneğin biri “1234” diğeri “SKU-1234”), dynamic ads’in sessizce çalışmamasına yol açan en sık rastlanan ama en geç fark edilen hatadır.

6. Test siparişini gerçek ödeme akışı dışında vermek. Shopify’ın test ödeme ağ geçidi veya bazı WooCommerce test modları, Purchase olayını gerçek bir siparişten farklı tetikleyebilir. Kurulumu doğrularken küçük tutarlı gerçek bir sipariş vermek, gerçek üretim davranışını görmenin tek güvenilir yoludur.

7. Havale/EFT gibi manuel ödeme yöntemlerinde sipariş durumunu göz ardı etmek. Bu yöntemlerde sipariş uzun süre “beklemede” kalabilir; eklenti varsayılan olarak yalnızca “tamamlandı” durumundaki siparişleri dönüşüm sayabilir. Bu, gerçek satışların bir kısmının hiç raporlanmamasına yol açar.

10. Sıkça Sorulan Sorular

Sonuç

Shopify ve WooCommerce’de Meta Piksel ve CAPI kurulumu, genel piksel mantığından farklı bir beceri seti gerektirir: hangi native uygulamanın kurulacağını bilmek, olay parametrelerinin platformun kendi veri modelinden doğru çekildiğini doğrulamak ve dynamic ads için ürün kataloğunu piksel verisiyle tutarlı biçimde bağlamak. Native entegrasyon seçenekleri — Shopify’ın Facebook & Instagram kanalı ve WooCommerce’in Facebook for WooCommerce eklentisi — bu sürecin büyük kısmını otomatikleştirir ve manuel kodlamaya kıyasla çok daha az bakım yükü getirir.

Kuruluma başlamadan önce piksel ve CAPI’nin genel çalışma mantığına, standart olaylara ve deduplication kavramına aşina değilseniz, önce genel Meta Pixel kurulum rehberimizi incelemenizi öneririz. Shopify mağazanızın genel SEO ve teknik altyapı ihtiyaçları için Shopify SEO hizmetimize, WooCommerce tarafında ise WooCommerce SEO hizmetimize göz atabilirsiniz.

Mağazanızda piksel, CAPI ve katalog entegrasyonunun eksiksiz ve doğru kurulduğundan emin olmak, kurulan kampanyaların üzerine inşa edileceği veri katmanını sağlamlaştırır. Bu kurulumdan reklam stratejisine uzanan süreçte profesyonel destek almak isterseniz, Meta reklam yönetimi hizmetimiz kapsamında piksel/CAPI kurulumundan kampanya optimizasyonuna kadar uçtan uca destek sağlıyoruz.