Conversions API nedir?

Meta reklamlarında ölçüm sorunu çoğu zaman aynı cümleyle başlar: "Reklam yöneticisi 40 başvuru diyor, CRM'de 25 kayıt var, kaç hastanın geldiğini ise kimse bilmiyor." Conversions API bu boşluğu kapatmak için tasarlanmış bir araçtır. Ancak sağlık kliniği için kurulum, bir e-ticaret sitesindeki kurulumla aynı değildir. Meta'nın sağlık verisi kuralları, veri kaynağı kategorileri ve KVKK birlikte devreye girer.

Bu rehber, Meta for Developers'daki Conversions API dokümanlarına ve Meta İşletme Yardım Merkezi sayfalarına dayanır; hepsi 26 Ekim 2026'da yeniden açılıp okundu. Parametre ve menü adlarını Meta'nın dokümanında geçtiği gibi yazıyoruz ki geliştiricinizle aynı dili konuşabilesiniz.

Dönüşümler API'si nedir?

Meta'nın tanımıyla Dönüşümler API'si, reklamverenin pazarlama verisi ile Meta'nın reklam sistemleri arasında doğrudan bağlantı kurmak için tasarlanmıştır. Pazarlama verisi site olaylarını, uygulama olaylarını, çevrimdışı dönüşümleri ve mesajlaşma olaylarını kapsar. Veri reklamverenin sunucusundan, site platformundan, uygulamasından veya CRM'inden gönderilir. Meta bu veriyi hedeflemeyi optimize etmek, sonuç başı maliyeti düşürmek ve sonuçları ölçmek için kullanır.

İngilizce adı Conversions API, kısaltması CAPI'dir; Meta'nın Türkçe arayüzünde Dönüşümler API'si diye geçer. Sunucudan gelen olaylar bir veri seti (dataset) kimliğine bağlanır ve Meta Pikseli olayları gibi işlenir: ölçümde, raporlamada ve optimizasyonda benzer biçimde kullanılabilir. Meta'ya göre farklı olay türlerini tek API ile göndermek, her veri kaynağı için ayrı bağlantı sürdürme ihtiyacını azaltır.

Meta Pikseli ile Conversions API arasındaki fark

Piksel ziyaretçinin tarayıcısında çalışan bir JavaScript kodudur; olay, kişinin cihazından Meta'ya gider. Dönüşümler API'si ise olayı sizin sunucunuzdan veya kullandığınız bir platformun sunucusundan gönderir. Bu fark, kliniğin hangi olayları ölçebileceğini de belirler.

Meta, pikselle birlikte Dönüşümler API'si kullanılmasını önerir ve bu kurguya "redundant setup" (yedekli kurulum) der. Yedekli kurulumda aynı form gönderimi hem tarayıcıdan hem sunucudan gelir. Bu yüzden tekilleştirme kurulumun zorunlu parçasıdır.

Olay tekilleştirme: event_id ve event_name

Meta'nın önerdiği yöntemde aynı müşteri eylemi için iki eşleşme aranır: pikseldeki eventID, sunucudaki event_id ile; pikseldeki olay adı (event), sunucudaki event_name ile aynı olmalıdır. Pikselde eventID, fbq çağrısının dördüncü argümanıdır. Aynı piksel kimliğine 48 saat içinde aynı anahtarla gelen sonraki olaylar atılır. Sunucu ve tarayıcı olayının içeriği anlamlı biçimde farklı değilse Meta genellikle ilk gelen olayı esas alır.

• ✓ event_id'yi formun kaydı oluştuğunda üretin

  Form sunucuya kaydedildiğinde oluşan başvuru numarası iyi bir event_id'dir. Aynı değer hem tarayıcıdaki piksel olayına hem sunucu olayına yazılır.

• ✓ Olay adlarını iki tarafta birebir aynı tutun

  Pikselde Lead, sunucuda lead yazılırsa eşleşme kurulmaz ve başvuru iki kez sayılır.

• ✓ Kimlik içinde kişisel veya sağlık bilgisi kullanmayın

  event_id rastgele veya sıralı bir başvuru numarası olmalı; telefon numarası, isim ya da tedavi adı içermemeli.

• ✓ Yedekli olmayan olaylarda tekilleştirme gerekmez

  Meta'ya göre bir olayı yalnız sunucudan gönderiyorsanız (örneğin CRM aşaması) piksel tarafıyla tekilleştirme kurmanız gerekmez.

