WooCommerce Meta CAPI Kurulumu ve Doğru Piksel Eşleşmesi

WooCommerce Meta CAPI kurulumu, dönüşümleri sunucudan Meta’ya gönderir. Meta Pixel ise tarayıcı olaylarını takip eder. İki kanal aynı Purchase olayını iletebilir. Bu nedenle aynı event_name ve event_id kullanılmalıdır.

Doğru kurulum yalnızca eklenti aktivasyonu değildir. WooCommerce doğru Pixel, Dataset, reklam hesabı ve ürün kataloğuna bağlanmalıdır. Event adları doğru eşleşmelidir. Ürün kimlikleri katalogla tutarlı olmalıdır. Kurulum, Meta Events Manager ve gerçek sipariş verisiyle doğrulanmalıdır.

WooCommerce Meta CAPI Kurulumu Neyi Kapsar?

WooCommerce Meta CAPI kurulumu üç veri katmanı içerir:

1. Tarayıcı olayları

2. Sunucu olayları

3. Meta ürün kataloğu

Meta Pixel tarayıcı olaylarını gönderir. Conversions API sunucu olaylarını iletir. Ürün kataloğu ise event içindeki ürünleri Meta kayıtlarıyla eşleştirir.

Sağlıklı kurulum şu akışı oluşturur:

WooCommerce ↓ Sipariş ve Event Doğrulama ↓ Meta Pixel + Conversions API ↓ Event ID ile Deduplication ↓ Meta Dataset ↓ Events Manager ↓ Reklam Optimizasyonu

Meta, Conversions API kullanımını Pixel’in yerine geçen tekil bir çözüm olarak konumlandırmaz. Meta, Pixel ile CAPI’nin birlikte kullanılmasını önerir. CAPI, Pixel’in ağ bağlantısı veya sayfa yükleme sorunları nedeniyle kaybedebileceği bazı web olaylarını iletebilir.

Meta Pixel’in Görevi Nedir?

Meta Pixel, kullanıcının tarayıcısında çalışan takip kodudur.

Pixel şu olayları izleyebilir:

• PageView

• ViewContent

• Search

• AddToCart

• InitiateCheckout

• AddPaymentInfo

• Purchase

• CompleteRegistration

Pixel tarayıcı bağlamına erişir.

Bu bağlam şu sinyalleri içerebilir:

• Sayfa adresi

• Tarayıcı bilgisi

• Kampanya tıklama bilgisi

• Meta tarayıcı kimliği

• Kullanıcının site içi davranışı

Pixel olayları tarayıcı koşullarından etkilenir. Reklam engelleyiciler, kullanıcı izinleri, ağ hataları veya sayfa yükleme sorunları bazı olayları sınırlayabilir.

Meta Conversions API’nin Görevi Nedir?

Meta Conversions API, işletme sunucusuyla Meta arasında doğrudan bağlantı kurar.

WooCommerce tarafında oluşan olaylar Meta’ya sunucudan gönderilebilir. Purchase olayı doğrudan sipariş kaydıyla ilişkilendirilebilir.

Bir server event şu alanları taşıyabilir:

Parametre	Görevi
event_name	Olay türünü belirtir
event_time	Olay zamanını belirtir
event_id	Aynı olayı tekilleştirir
action_source	Olay kaynağını belirtir
event_source_url	Olay sayfasını gösterir
user_data	Müşteri eşleştirme verisini taşır
custom_data	Tutar ve ürün verisini taşır

Meta, event_name ve event_id alanlarını Pixel ile CAPI üzerinden gönderilen aynı olayları tekilleştirmek için kullanır.

CAPI şu avantajları sağlar:

• Sipariş kaydına doğrudan erişir.

• Ödeme durumunu kontrol edebilir.

• Sunucu olaylarını loglayabilir.

• Başarısız istekleri yeniden gönderebilir.

• CRM verisiyle genişletilebilir.

• Tarayıcı sinyalini destekleyebilir.

Ancak CAPI tek başına veri doğruluğu sağlamaz.

Yanlış Purchase tetikleyicisi yine yanlış event üretir. Yanlış Pixel bağlantısı veriyi yanlış hesaba gönderir. Hatalı event_id ise çift sayım oluşturur.

Pixel ve CAPI Neden Birlikte Kullanılır?

Pixel tarayıcı bağlamını taşır.

CAPI işletme bağlamını taşır.

Pixel, kullanıcının reklam tıklamasıyla ilişkili tarayıcı sinyallerini yakalayabilir. CAPI ise sipariş ve ödeme verisini doğrudan WooCommerce üzerinden alabilir.

İki kaynak birlikte daha dayanıklı bir event yapısı oluşturur.

Ancak aynı dönüşüm iki kez raporlanmamalıdır.

Meta şu eşleşmeyi bekler:

Pixel event_name: Purchase CAPI event_name: Purchase

Pixel eventID: purchase_8451 CAPI event_id: purchase_8451

Meta, aynı event_name ve event_id değerlerini taşıyan olayları aynı dönüşüm olarak değerlendirebilir.

