Meta Conversions API Kurulumu: CAPI Nedir ve Nasıl Çalışır?

Reklam veriniz size yalan söylüyor olabilir. Güvenilir bir şekilde değil; iOS 14 güncellemesi, tarayıcı bazlı çerez engelleyiciler ve gizlilik odaklı tarayıcılar yüzünden. Dönüşümlerin yüzde 20-40’ı kayıt altına alınmıyor, algoritmaya yanlış sinyal gidiyor ve ROAS hesabınız olduğundan daha iyi görünüyor.

Meta Pixel bu problemi tek başına çözemiyor artık. Meta Conversions API (CAPI), bu veri boşluğunu kapatmak için geliştirildi ve Meta’nın artık resmi olarak önceliklendirdiği ölçüm yöntemi.

Bu rehberde Meta Conversions API kurulumu’nun ne olduğunu, neden kritik hale geldiğini ve Türkiye’deki işletmeler için en pratik kurulum yöntemini adım adım ele alacağız.

CAPI Nedir? Meta Conversions API’yi Anlamak

Meta Conversions API (CAPI), dönüşüm verilerini tarayıcı yerine doğrudan sunucunuzdan Meta’ya gönderen bir sunucu tarafı (server-side) takip sistemidir.

Pixel, kullanıcının tarayıcısında çalışır. Ad blocker varsa, Safari’nin ITP’si devredeyse veya kullanıcı iOS 14+ gizlilik ayarlarını kapattıysa, pixel veri gönderemez. CAPI ise tarayıcıyı tamamen devre dışı bırakır; sunucunuz doğrudan Meta’yla konuşur.

Pixel vs CAPI farkı:

CAPI neden bu kadar önemli: Facebook Conversions API, Meta’nın resmi adıyla Meta Conversions API, birçok reklamveren tarafından Meta pixel alternatifi olarak görülüyor ancak bu yanıltıcı. Amaç pixel’i silmek değil, server-side tracking katmanıyla onu güçlendirmek. Meta reklamlarının optimizasyonu, gönderilen dönüşüm sinyallerinin kalitesine bağlı. Kayıp veriyle çalışan algoritma, yanlış kitleyi hedefliyor; reklam maliyeti artıyor, ROAS düşüyor.

Meta reklam optimizasyonu stratejileri ve dönüşüm takibi için kapsamlı rehberlerimiz bu rehberi tamamlayacak.

Neden Şimdi? iOS 14+ Sonrası Değişen Tablo

Yeterçe duymak istemediğiniz ama atlayamayacağınız bir başlık. 2021’de Apple’ın ATT (App Tracking Transparency) güncellemesiyle başlayan süreç, Türkiye’deki pek çok reklamverenin takip ettiği veriyi yarıya indirdi.

Asıl tahribatı anlamak için iki senaryo:

Senaryo A — Yalnızca Pixel kullanan hesap:
– Gerçek satış: 100
– Pixel’in raporladığı satış: 58-65
– Algoritmaya giden sinyal: Düşük kalite, 35-42 satış kayıp

Senaryo B — Pixel + CAPI kullanan hesap:
– Gerçek satış: 100
– Raporlanan satış: 90-95
– Algoritmaya giden sinyal: Yüksek kalite, optimizasyon doğru kitleye

Aralarındaki fark yalnızca raporlama değil. Meta’nın algoritması, gelen sinyallerin kalitesine göre hangi kullanıcıya reklam göstereceğini belirliyor. Daha az sinyal = daha zayıf hedefleme = daha yüksek CPM.

Selin, İzmir’de organik kozmetik ürünleri satan bir e-ticaret şirketinin pazarlama müdürü. 2023 yılında Meta reklamlarından gelen ROAS’ının altı ay içinde 4,8’den 2,9’a düştüğünü fark etti. Bütçe aynı, ürün aynı, reklamlar güncellendi; fark etmedi. Ajansı pixel event kalitesini incelediğinde sorun netleşti: iOS kullanıcılarından gelen satışların yüzde 60’ı kaydedilmiyordu. Meta CAPI kurulumundan 45 gün sonra ROAS 4,1’e geri döndü. Server-side tracking, tarayıcının göremediği veriyi sunucudan doğrudan iletiyordu. Kayıp veri değil, kayıp sinyal sorunuydu.