Alternatif yöntem fbp ve/veya external_id ile eşleştirmedir; ancak Meta bu yöntemin genellikle yalnız önce tarayıcıdan, sonra sunucudan gelen olaylarda çalıştığını belirtir. Kurulumdan sonra Olay Yöneticisi'ndeki test ve tanılama ekranlarından olayların tekilleştirildiği kontrol edilmelidir.

Meta Dönüşümler API kurulumu: dört yol

Meta'nın İşletme Yardım Merkezi kurulum seçeneklerini maliyet, zorluk ve desteklenen olay kaynağına göre karşılaştırır. Klinik için doğru seçim, hangi olayları göndermek istediğinize bağlıdır: yalnız site formu mu, yoksa Hızlı Form ve WhatsApp sonrası CRM aşamaları da mı?

Meta'nın yardım sayfasına göre mobil uygulama ve fiziksel mağaza (çevrimdışı) olayları için şu anda kullanılabilen tek yol doğrudan entegrasyondur. CRM aşamaları için Meta ayrıca Zapier gibi kodsuz ortak entegrasyonlarını da listeler. Hangi yol seçilirse seçilsin, Meta'ya giden olay ve parametre listesi yazılı olarak çıkarılmalıdır; kliniklerde asıl risk kurulum yönteminde değil, gönderilen içeriktedir.

Conversions API system user ve erişim anahtarı

Dönüşümler API'sine yapılan her çağrı bir erişim anahtarı (access token) ister. "Conversions API system user nedir?" sorusunun cevabı da buradadır: system user, işletme portföyüne bağlı varlıklara API çağrısı yapan sunucuyu veya yazılımı temsil eden kullanıcıdır.

• —Olay Yöneticisi'nden (Meta'nın önerdiği yol): Piksel seçilir, Settings sekmesindeki Conversions API bölümünde Set up manually altındaki Generate access token bağlantısıyla anahtar oluşturulur. Meta'ya göre bu bağlantıyı yalnız işletmede geliştirici yetkisi olan kullanıcılar görür. Ardından Overview sekmesindeki Manage Integrations ekranında Conversions API'nin yanındaki Manage düğmesi, bir Conversions API uygulamasını ve Conversions API system user'ı otomatik oluşturur. Uygulama incelemesi (App Review) veya ek izin gerekmez.
• —Kendi uygulamanız ve system user'ınızla: İşletme ayarlarında piksel system user'a atanır (bu adımda yeni system user da oluşturulabilir), system user seçilip Generate Token ile anahtar üretilir. Bu yolda da App Review gerekmez.
• —CRM entegrasyonunda: CRM pikselinin Settings sekmesinden açılan CRM entegrasyon rehberinin Create Endpoint bölümünde Generate Access Token düğmesi ve uç nokta biçimi yer alır.

Kliniklerde Meta'nın sağlık verisi kısıtı

Sağlık kliniği için Dönüşümler API'sinin en önemli bölümü teknik değil, kural tarafıdır. 3 Kasım 2025'te yürürlüğe giren Meta İşletme Araçları Koşulları'nın 1.h kısmına göre reklamveren, doğrudan ya da dolaylı olarak sağlık bilgisi, finansal bilgi veya diğer hassas bilgi kategorilerini içeren ya da bunlara dayanan veriyi Meta ile paylaşmayacağını beyan eder. Aynı kısım, olaylar, dönüşümler ve özel hedef kitleler için seçilen adların ve kriterlerin bu bilgileri yansıtmamasını veya ima etmemesini ister. Bu koşullar Meta Pikseli'ni de, Dönüşümler API'sini de kapsar.

Meta'nın yasaklı bilgi sayfası sağlık örneklerini açıkça sayar: hastalıklar ve tıbbi durumlar, tıbbi prosedürler, tedaviler ve testler, reçeteli ilaçlar, vücut özellikleri ve sağlık durumunu ya da tedavi yerini belli eden fiziksel konumlar. Bu bilgiler URL parametrelerinde, özel hedef kitlelerde, özel dönüşümlerde, özel olay adlarında ve custom_data alanlarında yer almamalıdır.

Veri kaynağı kategorileri ve olay kısıtlaması

Meta, İşletme Araçları üzerinden veri gönderen siteleri ve uygulamaları konusuna ve sunduğu ürün veya hizmete göre bir veri kaynağı kategorisine atayabilir. Kısıtlı kategorilerden biri sağlık ve zindeliktir. Meta bu kategoriyi tıbbi durumlar veya belirli sağlık durumları, sağlayıcı ile hasta ilişkisi, kişisel sağlık bilgisine erişim hizmetleri ya da sağlıkla ilgili ürün ve hizmetlerle ilişkili kaynaklar olarak tanımlar. 26 Ekim 2026'da okunan yardım sayfasına göre bu kategorilerde üç tür kısıt uygulanabilir:

