Detaylı tanım
Pixel tarayıcı (cookie) bazlı veri toplar; iOS 14.5+ ATT (App Tracking Transparency) ile %30-40 veri kayboldu. CAPI server-side conversion gönderir; cookie kısıtlamalarından etkilenmez. Kurulum: Stape, Google Tag Manager Server-Side, Shopify CAPI app vb. CAPI + Pixel kombinasyonu = data quality skoru maksimuma çıkar.
CAPI (Conversions API) nasıl çalışır?
CAPI teknik olarak sunucunuzdan Meta'nın uç noktasına gönderilen bir olay bildirimidir. Gövdesinde olayın adı, zamanı, kaynağı yani site, uygulama ya da fiziksel mağaza bilgisi, değeri ve para birimi ile eşleştirme için kullanılan kullanıcı verileri bulunur: e-posta, telefon, ad, soyad, şehir, posta kodu, ülke ve varsa dahili müşteri kimliği. Bu alanlar gönderilmeden önce normalize edilip SHA-256 ile özetlenir; yanına tarayıcıdan alınan çerez değerleri, IP adresi ve tarayıcı bilgisi eklenir. Meta eşleşmeyi bu parametrelerin üzerinden kurar. Gönderdiğiniz doğru parametre sayısı arttıkça olay eşleştirme kalitesi yükselir; eksik ve düzensiz veri ise olayın hiç eşleşmemesi anlamına gelir.
Kurulumun kritik parçası tekilleştirmedir. Aynı satın alma hem tarayıcıdaki pikselden hem sunucudan gidiyorsa, iki bildirimin de aynı olay kimliğini ve aynı olay adını taşıması gerekir; Meta bu ikisini eşleyip tek olay olarak sayar. Kimlik verilmezse aynı satış iki kez sayılır, raporlanan dönüşüm ve ROAS şişer, daha kötüsü optimizasyon yanlış sinyalle öğrenir. Kurulum yolları arasında hazır e-ticaret eklentileri en hızlısı ama en kısıtlısıdır; sunucu tarafı etiket yöneticisi esneklik ve zenginleştirme imkânı verir; doğrudan arka uçtan, sipariş kaydının oluştuğu yerden gönderim ise en güvenilir olanıdır, çünkü olayın kaynağı ile bildirimin çıktığı yer aynıdır.
CAPI'nin az kullanılan tarafı çevrimdışı ve gecikmeli dönüşümlerdir. Reklamdan gelen bir talebin haftalar sonra telefonda, mağazada veya saha ziyaretinde satışa dönmesi durumunda, bu satış CRM'den geriye bildirilebilir. Böylece sistem form dolduran kişiye değil, gerçekten satın alan profile benzeyen kişilere yönelmeye başlar; B2B ve yüksek fiyatlı satışlarda asıl kazanç buradadır. Hukuki taraf ise teknikten ayrı düşünülmemelidir: özetleme anonimleştirme değildir, KVKK kapsamında açık rıza ve aydınlatma yükümlülüğü sürer. Rıza vermemiş kullanıcının verisini sunucudan göndermek, tarayıcı kısıtını aşmak değil, uyum riskini büyütmektir. Bu nedenle rıza yönetimi ile gönderim mantığı aynı kurala bağlanmalı, rıza durumu sunucu tarafına da taşınmalıdır.
Hangi terimlerle karıştırılıyor?
| Karıştırılan terim | Aradaki fark |
|---|---|
| Meta Pixel | Piksel tarayıcıda çalışır; çerez kısıtları, reklam engelleyiciler ve izleme sınırlamalarından etkilenir. CAPI olayı sunucudan gönderir ve tarayıcıdan bağımsızdır. İkisi birlikte, tekilleştirmeli kurulur. |
| Sunucu tarafı etiket yöneticisi (sGTM) | sGTM olayları toplayıp birden çok hedefe dağıtan taşıma altyapısıdır. CAPI ise Meta'nın kabul ettiği uç noktanın kendisidir; sGTM onu besleyen yollardan yalnızca biridir, zorunlu değildir. |
| Google Enhanced Conversions | Aynı ölçüm sorununu Google tarafında çözer. Parametreleri, özetleme kuralları ve tekilleştirme mantığı ayrıdır; Meta için yapılan kurulum Google tarafını kendiliğinden karşılamaz, iki entegrasyon ayrı yürütülür. |
| Çevrimdışı dönüşüm yükleme | Sitede hiç gerçekleşmemiş, mağazada veya telefonda kapanan satışları geriye bildirir. Aynı uç nokta üzerinden, olay kaynağı alanı farklı verilerek gönderilir ve gecikmeli satışları optimizasyona dahil eder. |
Sık yapılan hatalar
Pikseli kapatıp yalnız CAPI'ye geçmek
Tarayıcıdan gelen çerez değerleri, eşleştirme kalitesini yükselten parametreler arasındadır. Piksel kaldırıldığında bu sinyaller kaybolur ve sunucudan gönderilen olayların bir kısmı kişiyle eşleşemez. Önerilen kurulum, ikisinin birlikte, aynı olay kimliğiyle ve tekilleştirme kuralı tanımlanmış biçimde çalışmasıdır.
Olay kimliği tanımlamamak
Tekilleştirme kurulmazsa aynı satın alma iki kaynaktan iki kez sayılır. Panelde görünen dönüşüm sayısı ve ROAS gerçeğin belirgin biçimde üzerinde çıkar, bütçe kararları bu şişmiş rakama göre verilir ve algoritma da hatalı sinyalle eğitildiği için yanlış kitleye yönelir.
Veriyi normalize etmeden göndermek
E-posta adresindeki büyük harfler ve boşluklar, ülke kodu bulunmayan telefon numaraları farklı özet değerleri üretir ve eşleşme tutmaz. Gönderim öncesinde küçük harfe çevirme, boşluk temizleme ve telefonu uluslararası biçime getirme adımları zorunludur; ham kişisel veri gönderimi zaten kabul edilmez.
Rıza yönetimini atlamak
Veriyi sunucudan göndermek rıza gerekliliğini ortadan kaldırmaz. Çerez izni vermemiş bir kullanıcının verisinin iletilmesi KVKK açısından risk yaratır ve teknik bir kazanç sayılmaz. Rıza durumu sunucuya taşınmalı, gönderim bu duruma göre koşullandırılmalı ve karar kayıt altına alınmalıdır.
CAPI (Conversions API) ne zaman kritik hâle gelir?
Satın almanın tıklamadan çok sonra veya site dışında gerçekleştiği işlerde kritik olur: teklifle ilerleyen B2B satışlar, telefonla alınan siparişler, showroom ziyaretleri. İkinci belirti raporlar arasındaki açıklıktır; reklam panelindeki dönüşüm sayısı ile muhasebedeki sipariş sayısı sistematik olarak ayrışıyorsa sorun genellikle eşleştirme ve iletim tarafındadır. Mobil işletim sistemi izin kısıtlarının yüksek olduğu kitlelerde de kayıp bu yolla kapatılır.
Örnekler
- iOS kullanıcının satın alımı Pixel'de görünmüyor; CAPI ile server'dan Meta'ya iletilince yakalanıyor.