Facebook Conversion API (resmî adıyla Meta Conversions API, Türkçe arayüzde Dönüşümler API’si), web sitenizde, uygulamanızda veya mağazanızda gerçekleşen satın alma, form doldurma gibi olayları tarayıcı yerine doğrudan sunucunuzdan Meta’ya gönderen bir ölçüm aracıdır. Meta Pikseli ile birlikte kullanıldığında reklam engelleyiciler, tarayıcı kısıtlamaları ve çerez sorunları nedeniyle kaybolan dönüşüm verilerinin daha büyük kısmını yakalamanıza yardımcı olur. Bu rehberde Conversion API’nin ne olduğunu, pikselden farkını, kurulum yöntemlerini ve erişim jetonu oluşturmayı adım adım anlatıyoruz.
Facebook Conversion API Nedir?
Conversion API, işletmenizin sunucusu ile Meta’nın reklam sistemi arasında güvenli bir bağlantı kurar. Bir müşteri sitenizde alışveriş yaptığında bu bilgi yalnızca kullanıcının tarayıcısındaki piksel üzerinden değil, sizin sunucunuz üzerinden de Meta’ya iletilir.
Bu veriler Meta’nın üç temel işte kullanılır:
- Ölçüm: Hangi reklamın satış, kayıt veya potansiyel müşteri getirdiğini daha doğru raporlamak.
- Optimizasyon: Reklam sisteminin, dönüşüm yapma olasılığı yüksek kişileri daha iyi bulması.
- Hedefleme: Web sitesi ziyaretçilerinden retargeting kitleleri ve bu kitlelerden benzer hedef kitleler oluşturmak.
Meta Pikseli ile Conversion API Arasındaki Fark
Piksel, sitenize eklenen ve kullanıcının tarayıcısında çalışan bir JavaScript kodudur. Conversion API ise sunucu tarafında çalışır. Meta, en iyi sonuç için ikisinin birlikte kullanılmasını önerir.
| Özellik | Meta Pikseli | Conversion API |
|---|---|---|
| Çalıştığı yer | Kullanıcının tarayıcısı | İşletmenin sunucusu |
| Reklam engelleyicilerden etkilenme | Etkilenebilir | Doğrudan etkilenmez |
| Kurulum | Kod ekleme veya eklentiyle kolay | Entegrasyon gerektirir, kodsuz seçenekler de var |
| Çevrimdışı ve uygulama olayları | Sınırlı | Desteklenir |
| Veri kontrolü | Daha az | Hangi verinin gönderileceğini siz belirlersiniz |
Conversion API Neden Önemli?
Tarayıcıların gizlilik önlemleri, iOS cihazlardaki izleme izinleri ve reklam engelleyiciler, yalnızca piksele dayanan ölçümün bazı dönüşümleri kaçırmasına yol açar. Kaçan her dönüşüm, hem raporlarınızı hem de reklam sisteminin öğrenmesini zayıflatır. Conversion API bu boşluğu azaltarak şu faydaları sağlar:
- Dönüşüm raporlarının daha eksiksiz olması
- Reklam başına maliyetin ve ROAS değerinin daha doğru hesaplanması
- Kampanya optimizasyonunun daha fazla veriyle yapılması
- CRM veya mağaza satışları gibi çevrimdışı verilerin de reklam performansına bağlanabilmesi
Facebook Conversion API Kurulum Yöntemleri
Conversion API’yi kurmanın birden fazla yolu vardır. Teknik altyapınıza ve bütçenize göre birini seçebilirsiniz:
1. Olaylar Yöneticisi Üzerinden Kodsuz Kurulum
Meta, Olaylar Yöneticisi’nde web siteleri için kod yazmadan kurulabilen seçenekler sunar. Bu yöntem hızlıdır ancak standart olaylarla sınırlıdır; uygulama veya çevrimdışı olaylar ile özel veri alanları için genellikle yeterli olmaz.
2. İş Ortağı Entegrasyonları
Shopify ve WooCommerce (WordPress) gibi e-ticaret altyapılarının birçoğu Meta ile hazır entegrasyon sunar. Mağaza panelinden Meta hesabınızı bağlayarak Conversion API’yi birkaç adımda etkinleştirebilirsiniz.
3. Conversions API Gateway
Meta’nın kendi bulut altyapınızda veya bir iş ortağı tarafından barındırılan, düşük kodlu çözümüdür. Teknik ekibi sınırlı ama daha fazla kontrol isteyen işletmeler için uygundur.
4. Sunucu Taraflı Etiket Yönetimi
Google Tag Manager’ın sunucu taraflı (server-side) kapsayıcısı ile olayları kendi sunucunuz üzerinden Meta’ya iletebilirsiniz. Birden fazla reklam platformu için tek bir altyapı kurmak isteyenler için esnek bir yöntemdir. Temel kavramlar için Google Tag Manager nedir yazımıza göz atabilirsiniz.
5. Doğrudan (Manuel) Entegrasyon
Geliştiricinizin Meta’nın Graph API’si üzerinden olayları doğrudan göndermesidir. En fazla kontrolü sağlar ama en çok teknik emek isteyen yöntemdir.
Adım Adım Genel Kurulum Akışı
- İşletme hesabını hazırlayın: Meta İşletme Portföyü (eski adıyla Business Manager) hesabınız yoksa oluşturun. Ayrıntılar için Facebook Business Manager hesabı oluşturma rehberimize bakabilirsiniz.
- Veri kümesi ve piksel oluşturun: Olaylar Yöneticisi’nde bir veri kümesi (piksel) oluşturun ve sitenize ekleyin.
- Takip edilecek olayları belirleyin: Satın alma, sepete ekleme, potansiyel müşteri, kayıt gibi işletmeniz için önemli olayları seçin.
- Kurulum yöntemini seçin: Kodsuz kurulum, iş ortağı entegrasyonu, Gateway veya manuel entegrasyondan birini uygulayın.
- Tekilleştirmeyi ayarlayın: Aynı olay hem pikselden hem sunucudan geldiğinde çift sayılmaması için her iki kaynakta aynı olay adı ve olay kimliği (event_id) gönderilmelidir.
- Test edin: Olaylar Yöneticisi’ndeki Olayları Test Et aracıyla sunucu olaylarının doğru ulaştığını kontrol edin.
- Eşleşme kalitesini izleyin: Olay eşleşme kalitesi puanını takip edin; e-posta, telefon gibi müşteri bilgilerini (Meta tarafından şifrelenerek) göndermek eşleşmeyi artırır.
Conversion API Erişim Jetonu Nedir ve Nasıl Oluşturulur?
Erişim jetonu (access token), sunucunuzun Meta’ya olay gönderirken kimliğini doğrulamasını sağlayan bir yetkilendirme anahtarıdır. Manuel entegrasyonlarda ve bazı iş ortağı kurulumlarında gerekir.
- Olaylar Yöneticisi’nde ilgili veri kümesini (pikseli) seçin.
- Ayarlar sekmesine gidin.
- Conversions API bölümünde Erişim jetonu oluştur bağlantısına tıklayın.
- Oluşturulan jetonu kopyalayıp entegrasyonunuza veya eklentinize girin.
Güvenlik notu: Erişim jetonu bir şifre gibidir. Sitenizin herkese açık kodunda, e-postada veya paylaşılan belgelerde açık şekilde tutmayın. Jetonun ele geçirildiğinden şüphelenirseniz yenisini oluşturun.
Sık Yapılan Hatalar
- Tekilleştirme yapmamak: Olaylar çift sayılır, dönüşümler olduğundan yüksek görünür.
- Eksik müşteri bilgisi göndermek: Eşleşme kalitesi düşer, ölçüm ve optimizasyon zayıflar.
- Kişisel veri mevzuatını göz ardı etmek: Sitenizde çerez ve aydınlatma metinlerinin KVKK’ya uygun olduğundan, kullanıcı izinlerinin doğru alındığından emin olun.
- Kurulumdan sonra izlememek: Site güncellemeleri veya eklenti değişiklikleri entegrasyonu bozabilir. Olaylar Yöneticisi’ni düzenli kontrol edin.
Meta tarafındaki ölçümü Google Analytics ile birlikte değerlendirmek size daha bütün bir resim sunar. Bunun için Google Analytics nedir yazımıza göz atabilirsiniz.
Profesyonel Kurulum Desteği
Conversion API kurulumu altyapınıza göre birkaç dakikadan birkaç güne kadar sürebilir ve hatalı kurulum raporları yanıltabilir. Gezgin Ajans olarak Facebook reklam hizmetimizde piksel ve Conversion API kurulumunu, olay testlerini ve kampanya optimizasyonunu birlikte yürütüyoruz.
Sıkça Sorulan Sorular
Conversion API pikselin yerini alır mı?
Hayır. Meta, piksel ve Conversion API’nin birlikte kullanılmasını önerir. İkisi birlikte çalıştığında, tekilleştirme sayesinde olaylar çift sayılmadan daha eksiksiz veri toplanır.
Conversion API ücretli mi?
Meta, Conversion API için ücret almaz. Ancak sunucu, Gateway barındırma veya iş ortağı hizmetleri için ayrı maliyetler oluşabilir.
WordPress sitemde Conversion API nasıl kurulur?
WooCommerce kullanıyorsanız Meta’nın resmî entegrasyonu veya güvenilir bir iş ortağı eklentisiyle kurulum yapabilirsiniz. Kurulum sonrası Olaylar Yöneticisi’nde olayları mutlaka test edin.
Olay eşleşme kalitesi nedir?
Sunucudan gönderilen olayların Meta hesaplarıyla ne kadar iyi eşleştiğini gösteren puandır. E-posta, telefon gibi müşteri bilgilerini şifreli göndermek bu puanı yükseltir.