Kurulum Öncesi Gerekli Meta Varlıkları

Kuruluma başlamadan önce Meta varlıklarını listeleyin.

Yanlış varlık seçimi, teknik olarak çalışan fakat yanlış hesaba veri gönderen bir entegrasyon oluşturur.

Gerekli varlıklar

• Meta Business Portfolio

• Facebook sayfası

• Meta reklam hesabı

• Meta Pixel veya Dataset

• Meta ürün kataloğu

• Doğrulanmış alan adı

• Gerekli kullanıcı yetkileri

Meta varlık matrisi

WooCommerce Varlığı	Meta Karşılığı	Ana Kontrol
Mağaza alan adı	Doğrulanmış domain	Sahiplik
Reklam faaliyeti	Reklam hesabı	Hesap erişimi
Tarayıcı olayları	Meta Pixel	Pixel ID
Sunucu olayları	Dataset ve CAPI	Event hedefi
Ürünler	Meta Catalog	Ürün kimliği
Marka hesabı	Facebook Page	İşletme bağlantısı

Business Portfolio Kontrolü

Kurulumu yapan kullanıcı gerekli yetkilere sahip olmalıdır.

Şu erişimleri kontrol edin:

• İşletme yöneticisi erişimi

• Reklam hesabı erişimi

• Facebook sayfası erişimi

• Dataset veya Pixel erişimi

• Katalog erişimi

• Domain erişimi

Ajans hesabı kullanılıyorsa varlık sahipliğini ayrıca doğrulayın.

Ajansın erişim sahibi olması, varlığın ajansa ait olması anlamına gelmez. Pixel ve katalog mümkün olduğunda marka işletmesinin kontrolünde kalmalıdır.

Doğru Pixel ve Dataset Nasıl Seçilir?

Meta Pixel, web olaylarının tarayıcı kaynağını temsil eder.

Dataset ise farklı olay kaynaklarını aynı veri yapısında yönetebilir.

Kurulum sırasında şu soruları cevaplayın:

• Canlı mağazanın mevcut Pixel’i hangisidir?

• Reklam kampanyaları hangi Pixel’i kullanıyor?

• Eski ajans Pixel’i hâlâ çalışıyor mu?

• Test Pixel’i canlı mağazaya bağlı mı?

• Dataset doğru işletmeye mi ait?

• Reklam hesabı bu Dataset’e erişebiliyor mu?

Yeni bir Pixel oluşturmadan önce mevcut yapıyı denetleyin.

Aynı mağaza için gereksiz Pixel oluşturmak veri geçmişini böler. Kampanya optimizasyonu farklı kaynaklara dağılır. Events Manager raporları da karmaşıklaşır.

Ürün Kataloğu Nasıl Seçilmelidir?

WooCommerce ürünleri tek Meta kataloğuyla senkronize edilmelidir.

Manuel katalog ile eklenti kataloğunun karışması ürün görünürlüğü sorunları oluşturabilir. WooCommerce dokümantasyonu, kurulum sihirbazı dışında oluşturulan ikinci katalogların boş veya yanlış katalog bağlantısına yol açabileceğini belirtir.

Şu kontrolleri yapın:

• Aktif katalog doğru işletmeye ait mi?

• WooCommerce ürünleri bu kataloğa gidiyor mu?

• İkinci ve boş katalog bulunuyor mu?

• Ürün sayısı WooCommerce ile tutarlı mı?

• Varyasyonlar doğru biçimde senkronize oluyor mu?

• Katalog reklam hesabıyla paylaşılmış mı?

Kurulum Öncesi Çift Pixel Kontrolü

Eklentiyi kurmadan önce mevcut takip kaynaklarını bulun.

Aynı Pixel şu kanallardan eklenmiş olabilir:

• Tema dosyası

• Header eklentisi

• Google Tag Manager

• Meta for WooCommerce

• Farklı bir Pixel eklentisi

• Özel JavaScript

• Eski ajans kurulumu

Çift Pixel şu sorunları oluşturabilir:

• İki PageView olayı

• İki AddToCart olayı

• İki Purchase olayı

• Şişmiş dönüşüm hacmi

• Yanlış yeniden hedefleme kitlesi

• Tutarsız Events Manager raporu

Tarayıcı geliştirici araçlarını kullanın. Meta Pixel Helper sonuçlarını inceleyin. Google Tag Manager kapsayıcısını kontrol edin. Tema ve eklenti ayarlarını ayrıca tarayın.

Meta for WooCommerce Kurulumu Nasıl Yapılır?

WooCommerce’in Meta entegrasyonu, mağazayı Meta varlıklarına bağlamak ve ürünleri senkronize etmek için bir kurulum akışı sunar. WooCommerce ayrıca bağlantı ve ürün senkronizasyonu sorunlarında eklentiyi yeniden bağlamayı temel hata giderme adımlarından biri olarak gösterir.

Arayüz isimleri eklenti sürümüne göre değişebilir. Temel akış aynı kalır.

