Meta Conversions API nedir? Pixel ile farkı ve TR mağazasında kurulum

Not: Bu yazıdaki hesaplama örnekleri varsayımsal rakamlarla kurulmuştur; kendi mağazanızın maliyet, komisyon ve iade oranlarını yerine koyarak hesaplayın.

Meta Conversions API (CAPI) nedir?

Meta Conversions API (CAPI), reklam performansınızı ölçerken karşılaştığınız veri kaybını azaltmak ve daha güvenilir sonuçlar elde etmek için tasarlanmış bir araçtır. Bu yazıda CAPI’nin ne olduğunu, neden gerekli olduğunu ve nasıl çalıştığını adım adım açıklayacağız. Okur olarak, bu bölümü okuyduktan sonra CAPI’nin sadece bir teknik entegrasyon değil, reklam harcamalarınızın etkisini doğru ölçmek için temel bir altyapı olduğunu anlayacaksınız. Ayrıca, bu sistemin tarayıcı tabanlı yöntemlerle nasıl farklılaştığını ve neden modern e-ticarette kritik bir rol oynadığını kavrayacaksınız.

Geleneksel yöntem olan Meta Pixel, ziyaretçilerin tarayıcısında çalışan bir JavaScript kodu üzerinden veri toplar. Bu veri, sayfa görüntülemeleri, sepete eklemeler veya satın almalar gibi eylemleri Meta’nın sunucularına iletir. Ancak günümüzde reklam engelleyiciler, gizlilik ayarları (örneğin Apple’ın App Tracking Transparency veya GDPR uyumlu tarayıcı kısıtlamaları) ve ağ kesintileri bu veri akışını ciddi şekilde kesintiye uğratabilir. Sonuç olarak, Pixel tarafından raporlanan satışlar, varsayımsal olarak gerçek mağaza cironuzla %20-40 oranında fark gösterebilir. Bu fark, reklam bütçenizi yanlış yönlendirmenize, başarılı kampanyaları durdurmanıza veya etkisiz olanlara yatırım yapmanıza neden olabilir.

Burada Conversions API devreye girer. CAPI, tarayıcıya bağımlı olmadan, doğrudan sunucunuzun veya mağaza platformunuzun arka ucundan Meta’nın sunucularına olay verisi gönderir. Örneğin, bir müşteri sitenizde bir ürün satın aldığında, bu olay tarayıcı üzerinden değil, sunucunuz tarafından Meta API’sine güvenli bir HTTP isteğiyle iletilir. Bu sayede, reklam engelleyicileri, çerez kısıtlamaları veya tarayıcı güncellemeleri gibi faktörler veri akışını etkilemez. CAPI, Pixel’in yerini almaz; onu tamamlar. İkisi birlikte kullanıldığında, veri bütünlüğü maksimum seviyeye çıkarılır ve Meta’nın reklam algoritmaları daha doğru öğrenir.

CAPI’nin temel amacı basittir: gerçek veriyle reklam ölçümünü senkronize etmek. Bu, sadece teknik bir iyileştirme değil, karar verme sürecinizi veri odaklı hale getirmenin anahtarıdır. Özellikle Türkiye’deki e-ticaret mağazaları için, yüksek mobil kullanım oranı ve yaygın reklam engelleyici kullanımı göz önüne alındığında, CAPI’nin rolü daha da kritik hale gelir. Sonraki bölümlerde bu farkları detaylandırıp, ikas ve Shopify gibi platformlarda nasıl kurulacağını göstereceğiz. Şimdilik, CAPI’yi “sunucu tarafı doğrulama mekanizması” olarak düşünün: Pixel’in gördüğü şeyi, sunucunuzun da onaylayıp Meta’ya gönderen bir güvenlik katmanı.

CAPI vs Meta Pixel: temel farklar

Meta Pixel, kullanıcı tarayıcısında çalıştığı için reklam engelleyicileri ve iOS’un App Tracking Transparency (ATT) politikasıyla doğrudan etkilenir. Bu durum, özellikle iOS 14.5 ve sonrası cihazlarda kullanıcıların %30-50 oranında izlemeyi reddetmesiyle veri kaybına yol açar. Ayrıca JavaScript hataları, çerez sınırlamaları veya sayfa yükleme gecikmeleri de Pixel tarafından alınan etkinlik sayısını azaltabilir. Bu eksiklikler, reklam performansının altırapor edilmesini ve bütçe dağıtımındaki hatalı kararların riskini artırır.

CAPI ise bu riskleri azaltmak için sunucu tarafında veri gönderir. Tarayıcıya bağımlı olmadan, mağaza arka ucundan doğrudan Meta’nın sunucularına etkinlik verileri iletilir. Bu sayede ATT, reklam engelleyicileri veya çerez kısıtlamaları gibi faktörlerin etkisi minimize edilir. CAPI’nin başka bir avantajı da hassas müşteri verilerini (ör. e-posta, telefon numarası) hashleyerek göndererek gizlilik uyumluluğunu artırmasıdır. Ancak CAPI’nın etkili olması için sunucu tarafındaki entegrasyonun doğru ve eksiksiz olması gerekir; aksi takdirde duplicate veya eksik etkinlikler gibi sorunlar ortaya çıkabilir.

