Conversions API Nedir? Sunucu Taraflı Ölçüm Rehberi (2026)

Conversions API nedir sorusunun kısa yanıtı şu: Conversions API (CAPI), Meta'nın sunucu taraflı ölçüm altyapısıdır; satın alma, form ya da randevu gibi olayları ziyaretçinin tarayıcısı yerine doğrudan sizin sunucunuzdan Meta'ya gönderir. Böylece reklam engelleyiciler, tarayıcı çerez kısıtlamaları ve iOS gizlilik değişiklikleri nedeniyle kaybolan dönüşümlerin önemli bir kısmı yeniden ölçülebilir hale gelir. En iyi sonuç, Meta Pixel ile birlikte çalıştırılıp aynı olayların event_id ile tekilleştirildiği "çift kanallı" kurulumla alınır.

Bu yazıda Conversions API'nin ne olduğunu, neden artık bir lüks değil zorunluluk sayıldığını, tekilleştirmenin nasıl çalıştığını, olay eşleşme kalitesini nasıl yükselteceğinizi ve işletmenize uygun kurulum yolunu teknik jargona boğmadan anlatıyoruz.

Tarayıcı taraflı ve sunucu taraflı ölçüm farkı

Klasik Meta Pixel "tarayıcı taraflı" çalışır. Yani ziyaretçi sitenize girdiğinde, onun tarayıcısında bir JavaScript kodu çalışır ve olayı Meta'ya o tarayıcı gönderir. Bu modelin zayıf noktası, olayın gönderilip gönderilmeyeceğine ziyaretçinin cihazı ve tarayıcısının karar vermesidir.

Sunucu taraflı ölçümde ise olay, sizin kontrolünüzdeki sunucudan Meta'nın API'sine iletilir. Örneğin sipariş veritabanınıza kaydedildiği anda sunucunuz Meta'ya "şu tutarda bir satın alma oldu" bilgisini gönderir. Ziyaretçinin tarayıcısında ne olduğu bu gönderimi etkilemez.

Pixel'i kapatıp sadece CAPI kullanmalı mıyım?

Hayır. Meta da her iki kanalın birlikte kullanılmasını önerir. Piksel; sayfa görüntüleme, kaydırma, tıklama gibi tarayıcı davranışlarını ve çerez bilgilerini (_fbp, _fbc) sağlar. CAPI ise kritik dönüşümlerin kaybolmamasını garanti altına alır. İkisi birlikte çalıştığında Meta aynı olayı iki kanaldan alır, eşleştirir ve tek olay olarak sayar.

Neden iOS ve reklam engelleyiciler sonrası şart?

Son yıllarda dijital reklam ölçümünü zorlaştıran birkaç gelişme oldu. Bunları anlamak, CAPI'nin neden önemli olduğunu da açıklar.

iOS gizlilik değişiklikleri

Apple, iOS 14.5 ile birlikte Uygulama Takip Şeffaflığı (App Tracking Transparency) özelliğini getirdi. Bu özellikle uygulamalar, kullanıcıları başka uygulama ve sitelerde takip etmek için açık izin istemek zorunda kaldı. Instagram ve Facebook uygulamalarında izin vermeyen kullanıcıların verisi sınırlandı. Bunun yanında Safari'nin Akıllı İzleme Önleme (ITP) özelliği, tarayıcıda JavaScript ile oluşturulan çerezlerin ömrünü kısaltır. Sonuç olarak reklama tıklayıp birkaç gün sonra satın alan bir kullanıcıyı reklamla ilişkilendirmek zorlaşır.

Reklam engelleyiciler

Masaüstünde ve mobilde reklam engelleyici kullanımı yaygındır. Birçok engelleyici, Meta Pixel'in yüklendiği alan adını doğrudan engeller. Bu durumda piksel hiç çalışmaz ve o ziyaretçinin yaptığı satış Meta'ya hiç ulaşmaz.

Sonuç: Algoritma eksik veriyle öğreniyor

