
Meta Conversion API (CAPI), web sitesi, uygulama, CRM, fiziksel mağaza ve çevrimdışı dönüşüm verilerini Meta’nın optimizasyon, hedefleme ve ölçüm sistemlerine doğrudan bağlayan bir altyapıdır. Bu nedenle CAPI’yi yalnızca web sitesine eklenen teknik bir etiket olarak değil, farklı kaynaklardaki dönüşüm sinyallerini Meta’ya taşıyan bir veri bağlantısı olarak değerlendirmek gerekir.
CAPI kurulumu gündeme geldiğinde temel soru yalnızca “Sunucu tarafı veri gönderiyor muyuz?” olmamalıdır. Önce hangi müşteri yolculuğu aşamalarını ölçmek istediğinizi, bu olayların hangi sistemlerde oluştuğunu ve reklam optimizasyonunda hangi sonuçların değerli olduğunu tanımlamak daha sağlıklı bir başlangıç sağlar.
Conversion API neden gündeme geldi?
Meta Pixel tarayıcı üzerinden çalıştığı için tarayıcı yükleme hataları, bağlantı sorunları ve reklam engelleyicilerden etkilenebilir. CAPI ise sunucu, web platformu, uygulama veya CRM üzerinden veri ilettiğinden bu sorunlardan Pixel’e kıyasla daha az etkilenebilir.
Bu fark, Pixel’in gereksiz olduğu anlamına gelmez. Tarayıcıdan gelen davranış sinyalleri ile sunucu veya CRM kaynaklı sonuçların birlikte ele alınması, ölçüm altyapısının tek bir veri aktarım kanalına bağımlı kalmamasına yardımcı olabilir. Ancak iki kanal aynı dönüşümü gönderiyorsa, veri akışlarının birbirinden bağımsız değil, birlikte tasarlanması gerekir.
CAPI tarayıcı kısıtlamalarını tamamen ortadan kaldırmaz ve tüm dönüşümlerin eksiksiz yakalanacağını garanti etmez. Yanlış olay tanımı, eksik parametre, izin eksikliği veya çift gönderim gibi sorunlar sunucu tarafı entegrasyonunda da görülebilir.
CAPI’nin kampanya performansına etkisi her işletmede aynı olmayabilir. Otomatik bir performans artışı garanti edilmediğinden sonuçlar olay doğruluğu, veri kalitesi, izinler, deduplikasyon ve kampanya stratejisiyle birlikte değerlendirilmelidir.
Pixel ve CAPI birlikte nasıl çalışır?
Meta, web olaylarında Pixel ve CAPI’nin birlikte kullanılmasını önerir. Aynı dönüşümün iki kez sayılmasını önlemek için deduplikasyon kurulmalıdır.
Tarayıcıdan gönderilen Pixel olayı ile sunucudan gönderilen CAPI olayının aynı dönüşüm olduğunu belirtmek için ortak ve benzersiz bir event_id kullanılmalıdır. event_name ve event_time gibi alanların da tutarlı üretilmesi gerekir.
Event deduplication’ın pratik amacı, aynı satın alma veya lead işleminin iki ayrı kanal üzerinden ulaşmasına rağmen tek bir dönüşüm olarak ilişkilendirilmesini sağlamaktır. Bu nedenle entegrasyon testlerinde yalnızca olayın ulaşıp ulaşmadığı değil, Pixel ve CAPI olaylarının aynı dönüşüm anahtarını taşıyıp taşımadığı da kontrol edilmelidir.
Müşteri bilgilerine ilişkin ek ve uygun parametrelerin CAPI ile gönderilmesi, olayların kullanıcılarla eşleştirilmesine ve Event Match Quality değerinin iyileştirilmesine yardımcı olabilir.
Buradaki hedef, mümkün olan en fazla veriyi göndermek değil; gerekli, doğru, güncel ve izinli bilgileri doğru olayla ilişkilendirmektir. Ölçüm kalitesi, yalnızca olay hacmiyle değil, olayların kullanıcıyla ne kadar iyi eşleştirilebildiğiyle de ele alınmalıdır.
E-ticaret siteleri için CAPI kurulum planı
E-ticarette temel olaylar arasında ViewContent, AddToCart, InitiateCheckout ve Purchase bulunur. Purchase olayında value ve currency bilgilerinin doğru aktarılması gerekir.
Müşteri yolculuğunun ara aşamalarını da ölçmek, kampanya optimizasyonu ile gerçek satış verisini karşılaştırmayı kolaylaştırabilir. Bu nedenle ölçüm planı yalnızca Purchase olayına indirgenmemelidir.
E-ticaret akışında önce ürün görüntüleme, sepete ekleme, ödeme başlatma ve satın alma adımlarının işletme sistemlerinde nasıl oluştuğu haritalanmalıdır. Ardından her aşamanın hangi kaynaktan gönderileceği, hangi parametrelerin gerekli olduğu ve satın alma olayında siparişin nasıl benzersiz biçimde tanımlanacağı belirlenmelidir.
Test sırasında gerçek bir kullanıcı senaryosu izlenerek ürün görüntüleme, sepete ekleme, ödeme başlatma ve satın alma akışı denenmelidir. Sipariş numarası veya başka bir benzersiz anahtarın event_id üretiminde istikrarlı kullanıldığı ve aynı siparişin Pixel ile CAPI tarafından çift raporlanmadığı doğrulanmalıdır.
Lead kampanyalarında web, instant form ve CRM ayrımı
Web formu gönderimleri için web olayları ve web CAPI kullanılabilir. Instant form lead’lerinin satış, randevu veya nitelikli fırsata dönüşmesi gibi aşağı-funnel sonuçlar CRM’den CAPI aracılığıyla Meta’ya geri gönderilebilir.
Lead retrieval entegrasyonu yeni lead’leri CRM’e taşırken, CAPI CRM’deki aşağı-funnel sonuçları Meta’ya geri göndermeye yarar. Bu iki entegrasyon aynı şey değildir.
Web CAPI kurulmuş olması, instant form lead’leri için CRM tabanlı dönüşüm entegrasyonunun otomatik olarak tamamlandığı anlamına gelmez.
Lead kampanyalarında form doldurma başlangıç dönüşümüdür. Daha anlamlı optimizasyon için lead’in CRM’de satışa, randevuya veya nitelikli fırsata dönüşmesini ayrı bir veri akışı olarak planlamak gerekir. Bu nedenle web formu, instant form, lead retrieval ve CRM’den Meta’ya geri besleme adımları ayrı ayrı haritalanmalıdır.

