Conversion API · CAPI

Pixel öldü.
Server-side kazanıyor.

iOS 14.5, Safari ITP, üçüncü taraf çerez sonu ve reklam engelleyiciler birleşince browser pixel'lerin gördüğü dönüşüm verisinin yarısı kayboluyor. Meta, Google, TikTok ve LinkedIn artık sunucudan gelen olayları öğrenme sinyali olarak kullanıyor. Conversion API tam bu sebeple zorunlu hâle geldi.

Tipik kurulumdan sonra event match rate %30 seviyelerinden %85-90 bandına yükseliyor; algoritma yeniden öğreniyor, CAC düşüyor, ROAS geri geliyor. Bizim işimiz bu boru hattını sağlam kurmak — pixel'i kapatmadan, KVKK'yı bozmadan, mevcut analytics'inizi kırmadan.

Tarayıcı
Purchase · 249.99 TRY
çerez bloklu
{`event_id:"a91"`} {`value:249.99`} {`em:sha256(...)`} {`fbp,fbc,ip,ua`}
Sunucu
capi.partnerfy.co
M
Meta CAPI
graph.facebook.com/events
88%
G
Google Ads EC
googleadservices.com
91%
T
TikTok Events
business-api.tiktok.com
82%
L
LinkedIn CAPI
api.linkedin.com/conversions
79%
match rate %30 → %88

Neden gerekli?

Browser pixel'inizin gördüğü 100 dönüşümün 50'si artık görünmüyor.

Apple iOS 14.5 ile App Tracking Transparency açıldığında %75 kullanıcı izlemeyi reddetti. Safari'nin Intelligent Tracking Prevention'ı 3. taraf çerezleri 7 günde siliyor. Chrome 2024-2025 boyunca 3. taraf çerezleri tamamen kaldırıyor. uBlock Origin + Brave + DuckDuckGo gibi engelleyiciler kullanıcıların %25-40'ında pixel'i çalıştırmıyor. Sonuç: reklam algoritması yanlış sinyalle besleniyor, yanlış kişilere reklam çıkarıyor, CAC yükseliyor.

01

iOS 14.5 ATT

App Tracking Transparency ile kullanıcıların %75'i tracking'i reddediyor. IDFA gitti, SKAdNetwork gecikmeli ve eksik veri veriyor.

02

Safari ITP

Intelligent Tracking Prevention 1st-party çerezleri 7 günde, script'le set edilen çerezleri 24 saatte siliyor. Cross-site izleme bitti.

03

3. taraf çerez sonu

Chrome 2025'te 3. taraf çerezleri tamamen kaldırıyor. Firefox ve Edge zaten varsayılan kapatmış durumda.

04

Ad-blocker yoğunluğu

Türkiye + DE'de masaüstü kullanıcılarının %30-45'i ad-blocker kullanıyor. Pixel hiç çalışmadan kapanıyor.

05

ePrivacy + KVKK + DSGVO

Onay alınmadan pixel ateşlemek yasal değil. "Reddet" tıklayanlar için browser pixel sessizce kapalı kalıyor.

06

Algoritma açlık çekiyor

Meta ve Google'ın AI optimizasyonu signal kalitesine bağımlı. Sinyal düşünce CPM artıyor, CAC patlıyor, ROAS düşüyor.

Sistem nasıl çalışır

Tek bir olay → 4 reklam motoruna eşzamanlı, deduplicate, hash'lenmiş.

Kullanıcı satın aldığında sunucumuz olay nesnesini oluşturur, e-posta + telefonu SHA-256 ile hash'ler, event_id'yi pixel ile aynı tutar (deduplication için), sonra dört reklam platformuna paralel post atar. Aşağıda gerçek payload, gerçek match rate paneli ve gerçek dedup mantığı:

POST graph.facebook.com/v19.0/{`{pixel_id}`}/events
// Meta CAPI — Purchase event payload {   "data": [{     "event_name": "Purchase",     "event_time": 1748602800,     "event_id": "ord_a91c4f", // dedup key     "action_source": "website",     "event_source_url": "https://shop/...thank-you",     "user_data": {       "em": ["7c4a8d09ca3762af61e..."],       "ph": ["e6c2e9c9be1f7dd9e2..."],       "fbp": "fb.1.1748...", "fbc": "fb.1...."     },     "custom_data": { "value": 249.99, "currency": "TRY" }   }] }