Event_id ile tekilleştirme ve veri bütünlüğü

Meta Conversions API (CAPI) ve Meta Pixel aynı alışverişi iki kez gönderdiğinde, reklam platformu bu eventi iki farklı dönüşüm olarak sayar. Bu durum ROAS ve POAS gibi metrikleri yanıltır ve bütçe dağılımını bozar. Tekilleştirme için event_id kullanılır. Bu benzersiz tanımlayıcı, aynı siparişin hem pixel hem de CAPI üzerinden iletilmesini engeller.

event_id, sipariş benzersiz kimliğiyle eşleşmelidir. Örneğin, ikas mağazasında sipariş numarası ORD-2024-0875 ise, bu değer hem pixel hem de CAPI eventi içinde event_id parametresi olarak gönderilmelidir. Meta, aynı event_id ile gelen iki eventi tek bir dönüşüm olarak sayar; ikinciyi yinelenen olarak reddeder.

Tekilleştirme mantığı şu şekilde çalışır:

event_id oluştururken dikkat edilmesi gereken iki kural vardır: İlk olarak, değerin her sipariş için değişmez olması gerekir. İkincisi, hem pixel hem de CAPI tarafında aynı şekilde üretilmesi veya aktarılması zorunludur. Örneğin, pixel tarafında JavaScript ile sipariş numarası okunup fbq('track', 'Purchase', {value: 299.99, currency: 'TRY', event_id: 'ORD-2024-0875'}) şeklinde gönderiliyorsa, CAPI tarafında da aynı event_id değeri payload içinde yer almalıdır. Farklı bir değer (örneğin zaman damgası veya rastgele sayı) kullanılırsa Meta iki eventi ayrı olarak sayar ve tekilleştirme başarısız olur.

Kontrol için Meta Events Manager’da “Test Events” aracı kullanılır. Burada gelen eventi inceleyip event_id alanının hem pixel hem de CAPI kaynağından geldiğini ve değerinin aynı olduğunu doğrulayabilirsiniz. Aynı ID ile iki kez gelen eventi “Deduplicated” olarak görürsünüz; bu, sistemin düzgün çalıştığını gösterir.

Hatalı tekilleştirme en sık iki sebeple olur: İlk olarak, CAPI tarafında event_id eksik gönderilir. İkincisi, pixel tarafında dinamik değer (örneğin zaman damgası) kullanılır ve her sayfa yüklemesinde farklı bir ID üretilir. Bu durumda Meta her iki eventi ayrı olarak sayar ve varsayımsal olarak yüksek dönüşüm raporu oluşur. Düzeltilmesi için, event_id’nin sipariş veritabanından gelen sabit bir değer olduğundan emin olun.

ikas mağazasında CAPI kurulumu

ikas panelinden Meta entegrasyonu sekmesi üzerinden CAPI anahtarınızı ve piksel ID'nizi girerek kurulum tamamlanır. Bu bölümde ikas'ta gerekli adımlar ve kontrol noktaları listelenir.

1. ikas yönetim panelinize giriş yapın ve sol menüden Pazarlama → Meta Entegrasyonu sekmesine gidin.
2. Meta geliştirici hesabınızdan developers.facebook.com/apps adresine giderek sistem kullanıcı oluşturun ve bu kullanıcıya ads_management, ads_read, business_management izinlerini verin.
3. Oluşturduğunuz sistem kullanıcısı için Access Token oluşturun (Token v2.12 veya üzeri olmalı, 60 gün geçerli). Bu token, CAPI anahtarınız olarak kullanılacaktır.
4. ikas Meta entegrasyonu ekranında CAPI Anahtarı alanına bu access token'ı yapıştırın.
5. Aynı ekranda Pixel ID alanına Meta Events Manager'dan aldığınız piksel ID'nizi girin (örn: 123456789012345).
6. Test Events sekmesine giderek ikas'tan gelen test olaylarını (örn: ViewContent, AddToCart, Purchase) Meta'nın Events Manager > Test Events sayfasında doğrulayın.
7. Test olaylarının event_id ile tekilleştirildiğini ve server kaynağı olarak göründüğünü kontrol edin (Pixel tarafında duplicate olmamalı).
8. Canlı trafik için 24 saat bekleyin ve ikas panelindeki Meta Entegrasyonu Durum göstergesinin Aktif olduğunu onaylayın.

Varsayımsal olarak: ikas mağazanızda günlük 500 TL reklam harcaması yapıyorsunuz ve bu harcamadan 1500 TL net kâr elde ediyorsunuz. POAS (net kâr ÷ reklam harcaması) formülüyle hesaplama: POAS = 1500 ÷ 500 = 3.0. Bu, her 1 TL reklam harcaması için 3 TL net kâr ürettiğinizi gösterir. CAPI kurulumu tamamlandığında bu POAS değeri daha güvenilir olur çünkü server-side tracking sayesinde iOS 14+ sınırlamaları ve reklam engelleyicileri nedeniyle kaybedilen veri geri kazanılır.