1. Mağaza yedeğini alın

WordPress dosyalarını yedekleyin.

Veri tabanını ayrıca yedekleyin.

Canlı mağazada değişiklik öncesi geri dönüş planı hazırlayın.

2. Mevcut takip kaynaklarını listeleyin

Aktif Pixel kodlarını bulun.

GTM etiketlerini kontrol edin.

Eski CAPI entegrasyonlarını tespit edin.

Aynı eventin farklı kaynaklardan gönderilmesini engelleyin.

3. Meta entegrasyonunu yükleyin

WooCommerce panelindeki eklenti alanını açın.

Resmî Meta entegrasyonunu yükleyin.

Eklentiyi etkinleştirin.

4. Meta hesabını bağlayın

Bağlantı sihirbazını başlatın.

Meta hesabınızla giriş yapın.

Gerekli işletme izinlerini inceleyin.

5. Business Portfolio seçin

Markanın sahip olduğu işletmeyi seçin.

Ajans işletmesini yanlışlıkla seçmeyin.

Varlık sahipliğini kontrol edin.

6. Facebook sayfasını seçin

Doğru marka sayfasını seçin.

Sayfanın işletmeyle ilişkisini doğrulayın.

7. Reklam hesabını seçin

Aktif kampanyaların bulunduğu hesabı seçin.

Test hesabı kullanmayın.

8. Pixel veya Dataset seçin

Mevcut canlı veri kaynağını seçin.

Pixel kimliğini Events Manager üzerinden doğrulayın.

9. Ürün kataloğunu seçin

Mevcut doğru kataloğu seçin.

Boş veya eski katalogları kullanmayın.

Yeni katalog oluşturuluyorsa adlandırma standardı belirleyin.

10. Ürün senkronizasyonunu başlatın

İlk senkronizasyonu çalıştırın.

Ürün sayısını kaydedin.

Hatalı ürünleri inceleyin.

Varyasyon sonuçlarını ayrıca kontrol edin.

11. Bağlantıyı doğrulayın

WooCommerce bağlantı ekranını kontrol edin.

Events Manager veri akışını inceleyin.

Commerce Manager ürün sonuçlarını doğrulayın.

Bağlantı Sonrası İlk Kontroller

Kurulum sihirbazının tamamlanması, teknik doğrulamanın bittiği anlamına gelmez.

İlk kontrol listesi şöyledir:

• Doğru Pixel ID seçilmiş mi?

• Doğru Dataset kullanılıyor mu?

• Doğru katalog bağlı mı?

• Ürün senkronizasyonu başladı mı?

• Tarayıcı eventleri geliyor mu?

• Server eventleri geliyor mu?

• Aynı Purchase iki kez sayılıyor mu?

• Events Manager uyarı gösteriyor mu?

• Katalog ürün sayısı doğru mu?

Bağlantı başarısızsa WooCommerce bağlantı hatası rehberini izleyin. WooCommerce, yeniden bağlantı ve mevcut entegrasyon durumunu kontrol etme adımları sunar.

WooCommerce Event Mapping Nasıl Yapılmalıdır?

Event mapping, WooCommerce aksiyonunun doğru Meta eventine dönüştürülmesidir.

Temel eşleşme şöyledir:

WooCommerce Aksiyonu	Meta Standard Event
Sayfa görüntüleme	PageView
Ürün görüntüleme	ViewContent
Site içi arama	Search
Sepete ekleme	AddToCart
Ödeme başlangıcı	InitiateCheckout
Ödeme bilgisi ekleme	AddPaymentInfo
Başarılı sipariş	Purchase
Hesap oluşturma	CompleteRegistration

Pixel ve CAPI aynı ticari olay için aynı event adını kullanmalıdır.

Pixel Purchase gönderirken CAPI farklı bir özel event gönderirse Meta iki sinyali kolayca eşleştiremez.

Purchase Event Ne Zaman Gönderilmelidir?

Purchase event, doğrulanmış ticari sonucu temsil etmelidir.

Her ödeme yöntemi aynı sipariş akışını kullanmaz.

Bu nedenle tek bir global WooCommerce durumu her mağazada doğru sonuç üretmez.

Online kart ödemesi

Online ödeme sağlayıcısı tahsilatı anında doğrulayabilir.

Purchase şu koşullarda gönderilmelidir:

• Ödeme başarılıdır.

• Sipariş kimliği oluşturulmuştur.

• Tutar doğrulanmıştır.

• Para birimi belirlenmiştir.

• Başarısız işlem filtrelenmiştir.

Processing veya Completed durumu kullanılabilir.

Seçim mağazanın sipariş akışına bağlıdır.

Havale veya EFT

Sipariş ödeme öncesinde oluşturulabilir.

Sipariş oluşumunu doğrudan Purchase saymak yanlış gelir oluşturabilir.

Daha güvenli akış şöyledir:

1. Sipariş oluşturulur.

2. Ödeme beklenir.

3. Ödeme doğrulanır.