Kaybolan her dönüşüm iki zarara yol açar. Birincisi, raporlarınız gerçeği yansıtmaz; iyi çalışan bir kampanyayı kötü sanıp kapatabilirsiniz. İkincisi, Meta'nın algoritması kimin satın aldığını öğrenemediği için reklamı doğru kişilere gösteremez. Örneğin işletmenize 20 satış gelirken Reklam Yöneticisi 12 gösteriyorsa, algoritma 8 alıcının özelliklerinden hiç öğrenmemiş demektir.

event_id ile tekilleştirme nasıl çalışır?

Pixel ve CAPI birlikte çalıştığında aynı satın alma iki kez gönderilir: bir kez tarayıcıdan, bir kez sunucudan. Meta'nın bunları iki ayrı satış saymaması için tekilleştirme (deduplication) yapılır.

Tekilleştirme için iki bilgi eşleşmelidir:

• Olay adı: Pixel'de Purchase ise CAPI'de de event_name alanı Purchase olmalı.
• Olay kimliği: Pixel'de eventID parametresiyle, CAPI'de event_id alanıyla gönderilen benzersiz değer aynı olmalı.

Tekilleştirmeyi doğru kurmanın adımları

1. Olay gerçekleştiğinde benzersiz bir kimlik üretin. Örneğin sipariş numarası (order_1045) ya da rastgele üretilmiş bir değer.
2. Tarayıcı tarafında pikseli bu kimlikle tetikleyin: fbq('track', 'Purchase', {value: 850, currency: 'TRY'}, {eventID: 'order_1045'}); (değerler örnektir).
3. Sunucu tarafında aynı olayı event_name: "Purchase" ve event_id: "order_1045" ile gönderin.
4. Olay Yöneticisi'nde olaya tıklayıp tarayıcı ve sunucu olaylarının birlikte alındığını ve tekilleştirildiğini kontrol edin.
5. Tanılama sekmesinde "tekilleştirme eksik" türünde uyarı varsa kimliklerin iki tarafta aynı üretilip üretilmediğine bakın.

En sık hata, kimliğin tarayıcıda ve sunucuda ayrı ayrı rastgele üretilmesidir. Bu durumda değerler farklı olur ve Meta her satışı iki kez sayar. Kimlik bir kez üretilmeli ve iki tarafa da aynı değer aktarılmalıdır.

Olay eşleşme kalitesi (Event Match Quality) nedir?

Meta, sunucudan gelen bir olayı bir Facebook ya da Instagram kullanıcısıyla eşleştirmeye çalışır. Ne kadar fazla ve doğru müşteri bilgisi gönderirseniz eşleşme o kadar başarılı olur. Olay Yöneticisi bu başarıyı 0 ile 10 arasında bir olay eşleşme kalitesi puanıyla gösterir.

Eşleşmeyi güçlendiren müşteri bilgileri

Hash ne demek? Hash, bir veriyi geri döndürülemeyecek şekilde sabit uzunlukta bir karakter dizisine çevirmektir. E-posta adresi Meta'ya açık haliyle değil, SHA-256 algoritmasıyla şifrelenmiş haliyle gider. Meta da kendi tarafındaki hash'lenmiş verilerle karşılaştırarak eşleşme yapar. Hash'lemeden önce verinin küçük harfe çevrilmesi ve boşlukların temizlenmesi gerekir.

Eşleşme kalitesini yükseltmek için pratik adımlar

1. Formlarda e-posta ya da telefon alıyorsanız bunları hash'leyerek CAPI olayına ekleyin.
2. Telefon numarasını ülke koduyla ve sadece rakam olarak gönderin (örneğin 90 ile başlayan biçim).
3. fbp ve fbc çerez değerlerini sunucuya taşıyın ve olayla birlikte gönderin.
4. Ziyaretçinin IP adresi ve tarayıcı bilgisini (user agent) ekleyin.
5. Üye girişi olan sitelerde external_id olarak müşteri numarasını kullanın.

Conversions API kurulum yolları

CAPI'yi kurmanın tek bir yolu yoktur. Altyapınıza, bütçenize ve teknik ekibinize göre seçim yaparsınız.