Event match rate — pixel only vs CAPI

canlı
Meta 30% → 88%
Google 30% → 88%
TikTok 30% → 88%
LinkedIn 30% → 88%

event_id ile deduplication

pixel event_id=ord_a91c4f
CAPI event_id=ord_a91c4f
Meta aynı id → tek dönüşüm sayılır

Olay/sn

1.840

Gecikme

42ms

Hata

0.04%

Kimler için?

Reklam bütçesini doğru ölçemediği için yakan herkes.

01

E-ticaret · Meta ağırlıklı

Aylık 100k+ harcama yapan, iOS sonrası attribution kaybeden online mağazalar; gerçek Purchase olayını Meta'ya geri besleyince ROAS'ı kurtarır.

02

Lead-gen ajansları

Müşterilerine Meta + Google reklam yöneten, iOS'ta form-fill ölçemediği için aylık raporu zorlananlar; CAPI ile lead atfı netleşir.

03

SaaS — trial signup

Trial başlatan kullanıcıyı reklam motoruna geri bildirmesi gereken SaaS'lar; deneme → ödeyen dönüşüm zincirini de CAPI ile besler.

04

10+ Meta müşterili ajanslar

Beyaz etiket CAPI altyapısı; tek konsoldan tüm hesaplar için event yönetimi, dedup ve QA.

05

2-taraflı marketplace

Hem alıcı hem satıcı eventleri; kayıt, ilan, mesaj, satış — her birinin doğru reklam hedefiyle eşleştirilmesi.

06

Finans — gecikmeli dönüşüm

Kredi başvurusu, sigorta teklifi gibi günler sonra onaylanan dönüşümler; offline conversion upload + CAPI birlikte.

07

Çoklu-mağaza e-ticaret

Tek bir marka altında 3-10 mağaza; her domain'in eventleri tek bir pipe üzerinden, dedup garantili.

08

Perakende · offline

Mağaza içi POS satışlarını Google Ads offline conversion'a yükleme; online + offline atfı tek raporda.

10 katmanlı server-side stack

Her platform için ayrı SDK kurmak — ya da tek bir pipe'tan hepsine yayın yapmak.

Tek pipe avantajı: aynı event_id, aynı hash kuralı, aynı QA. Üç farklı SDK = üç farklı veri formatı = üç farklı dedup hatası. Partnerfy tek bir sunucu üzerinden tüm hedefleri besler.

01

Meta Conversions API

Pixel + CAPI hibrit; event_id dedup, em/ph/fbp/fbc parametrelerinin tamı, Test Events doğrulama.

02

Google Enhanced Conversions

User-provided data (email + phone, SHA-256) ile gclid eşleştirme; web + offline conversion upload.

03

TikTok Events API

ttclid yakalama, Advanced Matching, event_id dedup; Events Manager Test Event entegrasyonu.

04

LinkedIn CAPI

B2B kitlede li_fat_id eşleştirme + hash'lenmiş kullanıcı; Insight Tag ile dedup.

05

Snap Conversions API

sc_cid yakalama, hash'li veri, mobile + web olaylar tek pipe'tan.

06

Offline conversion upload

CRM'den gelen "ödedi", "iptal etti", "iade aldı" event'lerini Google + Meta'ya geri push.

07

Server-side Google Tag Manager

Stape.io ya da kendi Cloud Run/ECS'inizde sGTM; tek payload'tan 10+ destination.

08

event_id dedup garantisi

Pixel ve CAPI aynı id'yi taşır; Meta + TikTok + LinkedIn raporlarında çift sayım yok.

09

PII hashing & consent

SHA-256 normalize edilmiş trim + lowercase; consent management ile entegre on/off mantığı.

10

Multi-platform orchestration

Tek event = 4 platforma paralel; Sentry-style hata izleme + replay queue.

Süreç

