Meta Conversion API (CAPI)

Kısa Özet: Zeisoft Meta Conversion API (CAPI) kurulum hizmeti, Meta Pixel’in yapamadığı server-side event akışını Meta Graph API’ye HTTP üzerinden iletir; iOS 14.5+ ATT ile başlayan attribution kayıplarına teknik çözüm sunar. Pixel + CAPI çift kurulum + deduplication standart yapılandırma — ikisi aynı event’i göndermeli, event_id ile Meta tarafında eşleştirilmeli, aksi halde double-counting cezası riski oluşur. Event Match Quality (EMQ) skoru 0-10 arası ölçülür; 8-10 bandı için Advanced Matching parametreleri (hashlenmiş email, telefon, isim, şehir, doğum tarihi) eksiksiz gönderilmeli. Dört kurulum mekanizması vardır: GTM Server Container (en esnek, ~5 USD/ay), Shopify resmi entegrasyonu, WooCommerce eklentileri (PixelYourSite, Pixel Manager) ve custom backend entegrasyonu. Öncelikli event’ler — Purchase, AddToCart, InitiateCheckout, Lead, CompleteRegistration — CAPI ile gönderilir; ViewContent ve PageView gibi yüksek hacimli event’ler sadece Pixel’de bırakılır. KVKK/GDPR uyumlu hash’leme standart.

Meta Reklamlarında Veri Kaybediyor musunuz?

iOS 14.5 (Nisan 2021) öncesi tracking basitti: Meta Pixel kullanıcının tarayıcısında event’leri yakalardı, attribution çoğu zaman doğru çalışırdı. Sonra Apple ATT (App Tracking Transparency) geldi ve kullanıcılara reklam takibini kabul/red seçimi tanıdı. iOS kullanıcılarının çoğunluğu reklam takibini reddediyor — Apple’ın 2022 ATT kullanım raporları sonrası bu eğilim somut olarak ortaya çıktı.

Sonuç: Meta Pixel verilerinin önemli kısmı kayboluyor. Reklam algoritması yanlış veri ile optimize ediyor, ROAS gerçekten daha düşük raporlanıyor, attribution güvenilirliği çöküyor.

Meta Conversion API (CAPI) bu sorunun teknik çözümü. CAPI sunucu tarafında çalışır — event’ler sitenizden veya backend’inizden Meta’ya HTTP üzerinden direkt iletilir. iOS ATT, Safari ITP, ad blocker bu yolu engelleyemez. Apple’ın App Tracking Transparency dokümantasyonu ATT’nin teknik detaylarını anlatır.

Pixel + CAPI Çift Kurulum

CAPI Pixel’in yerini almaz; ikisi birlikte çalışır:

İkisi aynı event’i göndermeli; deduplication ile Meta tarafında eşleştirilir. Doğru deduplication kurulumu zorunlu — yanlış yapılırsa CAPI verilerinizi şişirir veya Meta double-counting yaptırımı uygular.

Event Match Quality (EMQ) — Skorunuzu Bilin

Meta gönderdiğiniz event verilerinin kullanıcıyla eşleştirilebilme kalitesini 0-10 arası bir skorla ölçer:

• 0-5 — Düşük kalite. Meta event’leri atfedemiyor, attribution gerçekte olduğundan düşük raporlanıyor.
• 6-7 — Orta kalite. Bazı parametre eksikliği.
• 8-10 — Yüksek kalite. Advanced Matching parametreleri tam, deduplication doğru, conversion zinciri bütün.

EMQ’yu yükseltmek için Advanced Matching parametreleri (hashlenmiş email, telefon, isim, şehir, doğum tarihi) CAPI çağrılarında gönderilir. Veriler SHA-256 ile hashlenir ve Meta’ya clear text olarak iletilmez — KVKK ve GDPR kapsamındaki kişisel veri işleme kuralları açısından uyumludur.

CAPI Kurulum Mekanizmaları

1. GTM Server Container

En esnek ve uzun vadeli sürdürülebilir yol. GTM Server Container üzerinden CAPI tag tetiklenir; Cloudflare Workers veya Cloud Run’da çalışır. KOBİ ölçeği için ~5 USD/ay başlangıç maliyeti.

2. Shopify Entegrasyonu

Shopify’ın resmi Facebook & Instagram entegrasyonu CAPI destekler. Ek olarak Shopify Web Pixel API ile custom event mapping yapılabilir.

3. WooCommerce Eklentisi