4. Sipariş durumu güncellenir.

5. Purchase event gönderilir.

Kapıda ödeme

Kapıda ödeme siparişi her zaman tamamlanmış gelir değildir.

Teslim edilmeyen siparişler yüksekse ilk sipariş oluşumu yanıltıcı sinyal üretir.

İşletme şu seçenekleri değerlendirmelidir:

• Sipariş oluşumunda Purchase gönderme

• Kargoya teslimde Purchase gönderme

• Teslimat doğrulamasında Purchase gönderme

• Gerçekleşmeyen siparişleri ayrı işleme

Karar, reklam optimizasyonu ile finansal doğruluk arasındaki dengeye göre verilmelidir.

İptal ve iade işlemleri

Meta Purchase olayı gönderildikten sonra sipariş iptal edilebilir.

WooCommerce raporu bu geliri düşürebilir. Meta Ads Manager aynı geliri atfedilen dönüşüm olarak göstermeye devam edebilir.

Bu nedenle şu verileri ayrı takip edin:

• Brüt sipariş

• Ödenmiş sipariş

• İptal edilen sipariş

• İade edilen sipariş

• Net gelir

Pixel ve CAPI Deduplication Nasıl Çalışır?

Deduplication, aynı dönüşümün iki kez sayılmasını engeller.

Pixel aynı Purchase olayını tarayıcıdan gönderir.

CAPI aynı Purchase olayını sunucudan gönderir.

Meta iki olayı şu alanlarla eşleştirir:

• Aynı event_name

• Aynı event_id

Meta dokümantasyonu, Pixel tarafındaki eventID değerinin CAPI tarafındaki event_id değeriyle eşleşmesi gerektiğini açıkça belirtir.

Event ID Nedir?

Event ID, aynı ticari olayın benzersiz kimliğidir.

Purchase olayı için WooCommerce sipariş kimliği temel alınabilir.

Örnek:

purchase_8451

Bu değer iki kanalda aynı olmalıdır:

Browser event: event_name \= Purchase eventID \= purchase_8451

Server event: event_name \= Purchase event_id \= purchase_8451

Sağlıklı Event ID Özellikleri

Event ID şu koşulları karşılamalıdır:

• Her sipariş için benzersizdir.

• Pixel ve CAPI tarafında aynıdır.

• Sayfa yenilemesinde değişmez.

• Farklı siparişlerde tekrar kullanılmaz.

• Aynı ticari olayı temsil eder.

• Event loglarında aranabilir.

Duplicate Purchase Neden Oluşur?

En yaygın nedenler şunlardır:

• Pixel ve CAPI farklı event ID kullanır.

• Pixel event ID göndermez.

• CAPI event ID göndermez.

• Aynı mağazada iki Pixel çalışır.

• İki CAPI entegrasyonu aynı olayı gönderir.

• GTM ve eklenti aynı Purchase olayını tetikler.

• Teşekkür sayfası her yenilemede event üretir.

• Webhook retry işlemi yeni event ID oluşturur.

• Pixel ve CAPI farklı event adı kullanır.

Yanlış deduplication örneği

Pixel eventID: purchase_8451 CAPI event_id: order_8451

Meta bu değerleri farklı olay olarak değerlendirebilir.

Doğru deduplication örneği

Pixel eventID: purchase_8451 CAPI event_id: purchase_8451

Meta aynı olayı tanıyabilir.

Duplicate Purchase İşletmeyi Nasıl Etkiler?

Çift Purchase yalnızca teknik hata değildir.

Şu sonuçları oluşturur:

• Meta geliri şişer.

• ROAS yüksek görünür.

• CPA düşük görünür.

• CAC yanlış hesaplanır.

• Başarısız reklam seti ölçeklenir.

• Kreatif performansı yanlış yorumlanır.

• Ajans raporu güven kaybeder.

Aylık 1.000 gerçek sipariş bulunan bir mağaza düşünün.

Sistem 100 siparişi iki kez sayarsa Meta 1.100 Purchase gösterebilir. Paneldeki dönüşüm hacmi yüzde 10 şişer.

Bu oran örnek senaryodur. Gerçek fark teknik audit ile ölçülmelidir.

WooCommerce Ürünleri Meta Kataloğuyla Nasıl Eşleştirilir?

Event içindeki ürün kimliği, katalogdaki ürün kimliğiyle aynı olmalıdır.

Meta, content_ids alanını eventteki ürünleri katalog kayıtlarıyla ilişkilendirmek için kullanır.

Kimlik standardı şu seçeneklerden biri olabilir:

• WooCommerce Product ID

• WooCommerce Variation ID

• SKU

• Meta retailer ID

Product ID

Product ID, WooCommerce ana ürün kaydını temsil eder.

Basit ürünlerde kullanışlıdır.

Değişken ürünlerde varyasyon ayrımını sınırlayabilir.

Variation ID

Variation ID, ürün varyasyonunu temsil eder.

Örnek varyasyonlar:

• Renk

• Beden

• Paket