1. Hazır iş ortağı entegrasyonları

Shopify, WooCommerce ve bazı e-ticaret altyapıları, Meta ile resmi ya da eklenti tabanlı CAPI entegrasyonu sunar. Genellikle Olay Yöneticisi'nden ya da platformun yönetim panelinden birkaç tıklamayla açılır. Avantajı hızlı olmasıdır; dezavantajı ise hangi olayların, hangi müşteri bilgileriyle gönderildiği üzerinde kontrolünüzün sınırlı olmasıdır.

2. Conversions API Gateway

Meta'nın sunduğu bu çözüm, sizin bulut hesabınızda çalışan bir ara sunucu kurar ve piksel olaylarını otomatik olarak sunucu tarafına da kopyalar. Kod yazmadan kurulabilir ancak bir bulut sağlayıcı hesabı ve aylık barındırma maliyeti gerektirir.

3. Sunucu taraflı Google Tag Manager

Server-side GTM, kendi alan adınızın alt alanında (örneğin olcum.siteniz.com) çalışan bir etiket sunucusudur. Tarayıcıdan gelen olayları alır, zenginleştirir ve Meta, Google Ads, GA4 gibi platformlara sunucudan iletir. Birden fazla reklam platformu kullanan işletmeler için esnek bir çözümdür ama kurulumu ve bakımı teknik bilgi ister.

4. Doğrudan API entegrasyonu

Siteniz özel kodlanmışsa, geliştirici sipariş ya da form kaydedildiği anda Meta'nın Graph API'sine doğrudan istek gönderen bir fonksiyon yazar. En fazla kontrolü sağlayan yöntem budur; telefonla gelen satışlar ya da CRM'de "müşteri oldu" olarak işaretlenen talepler gibi sayfa dışı olaylar da bu yolla gönderilebilir.

Hangi yol size uygun?

CAPI kurulumunu test etmek ve izlemek

Kurulumdan sonra şu kontrolleri yapın:

1. Olay Yöneticisi'nde Olayları test et sekmesini açın ve size verilen test kodunu (test_event_code) sunucu isteğinize geçici olarak ekleyin.
2. Sitede bir form gönderin ya da test siparişi verin; olayın "Sunucu" kaynağıyla göründüğünü doğrulayın.
3. Aynı olayın "Tarayıcı" kaynağıyla da geldiğini ve tekilleştirildiğini kontrol edin.
4. Test kodunu canlı kurulumdan kaldırın.
5. Birkaç gün sonra olay eşleşme kalitesi puanını ve Tanılama sekmesindeki uyarıları inceleyin.

Ayrıca olayların gecikmeden gönderildiğinden emin olun. Meta, olayların gerçekleştikten sonra mümkün olduğunca hızlı gönderilmesini önerir; web olayları için olay zamanı geçmişe dönük yalnızca sınırlı bir süre (en fazla 7 gün) kabul edilir.

KVKK ve onay

Sunucu taraflı ölçüm, çerez onayı kurallarını ortadan kaldırmaz. Pazarlama çerezlerine onay vermeyen ziyaretçilerin verisini CAPI ile göndermemek, kişisel verileri her zaman hash'lemek ve aydınlatma metninde bu işlemi açıklamak gerekir. Onay durumu hem tarayıcı hem sunucu tarafında aynı şekilde uygulanmalıdır.

Örnek senaryo: Randevu alan bir işletmede CAPI

Konuyu somutlaştırmak için varsayımsal bir örnek düşünelim. Bir diş kliniği Instagram reklamlarıyla randevu formu topluyor. Formu dolduranların bir kısmı reklam engelleyici kullanıyor, bir kısmı da reklama Instagram uygulaması içinden tıklayıp birkaç gün sonra Safari'den geri dönüyor. Sadece piksel kullanıldığında bu kişilerin formları Reklam Yöneticisi'ne hiç ya da eksik ulaşıyor.

CAPI kurulduğunda akış şöyle değişir:

