Ana Sayfa / Blog / Google Ads
Google Ads

Meta Dönüşümler API (CAPI) ve Server-Side Tracking Mimarisi

Cemalettin Kaş
Cemalettin Kaş SEO & Google Ads Danışmanı
13 Ekim 2026 8 dk okuma süresi
Özet & Temel Çıkarım (Key Takeaways):

Meta Dönüşümler API, tarayıcı tabanlı izleme kısıtlamalarını aşarak sunucu düzeyinde veri aktarımı sağlar. Bu rehber, veri kaybını minimize eden teknik mimariyi detaylandırır.

Meta Dönüşümler API (CAPI), tarayıcı tabanlı piksel izlemenin (Client-Side) iOS 14+ ve ITP (Intelligent Tracking Prevention) kısıtlamaları nedeniyle yaşadığı veri kaybını, sunucudan sunucuya (S2S) doğrudan veri iletimiyle çözen bir mimaridir. Bu sistem, tarayıcı engellerini devre dışı bırakarak dönüşüm verilerinin %100’e yakın doğrulukla Meta sunucularına iletilmesini sağlar ve E-Ticaret SEO Mimarisi ile entegre bir veri ekosistemi oluşturur.

Meta Dönüşümler API Algoritma ve Sistem Çalışma Mantığı

Meta Dönüşümler API, geleneksel tarayıcı tabanlı izleme yöntemlerinin aksine, veriyi kullanıcının tarayıcısından değil, doğrudan web sunucunuzdan Meta’nın Graph API uç noktalarına gönderir. Bu süreç, tarayıcıların çerezleri engelleme veya silme yetkisini devre dışı bırakır. Sistem, sunucunuzdaki bir ‘Event’ tetiklendiğinde (örneğin bir satın alma işlemi), bu veriyi işleyerek bir JSON payload’u oluşturur ve sunucudan sunucuya güvenli bir bağlantı üzerinden Meta’ya aktarır. Bu mimaride, tarayıcı tarafında gerçekleşen ‘Adblocker’ veya ‘Privacy Shield’ gibi engeller, verinin sunucu katmanında işlenmesini engelleyemez.

Sistem, ‘Event Match Quality’ (Etkinlik Eşleştirme Kalitesi) parametresine dayanır. Sunucu tarafında yakalanan e-posta, telefon numarası, IP adresi ve tarayıcı kullanıcı aracısı (User Agent) gibi veriler, Meta’nın eşleştirme algoritmaları tarafından anonimleştirilerek (hashing) kullanıcı kimliğiyle eşleştirilir. Bu, özellikle Performance Max (PMax) Mimarisi gibi makine öğrenimi odaklı sistemlerin, reklam optimizasyonunu daha doğru sinyallerle yapmasını sağlar. Sunucu tarafı izleme, tarayıcıdan bağımsız bir ‘Source of Truth’ (Doğruluk Kaynağı) oluşturur.

İndeksleme ve açık artırma sürecinde, Meta’nın algoritması sunucudan gelen bu yüksek kaliteli sinyalleri, ‘Conversion API’ üzerinden gelen verilerle birleştirir. Eğer bir kullanıcı hem tarayıcı hem de sunucu üzerinden veri gönderirse, Meta’nın ‘Deduplication’ (Tekilleştirme) mekanizması, ‘Event ID’ parametresini kullanarak aynı dönüşümün mükerrer sayılmasını engeller. Bu, veri tutarlılığını korumak için kritik bir mühendislik gereksinimidir.

Matematiksel Çerçeve ve Veri Analitiği

Dönüşüm kaybı, modern dijital pazarlamada ‘Attribution Gap’ olarak adlandırılan bir matematiksel modelle ifade edilir. Tarayıcı tabanlı izlemede, ITP kısıtlamaları nedeniyle çerez ömrü 24 saat ile 7 gün arasında sınırlandırılmıştır. Bu, ‘Click-to-Conversion’ süresi uzun olan B2B veya yüksek değerli ürünlerde veri kaybının %40 ile %60 arasında olmasına neden olur. CAPI ile bu kayıp, sunucu tarafında ‘Event ID’ ve ‘User Data’ eşleştirmesiyle %5-10 seviyelerine indirilir.