Kısıtlar belirli ülke veya bölgelere özgü olabilir ya da global uygulanabilir; Meta kısıtı e-posta ve Olay Yöneticisi bildirimiyle duyurur. Bir kaynakta veri kısıtı varsa özel olaylar, siz inceleyip onaylayana kadar otomatik olarak engellenir. Reklamveren veri setini ve bağlı kaynaklarını kendisi de kategorize edebilir; ancak Meta'nın atadığı kategoriyi değiştiremez, yalnız yeniden inceleme isteyebilir. Sağlık durumu ima eden özel dönüşümler de ayrıca işaretlenir; Meta'nın örneği artrit gibi belirli bir hastalığa atıftır. İşaretlenen özel dönüşüm yeni kampanyada kullanılamaz; çalışan kampanyada kampanyayı çoğaltıp işaretlenmemiş bir dönüşüm seçmek gerekir.

Pratik sonuç şudur: Dönüşümler API'si kliniğin veri kaynağı kategorisini aşmanın bir yolu değildir. Kısıt, olay pikselden de gelse sunucudan da gelse aynı veri setine uygulanır. Kurulumdan önce Olay Yöneticisi'nde veri setinin ayarlarında atanmış kategoriye ve kısıta bakılmalıdır. Meta reklam hesabının kendisi kısıtlandıysa bu ayrı bir süreçtir.

KVKK: olay parametrelerine tedavi adı yazmayın

6698 sayılı Kişisel Verilerin Korunması Kanunu'nun 6. maddesi sağlığa ilişkin verileri özel nitelikli kişisel veri sayar. Bir kişinin hash'lenmiş telefon numarasıyla birlikte "implant randevusu" olayının Meta'ya gönderilmesi, o kişinin sağlık hizmeti aldığını veya almak istediğini bir reklam platformuna aktarmak anlamına gelir. Verinin hash'lenmesi eşleştirme yapıldığı sürece onu kişisel veri olmaktan çıkarmaz. Aktarım çoğu senaryoda yurt dışına aktarım hükümlerini de tetikler.

Sunucu taraflı gönderim çerez rızasını da ortadan kaldırmaz. fbc ve fbp değerleri sitenizdeki Meta çerezlerinden gelir; ziyaretçi reklam çerezlerini reddettiyse aynı veriyi sunucu üzerinden göndermek, tarayıcıda engellenen aktarımı arka kapıdan yapmak olur. Rıza, aydınlatma metni ve veri işleyen sözleşmeleri kurulumdan önce hukuk danışmanıyla netleştirilmelidir.

Hızlı Form ve WhatsApp lead'lerinde CRM'den dönüşüm gönderimi

Kliniğe gelen başvuruların çoğu sitede değil, Meta'nın içinde başlar: Hızlı Form doldurulur veya WhatsApp'a yönlendiren reklamla konuşma açılır. Bu başvurunun nitelikli olup olmadığı ise günler sonra CRM'de belli olur. Dönüşümler API'si bu aşama bilgisini Meta'ya geri taşımanın resmî yoludur; iki ayrı ürünle yapılır.

Meta'nın Conversions API for CRM integration dokümanı, Hızlı Form'dan gelen lead'lerin CRM'deki aşamalarını Meta'ya geri göndermeyi anlatır. Bu veri, Conversion Leads (dönüşüm lead'leri) performans hedefinde kullanılır ve Meta'ya göre bu hedef şu anda yalnız Hızlı Form'la uyumludur. Meta'nın uygunluk ölçütleri şunlardır:

• —Facebook/Instagram Hızlı Form kullanılması ve 15–17 haneli Meta lead kimliğinin (lead_id) CRM'de saklanması; yoksa tıklama kimliği, telefon veya e-posta gibi müşteri parametreleri
• —Ayda en az 200 lead
• —Verinin en az günde bir kez yüklenebilmesi
• —Optimize edilecek aşamanın lead oluştuktan sonraki 28 gün içinde gerçekleşmesi
• —Bu aşamanın dönüşüm oranının yüzde 1 ile 40 arasında olması