Veri kalitesi nasıl denetlenir?
Veri kalitesi değerlendirmesinde yalnızca olay hacmi incelenmemelidir. Event Match Quality, olay teşhisleri, tarayıcı ve sunucu olaylarının oranı, deduplikasyon, olay gecikmesi, eksik parametreler ve CRM kayıtlarıyla oluşan farklar birlikte değerlendirilmelidir.
Bu kontrol listesi, “Events Manager’da olay görünüyor mu?” sorusunu daha kapsamlı bir denetime dönüştürür. Olayın görünmesi tek başına doğru değer, doğru zaman, doğru kullanıcı eşleştirmesi veya tekil raporlama anlamına gelmeyebilir. Bu yüzden kurulum sonrası teknik sinyaller ile işletmenin gerçek sipariş ve CRM kayıtları karşılaştırılmalıdır.
Event Match Quality veya tarayıcı-sunucu olay oranı için tüm işletmelere uygulanabilecek tek bir başarı eşiği yoktur. Kabul edilebilir seviyeler platforma, trafiğe, izin yapısına ve dönüşüm akışına göre değişebilir.
CAPI kurulumu için hangi yöntem seçilmeli?
Meta’nın kurulum seçenekleri arasında partner entegrasyonu, Conversions API Gateway ve manuel kurulum bulunur. Uygun seçenek platforma, ekip yetkinliğine, CRM yapısına ve gizlilik gereksinimlerine göre belirlenmelidir.
Partner entegrasyonu, Gateway veya manuel kurulum arasında seçim yaparken yalnızca ilk kurulum hızına odaklanmak yeterli değildir. Veri akışının nerede oluştuğu, CRM mimarisinin ne kadar özelleştirildiği, teknik ekibin bakım kapasitesi ve veri üzerinde ne düzeyde kontrol gerektiği birlikte değerlendirilmelidir.
Meta arayüzündeki menü adları, kurulum seçeneklerinin ayrıntıları ve geliştirici dokümanlarındaki alan gereksinimleri zaman içinde değişebilir. Yayına almadan önce güncel Events Manager ve geliştirici dokümanlarıyla doğrulama yapılmalıdır.
Gizlilik ve veri kullanımı açısından dikkat edilmesi gerekenler
CAPI, gizlilik kurallarını veya iOS App Tracking Transparency gerekliliklerini aşmak için tasarlanmış bir yöntem değildir. Müşteri bilgileri uygun amaçlar, izinler ve Meta Business Tools şartları çerçevesinde kullanılmalıdır.
Sunucu tarafı aktarım, verinin teknik olarak daha kontrollü iletilmesini sağlayabilir; ancak teknik kontrol hukuki uygunluğun yerine geçmez. Hangi müşteri bilgisinin neden işlendiği, hangi izinlerin bulunduğu ve hangi verinin gerçekten gerekli olduğu entegrasyon tasarımının parçası olmalıdır.
Yerel mevzuat, açık rıza, veri sorumlulukları ve müşteri bilgilerinin işlenmesine ilişkin özel yükümlülükler ülkeye ve senaryoya göre değişebilir. Bu içerik hukuki danışmanlık yerine genel bir uygulama çerçevesi sunar.

