Meta Dönüşüm API'si (CAPI) nedir? E-ticaret için neden gerekli?

Meta Pixel neden tek başına yetmiyor?

Meta Pixel, sitenize eklenen ve ziyaretçinin tarayıcısında çalışan bir koddur. Ziyaretçi satın aldığında tarayıcı bu bilgiyi Meta'ya gönderir. Fakat günümüzde tarayıcı tarafı ölçüm birçok engelle karşılaşır:

• iOS ve uygulama içi tarayıcılar: Apple'ın uygulama takip izni (ATT) ve tarayıcı kısıtlamaları takibi sınırlar.
• Reklam engelleyiciler: Piksel kodunun yüklenmesini tamamen engelleyebilir.
• Çerez süreleri ve kısıtlamaları: Tarayıcılar üçüncü taraf ve bazı birinci taraf çerezlerin ömrünü kısaltır.
• Sayfanın tam yüklenmemesi: Ödeme sonrası sayfa yüklenmeden çıkan ziyaretçinin satın alması gönderilmeyebilir.

Sonuç: bazı satışlar Meta'ya hiç ulaşmaz. Meta hem bu satışları raporlayamaz hem de algoritma "bu reklam satış getirmiyor" diye yanlış öğrenir.

Dönüşüm API'si nasıl çalışır?

CAPI'de satın alma bilgisi tarayıcıdan değil, sunucunuzdan Meta'ya gider. Sipariş veritabanınıza düştüğü anda sunucunuz Meta'ya "şu saatte, şu tutarda bir satın alma oldu" der. Tarayıcıdaki engeller bu yolu etkilemez.

Eşleştirme için olayla birlikte müşteri bilgileri de gönderilir: e-posta, telefon gibi bilgiler geri döndürülemez şekilde özetlenerek (SHA-256 hash) iletilir; IP adresi, tarayıcı bilgisi ve Meta'nın _fbp/_fbc çerezleri de eşleşmeye yardım eder.

Pixel ve CAPI birlikte mi kullanılmalı?

Evet. Meta'nın önerdiği kurulum ikisini birlikte kullanmaktır: piksel tarayıcıda, CAPI sunucuda aynı olayı gönderir. Biri kaçırırsa diğeri yakalar.

Çift sayım nasıl önlenir?

Aynı satın alma iki yoldan gelince Meta bunu iki satış saymamalıdır. Bunun için her iki yoldan da gönderilen olaya aynı olay kimliği (event_id) ve aynı olay adı verilir. Meta aynı kimliği taşıyan olayları birleştirir (tekilleştirme). Olay kimliği eşleşmezse satışlar iki kez sayılır ve ROAS olduğundan yüksek görünür.

Eşleşme kalitesi (Event Match Quality) nedir?

Meta Olay Yöneticisi'nde her olay için 0–10 arası bir eşleşme kalitesi puanı görürsünüz. Gönderdiğiniz müşteri bilgileri ne kadar eksiksiz ve doğruysa Meta olayı o kadar iyi bir hesapla eşleştirir. Puanı yükseltmek için:

• E-posta ve telefonu doğru biçimde (küçük harf, boşluksuz, ülke kodlu) özetleyip gönderin.
• _fbp ve _fbc çerez değerlerini, IP ve tarayıcı bilgisini olaya ekleyin.
• Giriş yapmış müşterilerde harici kimlik (external_id) gönderin.

CAPI kurulumunun yolları

1. E-ticaret altyapısının hazır entegrasyonu: Birçok altyapı Meta entegrasyonunda CAPI'yi de sunar. En hızlı yoldur; ayarlarda sunucu taraflı gönderimin açık olduğundan emin olun.
2. Sunucu taraflı etiket yöneticisi: Google Etiket Yöneticisi'nin sunucu sürümü gibi bir ara katmanla olayları sunucudan gönderirsiniz.
3. Doğrudan entegrasyon: Geliştirici ekibiniz sipariş oluştuğunda Meta'nın API'sine olay gönderir. En fazla kontrolü sağlar.

Kurulumdan sonra neyi kontrol etmelisiniz?

• Olay Yöneticisi'nde satın alma olayının hem tarayıcıdan hem sunucudan geldiğini,
• Tekilleştirmenin çalıştığını (olay sayısının siparişin iki katı olmadığını),
• Gönderilen tutarın para birimi ve KDV tanımının mağaza raporuyla aynı olduğunu,
• Eşleşme kalitesi puanını.

Kurulum sonrası Meta'daki satış sayısının mağazaya yaklaşması beklenir; ama tamamen eşitlenmez. Kalan farkın nedenlerini reklam ve mağaza verisi neden tutmuyor yazımızda anlattık.

KVKK ve çerez onayı

Ziyaretçi verisinin reklam ölçümü için Meta'ya aktarılması kişisel veri işlemedir. Pazarlama çerezleri ve ölçüm için açık rıza almak, rıza vermeyen ziyaretçinin verisini göndermemek ve aydınlatma metninde bu aktarımı açıkça belirtmek gerekir. Çerez onay mekanizmanızın hem pikseli hem sunucu tarafı gönderimi kapsadığından emin olun; hukuki ayrıntılar için hukuk danışmanınızın görüşünü alın.

Sonuç

Piksel + CAPI birlikte kurulduğunda Meta daha fazla satışı görür, algoritma daha doğru öğrenir ve raporlar mağazaya yaklaşır. Yine de bütçe kararlarında reklam verisini mağaza ve pazaryeri cirosuyla birlikte okumak gerekir; CiroFly bu iki tarafı tek panelde birleştirir.