Sytrics
Platform Rehberi

Meta Conversions API (CAPI) Kurulum Rehberi

Meta Conversions API (CAPI), dönüşüm etkinliklerini doğrudan sunucunuzdan Meta reklam platformuna göndererek tarayıcı tabanlı takip kısıtlamalarını aşan bir sunucu-sunucu entegrasyonudur. Reklam engelleyiciler veya iOS gizlilik ayarları tarafından engellenebilen Meta Pixel'in aksine, CAPI tarayıcının tamamen dışında çalışır. Sytrics, bu kurumu geliştirici olmadan uygulamak için gereken CAPI etkinlik kodunu ve tekilleştirme yapılandırmasını oluşturur.

Meta CAPI nedir?

Meta Conversions API (CAPI), dönüşüm etkinliklerini doğrudan sunucunuzdan Meta'nın reklam platformuna gönderen bir sunucu-sunucu entegrasyonudur. Ziyaretçinin tarayıcısında çalışan ve reklam engelleyiciler veya iOS gizlilik kısıtlamaları tarafından engellenebilen Meta Pixel'in aksine, CAPI tarayıcıyı tamamen atlar. Meta, etkinlik eşleştirme kalitesini artırmak ve yalnızca tarayıcı tabanlı takibin kaçırdığı dönüşümleri geri kazanmak için hem Pixel hem de CAPI'yi birlikte kullanmanızı önerir.

Pixel ve CAPI: Fark nedir?

Meta Pixel

GTM üzerinden kolay kurulum
Gerçek zamanlı tarayıcı verisi
Sayfa görüntülemelerini doğal olarak takip eder
Reklam engelleyiciler tarafından bloklanır
iOS 14+ kısıtlamalarından etkilenir
Üçüncü taraf çerez kısıtlamaları
Dönüşümlerin ~%20-30'unu kaçırır

Meta CAPI

Reklam engelleyicilerden etkilenmez
iOS güncellemelerinden sonra da çalışır
Sunucu taraflı veri kalite kontrolü
Kayıp dönüşümleri geri kazanır
Sunucu taraflı uygulama gerektirir
Kurulumu daha karmaşıktır
Pixel ile tekilleştirme gerektirir

Sytrics Meta CAPI için ne oluşturur?

Sunucu taraflı etkinlik kodu

Sunucunuzdan Meta'nın Graph API'sine etkinlik göndermek için kullanıma hazır kod şablonları (Purchase, Lead, AddToCart vb.).

Etkinlik tekilleştirme

Hem Pixel hem de CAPI üzerinden gönderilen etkinliklerin Meta Events Manager'da yalnızca bir kez sayılması için benzersiz event_id oluşturma mantığı.

Kullanıcı verisi hashleme

Meta'nın gizlilik politikası gereği e-posta, telefon ve ad alanları için SHA-256 hashleme.

Test ve doğrulama adımları

CAPI etkinliklerinizin canlıya geçmeden önce Meta'nın Test Etkinlikleri aracında göründüğünü doğrulamak için adım adım rehber.

Sytrics'in desteklediği standart Meta CAPI etkinlikleri

Purchase

Tamamlanan işlem — ROAS optimizasyonu için en önemli etkinlik

Lead

Form gönderimi, demo talebi veya iletişim formu doldurma

AddToCart

Alışveriş sepetine ekleme — temel orta huni sinyali

InitiateCheckout

Ödeme süreci başlatıldı

CompleteRegistration

Hesap kaydı veya deneme aktivasyonu

ViewContent

Önemli sayfa görüntüleme (ürün sayfası, fiyatlandırma sayfası)

Search

Site içi arama gerçekleştirildi

Contact

Telefon araması veya iletişim girişimi

Sytrics ile Meta CAPI kurulumu

  1. 1

    Sytrics'e site URL'nizi girin

    Sytrics.io'ya gidin ve web sitenizin URL'sini yapıştırın. İş sektörünüzü seçin (e-ticaret, lead gen, SaaS vb.).

  2. 2

    Meta'yı platform olarak seçin

    Platform listesinden Meta'yı seçin. Sytrics hem Pixel etkinlik kodunu hem de CAPI sunucu taraflı kodunu oluşturacak.

  3. 3

    CAPI kodunu kopyalayın

    Oluşturulan sunucu taraflı kodu kopyalayın. Sytrics en yaygın sunucu ortamları için şablonlar sağlar.

  4. 4

    Meta Erişim Jetonunuzu ekleyin

    Meta Events Manager → Veri Kaynakları → Pikseliniz → Ayarlar → Conversions API → Erişim Jetonu Oluştur. Bunu koda yapıştırın.

  5. 5

    Dağıtın ve test edin

    Kodu sunucunuza dağıtın ve etkinliklerin doğru şekilde ulaştığını doğrulamak için Meta'nın Test Etkinlikleri aracını (Events Manager → Test Etkinlikleri sekmesi) kullanın.

Sık sorulan sorular

Meta CAPI kullanmak için sGTM gerekli mi?

Hayır. Sunucu taraflı GTM (sGTM), CAPI'yi uygulamanın bir yoludur ancak GTM sunucu konteyneri barındırma gerektirir ($20-$90+/ay). Sytrics, mevcut sunucunuzda çalışan doğrudan sunucu-sunucu entegrasyon kodu oluşturur — sGTM gerekmez.

Hem Pixel hem de CAPI kullanırsam dönüşümleri çift sayar mıyım?

Tekilleştirme doğru kurulursa hayır. Sytrics, ürettiği koda benzersiz event_id oluşturma mantığını dahil eder. Aynı etkinlik hem Pixel hem de CAPI üzerinden aynı event_id ile gönderildiğinde, Meta bunu bir kez sayar.

CAPI etkinliklerimin çalışıp çalışmadığını nasıl anlarım?

Meta Events Manager → Pikseliniz → Test Etkinlikleri sekmesini açın → Site URL'nizi girin ve bir dönüşüm etkinliği tetikleyin. Etkinlik Test Etkinlikleri panelinde görünüyorsa CAPI çalışıyor demektir.

Meta CAPI GDPR/KVKK uyumlu mu?

CAPI bir veri iletim yöntemidir. GDPR uyumu, hangi kullanıcı verilerini gönderdiğinize ve geçerli bir onayınız olup olmadığına bağlıdır. Sytrics, kullanıcı verilerini (e-posta, telefon) Meta'nın gizlilik uyumu için önerdiği şekilde SHA-256 ile hashleyerek ileten kod üretir.

Meta CAPI, e-ticaret için sGTM ile nasıl karşılaştırılır?

Her ikisi de sunucu taraflı takibi sağlar. sGTM tüm etiketleri sunucunuz üzerinden yönlendirir ve çerez ömrünü uzatır — karmaşık çok etiketli bir yapıyı yönetiyorsanız doğru seçimdir. CAPI Meta'ya özeldir ve dönüşüm verilerini doğrudan Meta'nın API'sine gönderir. Çoğu e-ticaret mağazası için CAPI ile başlamak (barındırma maliyeti yok) kayıp iOS dönüşümlerini geri kazanmanın daha hızlı yoludur.

İlgili rehberler

TikTok Events API →E-ticaret takip rehberi →Lead generation takip rehberi →

Meta CAPI kodunuzu 3 dakikada oluşturun

sGTM gerekmez. Sunucu barındırma gerekmez. Başlamak için aylık ücret yok.

CAPI kodunuzu ücretsiz alın →