• Depolama alanı

Katalog varyasyonları ayrı kayıt olarak tutuyorsa event de Variation ID göndermelidir.

SKU

SKU, işletme tarafından belirlenen stok kodudur.

SKU şu koşullarda kullanılabilir:

• Her üründe bulunur.

• Her değer benzersizdir.

• Feed aynı SKU değerini kullanır.

• Varyasyonlarda tutarlı uygulanır.

Boş veya tekrar eden SKU değerleri eşleşme sorunları oluşturur.

Temel eşleşme kuralı

Katalog hangi kimliği kullanıyorsa event aynı kimliği göndermelidir.

Şu yapı yanlıştır:

Katalog kimliği: SKU-RED-42 Event content_ids: 8451

Şu yapı tutarlıdır:

Katalog kimliği: SKU-RED-42 Event content_ids: SKU-RED-42

Katalog Eşleşme Hataları

Yaygın hatalar şunlardır:

• Event Product ID gönderir.

• Katalog SKU kullanır.

• Variation ID katalogda bulunmaz.

• Aynı ürün iki katalogda bulunur.

• Manuel katalog ile eklenti kataloğu karışır.

• Ürün senkronizasyonu tamamlanmaz.

• Silinen ürün katalogda kalır.

• SKU değerleri tekrar eder.

• Ürün varyasyonları ana ürüne bağlanmaz.

Bu sorunlar şu çıktıları etkiler:

• Dinamik ürün reklamları

• Katalog yeniden hedefleme

• ViewContent eşleşmesi

• AddToCart eşleşmesi

• Purchase ürün raporlaması

• Ürün bazlı performans analizi

Event Match Quality Nasıl Artırılır?

Event Match Quality, server event ile gönderilen müşteri bilgilerinin Meta hesaplarıyla eşleşme gücünü değerlendirir. Meta, bu metriği CAPI üzerinden doğru müşteri bilgilerinin gönderilip gönderilmediğini değerlendirmek için kullanır.

WooCommerce şu sinyalleri sağlayabilir:

• E-posta

• Telefon

• External ID

• FBP

• FBC

• IP adresi

• User agent

• Şehir

• Posta kodu

• Ülke

Meta bu alanları customer information parameters olarak tanımlar. Bu kullanıcı tanımlayıcıları event bilgisiyle birlikte gönderilir.

E-posta normalizasyonu

E-posta adresini küçük harfe çevirin.

Baş ve son boşlukları temizleyin.

Geçersiz değerleri göndermeyin.

Telefon normalizasyonu

Telefonu ülke koduyla standartlaştırın.

Boşlukları kaldırın.

Parantez ve gereksiz işaretleri temizleyin.

Eksik numaraları göndermeyin.

External ID kullanımı

External ID, işletmenin kullanıcıyı tutarlı biçimde tanımladığı kimliktir.

Şu kaynaklardan üretilebilir:

• WooCommerce müşteri kimliği

• CRM müşteri kimliği

• Üyelik sistemi kimliği

Aynı müşteri için tutarlı değer kullanılmalıdır.

Meta, External ID’nin farklı kanallardan gönderilebildiğini ve diğer müşteri bilgileriyle birlikte kullanılabildiğini belirtir.

FBP ve FBC kullanımı

FBP, Meta tarayıcı kimliğiyle ilişkilidir.

FBC, Meta reklam tıklamasıyla ilişkilidir.

Bu değerler mevcutsa server evente aktarılabilir.

Sistem olmayan değeri üretmemelidir. Gerçek tarayıcı ve tıklama bağlamı korunmalıdır.

Event Match Quality Neyi Kanıtlamaz?

Yüksek Event Match Quality tüm kurulumun doğru olduğunu kanıtlamaz.

Bu metrik şu kontrollerin yerine geçmez:

• Purchase event kapsamı

• Event deduplication

• Sipariş tutarı doğruluğu

• Para birimi doğruluğu

• Ürün katalog eşleşmesi

• İade yönetimi

• WooCommerce gelir mutabakatı

Örneğin müşteri parametreleri güçlü olabilir.

Ancak Purchase olaylarının bir bölümü API hatası nedeniyle kaybolabilir.

Aynı şekilde tüm eventler gelebilir.

Fakat hatalı event_id çift sayım oluşturabilir.

Hashing ve Kullanıcı İzni Aynı Şey Değildir

Hashing, belirli müşteri verilerini aktarım öncesinde standart bir biçime dönüştürür.

Hashing kullanıcı izninin yerine geçmez.

Sunucu tarafı takip de izin kurallarını kaldırmaz.

İşletme şu alanları ayrıca yönetmelidir:

• KVKK yükümlülükleri

• Açık rıza gereksinimi

• Çerez tercihleri

• Veri minimizasyonu

• Veri saklama süresi

• Kullanıcı silme talepleri

• Veri işleme sözleşmeleri

Yalnızca gerekli ve izinli veriler gönderilmelidir.

Meta Test Events ile Kurulum Nasıl Doğrulanır?

