# Meta Conversions API (CAPI) Nedir? Pixel Neden Tek Başına Yetmiyor?

> Meta Conversions API nedir, Pixel ile farkı nelerdir ve CAPI kurulumu nasıl yapılır? Server-side tracking ile veri kaybını önleme adımlarını inceleyin.

- Kaynak: https://contentrylab.com/blog/meta-conversions-api-nedir-pixel-farki
- Yayıncı: Contentry Lab (https://contentrylab.com)
- Yazar: Contentry Lab Editör Ekibi
- Yayın tarihi: 2026-10-13
- Kategori: Reklam Yönetimi

Meta reklam yöneticinizde oturum açtığınızda kampanyalarınızın 15 satış ya da randevu bildirdiğini, banka veya sipariş panelinizde ise gerçek rakamın 22 olduğunu fark etmiş olabilirsiniz. Aradaki bu 7 dönüşümlük fark teknik bir hata değil, tarayıcı tabanlı ölçümleme sistemlerinin yaşadığı doğal bir tıkanmadır. Reklam bütçenizi doğru yönetmek ve harcadığınız her liranın karşılığını almak istiyorsanız, meta conversions api nedir sorusunun yanıtını ve çalışma prensibini ayrıntısıyla kavramanız gerekir.

Geleneksel web analiz araçları ve Meta Pixel, kullanıcının internet tarayıcısında çalışan küçük JavaScript kod parçacıklarına dayanır. Ancak modern gizlilik kısıtlamaları, katı çerez kuralları ve reklam engelleyici yazılımlar, bu kodların Meta sunucularına veri iletmesini her geçen gün daha fazla engeller. Veri akışı kesintiye uğradığında reklam algoritması potansiyel müşterilerinizi tanımakta zorlanır ve edinim maliyetleriniz hızla yükselir.

Bu rehberde, Meta Conversions API (kısaca CAPI) mimarisinin ne olduğunu, Meta Pixel ile temel farklarını, çift kanallı tekilleştirme mantığını ve popüler e-ticaret altyapılarında kurulum aşamalarını adım adım ele alıyoruz.

## iOS 14 Sonrası Meta Veri Kaybı: Geleneksel Piksel Neden Yetersiz Kaldı?

Reklam dünyasında dengeleri değiştiren ilk büyük kırılma Apple tarafından kullanıma sunulan App Tracking Transparency (ATT) çerçevesiyle yaşandı. Kullanıcılara uygulamalar arası takibe izin verip vermediklerini soran bu güncelleme, Safari tarafındaki Intelligent Tracking Prevention (ITP) kısıtlamalarıyla birleşti. Ardından masaüstü ve mobil cihazlarda reklam engelleyici (ad-blocker) kullanımının yaygınlaşması, istemci taraflı (client-side) ölçümlemeyi savunmasız bıraktı. Sektör analizleri, ios 14 sonrası meta veri kaybı oranının birçok e-ticaret ve kurumsal B2B hizmet hesabında yüzde 20 ile 30 bandına ulaştığını gösteriyor.

Meta Pixel, ziyaretçi sitenize geldiğinde fbevents.js dosyasını tarayıcıya indirir ve sayfa görüntüleme, sepete ekleme veya form gönderme gibi eylemleri istemci üzerinden Meta sunucularına fırlatır. Ne var ki bir ziyaretçi tarayıcısında uBlock Origin, Brave Kalkanları veya Safari gizlilik koruması kullanıyorsa, bu JavaScript istekleri daha web sitesinden çıkmadan engellenir. Kullanıcı sitenizden 5.000 TL değerinde alışveriş yapsa dahi reklam paneliniz bu satın almadan haberdar olamaz.

Pikselin tek başına veri toplayamaması işletmeler açısından iki kritik sorun yaratır:

- Yetersiz Optimizasyon Sinyali: Meta makine öğrenimi modelleri, reklamlarınızı kime göstereceğini son 7 günde gerçekleşen dönüşüm sinyallerine göre belirler. Alışveriş yapanların üçte biri sisteme yansımadığında, algoritma en yüksek satın alma eğilimi gösteren kitleyi bulmakta zorlanır.

- Daralan Yeniden Hedefleme Havuzları: Web sitenizi ziyaret eden veya sepete ürün ekleyen kullanıcıların çerezleri erken silindiği için dinamik yeniden pazarlama (retargeting) listeleriniz küçülür, reklam sıklığı dengesizleşir.

## Server-Side Tracking Meta Dünyasında Nasıl Çalışır?

İstemci taraflı izleme modellerinin tıkandığı noktada çözüm sunucu taraflı mimariye geçmektir. Dijital pazarlama literatüründe server-side tracking meta altyapısının temelini oluşturan Conversions API (CAPI), web sitenizin çalıştığı sunucu ile Meta veri tabanı arasında doğrudan, şifreli bir köprü kurar.

Bu sistemde bir kullanıcı sitenizde işlem yaptığında süreç tarayıcıda değil, sitenizin arka planındaki sunucuda işlenir. Örneğin bir ziyaretçi danışmanlık talep formunu doldurduğunda veya e-ticaret sitenizde siparişi tamamladığında, web sunucunuz bu bilgiyi veritabanına kaydeder. Ardından sunucunuz, arka planda güvenli bir HTTPS isteği aracılığıyla Meta Graph API uç noktasına bir veri paketi gönderir.

Sunucudan sunucuya gerçekleşen bu veri transferi hiçbir tarayıcı eklentisi, çerez engeli veya yerel güvenlik kalkanı tarafından durdurulamaz. Kullanıcı tarayıcısında en katı reklam engelleyiciyi kullansa bile, sunucunuz işlemi başarıyla kaydettiği için dönüşüm Meta paneline eksiksiz iletilir.

Veri güvenliği açısından Conversions API entegrasyonunda, müşteriye ait kimlik verileri Meta'ya açık metin olarak iletilmez. Müşterinin e-posta adresi, telefon numarası veya adı soyadı gibi kişisel bilgileri SHA-256 algoritmasıyla tek yönlü olarak özetlenir (hashlenir). Meta, bu şifrelenmiş dizgileri kendi veri tabanındaki şifreli profillerle eşleştirerek kullanıcının kimliğini tespit eder. Böylece veri güvenliği katmanı güçlendirilir; ancak bu veriler hukuken takma adlı kişisel veri sayıldığından KVKK ve GDPR uyumu için kullanıcı açık rızası ve aydınlatma metinleri eksiksiz uygulanmalıdır.

## Meta Pixel ve Conversions API Farkı

Sektörde sıklıkla yapılan hatalardan biri, Conversions API kurulduktan sonra Meta Pixel aracının devre dışı bırakılması gerektiği algısıdır. Oysa bu iki teknoloji birbirinin alternatifi değil, birbirini tamamlayan iki güvenlik katmanıdır. Doğru strateji, her iki veri kanalını aynı anda hibrit bir modelde çalıştırmaktır.

Geleneksel Meta Pixel, tarayıcı üzerindeki anlık kullanıcı hareketlerini, fare kaydırmalarını ve sayfa etkileşimlerini yakalamada son derece çeviktir. Conversions API ise nihai dönüşüm adımlarında (sipariş, ödeme, kayıt, randevu oluşturma) tarayıcı engellerine takılmaksızın çok daha yüksek bir veri teslimat güvenilirliği sunar. İki sistemin çalışma dinamiklerini netleştirmek için meta pixel ve conversions api farkı tablosunu inceleyelim:

Karşılaştırma Kriteri |
Geleneksel Meta Pixel (Tarayıcı Taraflı) |
Meta Conversions API (Sunucu Taraflı) |

Veri İletim Yolu |
Kullanıcı tarayıcısından Meta sunucularına istemci üzerinden aktarılır. |
Web sitesi sunucusundan Meta Graph API sistemine doğrudan iletilir. |

Reklam Engelleyici Koruması |
Tarayıcı eklentileri (ad-blocker) JavaScript isteklerini kolayca engeller. |
Sunucu trafiği istemciden bağımsız olduğu için engellenemez. |

Çerez Kısıtlamaları (ITP/ATT) |
Üçüncü taraf çerezlerin kısıtlanması sebebiyle veri kaybı yüksektir. |
Birinci taraf sunucu verisi ve SHA-256 eşleştirmesiyle kalıcıdır. |

Bağlantı ve Ağ Güvenilirliği |
Kullanıcı sayfayı erken kapatırsa veya ağ koparsa veri kaybolabilir. |
İşlem sunucu veritabanına işlendiği an tarayıcı bağımlılığı olmaksızın güvenle iletilir. |

Çevrim Dışı Olay Desteği |
Desteklemez; sadece tarayıcıda canlı oturum sırasında çalışır. |
CRM, telefonla satış veya mağaza içi işlemleri sonradan gönderebilir. |

Kurulum Süreci |
Web sitesi başlığına (header) küçük bir JS kodu eklenerek hızlıca kurulur. |
Hazır CMS eklentileriyle kolay, özel yazılımlarda teknik entegrasyon ister. |

## Meta Event Deduplication (Tekilleştirme) Mantığı Nasıl İşler?

Web sitenizde hem Meta Pixel hem de Conversions API aynı anda çalıştığında akla gelen ilk soru şudur: Aynı müşteri sipariş verdiğinde Meta bunu iki ayrı satış olarak sayıp panelde çift dönüşüm göstermez mi? İşte bu noktada meta event deduplication yani olay tekilleştirme mekanizması devreye girer.

Meta, hem tarayıcıdan hem sunucudan gelen eşzamanlı olayları akıllı bir algoritmayla süzer. Sistemin tekilleştirme yapabilmesi için iki temel parametrenin her iki kaynaktan da birebir aynı gönderilmesi şarttır:

- Olay Adı (event_name): Gönderilen eylemin adı her iki tarafta da aynı olmalıdır. Örneğin bir satın alma işlemi için hem pikselde hem de API çağrısında Purchase ifadesi kullanılmalıdır. Büyük-küçük harf duyarlılığı bulunduğu için bir tarafta purchase diğerinde Purchase yazılması tekilleştirmeyi bozar.

- Olay Kimliği (event_id): Gerçekleşen tekil işleme özel rastgele veya benzersiz bir kimlik atanmalıdır. E-ticaret sitelerinde bu kimlik için sipariş numarası (örneğin siparis_10845) kullanılır. Form sayfalarında ise işlem anında üretilen benzersiz bir UUID değeri atanır.

Ziyaretçi siparişi tamamladığında tarayıcıdaki Meta Pixel event_name: 'Purchase', event_id: 'siparis_10845' bilgisini gönderir. Bir saniye sonra web sunucunuz CAPI üzerinden aynı parametrelerle (event_name: 'Purchase', event_id: 'siparis_10845') sunucu isteğini Meta'ya iletir. Meta sunucuları 48 saatlik zaman penceresi içinde aynı kimliğe sahip iki olayı inceler; piksel verisindeki tarayıcı bilgilerini sunucu verisindeki zengin müşteri parametreleriyle birleştirir ve panelinizde tek bir net satış olarak kaydeder.

Bu birleşim aynı zamanda Meta Events Manager panelindeki Event Match Quality (Olay Eşleşme Kalitesi) puanınızı yükseltir. Eşleşme puanı 10 üzerinden hesaplanır; e-posta ve telefon gibi şifreli müşteri verilerinin yanı sıra IP adresi ve tarayıcı kimliği gibi parametrelerin eksiksiz gönderildiği sunucu entegrasyonlarında skor 8,0 puanın üzerine çıkarak reklam hedefleme isabetini artırır.

## Popüler Altyapılarda Meta Conversions API Kurulumu

Birçok modern e-ticaret platformu ve içerik yönetim sistemi, sunucu altyapısıyla doğrudan konuşan hazır CAPI eklentilerine sahiptir. Doğru bir meta conversions api kurulumu için ilk adım Meta Events Manager üzerinden yetki anahtarını oluşturmaktır.

### Meta Erişim Belirteci (Access Token) Nasıl Alınır?

Hangi altyapıyı kullanırsanız kullanın, sunucunuzun Meta hesabınıza güvenli veri gönderebilmesi için bir yetki anahtarına ihtiyacı vardır:

- Meta Business Suite üzerinden Olay Yöneticisi (Events Manager) paneline gidin.

- Sol menüden ilgili Veri Kümenizi (Pixel) seçin.

- Üst sekmedeki Ayarlar bölümüne tıklayın.

- Aşağı kaydırarak Dönüşümler API'si başlığı altındaki Erişim Belirteci Oluştur (Generate Access Token) bağlantısına tıklayın.

- Üretilen uzun harf ve rakam dizisini kopyalayarak güvenli bir not defterine kaydedin.

### 1. ikas Altyapısında CAPI Kurulumu

Türkiye'de bulut tabanlı e-ticaret altyapısıyla öne çıkan ikas, yerleşik Meta entegrasyonu sunar. Kurulum adımları şöyledir:

- ikas yönetim panelinize giriş yapın ve sol menüden Satış Kanalları > Eklentiler sekmesini açın.

- Pazarlama araçları listesinden Facebook Conversions API eklentisini bulun ve Bağlan butonuna tıklayın.

- Meta Olay Yöneticisi panelinden kopyaladığınız Erişim Belirteci (Access Token) kodunu ve Pixel Kimliğinizi ilgili alanlara yapıştırın.

- Değişiklikleri kaydedin. ikas, sipariş numaralarını otomatik olarak event_id ile eşleştirerek tekilleştirmeyi arka planda kusursuz biçimde yönetir.

### 2. Shopify Altyapısında CAPI Kurulumu

Shopify ekosisteminde Conversions API kurulumu Meta'nın resmi satış kanalı uygulaması üzerinden birkaç tıklamayla gerçekleştirilir:

- Shopify App Store üzerinden Facebook & Instagram resmi uygulamasını mağazanıza yükleyin.

- Uygulama ayarlarında Veri Paylaşımı Ayarları (Data Sharing Settings) bölümüne gelin.

- Veri paylaşım düzeyini Maksimum (Maximum) olarak işaretleyin.

- Maksimum seçeneği işaretlendiğinde Shopify, hem tarayıcı pikselini hem de Conversions API'yi otomatik olarak aktif hale getirir ve tekilleştirme kodlarını temanıza entegre eder.

### 3. WooCommerce Altyapısında CAPI Kurulumu

WordPress tabanlı WooCommerce mağazalarında kurulum genellikle resmi eklentilerle veya etiket yöneticileriyle yapılır:

- WordPress panelinizde Eklentiler > Yeni Ekle bölümünden Facebook for WooCommerce veya popüler PixelYourSite eklentisini yükleyin.

- Eklenti ayarları panelinde Meta Pixel ID bilginizi ve aldığınız CAPI Access Token anahtarınızı ilgili kutucuklara yapıştırın.

- Otomatik tekilleştirme seçeneğinin aktif olduğunu doğrulayarak ayarları kaydedin.

### 4. Özel Yazılımlar ve Açılış Sayfaları (Landing Pages)

Özel yazılımlı rezervasyon siteleri, danışmanlık platformları veya kurumsal hizmet portalları için entegrasyon doğrudan Meta Graph API üzerinden kodlanır. Web sitenizin sunucu tarafı (Node.js, PHP, Python veya .NET), kullanıcı form gönderdiğinde https://graph.facebook.com/v21.0/{pixel_id}/events uç noktasına POST isteği fırlatır. Alternatif olarak sunucu taraflı Google Tag Manager (sGTM) konteyneri kurularak bulut sunucu üzerinden tüm etkinlikler merkezi olarak yönetilebilir. Detaylı teknik parametreler için resmi Meta Conversions API geliştirici dokümantasyonunu inceleyebilirsiniz.

## Doğru Veri Altyapısıyla Reklam Maliyetlerini Düşürmek

Reklam optimizasyonu yalnızca kampanya açıp bütçe belirlemekle sınırlı değildir. Eksik ya da hatalı sinyallerle beslenen yapay zekâ algoritmaları, reklam bütçenizi satın alma niyeti olmayan kişilere harcayabilir. Contentry Lab olarak sunduğumuz ileri düzey Meta reklam yönetimi ve dönüşüm odaklı web sitesi geliştirme çözümlerinde, ölçümleme mimarisini çift katmanlı Pixel ve CAPI entegrasyonuyla kuruyoruz. Böylece tarayıcı kaynaklı veri kaybını en aza indiriyor, reklam algoritmalarının en yüksek kârlılığa sahip müşterileri bulmasını sağlıyoruz.

## Sık Sorulan Sorular

### Meta Conversions API kullanımı için Meta'ya ek bir ücret ödenir mi?

Conversions API, Meta tarafından tamamen ücretsiz olarak sunulan bir geliştirici aracıdır. Meta bu veri transferi için herhangi bir lisans ya da kullanım bedeli talep etmez. Ancak özel yazılımlarda sunucu taraflı Google Tag Manager (sGTM) için bulut sunucu kiralama gibi harici altyapı maliyetleri gerekebilir.

### Conversions API kurulduktan sonra Meta Pixel web sitesinden kaldırılmalı mıdır?

Hayır, Meta Pixel kesinlikle siteden kaldırılmamalıdır. Meta tarafından önerilen en sağlıklı model tarayıcı ve sunucu izlemesinin birlikte çalıştığı hibrit kurgudur. Piksel istemci taraflı anlık tıklama davranışlarını toplarken, Conversions API tarayıcı engeline takılan satış ve form verilerini güvenceye alır. İki sistem tekilleştirme sayesinde mükerrer kayıt üretmeden kusursuz çalışır.

### Event Match Quality (Olay Eşleşme Kalitesi) skoru kaç olmalıdır?

Meta Olay Yöneticisi panelindeki Event Match Quality skorunun 10 üzerinden en az 6,5 ile 7,0 seviyesinde olması beklenir. Başarılı bir sunucu entegrasyonunda SHA-256 ile özetlenmiş (hashlenmiş) e-posta ve telefon bilgilerinin yanı sıra IP parametresi düz metin olarak eksiksiz iletildiğinde bu skor 8,0 ile 9,5 bandına çıkarak reklam verimini maksimize eder.

### Conversions API reklam maliyetlerini (CAC ve CPA) nasıl düşürür?

Conversions API sayesinde reklam paneline eksiksiz veri aktarıldığında, Meta makine öğrenimi algoritmaları gerçek alıcı profilini çok daha hızlı modeller. Eksik verilerden kaynaklanan yanlış kitle optimizasyonunun önüne geçilir, yeniden hedefleme kitleleri genişler ve doğru kişilere ulaşılması müşteri edinme maliyetinizi (CAC) optimize etmeye ve düşürmeye yardımcı olur.

### Meta tekilleştirme (deduplication) hatası yaşanırsa ne olur?

Eğer tarayıcı pikseli ve Conversions API tarafından gönderilen event_name veya event_id parametreleri birebir eşleşmezse Meta bu olayları iki farklı işlem olarak algılar. Bu durum reklam panelinizde gerçekte olmayan mükerrer satışlar görünmesine, sahte bir ROAS artışına ve makine öğrenimi algoritmasının yanılmasına yol açar.

## Reklam Performansınızı Eksiksiz Veriyle Güçlendirin

Tarayıcı kısıtlamalarının ve reklam engelleyicilerin kampanya kârlılığınızı eritmesine izin vermeyin. Web sitenizde veya açılış sayfanızda çift katmanlı Conversions API altyapısını kurarak reklam verilerinizi güvenceye almak için Contentry Lab ekibiyle WhatsApp üzerinden hemen iletişime geçebilir, teknik denetim sürecinizi başlatabilirsiniz.

## Kaynaklar

- Meta for Developers: Conversions API Overview and Technical Documentation

- Meta Business Help Center: Monitor and Improve Your Conversions API Setup in Meta Events Manager

- Apple Developer: User Privacy, App Tracking Transparency and Data Protections

- WebKit Official Documentation: Intelligent Tracking Prevention (ITP) Details