Denetimden canlı match rate %85+'a: 21 günlük kurulum yol haritası.

  1. 01

    Gün 1-3 · Olay denetimi

    Mevcut pixel'leri, dataLayer'ı, GTM container'ı, GA4 event'lerini taradık. Hangi event'ler eksik, hangileri yanlış parametre alıyor — net liste.

  2. 02

    Gün 3-6 · Şema eşleme

    Sunucu event'lerinizi Meta, Google, TikTok, LinkedIn schema'larına eşleriz. event_id stratejisi, hash kuralı, fallback parametreler kararlaştırılır.

  3. 03

    Gün 6-12 · Pipe inşası

    Stape.io / sGTM / Cloud Run kararı sonrası pipe kodlanır. Queue, retry, idempotency, dead-letter — production seviyesinde.

  4. 04

    Gün 10-14 · PII hash & consent

    em/ph/external_id SHA-256, normalize edilir. KVKK + DSGVO consent durumuna göre event'in gidip gitmemesi kontrol edilir.

  5. 05

    Gün 14-18 · Deploy & doğrulama

    Meta Test Events, Google Tag Assistant, TikTok Test Event Tool — her platformda canlı doğrulama, ilk 48 saatte match rate raporu.

  6. 06

    Gün 18+ · İzleme & optimize

    Match rate dashboard, hata oranı, geç gelen event'ler, kampanya-bazlı atribüsyon karşılaştırması; haftalık tweak, aylık review.

Kullandığımız araçlar

Endüstri standardı CAPI + ETL stack'i.

Meta Conversions API Google Enhanced Conversions TikTok Events API LinkedIn CAPI Snap CAPI Server-side GTM Stape.io RudderStack Segment Tealium Zapier

Müşteri hikâyeleri

Aynı pipe. Farklı sektör. Aynı sonuç: match rate yukarı, CAC aşağı.

E-ticaret 41% → 89%

Fashion D2C

Meta event match rate %41 → %89. Algoritma yeniden öğrendi, 6 hafta sonra Meta ROAS 2.1x → 3.4x. Reklam bütçesi sabit, ciro %52 arttı.

Lead-gen ROAS +127%

Sigorta brokeri

iOS sonrası iflas eden Meta lead-gen kampanyalarına CAPI kurulumu: lead başına maliyet %44 düştü, ROAS +127% geri kazanıldı.

SaaS CAC −38%

Vertical SaaS

Trial signup eventi Google + Meta'ya server-side; trial→paying dönüşüm zinciri offline upload'la kapatıldı. CAC %38 düştü.

Marketplace CPL −29%

2-taraflı pazar yeri

Hem buyer hem seller eventi tek pipe'tan; ilan başı maliyet %29 düştü, satıcı kazanım kampanyası 3x ölçeklendi.

Finans ROAS +93%

Kredi karşılaştırma

Başvuru → onay 7 gün; CAPI + offline conversion upload ile gerçek "onaylı kredi" Meta'ya geri besledi. ROAS +93%.

Ajans 14 müşteri

Performance ajansı

14 e-ticaret müşterisi için beyaz etiket CAPI altyapısı; ortalama match rate %39 → %86, ajans churn %0.

Sık sorulanlar

CAPI kurulumu öncesi 8 kritik soru