PixelYourSite Pro, Pixel Manager, WooCommerce Facebook Pixel & CAPI gibi eklentiler hazır çözüm sunar. Custom data layer ile birleştirip optimum kurulum sağlanır.

4. Custom Backend Entegrasyonu

Kendi backend’iniz varsa direkt Meta Graph API’ye HTTP POST ile CAPI çağrıları yapılabilir. En düşük gecikme, en yüksek kontrol; ama bakım gerektirir.

Hangi Event’ler CAPI ile Gönderilmeli?

Tüm event’leri CAPI ile göndermek şart değil. Öncelikli event’ler:

• Purchase — En kritik conversion event’i
• AddToCart — Funnel optimizasyonu için
• InitiateCheckout — Drop-off analizi için
• Lead — B2B veya lead-gen kampanyalarda
• CompleteRegistration — Üyelik akışı varsa

ViewContent, PageView gibi yüksek hacimli event’leri sadece Pixel’de bırakmak performans açısından mantıklı.

Server-Side Purchase Event Örneği

Müşterinin satın alma anında Meta Graph API’ye Purchase event’i göndermek için tipik Node.js implementasyonu — Pixel ile aynı event_id kullanılarak deduplikasyon sağlanır, hassas kullanıcı verileri SHA-256 ile hash’lenir:

const crypto = require('crypto');

// Hassas veriler clear text gitmemeli — SHA-256 hash + lowercase + trim
const sha256 = (s) =>
  crypto.createHash('sha256').update(String(s).toLowerCase().trim()).digest('hex');

await fetch(`https://graph.facebook.com/v18.0/${PIXEL_ID}/events`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    data: [
      {
        event_name: 'Purchase',
        event_time: Math.floor(Date.now() / 1000),
        event_id: `order-${order.id}`, // Pixel ile aynı event_id (deduplication)
        action_source: 'website',
        event_source_url: order.checkoutUrl,
        user_data: {
          em: [sha256(user.email)],
          ph: [sha256(user.phone)],
          fn: [sha256(user.firstName)],
          ln: [sha256(user.lastName)],
          ct: [sha256(user.city)],
          fbc: cookies.fbc, // Facebook click ID — hash'lenmez
          fbp: cookies.fbp, // Facebook browser ID — hash'lenmez
          client_ip_address: req.ip,
          client_user_agent: req.headers['user-agent'],
        },
        custom_data: {
          currency: 'TRY',
          value: order.total,
          content_ids: order.items.map((i) => i.sku),
          content_type: 'product',
          num_items: order.items.length,
        },
      },
    ],
    access_token: META_ACCESS_TOKEN,
  }),
});

Doğrulama için Meta Test Events Tool (test_event_code parametresiyle) kullanılır; canlıya almadan önce her event’in EMQ skoru ve dedup oranı izlenir.

Conversion Lift Testi

CAPI kurulumu sonrası Meta’nın Conversion Lift testi ile attribution iyileşmesinin gerçek etkisi ölçülebilir:

• Kullanıcıların bir kısmına reklam gösterilmez (control group)
• Kalanına gösterilir (test group)
• İki grup arasındaki conversion farkı = reklamın gerçek artı etkisi (incremental lift)

Yüksek aylık reklam bütçeli müşterilerde lift testi öneriyoruz — CAPI yatırımının ROI’sini somut olarak doğruluyor.

Birlikte Çalıştığımız Hizmetler

• Google Tag Manager Kurulumu — GTM Server Container CAPI’nin altyapısı
• TikTok Pixel + Events API — Aynı mantık TikTok için
• Meta Ads Yönetimi — Meta reklam + CAPI tek elden
• Dijital Reklam — Tüm dijital reklam kanallarında tracking entegrasyonu

Süreç

1. Ücretsiz CAPI denetimi — Mevcut Pixel, CAPI varlığı, EMQ skoru, deduplication durumu
2. Strateji belgesi — Hangi event’ler CAPI ile gönderilecek, hangi mekanizma kullanılacak
3. Kurulum — GTM Server Container, Shopify/WooCommerce eklentisi veya custom backend
4. Deduplication yapılandırması — event_id eşleştirme
5. Advanced Matching kurulumu — EMQ skor optimizasyonu
6. Test ve doğrulama — Meta Test Events Tool ile her event ayrı ayrı doğrulanır
7. Conversion Lift testi (opsiyonel) — Yüksek bütçeli müşterilerde

İlk denetim için iletişim sayfasından görüşme planlayın.