Promogo yaklaşımıyla ölçüm altyapısını yönetmek
Promogo açısından Meta Ads yönetimi yalnızca kampanya kurulumundan ibaret değildir. Pixel, Conversion API, Events Manager, CRM ve dönüşüm kalitesinin birlikte yönetilmesi; e-ticarette Purchase ve gelir doğrulamasının, lead kampanyalarında ise formdan nitelikli lead veya satış sonucuna uzanan CRM geri beslemesinin izlenmesini gerektirir.
Sağlıklı bir çalışma akışı; funnel’ın tanımlanması, olayların ve veri kaynaklarının haritalanması, Pixel-CAPI deduplikasyonunun kurulması, gerçek senaryolarla test yapılması ve düzenli veri kalitesi raporlaması adımlarından oluşur. Böylece CAPI, tek başına mucizevi bir çözüm olarak değil, daha kontrollü bir ölçüm altyapısının parçası olarak konumlanır.
Müşteri verilerinin yalnızca gerekli amaçlarla, uygun izinler ve veri minimizasyonu ilkesi doğrultusunda kullanılması gerekir. Hash’leme veya teknik aktarım tek başına hukuki uygunluk sağlamaz.
Kaynaklar
- https://www.facebook.com/business/help/AboutConversionsAPI
- https://www.facebook.com/help/messenger-app/952192354843755
- https://www.facebook.com/help/331509497253087
- https://www.facebook.com/business/ads/performance-marketing
- https://www.facebook.com/legal/terms/businesstools/preview
- https://www.facebook.com/help/447278887528796?locale=en_GB
- https://www.facebook.com/business/ads/meta-advantage-plus/leads
- https://www.facebook.com/business/ads/performance-marketing?locale=en_GB
- https://www.facebook.com/business/ads/ad-objectives/lead-generation/lead-ads-with-forms
- https://www.facebook.com/business/ads/review-policy-guidelines
- https://www.facebook.com/business/ads/ad-objectives/traffic
- https://www.facebook.com/help/615546898822465
- https://www.facebook.com/business/help/859112078191288?locale=en_GB
- https://www.facebook.com/help/1076296042409786?locale=en_GB
- https://www.facebook.com/help/545264355506152
- https://www.facebook.com/business/ads/ad-objectives/sales
- https://www.facebook.com/help/2493859034062198