Meta Conversions API Kurulumu: 3 Yöntem

CAPI kurulumu için üç farklı yol var. Teknik altyapınıza ve kaynaklarınıza göre birini seçin.

Yöntem 1: Meta Events Manager ile Doğrudan Entegrasyon (Kolay)

Meta, 2022’den itibaren Events Manager üzerinde kod gerektirmeyen CAPI kurulum seçenekleri sunuyor. Bu yöntem özellikle Shopify, WooCommerce, Squarespace ve BigCommerce kullananlar için en hızlı yol.

Adım 1: Events Manager’a gidin

Meta Business Suite üzerinden Events Manager’ı açın. Sol menüden Data Sources’a tıklayın ve pixel’inizi seçin.

Adım 2: Partner Entegrasyonunu Seçin

“Add Events” > “From a partner platform” seçeneğine tıklayın. Listede platformunuzu bulun:
– Shopify: Native entegrasyon, kod yok
– WooCommerce: Meta for WooCommerce eklentisi
– Magento: Meta Business Extension
– BigCommerce: Native channel entegrasyonu

Adım 3: Yetkilendirme ve Eşleştirme

Partner platformunuzu Meta hesabınıza bağlayın. Sistem otomatik olarak şu standart olayları eşler: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase.

Adım 4: Test Mode ile Doğrulama

Events Manager içinde “Test Events” sekmesini açın. Gerçek bir purchase işlemi yapın. Hem pixel hem CAPI kaydı görünüyorsa, kurulum başarılı.

Yöntem 2: Google Tag Manager ile CAPI (Orta Seviye)

GTM kullanan ve Shopify/WooCommerce dışı bir platformda olan siteler için bu yöntem kod yazmadan CAPI gönderimi sağlıyor.

Gereksinimler:
– Google Tag Manager hesabı ve container
– Meta pixel ID
– CAPI Access Token (Events Manager > Settings > Conversions API > Generate Access Token)

GTM Kurulum Adımları:

1. GTM içinde yeni bir Server Container oluşturun (sadece web container değil)
2. Meta’nın resmi GTM şablonunu kullanın: Tag Templates > Community Templates Gallery > Meta Conversions API
3. Access Token ve Pixel ID’yi şablon ayarlarına girin
4. Trigger’larınızı purchase, add-to-cart gibi olaylara bağlayın
5. Preview modunda test edin; Events Manager’da sunucu tarafı olayları görmelisiniz

GTM sunucu taraflı kurulumu teknik bir alan. Eğer bu konuda destek almanız gerekiyorsa, dönüşüm optimizasyonu konusundaki ajanslarla çalışmayı değerlendirin.

Yöntem 3: Doğrudan API Entegrasyonu (Geliştirici)

En esnek ve en güçlü yöntem. Backend’inize özel bir entegrasyon yazılır; her olayı tam kontrol edersiniz.

Temel API çağrısı:

POST https://graph.facebook.com/v18.0/{pixel_id}/events?access_token={token}

Örnek event payload (Purchase):

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1672531200,
      "action_source": "website",
      "event_source_url": "https://example.com/thank-you",
      "user_data": {
        "em": ["[hashed_email]"],
        "ph": ["[hashed_phone]"],
        "client_ip_address": "1.2.3.4",
        "client_user_agent": "[user_agent]"
      },
      "custom_data": {
        "currency": "TRY",
        "value": "299.90",
        "order_id": "ORD-12345"
      }
    }
  ]
}

Önemli: E-posta ve telefon gibi kullanıcı verileri SHA-256 ile hash’lenmiş olmalıdır. Ham veri gönderimi hem Meta’nın politikasına hem KVKK’ya aykırı.

KVKK ve veri gizliliği gerekliliklerini CAPI entegrasyonunuzda göz önünde bulundurun; özellikle kullanıcı verisi işleme konsentini doğru kaydetmek kritik.

Hemen Uygula: Hangi yöntemi seçeceğinizi belirleyin. Shopify veya WooCommerce kullanıyorsanız Yöntem 1’e bugün başlayabilirsiniz; 30 dakika içinde kurulum tamamlanır. GTM’iniz varsa Yöntem 2 bir-iki günlük iş. Özel platform kullanıyorsanız Yöntem 3 için bir geliştirici briefi hazırlayın.

