Sunucu taraflı izleme: Conversions API'yi adım adım kurmak

Conversions API nedir ve neden gerekir?

Conversions API (CAPI), web sitenizin ya da iş sisteminizin dönüşüm olaylarını doğrudan sunucudan Meta'ya göndermesini sağlayan bir bağlantıdır. Meta Pixel olayları ziyaretçinin tarayıcısından gönderir; tarayıcı kısıtlamaları, reklam engelleyiciler ve çerez izinleri bu gönderimin bir kısmını engelleyebilir. Sunucu taraflı gönderim bu kayıpları azaltmaya yardım eder, çünkü olay tarayıcıya bağımlı değildir.

CAPI'nin diğer avantajı, tarayıcıda görünmeyen olayları da gönderebilmesidir: CRM'de lead'in nitelikli hale gelmesi, çevrimdışı satış, siparişin onaylanması ya da iadesi gibi. Böylece reklam sistemi yalnızca form dolduran kişiyi değil, gerçekten müşteriye dönüşen kişiyi öğrenir.

Pixel ile birlikte nasıl çalışır?

En yaygın ve önerilen düzen, pixel ve CAPI'nin birlikte (yedekli) kullanılmasıdır: aynı olay hem tarayıcıdan hem sunucudan gönderilir. Bu durumda Meta aynı olayı çift görür. Çift sayımı önlemek için tüm gönderimlere aynı olay adı ve aynı olay kimliği (event ID) eklenir; Meta bu kayıtları eşleştirip tek olay olarak sayar. Olay kimliği yoksa raporlarda dönüşümler şişer ve optimizasyon yanlış sinyalle çalışır.

Olay kimliği genellikle sipariş numarası ya da sayfada üretilen benzersiz bir değerdir; aynı değerin hem tarayıcı koduna hem sunucuya aktarılması gerekir. Bu yüzden kurulum, sadece pazarlama ekibinin değil, geliştirici ekibin de katıldığı bir iştir.

Kurulum seçenekleri

Kurulumun birkaç yolu vardır: • Platform entegrasyonları: Shopify, WooCommerce gibi platformlar ve bazı iş ortakları, birkaç adımda CAPI bağlantısı sunar. Teknik beceri gerektirmez, standart e-ticaret olaylarını kapsar. • Etiket yöneticisi sunucu tarafı: Sunucu taraflı bir etiket yönetici ortamı kurulur; olaylar tarayıcıdan bu ortama, oradan Meta'ya gider. Esnek ama bir barındırma ortamı ve bakım gerektirir. • Doğrudan entegrasyon: Kendi sunucunuz Meta'nın API'sine olayları kod ile gönderir. En çok kontrol ve en çok geliştirme gerektiren seçenektir; CRM ve çevrimdışı olaylar için gerekebilir.

Seçim; sitenizin altyapısı, ekibinizin teknik kapasitesi ve izlemek istediğiniz olay çeşitliliğine göre yapılır. Hazır entegrasyonla başlayıp ihtiyaç doğdukça doğrudan entegrasyona geçmek makul bir yoldur.

Örnek bir akış: kullanıcı reklamı tıklar ve sitenizde sipariş verir. Sipariş tamamlandığında tarayıcıdaki pixel satın alma olayını gönderir. Aynı anda sunucunuz, sipariş sisteminden aldığı bilgiyle aynı olayı aynı olay kimliğiyle Meta'ya iletir. Kullanıcı tarayıcısında reklam engelleyici kullanıyorsa pixel olayı kaybolur ama sunucu olayı yine ulaşır; Meta tek bir satın alma kaydeder. Günler sonra sipariş iptal edilirse, sunucu bu bilgiyi de ileterek optimizasyonun gerçek sonuçlara göre çalışmasına yardım edebilir.

Hangi seçeneği seçerseniz seçin, kurulumdan önce izlenecek olayların listesini ve her olayın hangi sistemden geleceğini yazın. Örneğin satın alma olayı sipariş sisteminden, nitelikli lead olayı CRM'den, sepete ekleme olayı ise tarayıcıdan gelebilir. Bu harita, hangi kaynakta eksik olay olduğunu görmeyi ve geliştirici ekiple net bir iş tanımı yapmayı kolaylaştırır.

