Meta reklamlarında son birkaç yıldır herkesin yaşadığı ortak bir sorun var: Reklam Yöneticisi’nde görünen dönüşüm sayısı ile e-ticaret panelinizdeki gerçek satışlar artık birbirini tutmuyor. Bunun en büyük sebebi, uzun yıllar tek başına kullandığımız Meta Pixel’in (eski adıyla Facebook Pixel) tarayıcı tabanlı olması ve çerez kısıtlamaları nedeniyle her şeyi yakalayamaması. İşte tam burada Conversions API (CAPI) devreye giriyor. Bu rehberde, 10 yılı aşkın dijital pazarlama deneyimimle, meta pixel capi kurulumu konusunu sade ve teknik bir dille, satışçı jargonuna boğmadan anlatacağım. Amacım, kurulumu kendiniz yapacak kadar net bir yol haritası vermek.
Meta Pixel Nedir ve Ne İşe Yarar?
Meta Pixel, web sitenize yerleştirdiğiniz küçük bir JavaScript kod parçasıdır. Bir ziyaretçi sitenize girdiğinde bu kod tarayıcıda çalışır ve kullanıcının yaptığı eylemleri (sayfa görüntüleme, sepete ekleme, satın alma, form doldurma gibi) Meta’ya bildirir. Bu veriler sayesinde şu üç kritik işi yaparsınız:
- Dönüşüm ölçümü: Hangi reklamın gerçekten satış veya potansiyel müşteri getirdiğini görürsünüz.
- Optimizasyon: Meta’nın algoritması, satın alma olasılığı yüksek kişilere reklam göstermeyi öğrenir.
- Yeniden pazarlama (retargeting): Sepeti terk edenleri veya belirli sayfayı gezenleri tekrar hedefleyebilirsiniz.
Piksel çalışmasının mantığı basittir: Tarayıcı, kullanıcının eylemini Meta’nın sunucularına doğrudan iletir. Yıllarca bu yöntem yeterliydi. Ama “yeterliydi” demem bir sebepten dolayı geçmiş zaman; çünkü artık tek başına yetmiyor.
Neden Meta Pixel Tek Başına Artık Yetmiyor?
Pikselin tarayıcı tabanlı çalışması, onu dışarıdan gelen müdahalelere açık hale getiriyor. Deneyimime göre son dönemde veri kaybının başlıca üç sebebi var:
1. iOS 14.5 ve ATT (App Tracking Transparency)
Apple’ın 2021’de getirdiği gizlilik politikasıyla birlikte iPhone kullanıcıları, uygulamaların kendilerini izlemesine açıkça izin verip vermeyeceğini seçiyor. Çoğu kullanıcı “izleme” seçeneğini reddediyor. Bu da Meta’nın, Instagram veya Facebook uygulamasından sitenize gelen bu kişilerin eylemlerini eksiksiz bağlayamaması anlamına geliyor. Sonuç: Ölçemediğiniz, dolayısıyla optimize edemediğiniz bir trafik dilimi.
2. Üçüncü Taraf Çerezlerinin Sonu ve Tarayıcı Engelleri
Safari’nin ITP (Intelligent Tracking Prevention) ve Firefox’un benzer özellikleri, izleme çerezlerinin ömrünü kısaltıyor ya da tamamen engelliyor. Pikseliniz çereze bağımlı olduğu için, bu çerez silindiğinde ya da bloklandığında veri akışı kesiliyor.
3. Reklam Engelleyiciler ve Ağ Kesintileri
Kullanıcının tarayıcısında bir reklam engelleyici (ad blocker) varsa, piksel script’i hiç yüklenmeyebilir. Aynı şekilde zayıf internet bağlantısında sayfa tam yüklenmeden kapatılırsa, olay (event) Meta’ya hiç ulaşmaz. Deneyimime göre mobil trafiğin yoğun olduğu sektörlerde bu kayıp ciddi boyutlara ulaşabiliyor.
Tüm bunların toplamı şu: Sadece pikselle çalışırsanız, gerçekte gerçekleşen satışların bir kısmını hiç göremezsiniz. Göremediğiniz veriyle de algoritmayı doğru besleyemezsiniz. İşte CAPI bu boşluğu kapatmak için var.
Conversions API (CAPI) Nedir?
Conversions API, olay verilerini kullanıcının tarayıcısı yerine sizin sunucunuzdan doğrudan Meta’nın sunucusuna gönderen bir bağlantıdır. Yani araya tarayıcı, çerez veya reklam engelleyici girmez. Veri, sunucudan sunucuya (server-to-server) akar.
Bunu şöyle düşünün: Piksel, müşterinin ağzından duyduğunuz bilgidir; arada gürültü olursa kaçırabilirsiniz. CAPI ise doğrudan kasa fişinden okuduğunuz bilgidir; daha güvenilir ve eksiksizdir. Bir satın alma gerçekleştiğinde, sitenizin sunucusu “bu kişi şu ürünü şu fiyata aldı” bilgisini arka planda doğrudan Meta’ya iletir. Tarayıcının çerezi engellemesi ya da kullanıcının sayfayı kapatması bu akışı durduramaz.
CAPI’nin pikselle paylaştığı temel veriler arasında olay adı, olay zamanı, ürün değeri ve para birimi gibi bilgilerin yanı sıra eşleştirme parametreleri (e-posta, telefon, ad-soyad gibi şifrelenmiş müşteri bilgileri) bulunur. Bu parametreler, Meta’nın olayı doğru kullanıcıya bağlayabilmesi için kritik önemdedir; biraz sonra bu konuya döneceğiz.
Pixel ve CAPI Neden Birlikte Kullanılmalı? Deduplication Mantığı
Burada en sık yapılan kafa karışıklığını netleştireyim: CAPI, pikselin yerine geçmez. İkisi birlikte çalışır. Meta’nın resmi önerisi de budur ve benim saha deneyimimde de her zaman ikisini birlikte kurarım.
Mantık şu: Piksel tarayıcıdan, CAPI sunucudan aynı olayı gönderir. Böylece biri eksik kalsa diğeri devreye girer; ikisi de çalışırsa veri bütünlüğünüz tam olur. Ama burada akla haklı bir soru geliyor: “Aynı satışı hem piksel hem CAPI gönderirse, Meta bunu çift sayar mı?”
İşte burada deduplication (tekilleştirme / çift kayıt ayıklama) devreye girer. Hem piksel hem CAPI, aynı olay için iki ortak kimlik gönderir:
- event_id: Her olaya atanan benzersiz bir kimlik. Piksel ve CAPI aynı satın alma için aynı event_id’yi göndermelidir. Meta, aynı event_id’li iki kaydı görünce bunların tek olay olduğunu anlar ve birini eler.
- event_name: Olayın adı (örn. “Purchase”). Eşleştirmenin doğru yapılması için iki tarafta da aynı isimle gönderilmelidir.
Yani doğru kurulumda Meta şu mantıkla çalışır: “Hem tarayıcıdan hem sunucudan aynı event_id geldi mi? Geldiyse bu tek bir satıştır, bir kez sayarım.” Eğer sadece biri gelmişse, eldeki tek kaydı kullanır. Bu sayede ne veri kaybedersiniz ne de çift sayım olur.
En kritik uyarı: Deduplication’ın doğru çalışması tamamen aynı event_id’nin iki tarafta da gönderilmesine bağlıdır. Pratikte gördüğüm en yaygın hata budur. event_id eşleşmezse Meta olayları ayrı sanır ve dönüşümlerinizi şişirir; raporlarınız olduğundan iyi görünür ama gerçeği yansıtmaz. Kurulum sonrası mutlaka kontrol edilmesi gereken bir nokta.
Meta Pixel CAPI Kurulumu: Hangi Yöntemi Seçmeli?
CAPI’yi devreye almanın tek bir yolu yok; işletmenizin teknik altyapısına ve kaynaklarınıza göre değişen yöntemler var. Aşağıdaki tabloda üç ana yöntemi karşılaştırdım. Bu tablo, meta pixel capi kurulumu kararında size yön verecek.
| Yöntem | Teknik Zorluk | Kontrol / Esneklik | Kimler İçin Uygun |
|---|---|---|---|
| Partner Entegrasyonu (Shopify, WooCommerce eklentisi vb.) | Düşük | Sınırlı | Hazır platform kullanan KOBİ’ler |
| Server-Side GTM (sunucu taraflı Google Tag Manager) | Orta | Yüksek | Veri kontrolü isteyen, GTM bilen ekipler |
| Doğrudan Sunucu Entegrasyonu (kendi kodunuz) | Yüksek | Çok yüksek | Yazılım ekibi olan özel altyapılar |
1. Partner Entegrasyonu (En Kolay Yol)
Shopify, WooCommerce, Ticimax, IdeaSoft gibi hazır e-ticaret platformları kullanıyorsanız en pratik yöntem budur. Meta Olaylar Yöneticisi’nde (Events Manager) “Conversions API” bölümüne girip platformunuzu seçersiniz; ardından birkaç tıkla bağlantı kurulur. Bu yöntemde deduplication’ı ve event_id eşleşmesini genellikle entegrasyon kendisi halleder, sizin kafa yormanıza gerek kalmaz. Teknik bilgisi sınırlı işletmeler için başlangıç noktası olarak bunu öneririm.
2. Server-Side Google Tag Manager (Dengeli Seçim)
Hem kontrol hem yönetilebilirlik isteyen ekipler için tercih ettiğim yöntem genellikle budur. Burada bir “sunucu konteyneri” (server container) oluşturulur (çoğunlukla Google Cloud üzerinde) ve tüm olaylar önce bu sunucudan geçer, oradan hem piksele hem de CAPI’ye dağıtılır. Avantajı, tek bir noktadan tüm etiketleri yönetebilmeniz ve verinin hangi formatta gittiğini görebilmenizdir. Dezavantajı, kurulumun ve sunucu yönetiminin bir miktar teknik bilgi gerektirmesidir. GA4 tarafını da aynı altyapıda toplamak isteyenler için mantıklı bir yatırımdır.
3. Doğrudan Sunucu Entegrasyonu (Tam Kontrol)
Kendi yazılım altyapınız varsa, olayları Meta’nın Graph API’sine doğrudan kodla gönderebilirsiniz. Bir erişim belirteci (access token) oluşturur, sunucunuzdaki satın alma anını yakalayıp Meta’ya POST isteğiyle gönderirsiniz. En esnek ama en çok kaynak isteyen yöntemdir; özel CRM veya headless altyapılarda mantıklı olur. Bu yol için bir yazılım ekibine ihtiyacınız olur.
Hangi yöntemi seçerseniz seçin, Meta Ads kampanyalarınızın sağlıklı ölçüm altyapısına oturması kritik önemde. Bu altyapının reklam stratejisiyle birlikte kurulması gerektiğine inanıyorum; Meta Ads yönetimi hizmetim kapsamında da önce ölçüm doğruluğunu, sonra optimizasyonu ele alıyorum.
Olay Eşleştirme (Event Matching) ve Match Quality
CAPI’nin gerçek gücü, gönderdiğiniz olayları Meta’nın doğru kullanıcıya bağlayabilmesinde yatar. Bu bağlama işlemine olay eşleştirme (event matching) denir. Ne kadar çok ve doğru eşleştirme parametresi gönderirseniz, “Event Match Quality” (Olay Eşleştirme Kalitesi) skorunuz o kadar yükselir; bu da optimizasyonun ve dolayısıyla reklam performansınızın temelidir.
Gönderebileceğiniz başlıca eşleştirme parametreleri şunlardır:
- E-posta (em): En güçlü eşleştirme sinyallerinden biridir.
- Telefon numarası (ph): Ülke kodu ile birlikte gönderilmelidir.
- Ad ve soyad (fn, ln)
- Şehir, eyalet, posta kodu, ülke
- External ID: Kendi sisteminizdeki müşteri kimliği.
- fbp ve fbc: Pikselin ürettiği tarayıcı/tıklama çerez parametreleri.
Burada gizlilik açısından çok önemli bir nokta var: Bu kişisel veriler Meta’ya düz metin olarak gönderilmez. SHA-256 algoritmasıyla hash’lenir (şifrelenir) ve öyle iletilir. Yani Meta, ham e-posta veya telefonu görmez; sadece şifrelenmiş halini kendi şifrelenmiş verisiyle karşılaştırıp eşleştirme yapar. Doğrudan sunucu entegrasyonu yapıyorsanız hash’leme işlemini sizin yapmanız gerekir; partner ve GTM yöntemlerinde genellikle altyapı otomatik halleder. Yine de kullanıcılardan açık rıza (KVKK/onam) almak ve gizlilik politikanızda bu veri akışını belirtmek sizin sorumluluğunuzdadır.
Standart Olaylar ve Doğru Veri Göndermek
Hem piksel hem CAPI tarafında Meta’nın tanıdığı standart olayları kullanmanız önemlidir. Bu sayede olaylarınızı optimizasyonda kullanabilirsiniz. En çok kullanılan standart olaylar:
- PageView — Sayfa görüntüleme (temel olay)
- ViewContent — Ürün veya içerik görüntüleme
- AddToCart — Sepete ekleme
- InitiateCheckout — Ödeme adımına geçme
- Purchase — Satın alma (en kritik dönüşüm olayı)
- Lead — Potansiyel müşteri / form doldurma
Özellikle Purchase ve Lead olaylarında mutlaka value (değer) ve currency (para birimi) bilgisini gönderin. Çünkü Meta’nın “değer optimizasyonu” ve ROAS hesapları bu veriye dayanır. Değersiz gönderilen bir satın alma olayı, raporda görünür ama algoritmaya gerçek getiriyi öğretemez. Deneyimime göre en sık atlanan ayrıntılardan biri budur.
Kurulum Sonrası Mutlaka Yapılması Gerekenler
Kurulumu yapıp “tamam, bitti” demek en büyük hata. Veri akışının sağlıklı olup olmadığını doğrulamadan reklam bütçesi harcamak, gözleri kapalı araba kullanmaya benzer. Şu adımları mutlaka uygulayın:
- Test Events aracını kullanın: Olaylar Yöneticisi’ndeki “Test Events” sekmesinden, hem pikselin hem CAPI’nin olayları gerçek zamanlı gönderdiğini gözlemleyin.
- Deduplication durumunu kontrol edin: Olay detayına baktığınızda Meta size “Sunucu” ve “Tarayıcı” olaylarının eşleşip eşleşmediğini gösterir. “Processed / Deduplicated” durumu görmeniz gerekir; eşleşmiyorsa event_id’yi kontrol edin.
- Event Match Quality skorunu izleyin: Her olay için “Good” veya “Great” seviyesine çıkmaya çalışın. Düşükse, daha fazla eşleştirme parametresi (e-posta, telefon vb.) gönderin.
- Diagnostics (Tanı) sekmesini takip edin: Meta burada eksik parametreleri, format hatalarını ve uyarıları listeler. Düzenli kontrol edin.
Bu ölçüm altyapısı, yalnızca Meta’yla da sınırlı değil. Reklam yatırımınızın gerçek getirisini görmek için benimle iletişime geçerek Meta, Google ve site analitiğinin (GA4 dahil) bütünleşik bir tabloda toplanmasını konuşabiliriz; çünkü tek bir platformun verisine bakarak verilen kararlar çoğu zaman yanıltıcı oluyor.
Sık Yapılan Hatalar (Deneyimden Notlar)
Sahada en sık karşılaştığım hataları kısaca toparlayayım; bunlardan kaçınmak kurulumunuzun yarısıdır:
- event_id’yi eşlememek: Piksel ve CAPI farklı event_id gönderince dönüşüm sayıları şişiyor. En kritik ve en yaygın hata.
- Sadece CAPI’ye geçip pikseli kaldırmak: İkisi birbirini tamamlar; pikseli kaldırmak retargeting ve tarayıcı sinyallerini zayıflatır.
- value/currency göndermemek: Algoritma getiri optimizasyonu yapamaz.
- Eşleştirme parametrelerini eksik göndermek: Sadece olay gönderip e-posta/telefon eklememek, Match Quality’yi düşürür.
- Kurulumu test etmeden bütçe açmak: Yanlış veriyle optimize edilen kampanya, paranızı yanlış kitleye harcar.
Sıkça Sorulan Sorular
CAPI kurarsam pikseli kaldırmalı mıyım?
Hayır, kesinlikle kaldırmayın. CAPI pikselin yerine geçen değil, onu tamamlayan bir çözümdür. İdeal kurulumda ikisi birlikte çalışır; piksel tarayıcı sinyallerini (özellikle retargeting için) sağlar, CAPI ise çerez kayıplarına rağmen verinin sunucu üzerinden eksiksiz akmasını garantiler. Deduplication mekanizması da zaten çift sayımı önler.
CAPI kurmak teknik bilgi gerektiriyor mu?
Seçtiğiniz yönteme bağlı. Shopify, WooCommerce gibi platformların hazır partner entegrasyonlarıyla teknik bilgi neredeyse hiç gerekmeden kurabilirsiniz. Server-side GTM ve doğrudan sunucu entegrasyonu ise orta-ileri seviye teknik bilgi ister. İşletme altyapısına göre en pratik yolu seçmek önemli; emin değilseniz partner entegrasyonuyla başlayıp ihtiyaç büyüdükçe GTM’e geçebilirsiniz.
Deduplication tam olarak nasıl çalışır?
Piksel ve CAPI, aynı olay için aynı event_id ve event_name bilgisini gönderir. Meta bu iki kaydı alır, aynı kimliğe sahip olduklarını görür ve bunları tek bir olay olarak sayar; diğerini eler. Bu sayede hem tarayıcıdan hem sunucudan veri gelse bile dönüşümünüz çift sayılmaz. Çalışmasının şartı, iki tarafta da event_id’nin birebir aynı üretilmesidir.
CAPI ile gönderilen kişisel veriler güvenli mi?
Evet. E-posta, telefon gibi eşleştirme parametreleri Meta’ya düz metin olarak değil, SHA-256 ile hash’lenerek (şifrelenerek) gönderilir. Meta ham veriyi göremez, yalnızca şifrelenmiş halini kendi verisiyle karşılaştırır. Yine de KVKK kapsamında kullanıcılardan açık rıza almalı ve gizlilik politikanızda bu veri paylaşımını belirtmelisiniz; bu sizin sorumluluğunuzdadır.
Event Match Quality skorum düşük, ne yapmalıyım?
Olaylarınızla birlikte daha fazla ve daha doğru eşleştirme parametresi gönderin. Özellikle e-posta ve telefon numarası güçlü sinyallerdir; bunları eklemek skoru hızla yükseltir. Ayrıca fbp ve fbc çerez parametrelerinin de iletildiğinden emin olun. Telefon numarasının ülke koduyla, e-postanın küçük harfle ve boşluksuz gönderildiğini kontrol edin; format hataları eşleştirmeyi düşürür.
Kurulumun doğru çalıştığını nasıl anlarım?
Meta Olaylar Yöneticisi’ndeki üç aracı kullanın: “Test Events” ile olayların gerçek zamanlı geldiğini görün, olay detayında “Deduplicated/Processed” durumunu kontrol edin ve “Diagnostics” sekmesinden uyarıları takip edin. Eğer olaylar hem tarayıcı hem sunucu kaynağından geliyor ve eşleşiyorsa, Match Quality skoru iyi seviyedeyse kurulumunuz sağlıklı demektir.