Test Events, eventlerin Meta’ya ulaşıp ulaşmadığını gösterir.

Ancak test yalnızca event teslimini değil, event kalitesini de incelemelidir.

1. Test Events ekranını açın

Meta Events Manager’a girin.

Doğru Dataset’i seçin.

Test Events bölümünü açın.

2. Test ürünü belirleyin

Tek bir ürün seçin.

Ürün kimliğini kaydedin.

Fiyatı ve para birimini not edin.

3. Test siparişi oluşturun

Ürünü görüntüleyin.

Sepete ekleyin.

Checkout başlatın.

Test ödemesini tamamlayın.

Sipariş kimliğini kaydedin.

4. Browser eventleri kontrol edin

Şu olayları inceleyin:

• ViewContent

• AddToCart

• InitiateCheckout

• Purchase

Her olayda şu alanları kontrol edin:

• Event adı

• Event zamanı

• Event ID

• Sayfa adresi

• Product ID

• Value

• Currency

5. Server eventleri kontrol edin

Aynı eventlerin server kaynağından gelip gelmediğini kontrol edin.

Şu alanları inceleyin:

• event_name

• event_time

• event_id

• action_source

• user_data

• custom_data

• Dataset

6. Deduplication sonucunu kontrol edin

Browser ve server Purchase olaylarını bulun.

Event ID değerlerini karşılaştırın.

İki eventin tekilleştirilip tekilleştirilmediğini inceleyin.

Meta’nın API kullanım dokümantasyonu, çift olayları önlemek için event kimliğinin istekle gönderilmesini önerir.

7. Diagnostics uyarılarını inceleyin

Şu uyarılara odaklanın:

• Missing event ID

• Duplicate events

• Invalid value

• Missing currency

• Missing user data

• Delayed server event

• Invalid content ID

• Eksik parametre

8. WooCommerce loglarını kontrol edin

API isteklerinin sonucunu inceleyin.

Başarısız eventleri bulun.

Tekrar gönderim davranışını kontrol edin.

Bağlantı ve ürün senkronizasyonu sorunlarında WooCommerce dokümantasyonu yeniden bağlantıyı ve mevcut bağlantı durumunun kontrolünü önerir.

Test Events Neyi Kanıtlamaz?

Test Events içinde başarılı bir Purchase görmek önemlidir.

Ancak bu sonuç tüm kurulumu doğrulamaz.

Test Events şu soruları tek başına cevaplamaz:

• Tüm gerçek siparişler geliyor mu?

• Uzun dönem event kaybı bulunuyor mu?

• İadeler doğru işleniyor mu?

• Katalogdaki tüm ürünler eşleşiyor mu?

• Meta geliri net işletme geliriyle tutarlı mı?

• Attribution farkı ne kadar?

• Farklı ödeme yöntemleri doğru çalışıyor mu?

Bu nedenle test sonrasında sipariş mutabakatı gerekir.

WooCommerce ve Meta Sipariş Mutabakatı Nasıl Yapılır?

Mutabakat, WooCommerce siparişleriyle Meta eventlerini aynı dönemde karşılaştırır.

1. Tarih aralığını belirleyin

En az yedi günlük veri kullanın.

Yüksek hacimli mağazalar daha kısa dönemleri de inceleyebilir.

Aynı başlangıç ve bitiş tarihini kullanın.

2. Saat dilimini eşitleyin

WooCommerce saat dilimini kaydedin.

Meta reklam hesabı saat dilimini kontrol edin.

Gün sınırlarındaki farkları ayırın.

3. Sipariş durumlarını sınıflandırın

Şu grupları ayrı tutun:

• Ödenmiş

• Processing

• Completed

• Failed

• Cancelled

• Refunded

4. Purchase event sayısını çıkarın

Meta Events Manager içindeki Purchase hacmini alın.

Ads Manager atfedilen Purchase sayısını ayrıca alın.

İki sayı aynı metrik değildir.

Events Manager event teslimini gösterir.

Ads Manager reklam atribüsyonunu gösterir.

5. Sipariş farkını hesaplayın

Teknik Sipariş Farkı \= Doğrulanmış WooCommerce Siparişleri - Geçerli Meta Purchase Eventleri

Negatif sonuç duplicate event riskini gösterebilir.

Pozitif sonuç eksik event riskini gösterebilir.

6. Gelir farkını hesaplayın

Gelir Farkı \= WooCommerce Doğrulanmış Geliri - Meta Tarafında Raporlanan Gelir

Gelir farkı yalnızca teknik kayıptan oluşmaz.

Attribution kuralları da sonucu etkiler.

7. Attribution farkını teknik kayıptan ayırın

Attribution farkı şu nedenlerle oluşabilir:

• View-through dönüşüm

• Click-through dönüşüm

• Cross-device eşleşme

• Attribution penceresi

• Kampanyalar arası kredi dağılımı

Teknik fark şu nedenlerle oluşabilir:

• Event gönderim hatası

• Yanlış Dataset