CAPI Kurulumunda Kritik: Deduplication (Tekrar Önleme)

Meta Conversions API kurulumu tamamlandığında en sık gözden kaçan adım deduplication. CAPI ve Pixel aynı anda çalıştığında, aynı olay iki kez raporlanabilir. Meta buna “duplicate event” diyor ve bu durum reklam optimizasyonunu olumsuz etkiliyor.

Çözüm: event_id parametresi.

Her olay için benzersiz bir ID oluşturun ve bu ID’yi hem pixel hem CAPI çağrısında gönderin. Meta, aynı event_id ile gelen iki kaydı otomatik olarak birleştirir; sadece bir kez sayar.

Pixel tarafında (JavaScript):

fbq('track', 'Purchase', {
  value: 299.90,
  currency: 'TRY'
}, {
  eventID: 'order_12345'  // Sipariş numaranız veya benzersiz ID
});

CAPI tarafında (API payload):

{
  "event_name": "Purchase",
  "event_id": "order_12345",  // Pixel ile aynı ID
  "event_time": ...
}

Meta’nın resmi deduplication dokümantasyonu bu konuyu teknik detaylarıyla anlatıyor.

Hangi Olayları CAPI ile Göndermeli?

Meta Conversions API kurulumu sonrası en yaygın soru: Hangi olaylar server-side tracking ile iletilmeli? Her olayı CAPI’ye göndermek zorunda değilsiniz. Önceliklendirme, hem sunucu yükü hem veri kalitesi açısından kritik.

Öncelik 1: Mutlaka Gönderin

Purchase (Satın Alma): En kritik olay. Değer optimizasyonu için currency ve value parametrelerini ekleyin. Türkiye için currency: “TRY”.

Lead (Form Doldurma): B2B ve hizmet işletmeleri için birincil dönüşüm. Form submit anında sunucudan tetikleyin.

InitiateCheckout: Sepet terk analizi için kritik. Hem pixel hem CAPI kombinasyonu en doğru veriyi veriyor.

Öncelik 2: Ekleyin

AddToCart: Sepet ekleme, Purchase için veri eğitimini güçlendiriyor.

ViewContent: Ürün sayfası görüntülemesi. Yüksek hacimli, pixel yeterli olabilir ama CAPI eklemek kaliteyi artırır.

CompleteRegistration: Üyelik tamamlama, SaaS ve üyelik platformları için.

Öncelik 3: Opsiyonel

Search, Contact, Schedule: Hacim düşükse pixel yeterli. Yüksek hacimli işletmeler için CAPI ekleyebilir.

Hemen Uygula: Events Manager’ı açın ve son 7 gündeki event kalite skorunu kontrol edin. “Event Match Quality” skoru 6/10’un altındaysa, CAPI kurulumu en yüksek önceliğiniz olmalı. Skor 8+ise, mevcut setup’ınız iyi çalışıyor demek; ince ayarlarla optimize edebilirsiniz.

Kullanıcı Eşleştirme: CAPI’yi Güçlendiren Veri

CAPI’nin asıl gücü user matching’de; bu, Facebook Conversions API’yi Meta pixel alternatifi değil, onu tamamlayan bir sistem yapan en kritik farktır. Pixel yalnızca IP adresi ve user agent ile eşleştirme yapıyor. CAPI ise hashed e-posta, telefon ve diğer birinci taraf müşteri verilerini kullanarak çok daha güçlü bir eşleştirme kalitesi sunuyor.

Match Quality (Eşleştirme Kalitesi) için mutlaka gönderin:

"user_data": {
  "em": ["sha256_hashed_email"],
  "ph": ["sha256_hashed_phone"],
  "fn": ["sha256_hashed_first_name"],
  "ln": ["sha256_hashed_last_name"],
  "ct": ["sha256_hashed_city"],
  "st": ["sha256_hashed_state"],
  "zp": ["sha256_hashed_zip"],
  "country": ["sha256_hashed_country_code"],
  "client_ip_address": "user_ip",
  "client_user_agent": "user_agent",
  "fbc": "fb.1.timestamp.click_id",
  "fbp": "fb.1.timestamp.random_number"
}