Kârlılık formülü, (CAPI ile artan dönüşüm verisi) * (ROAS verimliliği) – (Sunucu maliyeti) şeklinde optimize edilir. Veri analitiğinde ‘Match Rate’ (Eşleşme Oranı), sunucuya gönderilen verinin ne kadarının Meta veritabanındaki kullanıcılarla eşleştiğini gösteren temel metriktir. Yüksek ‘Match Quality Score’, reklam açık artırmalarında daha düşük CPM ve daha yüksek dönüşüm oranı (CVR) ile sonuçlanır.

Log analizi yaparken, sunucu tarafındaki ‘HTTP 200 OK’ yanıtlarının yanı sıra, Meta’nın döndürdüğü ‘Event Processing’ gecikmelerini izlemek gerekir. Sunucu tarafında işlenen verinin, gerçek zamanlı olarak Meta’nın ‘Events Manager’ paneline yansıması, sistemin sağlıklı çalıştığının matematiksel kanıtıdır. Veri setindeki ‘Event ID’ çakışmalarını izleyerek, tekilleştirme başarısını %99’un üzerinde tutmak, algoritmik öğrenme sürecini hızlandırır.

Karşılaştırmalı Matris: Client-Side vs Server-Side

Aşağıdaki matris, geleneksel tarayıcı tabanlı izleme ile sunucu tarafı izlemenin teknik yeteneklerini ve kısıtlamalarını kıyaslamaktadır.

KriterClient-Side (Piksel)Server-Side (CAPI)
Veri KaynağıTarayıcı (Browser)Sunucu (Backend)
iOS 14+ EtkisiYüksek (Veri kaybı)Yok (Tam veri)
Adblocker DirenciDüşükYüksek
Veri GüvenliğiDüşük (Hassas veri riski)Yüksek (Sunucu taraflı hashing)
Kurulum KarmaşıklığıDüşükYüksek

Tablo analizi gösteriyor ki, CAPI sadece bir ‘yedekleme’ sistemi değil, veri bütünlüğü için zorunlu bir mimaridir. Client-side piksel, kullanıcı arayüzü etkileşimlerini (tıklama, kaydırma) yakalamada başarılıyken, CAPI, satın alma ve form doldurma gibi kritik sunucu taraflı işlemlerde mutlak doğruluk sağlar. Hibrit bir yapı (her ikisinin birlikte kullanımı), en yüksek veri kalitesini sunar.

Adım Adım Mühendislik Uygulama Kılavuzu

Kurulum süreci, Meta Business Suite içerisinde bir ‘Access Token’ oluşturulmasıyla başlar. İlk adım, sunucunuzda bir ‘Webhook’ veya ‘API Endpoint’ oluşturarak, satın alma tetikleyicilerini (trigger) dinlemektir. Bu tetikleyiciler, Meta’nın ‘Events API’ formatına uygun JSON nesnelerine dönüştürülmelidir. Özellikle ‘event_name’, ‘event_time’, ‘user_data’ ve ‘custom_data’ alanlarının eksiksiz doldurulması gerekir.

İkinci adım, ‘Event ID’ mantığının kurgulanmasıdır. Hem tarayıcıdan hem de sunucudan gönderilen etkinliklerin tekilleştirilmesi için aynı ‘Event ID’ (örneğin bir sipariş numarası veya benzersiz bir UUID) her iki tarafta da kullanılmalıdır. Google Tag Manager (GTM) Server-Side container kullanıyorsanız, ‘Meta CAPI’ şablonunu kullanarak bu süreci kod yazmadan yönetebilirsiniz. Ancak, yüksek trafikli sitelerde doğrudan API entegrasyonu daha düşük gecikme (latency) sağlar.