• Yanlış Purchase tetikleyicisi

• Event ID eksikliği

• Duplicate event

• Yanlış değer

• Yanlış para birimi

• Consent durumu

Örnek Mutabakat Tablosu

Aşağıdaki rakamlar örnektir.

Kontrol	WooCommerce	Meta	İnceleme
Ödenmiş sipariş	500	470	Eksik event araştırılır
Events Manager Purchase	—	485	Duplicate kontrol edilir
Net gelir	1.000.000 TL	1.080.000 TL	Attribution incelenir
İade	60.000 TL	Ayrı görünmeyebilir	Net gelir ayrıştırılır

Sipariş sayısı ile gelir aynı anda kontrol edilmelidir.

Doğru sipariş sayısı, doğru gelir anlamına gelmez.

Standart Meta Entegrasyonu Ne Zaman Yeterlidir?

Standart entegrasyon bazı mağazalarda yeterli sonuç verebilir.

Şu koşullar bunu destekler:

• Tek WooCommerce mağazası bulunur.

• Tek Meta işletmesi kullanılır.

• Standart ödeme akışı vardır.

• Temel e-ticaret eventleri yeterlidir.

• CRM bağlantısı gerekmez.

• Özel ürün kimliği kullanılmaz.

• Düzenli audit yapılır.

• Sipariş uyuşmazlığı düşüktür.

WooCommerce’in resmî entegrasyonu ürün senkronizasyonu ve Meta bağlantısı için otomatik bir kurulum sunar. Ancak kurulum sonrası katalog, event ve bağlantı sonuçlarının ayrıca kontrol edilmesi gerekir.

Özel CAPI veya Veri Zenginleştirme Ne Zaman Gerekir?

Gelişmiş yapı şu durumlarda önem kazanır:

• Aylık sipariş hacmi yüksektir.

• Birden fazla Pixel bulunur.

• Çoklu mağaza yönetilir.

• Özel ödeme akışı kullanılır.

• CRM verisi işlenir.

• LTV optimizasyonu yapılır.

• Yeni müşteri ayrımı gerekir.

• İade verisi işlenir.

• Özel eventler kullanılır.

• Ayrıntılı API logları gerekir.

• Başarısız eventler tekrar gönderilir.

• Meta dışındaki platformlara veri iletilir.

Data4Ad’in öncelikli profili aylık 500 ve üzeri sipariş alan WooCommerce mağazalarını kapsar. Ajans segmenti ise yüksek hacimli e-ticaret hesaplarını yöneten performans ekiplerinden oluşur.

Yüksek hacimde küçük hata oranları büyük karar farkları oluşturur.

Aylık 10.000 siparişte yüzde 3 teknik fark, 300 sipariş eder.

Bu oran örnek senaryodur. Gerçek kayıp audit ile ölçülmelidir.

WooCommerce Meta CAPI Audit Kontrol Listesi

Meta varlıkları

• Business Portfolio doğru mu?

• Reklam hesabı doğru mu?

• Facebook sayfası doğru mu?

• Pixel doğru mu?

• Dataset doğru mu?

• Katalog doğru mu?

• Domain doğrulanmış mı?

Event yapısı

• PageView çalışıyor mu?

• ViewContent çalışıyor mu?

• AddToCart çalışıyor mu?

• InitiateCheckout çalışıyor mu?

• Purchase doğru zamanda mı oluşuyor?

• Event adları standart mı?

Deduplication

• Browser event geliyor mu?

• Server event geliyor mu?

• eventID bulunuyor mu?

• event_id bulunuyor mu?

• İki değer aynı mı?

• Sipariş başına tek Purchase var mı?

• Çift Pixel bulunuyor mu?

Purchase verisi

• Sipariş kimliği geliyor mu?

• Tutar doğru mu?

• Para birimi doğru mu?

• Ürün kimlikleri geliyor mu?

• Ürün adedi doğru mu?

• Ödeme durumu kontrol ediliyor mu?

• Başarısız siparişler filtreleniyor mu?

Müşteri eşleştirme verisi

• E-posta doğru mu?

• Telefon standart mı?

• External ID tutarlı mı?

• FBP aktarılıyor mu?

• FBC aktarılıyor mu?

• IP adresi izin kapsamında mı?

• User agent geliyor mu?

Katalog eşleşmesi

• content_ids katalogla eşleşiyor mu?

• Product ID standardı tutarlı mı?

• Variation ID doğru mu?

• SKU değerleri benzersiz mi?

• İkinci katalog bulunuyor mu?

• Ürün senkronizasyonu güncel mi?

Teknik izleme

• API sonuçları loglanıyor mu?

• Başarısız istekler sınıflandırılıyor mu?

• Retry mekanizması çalışıyor mu?

• Diagnostics uyarıları takip ediliyor mu?

• Bağlantı kopması izleniyor mu?

İşletme mutabakatı

• Sipariş sayıları karşılaştırıldı mı?

• Gelir karşılaştırıldı mı?

• Saat dilimleri eşitlendi mi?

