Meta Piksel + Conversion API kurulumu — iOS 14 sonrası rehber | Nuvi

Meta Piksel (eski Facebook Pixel), Facebook ve Instagram reklamlarının kimin satın aldığını öğrenmesini sağlayan tarayıcı tabanlı izleme kodudur. Ama 2021 sonrası iki şey değişti: Apple iOS 14 ile ATT (App Tracking Transparency) tarayıcı izlemeyi büyük ölçüde kırdı, ve Google Chrome 3rd-party cookie'leri 2024'te aşamalı kapattı. Meta'nın bu sorunlara cevabı Conversion API (CAPI) — sunucudan-sunucuya doğrudan event gönderme.

2026'da doğru kurulum Piksel + CAPI ikilisidir. Sadece Piksel = %30-50 sinyal kaybı, sadece CAPI = client-side davranış sinyalleri eksik. Bu rehber ikisini birlikte kurmayı, deduplike etmeyi ve doğru çalıştığını doğrulamayı gösteriyor.

1. Meta Business Suite hesabı + Piksel oluşturma

business.facebook.com → Business Settings → "Data Sources" → "Pixels" → "Add"
Piksel adı: mağaza adınız. URL ile doğrulayın.
Piksel ID'sini kopyalayın (15 haneli sayı).

2. Piksel kodunu siteye ekleme

Üç yol var:

Hazır platform entegrasyonu (Nuvi, Shopify): Admin → Pazarlama → Meta Piksel alanına ID gir, biter. Standart e-ticaret olayları otomatik tetiklenir.
Google Tag Manager: GTM şablon galerisinden "Facebook Pixel" tag'ini ekle, ID'ni gir, "All Pages" trigger'ına bağla.
Direkt kod yapıştırma: Sayfanın <head> bölümüne Meta'nın verdiği snippet'i yapıştırırsın.

3. Standart olaylar (events)

Meta Piksel'in 17 standart olayı vardır; e-ticaret için kritik 6 tanesi:

PageView — her sayfa
ViewContent — ürün sayfası görüntülendi
AddToCart — sepete eklendi
InitiateCheckout — ödeme başladı
AddPaymentInfo — ödeme bilgisi girildi
Purchase — satın alma tamamlandı (en kritik)

Her event ile birlikte değer ve para birimi gönderilmelidir:

fbq('track', 'Purchase', {
value: 249.90,
currency: 'TRY',
content_ids: ['sku-001'],
content_type: 'product',
contents: [{ id: 'sku-001', quantity: 1, item_price: 249.90 }]
});

4. Conversion API kurulumu

CAPI sunucudan event gönderdiği için ATT / cookie engelleyici / 3rd-party cookie kısıtlamalarından etkilenmez. Üç yol:

a) Hazır platform CAPI entegrasyonu

Nuvi, Shopify, BigCommerce gibi platformlar admin panelinden CAPI access token girmenizi ister. Olaylar otomatik sunucu tarafından duplicate Piksel event'leri ile birlikte gönderilir.

b) Stape veya Stape Cloud (orta seviye)

Server-side GTM container kurarsınız, Stape kendi sunucusunda host eder. Aylık 20-50 USD. Tüm tag'leri (Meta CAPI, Google Ads, TikTok) tek noktadan yönetirsiniz.

c) Self-host server-side GTM (ileri seviye)

Google Cloud Run veya AWS'te kendi server-side GTM'inizi host edersiniz. Tam kontrol, aylık ~10 USD altyapı maliyeti, biraz devops bilgisi.

5. Deduplikasyon — kritik adım

Hem Piksel hem CAPI aynı olay için tetiklenirse Meta event'i 2 kez sayar. Engellemek için her olaya event_id parametresi ekleyin (UUID veya sipariş ID'si):

// Browser (Piksel)
fbq('track', 'Purchase', { value, currency }, { eventID: 'order-12345' });

// Server (CAPI)
{ event_name: 'Purchase', event_id: 'order-12345', ... }

Aynı event_id ile gelen iki event'i Meta otomatik birleştirir.

6. Olay Eşleştirme (Match Quality) skoru