Shopify mağazasında CAPI kurulumu

Shopify admin panelinizden sol menüdeki Uygulamalar sekmesine gidin. Arama çubuğuna Meta Facebook yazın ve Meta Facebook uygulamasını bulup Uygulamayı ekle butonuna tıklayın. Uygulama izni ekranında Uygulamayı yükle seçeneğini onaylayın.

Uygulama yüklendikten sonra Kanallar menüsü altında Meta Facebook seçeneği görünecektir. Bu sekmeye tıklayın ve Bağlantı ayarları sekmesine geçin. Burada Veri paylaşımı başlığı altında Conversions API (CAPI) seçeneğini bulun ve Etkinleştir butonuna tıklayın.

CAPI etkinleştirildikten sonra sistem otomatik olarak Access Token ve Pixel ID bilgilerinizi doldurur. Bu değerlerin doğru olduğundan emin olmak için Pixel ID kısmını Meta Events Manager üzerinden kontrol edin. Yanlış bir Pixel ID girildiğinde veri akışı kesilir.

Etkinleştirme tamamlandıktan sonra Event yönetimi sekmesine gidin. Burada Purchase, AddToCart, ViewContent gibi temel e-ticaret olaylarının aktif olup olmadığını kontrol edin. Eksik olan olaylar için Olay ekle butonunu kullanarak manuel olarak ekleyebilirsiniz.

Kurulum sonrası Meta Events Manager üzerinden Test Events aracını çalıştırın. Shopify mağazanızda bir test siparişi verin ve gerçek zamanlı olarak Purchase olayı gelip gelmediğini kontrol edin. Olay gelmiyorsa Hata ayıklama sekmesinden Access Token süresi dolmuş veya Pixel ID uyuşmuyor gibi uyarıları inceleyin.

Sık karşılaşılan hatalar arasında Access Token yenilenmedi (Shopify bu işlemi otomatik yapar ancak bazen yeniden yetkilendirme gerekir), Pixel ID hatalı girildi ve İzin kapsamı eksik (örneğin ads_management veya pages_read_engagement eksik) yer alır. Bu durumlarda uygulama sayfasından Bağlantıyı kes ve Yeniden bağla adımlarını tekrarlayın.

Veri bütünlüğü için event_id parametresinin Shopify tarafından otomatik olarak gönderildiğinden emin olun. Bu değer, aynı siparişin Pixel ve CAPI üzerinden iki kez sayılmasını engeller. Shopify Meta kanalı bu işlemi varsayılan olarak yapar; elle müdahale gerekmez.

Kurulum sonrası kontrol ve sık hatalar

Meta Events Manager’da test eventi göndererek CAPI’nin çalıştığını doğrulayın. Sol menüden Veri Kaynakları → Web → Etkinlikler sekmesine gidin. Test Etkinliği Gönder butonuna tıklayın, ardından Purchase gibi bir etkinlik seçin. Gönderilen veri paketinin event_id alanının dolu ve benzersiz olduğundan emin olun; bu alan eksikse Meta aynı eventi tekrar sayar ve raporlardaki çiftleşme artar.

Yaygın hatalar şunlardır: eksik event_id, yanlış piksel ID (Business Settings’teki ID ile Events Manager’da görülen ID farklıysa), yetkisiz erişim (sistem kullanıcısının Events Manager ve Pixel izinlerine sahip olmaması). Ayrıca access token süresi dolmuş olabilir; uzun süreli token üretip 60 günlük yenileme döngüsünü kontrol edin.

Doğrulama adımları:

1. Events Manager’da Test Etkinliği Gönder ile bir Purchase eventi tetikleyin.
2. Gönderilen veri içinde event_id ve pixel_id alanlarının varlığını ve formatını kontrol edin.
3. Hata mesajı varsa Hata Ayrıntıları sekmesinden kodunu not alın (örnek: 100, 190, 200).
4. Access token’i Meta Developer’da yeniden üretip, ikas/Shopify entegrasyon sayfasına yapıştırın.
5. 24 saat içinde gerçek alışveriş eventiyle karşılaştırın; CAPI ile Pixel arasındaki fark %5’i aşmamalıdır.

Yarın yapmanız gereken: Test eventi gönderip, event_id doluluğunu ve piksel ID eşleşmesini onaylayın. Eğer hata alıyorsanız, access token’i yenileyip sistem yetkilerini kontrol edin. Başarılı kurulum, veri bütünlüğünü korur ve NetROAS gibi araçlarla net kârlılık ölçümünüzü güvenilir hale getirir.

İlgili araçlar ve yazılar

• POAS nedir, nasıl hesaplanır?
• Meta'nın bildirdiği ciro neden mağaza cironuzla tutmuyor?
• GA4 cirosu mağaza cironuzla neden tutmuyor?
• ikas mağazasında reklam atıflama nasıl kurulur?
• POAS hesaplayıcı (ücretsiz)

Kaynaklar

• Meta Conversions API Overview
• Meta Conversions API belgeleri
• Meta Pixel belgeleri
• ikas e-ticaret altyapısı
• Meta İşletme Yardım Merkezi