Eşleşme kalitesi: hangi bilgi gönderilir?

Meta, gelen olayı bir kişiyle eşleştirebildiği ölçüde reklam teslimi ve ölçüm iyileşir. Bunun için olayla birlikte müşteri bilgi parametreleri (e-posta, telefon, ad gibi) ve tarayıcı tanımlayıcıları gönderilir. Kişisel veriler Meta'ya iletilmeden önce özetleme (hash) yöntemiyle şifrelenir; bunun teknik biçimi için Meta'nın güncel dokümantasyonuna uyulmalıdır.

Kişisel veriyi yalnızca açık rıza ve gizlilik politikanız çerçevesinde gönderin. Onay vermemiş kullanıcının verisini sunucudan göndermek, tarayıcıdan göndermekle aynı hukuki sorumluluğu taşır. Ne kadar çok doğru parametre iletilirse eşleşme o kadar iyi olur, ama bilgi yalnızca hukuken ve operasyonel olarak gönderilebilir olanla sınırlı kalmalıdır.

Doğrulama ve izleme

Kurulumdan sonra Events Manager'da olayların hangi kaynaktan (tarayıcı veya sunucu) geldiğini görebilirsiniz. Kontrol edeceğiniz noktalar: olaylar hem tarayıcıdan hem sunucudan geliyor mu, tekilleştirme çalışıyor mu (çift sayım yok mu), eşleşme kalitesi göstergesi yeterli mi, olay gecikmesi kabul edilebilir mi?

Meta, sunucu olaylarını denemek için bir test olayı kodu ve test aracı sunar; ilk kurulumda gerçek veriyi kirletmeden doğrulama yapabilirsiniz. Canlıya aldıktan sonra raporlardaki sipariş sayısını kendi sisteminizin (e-ticaret paneli, CRM) sayısıyla karşılaştırın. Farkın nedenini anlayın: Meta atıf modeliyle çalışır, bu yüzden sayılar birebir tutmayabilir, ama büyük sapmalar kurulum hatasının işaretidir. Düzenli olarak olay uyarılarını izleyin.

Kurulumdan sonra bakım unutulmamalıdır. Meta olay şemasını ve gereksinimlerini zaman zaman günceller; platform eklentileri de sürüm değiştirir. Events Manager'daki uyarıları düzenli kontrol etmek, sunucu bağlantısındaki kimlik doğrulama sorunlarını ve eksik parametreleri erken yakalamanızı sağlar. Sunucu tarafında olay gönderimi başarısız olduğunda sessizce kaybolmaması için hata kaydı tutmak ve yeniden deneme mantığı kurmak, doğrudan entegrasyonda önemlidir.

Sık yapılan hatalar

• Olay kimliği göndermemek ve dönüşümleri çift saymak.
• Pixel'deki olay adı ile sunucudaki olay adının farklı yazılması; eşleşme olmaz.
• Onay vermemiş kullanıcıların verisini göndermek.
• Müşteri bilgi parametrelerini gönderirken biçim kurallarına uymamak, yani eşleşme kalitesini düşük bırakmak.
• Yalnızca satın almayı kurup üst huni olaylarını atlamak.
• Test olayı kodunu canlı yayında bırakmak.
• Kurulumu bir kez yapıp bir daha izlememek; site güncellemeleri olay akışını bozabilir.

Mindset programlarında bu beceri nerede çalışılır?

Meta Ads (Facebook & Instagram) Yönetimi eğitiminin modülleri arasında Meta reklam platformuna giriş, kampanya amacı ve optimizasyon seçenekleri, yeniden hedefleme ve huni stratejisi ile raporlama, analiz ve ölçekleme yer alır. Sunucu taraflı izleme, bu modüllerin dayandığı ölçüm altyapısının teknik tarafıdır.

Bu yapı, ölçümü reklam performansının merkezine koyan performans pazarlama uzmanları, e-ticaret ekipleri ve ajanslar için uygundur. Kurumsal ekiplerde pazarlama, yazılım ve veri birimlerinin izleme mimarisini birlikte planlaması için ortak bir başvuru noktası oluşturabilir.