1. Ziyaretçi formu gönderir; site, form kaydını veritabanına yazar.
2. Aynı anda tarayıcıdaki piksel Lead olayını benzersiz bir eventID ile gönderir (engellenmediyse).
3. Sunucu, aynı event_id ile, hash'lenmiş telefon numarası, fbp/fbc değerleri, IP adresi ve tarayıcı bilgisini ekleyerek Lead olayını Meta'ya iletir.
4. Meta iki olayı eşleştirip tek potansiyel müşteri olarak sayar; piksel engellendiyse sunucu olayı yine de ulaşır.
5. Klinik daha sonra randevuya gelen hastaları CRM'de işaretler ve bu bilgiyi de ayrı bir olay olarak (örneğin özel bir "Randevuya geldi" olayı) sunucudan gönderir.

Son adım özellikle değerlidir. Algoritma artık yalnızca form dolduranları değil, gerçekten randevuya gelenleri de öğrenir. Bu sayede zamanla daha nitelikli kişilere reklam gösterme şansı artar. Elbette sonuç sektöre, bütçeye ve teklifin kalitesine göre değişir; CAPI burada sadece daha doğru veri sağlar.

Kurulumdan önce hazır olması gerekenler

• Meta iş portföyünüzde yönetici erişimi ve pikselin size ait olması
• Conversions API için Olay Yöneticisi'nden oluşturulan erişim belirteci (access token)
• Hangi olayların sunucudan gönderileceğinin listesi
• Formlarda ve siparişlerde hangi müşteri bilgilerinin toplandığı
• Çerez onay sisteminin onay durumunu sunucuya da iletebilmesi

Erişim belirteci bir şifre gibidir; kod deposunda açık metin olarak saklanmamalı, sunucu ortam değişkenlerinde tutulmalıdır.

CAPI ile neler değişir, neler değişmez?

Beklentiyi doğru kurmak önemli. Conversions API:

• Reklam engelleyici ve çerez kısıtlamaları nedeniyle kaybolan dönüşümlerin bir kısmını geri kazandırır.
• Algoritmaya daha fazla ve daha doğru sinyal verir; bu da zamanla hedeflemeyi iyileştirebilir.
• Telefonla satış, mağazada satış ya da CRM aşamaları gibi site dışı olayları ölçmeyi mümkün kılar.

Ancak CAPI:

• Kötü bir teklifi ya da yavaş bir siteyi düzeltmez.
• Onay vermeyen kullanıcıları ölçmenize izin vermez.
• Tek başına "%100 doğru" veri garantisi değildir; eşleşme her zaman olasılıksaldır.

Kurulumu kendiniz yapmak yerine uzman desteği isterseniz, Ölçüm Kurulumu paketimiz Meta Pixel ile Conversions API'yi, GA4 ve Google Ads dönüşümleriyle birlikte 3 iş gününde kurar (15.000 ₺, KDV hariç). Sunucu taraflı ölçümün reklam yönetimine nasıl bağlandığını Google ve Meta reklam yönetimi sayfamızda bulabilirsiniz. Klinik ve sağlık işletmeleri için randevu odaklı ölçüm kurgusunu ise sağlık ve klinik sektör sayfamızda anlatıyoruz.

Sonuç

Conversions API, Meta reklamlarında ölçümün yeni standardıdır. Tarayıcı pikseli tek başına artık yeterli değil; iOS gizlilik değişiklikleri, Safari çerez kısıtlamaları ve reklam engelleyiciler verinin bir kısmını görünmez kılıyor. Pixel ve CAPI'yi birlikte kurup event_id ile tekilleştirmek, hash'lenmiş müşteri bilgileriyle eşleşme kalitesini yükseltmek ve onay kurallarına uymak, hem raporlarınızı hem de reklam performansınızı daha sağlam bir zemine oturtur.

Sitenizde Meta Pixel ve diğer ölçüm etiketlerinin kurulu olup olmadığını görmek için ücretsiz ölçüm aracımızla sitenizi 30 saniyede analiz edin.