Meta Events Manager → "Diagnostics" sekmesinde Event Match Quality (EMQ) skoru görürsünüz (0-10 arası). 7+ ideal, 5 altı reklam optimizasyonunu bozar. EMQ'yu artırmak için CAPI ile user data gönderin (hash'lenmiş):

E-posta (SHA-256 hash)
Telefon numarası (E.164 + SHA-256)
İsim/soyisim (lower + SHA-256)
IP adresi + User-Agent
fbc / fbp cookie değerleri

Hash'lemeden gönderirseniz Meta verisini reddeder.

7. Test ve doğrulama

Pixel Helper Chrome eklentisi → sitenize girin, sepete ekleyin. Her event'in yeşil ✓ ile geldiğini görün.
Test Events aracı (Events Manager > Test Events) — gerçek zamanlı event akışı.
Test bir sipariş verin, "Teşekkürler" sayfasında Purchase event'inin 1 kez geldiğini doğrulayın.

8. iOS 14 kullanıcısına özel uyarı

iOS 14+ kullanıcısı ATT prompt'ta "İzleme yok" derse, Meta o kullanıcının davranışını birleştiremez. Çözüm: Aggregated Event Measurement (AEM). Events Manager'da hangi 8 olayın iOS izinsiz kullanıcılar için raporlanacağını seçersiniz. Çoğu mağaza için sıralama: Purchase > InitiateCheckout > AddToCart > ViewContent > ...

9. Özel Hedef Kitleler (Custom Audiences)

Piksel + CAPI doğru kuruluysa, otomatik olarak şu kitleler oluşturulabilir:

Son 30 gün ürün gören ama satın almayanlar (retargeting)
Son 90 gün sepete ekleyen
Son 180 gün satın alan (alıcı listesi)
Müşteri listesi LTV bazlı segmentler

Bu kitleler üzerinden Lookalike oluşturup soğuk kampanyaların temel hedefleme materyalini sağlarsınız.

10. Yaygın hatalar

Piksel kodunun yanlış sayfaya yerleştirilmesi: <head> dışında ya da defer ile yüklenirse PageView eksik.
Value alanı string olarak gönderilmesi: Meta sayısal değer bekler; "249,90" stringi reddedilir. Nokta + tek bir nokta ondalık ayırıcı.
Çoklu Piksel (ana Piksel + alt Piksel) karışıklığı: Mağaza başına tek Piksel kullanın. Çoklu Piksel raporları parçalar.
Test event'leri canlıya bırakmak: Test Events sekmesinden test ettikten sonra test ID'sini kaldırın.
EMQ'nun düşük kalması: CAPI'de user data hash'leri eksik. fbc + fbp cookie'leri her event ile gönderin.

Sık sorulan sorular

Meta Piksel ücretsiz mi?

Evet. CAPI de ücretsiz. Server-side GTM host'lamak istiyorsanız altyapı maliyeti var (Stape 20 USD/ay veya self-host ~10 USD/ay).

CAPI olmadan reklam veremem mi?

Verebilirsin ama performans çok düşer. iOS 14+ trafiğinde %30-50 sinyal kaybı yaşarsın, bu da CPA'yı 2x'leyebilir.

KVKK / GDPR ile Piksel'in ilişkisi nedir?

Piksel kişisel veri (IP, davranış) topladığı için GDPR/KVKK kapsamındadır. Çerez izni alınmadan Piksel yüklemek illegaldir. Çerez yöneticisi (Cookiebot, OneTrust, Nuvi'nin yerleşik cookie consent modülü) zorunlu.

iOS Safari ve Brave gibi tarayıcılarda Piksel çalışır mı?

Sınırlı. Safari Intelligent Tracking Prevention ve Brave'in shield'leri 3rd-party izlemeyi engeller. CAPI bu durumda kurtarıcıdır — sunucudan event gönderilir.

Sonuç

Meta Piksel artık tek başına yetersiz. iOS 14, çerez engelleyiciler ve KVKK karşısında Piksel + CAPI ikili kurulumu standart hale geldi. Hazır platformda 10 dakikada kurulur; özel site'taysanız Stape gibi bir aracıyla bir öğleden sonra harcayın. Doğru kurulmuş bir setup, reklam bütçenizin sinyali doğru olduğu için yanlış kurulanlara göre %30-50 daha verimli çalışır.