Hayır, kesinlikle kapatmayın. Optimal yapı hybrid'dir: tarayıcıda pixel çalışmaya devam eder (engellenmediği kullanıcılarda hızlı sinyal verir), sunucudan da CAPI gönderilir. İki kaynak aynı event_id'yi taşıdığı için Meta, Google ve TikTok dedup yapar — sayım tek seferdir. Sadece CAPI bırakırsanız iOS'taki cihaz parmak izi (fbp / fbc / ttclid) gibi sadece tarayıcıdan alınabilen parametreleri kaybedersiniz; bu da match rate'i düşürür. Pixel hâlâ değerli; CAPI onu tamamlar, ikame etmez.
Evet, üç koşul sağlanırsa: (1) kullanıcı consent banner'ında "advertising / measurement" amaçlarını kabul etmiş olmalı; (2) email, telefon, isim gibi PII alanları sunucuda SHA-256 ile geri-çevrilemez şekilde hash'lenmiş gönderilmeli; (3) consent yoksa o kullanıcının event'i hiç pipe'a girmemeli. Partnerfy bu üçünü de teknik olarak garanti eder — Consent Mode v2, IAB TCF, OneTrust, Cookiebot, Usercentrics gibi consent platformlarıyla entegrasyon hazır. KVKK ve DSGVO için hashlenmiş data zaten "kişisel veri" sayılmaz — Avrupa Veri Koruma Kurulu ve KVKK rehberlerinde açık.
Trafik hacmine ve teknik kapasiteye bağlı. sGTM (Google'ın server container'ı) hızlı kurulur, GTM UI'sından yönetilir, ayda 100k istek altında ücretsizdir; e-ticaret ve orta-ölçek SaaS için ideal. Yüksek trafik (10M+ event/ay), karmaşık logic (kişiselleştirilmiş retry, condition'lı dedup, queue), ya da çok büyük PII compliance gereksinimleri varsa kendi Node/Go server'ınız (Cloud Run, ECS, kendi VPC) daha doğrudur. Partnerfy ikisini de kurar; karar 30 dakikalık denetimle netleşir.
Stape.io managed sGTM hosting sağlar — DNS, SSL, scaling, monitoring derdi sıfır. Aylık 20-200$ arası, kurulum 1-2 saat. Avantajı hız; dezavantajı veri 3. parti sunucudan geçer (gerçi consent + hashing varsa sorun değildir) ve özelleştirme sınırlıdır. Kendi sunucunuz (AWS Cloud Run, Google Cloud Run, kendi Kubernetes) daha fazla kontrol, sınırsız özelleştirme, veri sizin VPC'nizde kalır; ama DevOps yükü vardır. Çoğu müşteriye Stape.io ile başlayıp 1 yıl sonra trafiği yüksekse kendi sunucuya göç öneriyoruz.
Match rate, gönderdiğiniz event'in reklam platformunda gerçek bir kullanıcı kimliğiyle eşleşme yüzdesi. Yükselten faktörler: hashlenmiş email + telefon + isim + adres + şehir (ne kadar fazla parametre, o kadar iyi); fbp/fbc/gclid/ttclid gibi click ID'lerin yakalanması; doğru event_time (event ile post arası 7 gün içinde); IP + User-Agent'ın forward edilmesi; ülke + posta kodu eklenmesi. Düşüren faktörler: sadece email göndermek, hash'i lowercase + trim normalize etmeden yapmak, fbp/fbc eksik, kullanıcı login değil. Bizim hedefimiz Meta için %85+, Google EC için %80+, TikTok için %75+ bandı.
Standart bir e-ticaret + Meta + Google + TikTok kombinasyonu 14-21 gün. Mevcut dataLayer'ınız temizse ve teknik ekibimizle 2 saatlik bir kickoff yaptıysak, ilk haftada audit + mapping biter; ikinci hafta pipe + hash + consent katmanı yazılır; üçüncü hafta canlı doğrulama + ilk match rate raporu çıkar. LinkedIn + Snap eklenirse +3 gün, offline conversion upload + 1 hafta. CRM entegrasyonu ya da kişiselleştirilmiş queue/retry isteniyorsa toplam 4-6 hafta.
Hayır. CAPI sunucu tarafından çalışır, sayfanıza tek bir satır kod bile eklemeden devreye girer (gerçi event_id taşımak için dataLayer'a küçük bir patch atarız — 5 satır). Mevcut GA4, Google Tag Manager, Hotjar, Mixpanel, Segment, kendi BI sisteminiz — hepsi olduğu gibi kalır. Hatta birçok müşteride sGTM kurulumu sayfa hızını da iyileştirir (3rd-party scriptler sunucuya taşınır). Test ortamında önce kurulur, A/B mantığıyla bir hafta paralel çalıştırılır, sonra production'a geçer.
Üç katmanda: (1) Teknik metrikler — match rate (yüzde olarak yükselme), event delivery success rate (%99+ hedeflenir), gecikme (median <100ms). (2) Reklam metrikleri — kampanya bazlı atribüsyon (Meta Reports + GA4 + sizin BI), CPM düşüşü, CPA / CPL düşüşü, ROAS yükselişi; tipik 6-8 hafta içinde net görünür. (3) İşletme metrikleri — toplam ciro, organik vs paid karışım, müşteri yaşam boyu değeri. Tüm bunları aylık raporda + canlı dashboard'da gösteriyoruz; "CAPI kuruldu, attribution geri geldi, X bütçeyi Y'ye taşıdık, ROAS Z oldu" şeklinde nedensel bağıyla.

Reklam paranızı doğru ölçün.

30 dakikalık ücretsiz denetimde mevcut pixel + CAPI durumunuzu birlikte inceliyor; ilk 21 günde match rate'i %85+'a çıkaracak yol haritasını paylaşıyoruz.

sonuç