• İadeler ayrıldı mı?

• İptaller ayrıldı mı?

• Attribution farkı ayrıca yorumlandı mı?

Sık Sorulan Sorular

WooCommerce Meta CAPI nasıl kurulur?

WooCommerce mağazası doğru Meta Business Portfolio, reklam hesabı, Facebook sayfası, Pixel, Dataset ve ürün kataloğuna bağlanır.

Kurulum sonrası browser ve server eventleri Events Manager içinde test edilir.

Meta Pixel ve CAPI birlikte kullanılmalı mı?

Evet.

Pixel tarayıcı olaylarını gönderir. CAPI sunucu olaylarını gönderir. Meta iki kaynağın birlikte kullanılmasını destekler.

WooCommerce Purchase neden iki kez sayılır?

Pixel ve CAPI farklı event ID kullanabilir.

Aynı mağazada ikinci Pixel de çalışabilir. GTM ve eklenti aynı Purchase olayını ayrıca gönderebilir.

Event ID olarak WooCommerce Order ID kullanılabilir mi?

Evet.

Sipariş kimliği temelli benzersiz bir yapı kullanılabilir. Pixel ve CAPI aynı değeri göndermelidir.

Örnek:

purchase_{order_id}

Event ID ile Order ID aynı kavram mıdır?

Hayır.

Order ID işletme siparişini tanımlar.

Event ID Meta’ya gönderilen olayı tanımlar.

Purchase event ID değeri Order ID kullanılarak üretilebilir.

Purchase hangi sipariş durumunda gönderilmelidir?

Tetikleyici ödeme yöntemine göre seçilmelidir.

Online ödeme kullanan mağaza başarılı tahsilatı doğrulamalıdır. Havale ve kapıda ödeme farklı doğrulama mantığı gerektirir.

Event Match Quality nasıl artırılır?

Doğru müşteri parametreleri gönderilmelidir.

E-posta, telefon, External ID, FBP ve FBC değerleri standart ve tutarlı olmalıdır.

Yüksek Event Match Quality kurulumu doğrular mı?

Hayır.

Event kapsamı, deduplication, sipariş değeri ve katalog eşleşmesi ayrıca kontrol edilmelidir.

Product ID mi SKU mu kullanılmalıdır?

Katalog ve event aynı kimlik standardını kullanmalıdır.

Katalog SKU kullanıyorsa event de aynı SKU değerini göndermelidir.

Test Events başarılıysa kurulum tamamlanır mı?

Hayır.

Test Events event teslimini gösterir. Gerçek sipariş sayısı ve gelir WooCommerce verisiyle ayrıca karşılaştırılmalıdır.

Meta ile WooCommerce satışları neden uyuşmaz?

Teknik event kaybı fark oluşturabilir.

Duplicate event sonucu da değiştirebilir. Sipariş durumları ve reklam atribüsyonu ayrıca farklılık üretir.

Standart Meta entegrasyonu yeterli midir?

Basit mağazalarda yeterli olabilir.

Yüksek hacim, özel ödeme akışı, CRM bağlantısı ve ayrıntılı loglama ek altyapı gerektirebilir.

Server-side tracking KVKK yükümlülüklerini kaldırır mı?

Hayır.

Sunucu tarafı aktarım, izin ve veri işleme kurallarını ortadan kaldırmaz.

Sonuç

WooCommerce Meta CAPI kurulumu eklenti aktivasyonuyla tamamlanmaz.

Doğru Meta varlıkları seçilmelidir. WooCommerce eventleri standart Meta eventleriyle eşleşmelidir. Pixel ve CAPI aynı event_id değerini kullanmalıdır. Ürün kimlikleri katalogla tutarlı olmalıdır. Purchase tetikleyicisi ödeme akışına göre belirlenmelidir.

Test Events teknik teslimi gösterir.

Gerçek doğruluk sipariş mutabakatıyla ölçülür.

Data4Ad, WooCommerce eventlerini sunucu katmanında doğrular. Sistem Pixel ve CAPI olaylarını eşleştirir. Sistem duplicate Purchase riskini kontrol eder. Sistem ürün ve sipariş verisini tutarlı hale getirir. Teknik sonuçlar şeffaf biçimde raporlanır.

Data4Ad’in konumlandırması, basit event aktarımından daha geniştir. Marka; sunucu katmanında veri toplama, veri zenginleştirme ve reklam kararlarını güvenilir sinyallerle destekleme üzerine konumlanır.

WooCommerce CAPI Kurulumunuzu Kontrol Edin

Şu sorunlardan biri bulunuyorsa teknik audit gerekir:

• Meta ve WooCommerce satışları uyuşmuyor.

• Purchase olayları iki kez sayılıyor.

• Event Match Quality düşük kalıyor.

• Ürünler katalogla eşleşmiyor.

• Yanlış Pixel veri topluyor.

• Events Manager düzenli hata gösteriyor.

Data4Ad ile ücretsiz WooCommerce veri kaybı analizi başlatın.