Üçüncü adım, veri gizliliği ve hashing işlemidir. Kullanıcı verileri (e-posta, telefon) sunucuda ‘SHA-256’ algoritması ile hash’lenerek gönderilmelidir. Bu, GDPR ve KVKK uyumluluğu için zorunludur. Kurulum sonrası, ‘Events Manager’ panelindeki ‘Test Events’ aracı ile sunucudan gelen sinyallerin ‘Server’ etiketiyle başarıyla işlendiğini doğrulamalı ve ‘Event Match Quality’ skorunu 7.0/10 üzerine çıkarmalısınız.

Büyüme ve Optimizasyon Stratejisi

CAPI kurulumunda yapılan en büyük hata, ‘Event ID’ tekilleştirmesini atlamaktır. Bu, dönüşümlerin iki kez sayılmasına ve reklam bütçesinin yanlış optimize edilmesine neden olur. İkinci ölümcül hata, ‘User Data’ parametrelerinin eksik gönderilmesidir; Meta, eşleştirme için yeterli sinyal alamazsa CAPI’nin performansı piksel seviyesine düşer. Üçüncü hata ise, sunucu tarafındaki ‘latency’ (gecikme) sorunlarını göz ardı etmektir; API yanıt süresi 2 saniyeyi aşarsa, veri kaybı yaşanabilir.

Geleceğe yönelik GEO hazırlığı (Generative Engine Optimization), verinin sadece Meta’ya değil, tüm reklam platformlarına (Google, TikTok, LinkedIn) benzer bir sunucu taraflı mimariyle iletilmesini gerektirir. ‘First-party data’ stratejisi, üçüncü taraf çerezlerin tamamen kalkacağı bir dünyada tek ayakta kalma yöntemidir. CAPI, bu stratejinin temel taşıdır.

Optimizasyon için, ‘Advanced Matching’ özelliklerini her zaman ‘Automatic’ yerine ‘Manual’ olarak yapılandırın. Sunucu günlüklerinizi (logs) düzenli olarak inceleyerek, API hatalarını (400, 403, 429 kodları) takip edin. Bu teknik disiplin, reklam harcamalarınızın verimliliğini artırırken, Meta’nın makine öğrenimi modellerini daha hızlı eğitmenizi sağlar.

Sıkça Sorulan Sorular

Hayır, en iyi sonuç için hem tarayıcı tabanlı pikseli hem de CAPI'yi birlikte kullanmalısınız. Bu hibrit yapı, 'Event ID' tekilleştirmesi sayesinde veri kaybını minimize eder.

Meta'nın gönderdiğiniz veriyi kendi veritabanındaki kullanıcılarla eşleştirme başarısıdır. E-posta, telefon, IP ve tarayıcı bilgisi gibi daha fazla parametre göndererek bu skoru artırabilirsiniz.

GTM Server-Side kullanıyorsanız, Google Cloud veya benzeri bir sağlayıcıda küçük bir barındırma maliyeti oluşur. Ancak, artan dönüşüm verisi ve optimize edilen reklam harcaması, bu maliyeti fazlasıyla karşılar.

CAPI, tarayıcıdan bağımsız çalıştığı için Apple'ın 'App Tracking Transparency' (ATT) çerçevesinden etkilenmez. Veri doğrudan sunucudan iletildiği için tarayıcı kısıtlamalarına takılmaz.

Tüm kişisel veriler (PII) sunucu tarafında SHA-256 ile hash'lenerek Meta'ya gönderilir. Bu sayede ham veri sunucudan dışarı çıkmaz ve gizlilik standartlarına uyum sağlanır.

Cemalettin Kaş
İÇERİK MİMARI & STRATEJİST

Cemalettin Kaş

Orta ve büyük ölçekli işletmeler için veri odaklı büyüme mimarisi, teknik SEO, GEO (AI Search) ve kârlılık odaklı Google Ads danışmanı.