Olay biçimi de belirlidir: action_source değeri system_generated, custom_data içinde event_source değeri crm ve lead_event_source alanında CRM'in adı yer alır. event_name serbest metindir ve CRM'deki aşamayı anlatır; ham lead dahil her aşama değiştikçe gönderilir. Meta'nın örneğinde 100 lead için ham lead, nitelikli lead, satış fırsatı ve dönüşen aşamalarıyla toplam 215 olay beklenir. Bir toplu gönderim en çok 1.000 olay içerebilir; hatalı bir olay tüm partinin atılmasına yol açar. Meta, CRM entegrasyonunda geliştirici yolu için 3–4 hafta, Zapier veya başka bir ortak entegrasyonu için bir günden kısa süre öngörür; öğrenme dönemi 2–4 haftadır.

WhatsApp'a yönlendiren reklamlar: işletme mesajlaşması için Dönüşümler API'si

WhatsApp konuşmasında gerçekleşen olaylar için Meta'nın ayrı bir ürünü var: Conversions API for Business Messaging. Reklamdan açılan konuşmada WhatsApp Business Platform'un mesaj webhook'u bir tıklama kimliği (ctwa_clid) taşır. Bu kimlik konuşmayla birlikte saklanır ve konuşmada bir dönüşüm olduğunda action_source değeri business_messaging, messaging_channel değeri whatsapp olan olayla Meta'ya geri gönderilir.

• —Ön şart WhatsApp Business Platform entegrasyonudur (Meta'nın önerdiği seçenek Cloud API). Doküman işletme mesajlaşma ortaklarına yöneliktir; uygulamada whatsapp_business_manage_events gibi izinler gerekir. Klinik bu altyapıyı çoğunlukla bir WhatsApp Business Platform sağlayıcısı üzerinden kullanır.
• —Desteklenen olaylar arasında LeadSubmitted, QualifiedLead ve Purchase vardır. Olay yalnız konuşma içinde gerçekleşen etkileşimi temsil etmelidir; sitede gerçekleşen dönüşüm site için Dönüşümler API'siyle gönderilir.
• —Meta işletme mesajlaşması olaylarında tekilleştirme yapmaz; aynı olayı iki kez göndermemek reklamverenin sorumluluğundadır.
• —ctwa_clid yoksa hash'lenmiş müşteri bilgisi ve Sayfa kimliğiyle gönderim mümkündür; ancak Meta bu yolda atfın son 7 günle sınırlı olduğunu ve yalnız bazı ülkelerde çalıştığını belirtir.
• —Meta'ya göre satın alma optimizasyonu Messenger ve WhatsApp'a yönlendiren reklamlarda kullanılabilir; Instagram'a yönlendiren reklamlarda bu optimizasyon şu anda yoktur.

WhatsApp'ta sağlık verisi riski formdan daha yüksektir; hasta fotoğraf, tahlil veya şikâyet yazabilir. Meta'ya giden olay yalnız aşamayı ve kimliği taşımalı; konuşma içeriğinden hiçbir alan olay parametresine kopyalanmamalıdır. WhatsApp başvurularının CRM'e kaynağıyla nasıl kaydedileceğini ayrı rehberde anlattık.

Ölçüm: gerçekleşen hastayı ve değeri göndermek

Dönüşümler API'sinin en cazip vaadi, reklam sisteminin "form dolduran" yerine "kliniğe gelen" kişiyi öğrenmesidir. Teknik olarak bu mümkündür: CRM entegrasyonunda son aşama gönderilebilir, Purchase olayında value ve currency alanları kullanılabilir. Meta'nın tanımına göre value alanı parasal bir tutarı temsil etmelidir ve satın alma olaylarında zorunludur; currency üç harfli ISO 4217 kodudur.

Klinikte bu adım üç kontrolden geçmeden atılmamalıdır. Meta İşletme Araçları Koşulları'nın 1.h kısmı dolaylı sağlık bilgisini de kapsar ve Meta'nın sağlık ve zindelik kategorisi tanımı sağlayıcı ile hasta ilişkisini sayar. "Bu kişi kliniğe geldi ve 2.500 EUR ödedi" olayı, tedavi adı yazılmasa bile kişinin sağlık hizmeti aldığını ima eder.

• ✓ 1. Meta tarafı: veri kaynağı kategorisi ve kısıt

  Olay Yöneticisi'nde veri setine sağlık ve zindelik kategorisi atanmışsa orta ve alt huni olayları zaten kısıtlanmış olabilir. Önce hangi olayların kabul edildiğine bakın.

• ✓ 2. Hukuk tarafı: hukuki dayanak ve yurt dışı aktarım

  Gelen hasta bilgisinin pazarlama amacıyla ve yurt dışındaki bir platforma aktarılması için KVKK'daki dayanak ve aktarım mekanizması hukuk danışmanıyla yazılı olarak belirlenmelidir. Dönüşümler API'si tek seferlik değil, sürekli bir aktarımdır; KVKK'nın 2024'te değişen yurt dışı aktarım rejimi bu yüzden ayrıca değerlendirilir.

• ✓ 3. Olay tasarımı: yalnız aşama ve tutar

  Nötr aşama adı, para birimi ve tutar. Tedavi adı, işlem adedi, ürün kimliği veya hekim bilgisi gönderilmez. Tutar tek bir tedavinin bilinen fiyatını ele veriyorsa tedavi ayrımı yapmayan ortalama bir hasta değeri daha güvenlidir.

Üç kontrolden biri olumsuzsa gelen hasta ve ciro verisi klinik içinde raporlanır; Meta'ya yalnız platform içi sinyaller (başlatılan mesaj, gönderilen form) ve nitelik aşaması kalır. Bu durumda başarı ölçütü yine aynıdır: kampanya bazında gelen hasta ve hasta başı maliyet, CRM'den hesaplanır. Google Ads tarafındaki karşılığını kliniklerde Google Ads dönüşüm takibi rehberinde ele aldık.

Türkiye'de klinikler Conversions API'yi hangi kampanyada kullanır?

Dönüşümler API'si bir ölçüm aracıdır; reklam izni vermez. 12 Kasım 2025 tarihli ve 33075 sayılı Sağlık Hizmetlerinde Tanıtım ve Bilgilendirme Faaliyetleri Hakkında Yönetmelik'in 5/1-i bendi, sosyal medya kaydının ücretli sponsorlu ve öne çıkmaya yönelik olmamasını şart koşar; istisnalar açılışı izleyen ilk ay ve Bakanlıkça tıbben kabul edilen yeni yöntemlerdir (5/1-j). Sağlık turizmi yetki belgesi olan kurumlar ise Madde 8'deki şartlarla, yurt dışına yönelik ayrı hesap veya site üzerinden Türkçe hariç resmî dillerde sponsorlu tanıtım yapabilir.

Bu yüzden klinikte Dönüşümler API'sinin pratik kullanım alanı çoğunlukla Madde 8 kapsamındaki yurt dışı kampanyalardır: hedef ülkeden gelen Hızlı Form ve WhatsApp başvurularının CRM aşamaları. Bu hesaplarda yurt dışındaki kişinin verisi işlendiği için hedef ülkenin veri koruma kuralları da (örneğin AB'deki kişiler için GDPR) ayrıca değerlendirilir.