E-posta ve telefon en güçlü eşleştirme sinyalleri. Türkiye’de telefon numaralarını 90 ülke kodu dahil, başında + olmadan hash’leyin: +905551234567 yerine 905551234567.

Ahmet, İstanbul’da kurumsal yazılım satan bir SaaS şirketinin büyüme müdürü. 2025 başında CAPI kurulumunu tamamladıktan sonra user_data alanlarını boş bırakmıştı; API’den sadece IP adresi gönderiyordu. Event Match Quality skoru 3/10 olarak kaldı. Bir ay sonra form dolduran kullanıcıların hashed e-postalarını eklediklerinde skor 8/10’a çıktı. Aynı bütçeyle lead başına maliyet 40 günde yüzde 28 düştü.

Test ve Doğrulama: CAPI Çalışıyor mu?

Meta Conversions API kurulumu tamamlandıktan sonra doğrulama adımı atlanmamalı. Server-side tracking’in düzgün çalıştığını teyit etmek için üç kontrol noktası.

1. Events Manager Test Events

Events Manager > Data Sources > Pixel’iniz > Test Events sekmesini açın.

“Test Event Code” kutusunda bir kod üretilir. Bu kodu API payload’unuza ekleyin:

"test_event_code": "TEST12345"

Gerçek bir satın alma işlemi yapın. Hem “Browser” hem “Server” kolonunda Purchase eventi görüyorsanız, sistem çalışıyor.

2. Event Kalite Skoru

Events Manager > Events > Event seçin > Match Quality. Hedef skor: 6/10 üzeri (ideal: 8+).

Düşük skor nedenleri:
– Hashed user_data eksik (e-posta, telefon)
– IP adresi veya user_agent gönderilmiyor
– fbc/fbp parametreleri eksik

3. Deduplication Kontrolü

Events Manager’da aynı event’in iki kez göründüğünü fark ediyorsanız, event_id’ler eşleşmiyor demek. Pixel ve CAPI’deki event_id değerlerini karşılaştırın.

Hemen Uygula: Events Manager’ı açın ve “Event Match Quality” skorunu kontrol edin. 6/10 üzerinde: server-side tracking düzgün çalışıyor. 4-6 arası: user_data alanlarını genişletin (e-posta + telefon). 4 altı: CAPI payload’unda IP ve user_agent gönderildiğini doğrulayın. Bu iki parametre hash gerektirmiyor; eklenmesi match quality’yi anında 1-2 puan artırır.

Türkiye’de CAPI Kullanımı için KVKK Uyumu

Bu kısım teknik değil, yasal. Meta CAPI kurulumu, server-side tracking yapısı gereği kullanıcı verilerini doğrudan sunucunuzdan Meta’ya iletir; bu da yasal sorumluluğu sizin omuzlarınıza yükler. Türkiye’de kişisel veri işleme KVKK kapsamında ve her veri aktarımı için açık kullanıcı rızası zorunlu.

Yapmanız gerekenler:

1. 
   

   Açık rıza bildirimi: Site üzerinde “reklam amaçlı kişisel veri işleme” için ayrı onay kutusu. “Kullanıcı sözleşmesini okudum” yeterli değil.

   
   
2. 
   

   Veri işleme kaydı: CAPI üzerinden Meta’ya veri aktarımını iç veri işleme kayıtlarınıza ekleyin.

   
   
3. 
   

   Yalnızca hashed veri gönderin: Ham e-posta veya telefon asla gönderilmemeli. SHA-256 hashing zorunlu.

   
   
4. 
   

   Opt-out mekanizması: Kullanıcı rızasını geri çekerse, o kullanıcının verisini CAPI üzerinden göndermeyi durdurun.

   
   

KVKK ve GDPR uyumu konusundaki rehberlerimizi inceleyerek CAPI entegrasyonunuzu yasal çerçevede tutun.

CAPI Kurulumundan Sonra: Performans Beklentileri

Meta Conversions API kurulumunu doğru tamamladığınızda beklentileri gerçekçi tutmak önemli. Aşağıdaki zaman çizelgesi, server-side tracking’in reklam performansına etkisini tipik bir e-ticaret hesabı üzerinden gösteriyor.

