Conversions API (CAPI), web sitesi, uygulama, CRM veya mağaza olaylarını tarayıcı yerine doğrudan sunucunuzdan Meta'ya gönderen bağlantıdır. Pixel tarayıcıda çalıştığı için reklam engelleyici ve çerez kısıtlarından etkilenir; CAPI bunlardan bağımsızdır. Meta ikisinin birlikte kullanılmasını önerir. Aynı olayın iki kez sayılmaması için event_id ve event_name eşleşmeli; tekilleştirme 48 saat içinde yapılır.
Bu sayfada
- Conversions API nedir, ne işe yarar?
- Meta Pixel ile Conversions API arasındaki fark nedir?
- Aynı satış iki kez sayılmaz mı? Tekilleştirme nasıl çalışır?
- Conversions API hangi yollarla kurulur?
- CAPI ile hangi müşteri verileri gönderilir?
- Kurulum adım adım nasıl yapılır?
- Kurulumu kendiniz mi yapmalısınız?
- Sık sorulan sorular
Conversions API nedir, ne işe yarar?
Conversions API nedir sorusuna Meta'nın kendi tanımı şöyle: reklamverenin sunucusundaki, web sitesi platformundaki, mobil uygulamasındaki veya CRM'indeki pazarlama verisini (site olayları, uygulama olayları, mesajlaşma olayları ve çevrim dışı dönüşümler) Meta sistemlerine bağlayan bir bağlantı.
Pratikte şu anlama gelir: Bir müşteri sitenizde satın alma yaptığında bu bilgi yalnızca ziyaretçinin tarayıcısından değil, sipariş kaydını tutan sunucunuzdan da Meta'ya gider. Böylece reklam sistemi hangi reklamın satış getirdiğini daha eksiksiz görür ve teklif stratejisini buna göre optimize eder.
Meta Pixel ile Conversions API arasındaki fark nedir?
| Özellik | Meta Pixel | Conversions API |
|---|---|---|
| Nerede çalışır? | Ziyaretçinin tarayıcısında (JavaScript) | Sizin sunucunuzda veya bulut ortamınızda |
| Reklam engelleyici etkisi | Engellenebilir | Etkilenmez |
| Hangi olayları gönderir? | Sitede gerçekleşen olaylar | Site, uygulama, telefon, mağaza, CRM olayları |
| Çevrim dışı satış | Gönderemez | Gönderebilir (ör. telefonla kapanan satış) |
| Kurulum | Kodu siteye eklemek yeterli | Sunucu tarafı entegrasyon veya hazır bağlantı gerekir |
| Veri kontrolü | Tarayıcının gönderdiği her şey | Hangi alanın gideceğine siz karar verirsiniz |
Meta, ikisinin birlikte kullanıldığı yedekli kurulumu (redundant setup) öneriyor. Pixel'in yakaladığı olay CAPI ile de gelir; biri kaçırırsa diğeri tamamlar.
Farkı somut bir örnekle düşünelim: bir ziyaretçi reklam engelleyici kullanan bir tarayıcıyla sitenize girip satın alma yaptı. Pixel bu satışı Meta'ya iletemez, ama sipariş sunucunuza kaydedildiği anda CAPI aynı olayı gönderir. Reklam sistemi o satışı getiren reklamı öğrenir ve benzer kişilere daha çok gösterim yapar.
Aynı satış iki kez sayılmaz mı? Tekilleştirme nasıl çalışır?
Yedekli kurulumda aynı satın alma hem Pixel'den hem sunucudan gelir. Meta bunları tek olay saymak için olay kimliğine (ID) ve olay adına bakar. Pixel'deki eventID ile CAPI'deki event_id, Pixel'deki olay adı ile CAPI'deki event_name aynı olmalıdır.
| Kural | Değer | Kaynak |
|---|---|---|
| Tekilleştirme anahtarı | event_id + event_name (önerilen yöntem) | Meta Developers |
| Alternatif anahtar | event_name + fbp ve/veya external_id | Meta Developers |
| Tekilleştirme penceresi | İlk olay alındıktan sonra 48 saat | Meta Developers |
| Olay zamanı sınırı | event_time 7 günden eskiyse tüm istek hata verir | Meta Developers |
| event_id örneği | Sipariş numarası veya işlem kimliği | Meta Developers |
Conversions API hangi yollarla kurulur?
| Yol | Kimin için? | Artısı | Dikkat |
|---|---|---|---|
| Conversions API Gateway | Geliştiricisi olmayan ama bulut hesabı olan işletmeler | Events Manager'dan kurulur; Meta'ya göre süreyi haftalardan saatlere indirir | Sizin AWS veya Google Cloud hesabınızda çalışır, bulut maliyeti size aittir |
| Sunucu taraflı etiket yöneticisi | Google ve Meta ölçümünü birlikte yöneten siteler | Tek sunucu kapsayıcısından birden çok platforma veri | Sunucu barındırma ve bakım gerektirir |
| Doğrudan entegrasyon | Özel yazılım, CRM, çevrim dışı satış | En esnek yol; telefon ve mağaza satışları da gönderilir | Geliştirici emeği ve test süreci gerekir |
CAPI ile hangi müşteri verileri gönderilir?
Meta'nın olayı doğru kişiyle eşleştirebilmesi için olayla birlikte müşteri bilgileri de gönderilir. Kişisel iletişim bilgileri gönderilmeden önce SHA-256 ile özetlenmeli (hash) ve belirli kurallarla normalleştirilmelidir.
| Alan | Özetlenir mi? | Normalleştirme |
|---|---|---|
| E-posta (em) | Evet | Baştaki ve sondaki boşluklar silinir, tamamı küçük harfe çevrilir |
| Telefon (ph) | Evet | Semboller ve harfler silinir, ülke kodu eklenir (Türkiye için 90) |
| Ad, soyad (fn, ln) | Evet | Küçük harf, UTF-8 |
| Şehir, posta kodu, ülke | Evet | Küçük harf, boşluk ve özel karakter yok |
| IP adresi, tarayıcı bilgisi | Hayır | Olduğu gibi gönderilir |
| fbc, fbp (Meta çerez kimlikleri) | Hayır | Olduğu gibi gönderilir |
Bu veriler kişisel veridir. Türkiye'de KVKK kapsamında aydınlatma metninizde reklam platformlarına veri aktarımını açıklamanız, AB'deki ziyaretçiler için ise pazarlama çerezleri ve sunucu tarafı ölçüm için önceden onay almanız gerekir.
Kurulum adım adım nasıl yapılır?
- Olay listesini çıkarınHangi olayların ölçüleceğine karar verin: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase, Lead. Her olayın sitede nerede tetiklendiğini yazın.
- Kurulum yolunu seçinAltyapınıza göre platform entegrasyonu, Gateway, sunucu taraflı etiket yöneticisi veya doğrudan entegrasyonu seçin.
- event_id üretinHer olay için benzersiz bir kimlik oluşturun ve aynı değeri hem Pixel'e hem CAPI'ye gönderin. Satın almada sipariş numarası en güvenli seçimdir.
- Müşteri bilgilerini ekleyinE-posta ve telefonu kurallara göre normalleştirip SHA-256 ile özetleyin; IP ve tarayıcı bilgisini özetlemeden ekleyin.
- Test Events ile doğrulayınEvents Manager'daki test aracıyla olayların iki kaynaktan geldiğini ve tekilleştirildiğini kontrol edin.
- Eşleşme kalitesini izleyinEvents Manager'daki olay eşleşme kalitesi göstergesini takip edin; düşükse eksik müşteri alanlarını tamamlayın.
Kurulumu kendiniz mi yapmalısınız?
Özel yazılım, telefonla satış veya birden fazla reklam platformu varsa sunucu tarafı kurulum geliştirici işi gerektirir. Dönüşüm takibi kurulumu hizmetimizde Meta Pixel ve CAPI'yi Google Ads ve GA4 ölçümüyle birlikte kuruyor, test ederek teslim ediyoruz. Reklamları da yönetmemizi isterseniz Instagram reklam ajansı sayfamıza, CRM ve özel sistemlerle bağlantı için API entegrasyonu sayfamıza bakabilirsiniz. Google ve Meta'yı birlikte kullanırken ölçüm farklarını Google Ads mi Instagram reklamı mı yazımızda ele aldık.
Sık sorulan sorular
Conversions API Pixel'in yerine geçer mi?
Geçebilir ama Meta bunu önermiyor. Meta'nın tavsiyesi, Pixel ve Conversions API'nin birlikte çalıştığı yedekli kurulumdur. Pixel tarayıcıdaki anlık davranışı iyi yakalar, CAPI ise engellenen veya tarayıcı dışında gerçekleşen olayları tamamlar. İkisi event_id ile tekilleştirildiğinde en eksiksiz veri elde edilir.
Conversions API ücretli mi?
Meta, Conversions API kullanımı için ücret almaz. Maliyet kurulum ve barındırma tarafındadır: Conversions API Gateway kendi bulut hesabınızda çalışır ve bulut ücretini siz ödersiniz, doğrudan entegrasyon ise geliştirici emeği gerektirir.
Telefonla gelen satışları Meta'ya gönderebilir miyim?
Evet. Conversions API, action_source alanında phone_call, physical_store veya system_generated gibi değerlerle site dışındaki olayları da kabul ediyor. Olay zamanı 7 günden eski olmamalı. CRM'inizde satış kapandığında müşterinin e-posta veya telefonunu özetleyip olayı göndermek yeterlidir.
Olaylar neden iki kez sayılıyor?
En sık neden, Pixel ve Conversions API'nin aynı olay için farklı event_id göndermesi ya da hiç göndermemesidir. Olay adının da iki kaynakta birebir aynı yazılması gerekir. Test Events aracında iki kaynaktan gelen olayın tekilleştirildiğini doğrulayın.
KVKK açısından Conversions API kullanmak sorun mu?
Kullanılabilir, ancak kişisel veri aktarımı olduğu için aydınlatma metninizde reklam platformlarıyla hangi verinin hangi amaçla paylaşıldığını açıklamanız gerekir. İletişim bilgileri özetlenerek gönderilse de kişisel veri niteliğini korur. Kendi durumunuz için bir hukukçuya danışmanızı öneririz.
ChatGPT reklamlarında da Conversions API var mı?
Evet. OpenAI da 5 Mayıs 2026'dan itibaren ChatGPT reklamları için Pixel ve Conversions API sunuyor. Mantık benzer: dönüşümler sunucunuzdan reklam platformuna gönderilir. Aynı sunucu tarafı altyapıdan Meta, Google ve OpenAI'a veri göndermek mümkündür.
Projenizi konuşalım
İhtiyacınızı WhatsApp'tan kısaca yazın; kapsamı netleştirip aynı gün içinde size dönüş yapalım.
İlgili sayfalar
- Dönüşüm Takibi Kurulumu: Reklamınızın Getirdiği Her Müşteriyi ÖlçünForm, telefon, WhatsApp ve satın almayı Google Ads, GA4 ve Meta'da doğru sayılacak şekilde kuruyoruz. Avrupa'ya reklam verenler için Consent
- Instagram Reklam Ajansı: Instagram ve Facebook Reklamlarınızı YöneteliInstagram, Facebook ve WhatsApp'a yönlenen reklamlarınızı ölçüm, kreatif ve hedef kitle tarafıyla birlikte yönetiyoruz. Reklam hesabı sizin
- Google Ads mi Instagram Reklamı mı? Niyet ve Keşif Karşılaştırmasıİki platform aynı işi yapmaz. Google, bir şeyi arayan kişiyi yakalar; Instagram, henüz aramayan ama ilgilenebilecek kişiye ürünü gösterir. H
- Meta Developers — Conversions API
- Meta Developers — Deduplicate Pixel and Server Events
- Meta Developers — Server Event Parameters (event_time, action_source)
- Meta Developers — Customer Information Parameters (hash kuralları)
- Meta Developers — Conversions API Gateway
- OpenAI — New ways to buy ChatGPT ads (5 Mayıs 2026)