Kurulumdan sonra kontrol listesi

• ✓ Veri seti kategorisi ve kısıtı kontrol edildi

  Olay Yöneticisi'nde atanmış kategori, kısıt türü ve engellenen özel olaylar not edildi.

• ✓ Gönderilen olay ve parametre listesi yazılı

  Her olay için ad, action_source, user_data alanları ve custom_data alanları tek tabloda; tedavi adı içeren alan yok.

• ✓ Tekilleştirme test edildi

  Aynı form gönderimi hem tarayıcıdan hem sunucudan aynı event_id ve olay adıyla geliyor; Olay Yöneticisi'nde tekil görünüyor.

• ✓ Erişim anahtarı kliniğin system user'ında

  Anahtar sunucuda saklanıyor; ajans ilişkisi bittiğinde yenileniyor.

• ✓ CRM aşamaları nötr adlarla tanımlı

  Ham lead dahil her aşama gönderiliyor; aşama adları tedaviyi ima etmiyor.

• ✓ Çerez rızası sunucu gönderimine bağlı

  Reklam çerezini reddeden ziyaretçinin site olayları, fbc ve fbp dahil, sunucudan da gönderilmiyor.

• ✓ Gelen hasta ve hasta başı maliyet CRM'den raporlanıyor

  Meta'ya gönderilsin ya da gönderilmesin, başarı ölçütü CRM'deki gelen hasta sayısıdır.

• Klinik Meta reklam ajansı hizmeti →
• Klinik lead funnel ve CRO hizmeti →
• Sağlık turizmi CRM kurulumu →
• Meta reklamları klinikler için nasıl çalışır? →
• Sağlık turizmi CRM ve hasta takibi →