İlk 2 hafta:
– Reported dönüşümler artış gösterir. Bu gerçek bir artış değil, daha önce kaçan olayların görünür hale gelmesi.
– ROAS görünür biçimde iyileşebilir (aynı bütçe, daha iyi raporlama).

2-6 hafta:
– Algoritma daha kaliteli sinyal aldığı için hedefleme iyileşmeye başlar.
– CPM ve CPC’de düşüş başlayabilir.

6-12 hafta:
– Tam optimizasyon etkisi. CAPI öncesi döneme kıyasla ROAS farkı net olarak görünür hale gelir.
– Türkiye’deki e-ticaret işletmeleri ortalama yüzde 15-35 ROAS iyileşmesi rapor ediyor (sektöre ve başlangıç event kalitesine göre değişiyor).

E-ticaret reklam stratejisi ve Meta kampanya optimizasyonu için rehberlerimiz, CAPI kurulumu sonrası maksimum performansı nasıl yakalayacağınızı detaylandırıyor.

Sık Yapılan CAPI Hataları

Meta Conversions API kurulumu sonrasında en sık karşılaşılan 5 hata aşağıda. Facebook Conversions API kullananların büyük çoğunluğu bu hatalardan en az ikisini yapıyor:

1. Deduplication yapmamak: CAPI ve pixel aynı eventi gönderince, Meta çift sayıyor. Sonuç: Raporlamada şişme, optimizasyonda bozulma. Çözüm: event_id zorunlu.

2. Sunucu gecikmesiyle event_time uyumsuzluğu: CAPI’de event_time, olayın gerçekleştiği an olmalı, sunucunun işleme zamanı değil. 7 günden eski event_time’lar Meta tarafından reddediliyor.

3. Hashed veri yerine ham veri göndermek: E-posta veya telefonu SHA-256 olmadan gönderirseniz, hem Meta politikası ihlali hem KVKK riski. Hashing client-side değil, server-side yapılmalı.

4. Test Events’i kapatmayı unutmak: test_event_code aktifken gönderilen olaylar gerçek dönüşüm olarak sayılmaz. Canlıya geçmeden önce bu kodu kaldırın.

5. Yalnızca IP adresi göndermek: User_data’da sadece IP varsa match quality çok düşük kalır. En az e-posta + user_agent kombinasyonu gerekli.

Meta Conversions API Kurulumu: Özet Aksiyon Planı

Meta’nın resmi CAPI dokümantasyonu teknik detayları için birincil kaynak.

Bu hafta yapmanız gerekenler:

1. Events Manager’ı açın, mevcut Event Match Quality skorunuzu kaydedin
2. Platform uyumluluğunuzu kontrol edin (Shopify/WooCommerce > Yöntem 1, GTM > Yöntem 2, özel > Yöntem 3)
3. Purchase ve Lead eventleri için CAPI entegrasyonunu önceliklendirin
4. event_id deduplication planını oluşturun
5. Test Events ile doğrulama yapın

Sonuç: Meta Conversions API kurulumu artık bir “nice-to-have” değil. iOS, Android ve tarayıcı bazlı gizlilik güncellemeleriyle bu bir “must-have” haline geldi. Kurulum yapmayan hesaplar, rakipleriyle aynı bütçeyi harcayıp daha az dönüşüm elde ediyor.

Pixel’i bırakmanıza gerek yok. Pixel + CAPI kombinasyonu ideal kurulum. Tek değişiklik: Verinin kaynağını tarayıcıdan sunucuya taşımak.

Meta reklam optimizasyonu ve dönüşüm takibi rehberlerimizle CAPI kurulumunu tamamladıktan sonraki optimizasyon adımlarını da ele alın.

Hemen CAPI kurulumuna başlamak için: Meta Business Help Center’daki adım adım rehberi referans alın ve bugün Events Manager’daki mevcut event kalite skorunuzu kontrol edin.

Not: Kod örneklerindeki v25.0 API versiyonu, makale yazım tarihinde günceldir. Meta Graph API versiyonlarını developers.facebook.com/docs/graph-api/changelog adresinden takip edin ve production ortamında her zaman güncel versiyonu kullanın.

Meta Events Manager’da Event Kalite Skorunuzu Kontrol Edin →