← Bloga Dön

Meta Pixel ve Conversions API (CAPI) Kurulumu: Adım Adım Rehber

GravityOne ADS Ekibi·15.07.2026·9 dk okuma

Kısa cevap: Meta Pixel, ziyaretçinin tarayıcısından olay gönderir; Conversions API (CAPI) aynı olayları sunucunuzdan gönderir. Tarayıcı kısıtları, reklam engelleyiciler ve çerez izinleri nedeniyle Pixel bazı satışları kaçırır. İkisini birlikte kurup aynı olay kimliğiyle (event_id) tekilleştirdiğinizde Meta daha fazla dönüşümü görür ve reklamları satın alma olasılığı yüksek kişilere gösterir.

Neden yalnızca Pixel yetmez?

  • Tarayıcıların üçüncü taraf çerez ve izleme kısıtları.
  • Reklam engelleyiciler Pixel betiğini yüklemez.
  • Çerez izni vermeyen ziyaretçiler.
  • Ödeme sayfası başka bir alan adındaysa (ödeme sağlayıcısı) olayın kaybolması.

Sonuç: Reklam paneli gerçekte olandan daha az satış gösterir, ROAS düşük görünür ve algoritma yanlış kişileri hedefler.

Hangi olaylar gönderilmeli?

OlayNe zaman?Önemli parametreler
PageViewHer sayfa—
ViewContentÜrün sayfasıcontent_ids, value, currency
AddToCartSepete eklemecontent_ids, value, currency
InitiateCheckoutÖdemeye başlamavalue, num_items
PurchaseSipariş tamamlandıvalue, currency, order_id
LeadForm gönderimi—

Katalog reklamları kullanıyorsanız content_ids değerlerinin ürün kataloğundaki kimliklerle birebir aynı olması gerekir.

Tekilleştirme (deduplication)

Aynı satın alma hem Pixel'den hem CAPI'den gelirse Meta bunu iki satış saymamalıdır. Bunun için iki kaynağın da aynı event_name ve aynı event_id değerini göndermesi gerekir. En pratik yol, sipariş numarasını ya da sipariş anında üretilen benzersiz bir kimliği her iki tarafta kullanmaktır.

Olay eşleşme kalitesi (EMQ)

Meta'nın olayı doğru kişiyle eşleştirmesi için CAPI olaylarına müşteri bilgisi eklenir: e-posta, telefon, ad-soyad, şehir gibi alanlar SHA-256 ile karma (hash) yapılarak gönderilir; ayrıca IP adresi, tarayıcı bilgisi ve fbp/fbc çerez değerleri eklenir. Events Manager'daki olay eşleşme kalitesi puanı ne kadar yüksekse, reklam optimizasyonu o kadar iyi olur.

KVKK açısından: kişisel verileri ham olarak değil karma yapılarak gönderin, çerez politikanızda ve aydınlatma metninizde bu aktarımı belirtin, açık rıza gerektiren durumlarda rızayı alın.

Kurulum seçenekleri

  1. Platform entegrasyonu: Shopify gibi altyapıların resmi Meta entegrasyonu CAPI'yi kendisi kurar.
  2. Sunucu tarafı etiket yönetimi: Google Tag Manager sunucu kapsayıcısı ile.
  3. Doğrudan API: Kendi sunucunuzdan Graph API'ye olay gönderimi; en esnek ama yazılım gerektirir.
  4. Pazarlama yazılımı: Mağaza entegrasyonunuz üzerinden siparişleri otomatik CAPI olayı olarak gönderen bir araç.

Kurulumu nasıl test edersiniz?

  • Events Manager'daki Test Events sekmesinde test kodu ile olayları canlı izleyin.
  • Bir test siparişi verip Purchase olayının hem tarayıcıdan hem sunucudan geldiğini ve "tekilleştirildi" olarak göründüğünü kontrol edin.
  • Değer ve para biriminin doğru geldiğini (ör. 800 ve TRY) doğrulayın.
  • Birkaç gün sonra olay eşleşme kalitesi puanını kontrol edin.

Sık sorulan sorular

CAPI kurarsam Pixel'i kaldırabilir miyim?

Meta, ikisinin birlikte kullanılmasını önerir. Pixel tarayıcıdaki davranışı yakalar, CAPI kayıpları telafi eder.

Conversions API ücretli mi?

Meta tarafında ücretsizdir; maliyet, kurulum için kullandığınız sunucu ya da yazılımdan gelir.

Erişim izni neden yenilenmeli?

Reklam hesabına bağlı uygulama izinleri belirli aralıklarla dolar; izin dolduğunda olay gönderimi ve veri eşitlemesi durur. İznin dolmadan yenilenmesi gerekir.

CAPI'yi kodsuz kurun

GravityOne ADS, Pixel ve Conversions API bağlantısını panelden adım adım kurdurur; mağaza entegrasyonunuz varsa siparişler otomatik olarak Purchase olayı olarak gönderilir ve Meta erişim izni dolmadan sizi uyarır.

Meta reklam yönetimini inceleyin →

meta pixelconversions apicapidönüşüm takibifacebook reklam