Kısa tanım
Dönüşüm API’si (Conversions API), web sitesi, uygulama, mesajlaşma ve çevrimdışı olaylarını sunucu, web sitesi platformu, uygulama ya da CRM bağlantısıyla Meta’ya ileten araçtır. Meta, pikselle birlikte kullanılmasını önerir. Aynı piksele giden olaylarda kimlik ve olay adı eşleşirse ilk olaydan sonraki 48 saat içinde gelen kopya atılır. Türkiye’deki reklam hesaplarında kurulabilir.
22 Ekim 2026 itibarıyla.
Editör: Deniz Savaş, Kreatif Stratejist
Tarayıcıdaki piksel, yükleme hatasında, bağlantı sorununda ya da reklam engelleyicide olayı kaçırabilir. Dönüşüm API’si (Conversions API) aynı olayı sunucunuzdan, web sitesi platformunuzdan, uygulamanızdan ya da CRM sisteminizden Meta’ya gönderir. Meta’nın Türkçe arayüzünde adı Dönüşümler API’si olarak geçer.
Dönüşüm API’si Meta’ya hangi verileri taşır?
Web sitesi, uygulama, mesajlaşma ve çevrimdışı olaylarını tek bir API üzerinden gönderirsiniz. CRM (müşteri ilişkileri yönetimi) sisteminiz bu olayların kaynaklarından biri olabilir. Web sitesi olayları pikselinize bağlanır ve piksel olayları gibi davranır. Çevrimdışı olaylar ise yalnızca “Web sitesi ve mağaza” seçili Satış hedefli kampanyada optimizasyona girer.
Piksel varken sunucu bağlantısını neden kurarsınız?
Meta ikisini birlikte kullanmayı öneriyor. Aynı satın alma çift sayılmasın diye iki olay aynı piksel kimliğine gider ve pikseldeki eventID ile sunucudaki event_id aynı değeri taşır. Pikseldeki olay adı da sunucudaki event_name ile eşleşir. Meta, ilk olaydan sonraki 48 saat içinde gelen eşleşen kopyayı atar.
Olay Yöneticisi’ndeki (Events Manager) Etkinlik Eşleştirme Kalitesi (Event Match Quality) puanı, müşteri bilgisinin olayı bir Meta hesabıyla eşleştirmeye ne kadar elverişli olduğunu 10 üzerinden gösterir. E-posta ve telefon karma (hash) işleminden geçerek, IP adresi karmasız gönderilir. Kurulumdan sonra ilk iş bu puana bakın.
Türkiye’deki reklam hesapları Dönüşüm API’sini kurabilir mi?
Evet. Doğrudan kurulum için İşletme Yöneticisi hesabı, veri kümesi (piksel) kimliği ve Olay Yöneticisi’nden oluşturulan erişim anahtarı gerekir. Birçok iş ortağı entegrasyonu geliştirici istemez. Meta’nın belgelerinde bölgeye bağlı bir kısıt geçmiyor.
İlgili rehberler
Sık sorulanlar
Dönüşüm API’si pikselin yerine geçer mi?
Meta en iyi sonuç için ikisini birlikte kullanmayı öneriyor. Aynı olay iki kanaldan aynı piksel kimliğine gönderiliyorsa pikseldeki eventID ile sunucudaki event_id aynı değeri taşımalı. Pikseldeki olay adı da sunucudaki event_name ile eşleşmeli. Meta, ilk olaydan sonraki 48 saat içinde gelen kopyayı atar.
Etkinlik Eşleştirme Kalitesi neyi gösterir?
Olay Yöneticisi’ndeki 10 üzerinden verilen bu puan, gönderdiğiniz müşteri bilgisinin olayı bir Meta hesabıyla eşleştirmeye ne kadar elverişli olduğunu gösterir. Karma işleminden geçmiş e-posta ve telefon ile karmasız gönderilen IP adresi gibi bilgiler eşleşmeye yardım eder.
Dönüşüm API’si için ne gerekir?
Doğrudan kurulum için bir İşletme Yöneticisi hesabı, bir veri kümesi (piksel) kimliği ve Olay Yöneticisi’nden oluşturulan erişim anahtarı gerekir. Olayları sunucu entegrasyonunuz gönderir. İş ortağı araçlarıyla kurulumda adımlar değişir ve Meta’ya göre birçok entegrasyon geliştirici gerektirmez.