Meta reklamlarında doğru dönüşüm verisi elde etmek için yalnızca reklam paneline bakmak yeterli değildir. Kullanıcının web sitesinde gerçekleştirdiği form, satın alma, kayıt veya iletişim işlemlerinin Meta’ya doğru şekilde iletilmesi gerekir.
Bu süreçte iki temel teknoloji kullanılır: Meta Pixel ve Conversions API.
Pixel ile CAPI birbirinin doğrudan alternatifi değildir. Doğru projelerde birlikte kullanıldıklarında daha dayanıklı bir ölçümleme mimarisi oluşturabilirler.
Genel dönüşüm takip altyapısı için önce [İÇ LİNK: 2026 Dönüşüm Takibi Rehberi] içeriğini inceleyebilirsiniz.
Meta Pixel Nedir?
Meta Pixel, web sitesine eklenen ve kullanıcının tarayıcısı üzerinden Meta’ya etkinlik gönderen istemci taraflı bir ölçümleme aracıdır.
Pixel ile aşağıdaki işlemler takip edilebilir:
- Sayfa görüntüleme
- İçerik görüntüleme
- Form gönderme
- İletişim kurma
- Kayıt tamamlama
- Sepete ekleme
- Ödeme başlatma
- Satın alma
Pixel’in güçlü yönleri şunlardır:
- Kurulumu görece kolaydır.
- Tarayıcı etkileşimlerini hızlı şekilde ölçer.
- Meta Event Manager içinde test edilebilir.
- Reklam optimizasyonuna veri sağlar.
- Yeniden pazarlama kitleleri oluşturulmasına katkı verir.
Ancak Pixel tarayıcı üzerinde çalıştığı için tarayıcı kısıtlamaları, bağlantı sorunları, yanlış kodlama veya kullanıcı izinleri nedeniyle bazı etkinlikler gözlemlenemeyebilir.
Conversions API Nedir?
Conversions API, etkinliklerin işletmenin sunucusu, backend sistemi, CRM’i veya sunucu taraflı entegrasyonu üzerinden Meta’ya gönderilmesini sağlar.
Örnek veri akışı:
Kullanıcı form gönderdi
↓
Sunucu formu doğruladı
↓
Kayıt veritabanına eklendi
↓
Sunucu Meta CAPI etkinliği gönderdi
CAPI yalnızca web sitesi etkinlikleri için kullanılmaz. Uygun entegrasyonlarda CRM’de satışa dönüşen müşteri adayları veya çevrimdışı işlemler de Meta’ya aktarılabilir.
Pixel ve CAPI Arasındaki Fark
| Özellik | Meta Pixel | Conversions API |
|---|---|---|
| Veri kaynağı | Kullanıcı tarayıcısı | İşletme sunucusu veya backend |
| Kurulum | Daha kolay | Daha teknik |
| Etkileşim ölçümü | Güçlü | Backend sonucuna bağlı |
| Erişim anahtarı | Tarayıcı kodu | Sunucuda korunmalı |
| CRM entegrasyonu | Sınırlı | Daha uygun |
| Tarayıcı kısıtlamaları | Daha fazla etkilenebilir | Daha kontrollü |
| Kullanıcı izni | Gereklilikler geçerlidir | Gereklilikler devam eder |
CAPI kullanılması, kullanıcının izin tercihlerinin veya veri koruma yükümlülüklerinin göz ardı edilebileceği anlamına gelmez.
Pixel mi CAPI mi Kullanılmalı?
Basit bir tanıtım sitesinde yalnızca temel sayfa ve buton etkileşimleri ölçülüyorsa Pixel başlangıç için yeterli olabilir.
Aşağıdaki durumlarda CAPI entegrasyonu değerlendirilmelidir:
- Formlar backend üzerinden işleniyorsa
- Satın alma sonuçları sunucuda doğrulanıyorsa
- CRM satış verileri Meta’ya gönderilecekse
- Tarayıcı ve sunucu verileri birlikte kullanılacaksa
- Birinci taraf veri mimarisi geliştiriliyorsa
- Reklam bütçesi yüksek ve ölçüm kalitesi kritikse
En kapsamlı yapı genellikle Pixel ve CAPI’nin birlikte kullanılmasıdır.
Pixel ve CAPI Birlikte Nasıl Çalışır?
Örnek bir form dönüşümünde şu akış oluşabilir:
1. Kullanıcı formu başarıyla gönderir.
2. Tarayıcı Meta Pixel üzerinden Lead etkinliği gönderir.
3. Backend aynı işlem için CAPI üzerinden Lead etkinliği gönderir.
4. İki etkinlik aynı benzersiz event_id değerini taşır.
5. Meta iki kaydı aynı işlem olarak değerlendirir.
Bu yapı kurulurken en kritik konu event deduplication, yani etkinlik tekilleştirmedir.
Event Deduplication Nedir?
Aynı kullanıcı işlemi hem Pixel hem de CAPI üzerinden gönderildiğinde Meta’ya iki farklı etkinlik ulaşır.
Tekilleştirme yapılmazsa bir form gönderimi iki adet Lead olarak raporlanabilir. Bu durum:
- Dönüşüm sayısını şişirir.
- Dönüşüm maliyetini olduğundan düşük gösterir.
- Reklam optimizasyonunu bozar.
- Gerçek satış sonuçlarıyla reklam paneli arasında fark oluşturur.
Meta, Pixel ve CAPI üzerinden gelen aynı etkinlikleri temel olarak uyumlu event_name ve event_id değerleri üzerinden eşleştirerek tekilleştirir.
Örnek:
event_name: Lead
event_id: lead_7f92c834
Tarayıcı ve sunucu tarafında aynı işlem için bu değerler aynı olmalıdır.
Benzersiz Event ID Nasıl Üretilir?
Her kullanıcı işlemi için tekrar etmeyen bir kimlik oluşturulmalıdır.
Örnekler:
lead_b9a72f4c
order_CRX20261048
appointment_8132e9d7
Event ID:
- Her işlem için benzersiz olmalıdır.
- Pixel ve CAPI tarafında aynı olmalıdır.
- Sayfa görüntüleme gibi farklı etkinliklerde gelişigüzel tekrar kullanılmamalıdır.
- Satın almalarda sipariş kimliğiyle ilişkilendirilebilir.
- Formlarda backend tarafından üretilebilir.
En güvenli yaklaşım, event ID’nin form veya sipariş kaydı oluşturulurken backend tarafından üretilmesi ve tarayıcıya başarılı işlem cevabıyla döndürülmesidir.
Örnek Form Dönüşüm Mimarisi
Kullanıcı “Gönder” butonuna bastı
↓
Form API’ye gönderildi
↓
Backend veriyi doğruladı
↓
Supabase veritabanına lead kaydı eklendi
↓
Benzersiz event_id oluşturuldu
↓
Backend CAPI üzerinden Lead gönderdi
↓
Tarayıcı aynı event_id ile Pixel Lead gönderdi
↓
Meta etkinlikleri tekilleştirdi
Bu yapıda form butonuna basıldığı anda etkinlik gönderilmez. Önce veritabanı kaydının başarıyla oluşması beklenir.
Bolt.new ve Supabase Projelerinde CAPI Kurulumu
Bolt.new ile geliştirilen ve Supabase kullanan uygulamalarda CAPI isteği doğrudan kullanıcının tarayıcısından gönderilmemelidir.
Önerilen mimari:
Frontend
↓
Supabase Edge Function veya güvenli backend
↓
Meta Conversions API
Meta erişim anahtarı aşağıdaki ortamlarda açık şekilde bulunmamalıdır:
- Frontend JavaScript dosyaları
- React bileşenleri
- Tarayıcı ağ istekleri
- Public environment değişkenleri
- GitHub deposuna yüklenen ayar dosyaları
Erişim anahtarı yalnızca güvenli sunucu ortamında saklanmalıdır.
Örnek İşlem Sırası
- Kullanıcı form gönderir.
- Frontend güvenli API fonksiyonunu çağırır.
- Fonksiyon formu doğrular.
- Lead kaydını veritabanına ekler.
- Benzersiz event ID üretir.
- İzin ve veri işleme şartlarını kontrol eder.
- Meta’ya sunucu etkinliği gönderir.
- Frontend’e başarılı işlem ve event ID döner.
- Pixel aynı event ID ile etkinliği gönderir.
Standart Meta Etkinlikleri
Özel etkinlik oluşturmak yerine mümkün olduğu durumlarda Meta’nın standart etkinlik isimleri tercih edilebilir.
Örnekler:
ViewContent
Contact
Lead
CompleteRegistration
AddToCart
InitiateCheckout
Purchase
Subscribe
Schedule
Etkinlik adı, gerçekleşen işlemi doğru temsil etmelidir.
Örneğin yalnızca WhatsApp butonuna tıklayan kullanıcıya Purchase etkinliği göndermek yanlış optimizasyon verisi oluşturur.
Event Match Quality Nasıl İyileştirilir?
Meta, sunucu etkinliğinin bir reklam kullanıcısıyla eşleşebilmesi için izinli ve uygun müşteri bilgilerini kullanabilir.
Entegrasyon kapsamına göre aşağıdaki veriler değerlendirilebilir:
- E-posta
- Telefon numarası
- İşletme içi kullanıcı kimliği
- Tarayıcı ve tıklama tanımlayıcıları
- IP ve kullanıcı aracısı bilgileri
- Etkinlik kaynağı
Meta’nın resmi entegrasyon rehberlerinde, etkinlik eşleştirme doğruluğunu artırmak amacıyla izin verilen ve mevcut müşteri bilgisi alanlarının doğru şekilde gönderilmesi önerilir.
Ancak daha fazla veri göndermek tek başına amaç olmamalıdır. Yalnızca gerekli, doğru, izinli ve hukuki dayanağı bulunan veriler işlenmelidir.
CAPI Etkinliği İçinde Bulunabilecek Temel Alanlar
Entegrasyona göre aşağıdaki bilgiler kullanılabilir:
event_name
event_time
event_id
action_source
event_source_url
user_data
custom_data
Satın alma etkinliğinde ayrıca:
currency
value
order_id
content_ids
gibi ticari parametreler gönderilebilir.
Etkinlik zamanı, işlem gerçekleştiği anı doğru şekilde temsil etmelidir. Sunucu saatinin hatalı olması raporlama sorunlarına neden olabilir.
Test Events ile Kurulum Kontrolü
Meta Events Manager içindeki test araçlarıyla hem tarayıcı hem sunucu etkinlikleri incelenmelidir.
Kontrol edilmesi gerekenler:
- Pixel etkinliği ulaşıyor mu?
- CAPI etkinliği ulaşıyor mu?
- Event name aynı mı?
- Event ID aynı mı?
- Etkinlikler tekilleştiriliyor mu?
- Purchase değeri ve para birimi doğru mu?
- Test formu gerçek reklam sonuçlarına karışıyor mu?
- Aynı işlem tekrar gönderiliyor mu?
- Sunucudan hata cevabı geliyor mu?
Test tamamlandıktan sonra test kodları ve geçici tanılama değerleri üretim ortamından kaldırılmalıdır.
En Sık Yapılan CAPI Hataları
- Erişim anahtarını frontend içine yazmak
- Pixel ve CAPI’de farklı event ID kullanmak
- Aynı event ID’yi birden fazla işlemde tekrar kullanmak
- Form başarıyla kaydedilmeden Lead göndermek
- Satın alma yerine buton tıklamasını Purchase yapmak
- Değer ve para birimi alanlarını göndermemek
- Test etkinliklerini gerçek raporlara karıştırmak
- Kullanıcı izinlerini değerlendirmemek
- CAPI kurunca Pixel’i tamamen kaldırmak
- Sunucu hatalarını ve API cevaplarını kaydetmemek
Pixel ve CAPI Kurulum Kontrol Listesi
[ ] Pixel temel etkinlikleri gönderiyor
[ ] CAPI güvenli backend üzerinden çalışıyor
[ ] Erişim anahtarı istemci tarafında görünmüyor
[ ] Standart etkinlik isimleri doğru kullanılıyor
[ ] Pixel ve CAPI aynı event_id değerini taşıyor
[ ] Event deduplication çalışıyor
[ ] Satış değeri ve para birimi doğru
[ ] Test Events ile kontrol yapıldı
[ ] Kullanıcı izinleri sisteme yansıtılıyor
[ ] CRM sonuçlarıyla entegrasyon planlandı
Sık Sorulan Sorular
CAPI kullanırsam Pixel’i kaldırmalı mıyım?
Genellikle hayır. İki sistem birlikte kullanılabilir. Ancak aynı işlemlerin tekilleştirilmesi gerekir.
CAPI reklam engelleyicileri tamamen aşar mı?
CAPI bazı tarayıcı temelli veri kayıplarını azaltabilir; ancak tüm kullanıcıları veya tüm dönüşümleri yüzde 100 ölçme garantisi vermez.
Event ID her etkinlik için farklı mı olmalı?
Her ayrı kullanıcı işlemi için benzersiz olmalıdır. Aynı işlemin Pixel ve CAPI kopyalarında ise aynı event ID kullanılmalıdır.
CAPI kullanıcı izni gerektirmez mi?
Hayır. Verinin sunucudan gönderilmesi, kullanıcı izinleri ve kişisel veri işleme yükümlülüklerini ortadan kaldırmaz.
Meta Reklamlarınızı Eksik Veriye Göre Optimize Etmeyin
Pixel ve CAPI yanlış bağlandığında dönüşüm sayıları şişebilir, satışlar eksik ölçülebilir veya reklam algoritması değersiz aksiyonlara göre optimize olabilir.
Creamaxi; Meta Pixel, Conversions API, event deduplication, Supabase Edge Function ve CRM entegrasyonlarınızı analiz ederek daha güvenilir bir ölçümleme altyapısı oluşturur.
Meta reklamlarınızın gerçek form ve satış sonuçlarıyla optimize edilmesi için Creamaxi ile iletişime geçin.
