Hızlı özet
- Conversion API, satın alma gibi olayları tarayıcı yerine sunucudan Meta'ya gönderir; Pixel'in kaçırdığı olayları tamamlar.
- Pixel'i kaldırmayın: Meta ikisinin birlikte kullanılmasını önerir.
- Aynı olay iki kanaldan geldiğinde ortak event_id ile tekilleştirilmezse satışlar çift sayılır.
- Eşleşme kalitesi (Event Match Quality) ne kadar yüksekse Meta doğru kişiyi o kadar iyi bulur.
- Kurulumdan sonra mutlaka test edin: Events Manager'daki satın alma sayısı mağaza siparişlerine yakın olmalı.
Conversion API nedir?
Meta Conversion API (kısaca CAPI), sitenizde gerçekleşen olayları (ürün görüntüleme, sepete ekleme, ödeme başlatma, satın alma) sunucudan sunucuya Meta'ya ileten bir bağlantıdır. Meta Pixel ise aynı olayları ziyaretçinin tarayıcısında çalışan bir kodla gönderir.
Tarayıcı tarafı her geçen yıl daha kırılgan: reklam engelleyiciler Pixel'i durdurabiliyor, Safari gibi tarayıcılar çerez ömrünü kısaltıyor, mobil cihazlardaki izleme kısıtlamaları sinyali azaltıyor. CAPI tarayıcıya bağlı olmadığı için bu kayıpların bir kısmını telafi eder.
Pixel ve Conversion API farkı
| Meta Pixel | Conversion API | |
|---|---|---|
| Nerede çalışır? | Ziyaretçinin tarayıcısında | Sitenin ya da altyapının sunucusunda |
| Reklam engelleyiciden etkilenir mi? | Evet | Hayır |
| Güçlü olduğu yer | Tarayıcı davranışı, çerez bilgileri (fbp, fbc) | Kesinleşmiş satış, sipariş tutarı, müşteri bilgileri |
| Kurulum | Kod veya platform entegrasyonu | Platform entegrasyonu, server-side GTM veya API |
Doğru kurulum "Pixel mi, CAPI mi?" değil, "Pixel ve CAPI birlikte, tekilleştirilmiş" kurulumdur. Pixel tarayıcıdaki bağlamı, CAPI kesinleşmiş satışı taşır.
Tekilleştirme: çift sayımı önleyen kural
Pixel ve CAPI aynı satın almayı birlikte gönderdiğinde, Meta'nın bunların tek bir satış olduğunu anlaması gerekir. Bunun için iki kanaldan gelen olayın aynı olay adını (örneğin Purchase) ve aynı olay kimliğini (event_id, genellikle sipariş numarası) taşıması gerekir. Meta, kısa bir süre içinde gelen bu eşleşen olayları tek olay olarak sayar.
event_id eksikse ya da iki tarafta farklıysa, her satış iki kez sayılır. Sonuç: reklam paneli olduğundan iki kat iyi görünür, algoritma yanlış sinyalle öğrenir ve bütçe kararları yanlış verilir.
Event Match Quality: Meta kişiyi ne kadar iyi tanıyor?
Event Match Quality (eşleşme kalitesi), gönderdiğiniz olayların Meta kullanıcılarıyla ne kadar iyi eşleştiğini gösteren 10 üzerinden bir puandır ve Events Manager'da her olay için ayrı görünür. Puanı yükselten parametreler şunlar:
- Müşteri bilgileri: e-posta, telefon, ad-soyad, şehir. Meta'ya karma (SHA-256 hash) formatında gönderilir.
- Tarayıcı kimlikleri:
fbp(Meta çerezi) vefbc(reklam tıklama kimliği). Sunucu olayına tarayıcıdan taşınması gerekir. - Teknik bilgiler: ziyaretçinin IP adresi, tarayıcı bilgisi (user agent) ve müşteri kimliği (external_id).
Eşleşme ne kadar iyiyse Meta, satın alan kişiyi o kadar doğru tanır ve benzerlerini o kadar iyi bulur.
ikas ve Shopify'da Conversion API kurulumu
İki altyapıda da CAPI için kod yazmanız gerekmez; yerleşik entegrasyonlar işin büyük kısmını yapar. Panel adımları platform güncellemeleriyle değişebildiği için aşağıdaki akışı bir kontrol listesi olarak kullanın.
ikas
ikas panelindeki Meta entegrasyonunda Pixel kimliğinizi girin ve Conversion API için Events Manager'da oluşturduğunuz erişim belirtecini (access token) ekleyin. Ardından olayların hem tarayıcıdan hem sunucudan geldiğini Events Manager'da doğrulayın.
Shopify
Shopify'ın Facebook & Instagram (Meta) uygulamasını bağlayın ve müşteri verisi paylaşım ayarını en kapsamlı seviyeye getirin; bu seviye Conversion API'yi de devreye alır. Temaya elle eklenmiş eski Pixel kodlarını kaldırın.
Erişim belirteci, Meta Events Manager'da ilgili Pixel'in Ayarlar sekmesindeki Conversions API bölümünden oluşturulur. Altyapının yerleşik entegrasyonu yetmediğinde (özel bir altyapı, birden fazla domain ya da gelişmiş veri ihtiyacı) server-side Google Tag Manager veya doğrudan API entegrasyonu kullanılır.
Kurulumdan sonra 5 adımlık test
- Test olayları: Events Manager'daki Test Events ekranını açıp sitede bir ürün görüntüleyin, sepete ekleyin ve test siparişi verin. Olayların anlık düştüğünü görün.
- Bağlantı yöntemi: Purchase olayının hem tarayıcıdan (Browser) hem sunucudan (Server) geldiğini kontrol edin.
- Tekilleştirme: Olay ayrıntılarında tekilleştirmenin çalıştığını, yani iki kanaldan gelen olayın tek sayıldığını doğrulayın.
- Değer ve para birimi: Satın alma tutarının doğru geldiğini, para biriminin TRY olduğunu ve KDV dahil/hariç tercihinizin her yerde aynı olduğunu kontrol edin.
- Mağaza ile karşılaştırma: Birkaç gün boyunca Events Manager'daki günlük Purchase sayısını mağazadaki sipariş sayısıyla karşılaştırın. İkisi birbirine yakın olmalı.
En sık yapılan 6 hata
- Çift Pixel. Altyapı entegrasyonu açıkken temada ya da Google Tag Manager'da eski bir Pixel kodu da çalışıyor; her olay iki kez gidiyor.
- Eşleşmeyen event_id. Tarayıcı ve sunucu farklı kimlik gönderiyor; tekilleştirme çalışmıyor.
- Yanlış değer. Para birimi eksik, tutar kargo veya KDV tercihine göre tutarsız; ROAS hesapları baştan yanlış.
- Tekrar tetiklenen Purchase. Teşekkür sayfası her yenilendiğinde satın alma olayı yeniden gönderiliyor.
- Zayıf eşleşme. Sunucu olaylarında e-posta, telefon, fbp ve fbc gönderilmiyor; Event Match Quality düşük kalıyor.
- Süresi dolan ya da silinen erişim belirteci. Sunucu olayları sessizce kesiliyor ve kimse fark etmiyor. Events Manager uyarılarını düzenli kontrol edin.
Parfüm markası Anymo Paris'te büyüme çalışmasının ilk adımı bu tür ölçüm hatalarını gidermekti; sonuçları vaka analizimizde anlattık.
Lead toplayan işletmeler için: CRM'den Meta'ya geri bildirim
Satış sitede değil sonradan (telefonla, görüşmede, mağazada) gerçekleşiyorsa, Meta yalnızca form dolduranı görür ve her formu eşit değerde sanar. Conversion API ile CRM'deki "nitelikli müşteri" ya da "satışa dönüştü" bilgisini Meta'ya geri gönderdiğinizde, algoritma form dolduran herkesi değil gerçekten satışa dönen kişileri bulmayı öğrenir. Bu kurgunun sonuçlarını kozmetik markası Luminis Paris'in vaka analizinde görebilirsiniz.
Ölçüm doğru, sıradaki soru: hangi rakama bakmalı?
CAPI kurulduğunda Meta'nın raporladığı satış sayısı artar; bu iyi bir şey ama platformun kendi rakamı her zaman mağaza gerçeğinin yerini tutmaz. Kararları toplam ciro ve toplam reklam harcamasıyla da kontrol etmenin neden önemli olduğunu ROAS mı Blended ROAS mı? yazımızda anlattık.
Sıkça sorulan sorular
Conversion API kurunca Pixel'i kaldırmalı mıyım?
Hayır. Meta, Pixel ile Conversion API'nin birlikte kullanılmasını önerir. Pixel tarayıcıdaki davranışı yakalar, CAPI ise tarayıcının kaçırdığı olayları sunucudan tamamlar. İkisi aynı olayı gönderdiğinde ortak bir event_id ile tekilleştirilir.
Meta Conversion API ücretli mi?
Meta tarafında ücretsizdir. ikas ve Shopify'ın yerleşik entegrasyonlarında ek maliyet çıkmaz; server-side Google Tag Manager gibi kendi sunucunuzu gerektiren kurulumlarda ise sunucu maliyeti oluşur.
Çift sayım olup olmadığını nasıl anlarım?
Events Manager'daki günlük Purchase olay sayısını aynı günün mağaza sipariş sayısıyla karşılaştırın. Olay sayısı sipariş sayısından belirgin şekilde fazlaysa çift sayım, belirgin şekilde azsa eksik ölçüm vardır. Events Manager'da olayın hem tarayıcıdan hem sunucudan geldiğini ve tekilleştirmenin çalıştığını da kontrol edin.
Event Match Quality nedir, kaç olmalı?
Event Match Quality, gönderdiğiniz olayların Meta kullanıcılarıyla ne kadar iyi eşleştiğini gösteren 10 üzerinden bir puandır. E-posta, telefon, fbp ve fbc gibi parametreleri eksiksiz göndermek puanı yükseltir. Satın alma olayında Meta'nın iyi ya da daha üstü olarak gösterdiği seviyeyi hedefleyin.
Conversion API KVKK'ya uygun mu?
CAPI veriyi sunucudan gönderir ama bu, aydınlatma ve açık rıza yükümlülüklerini ortadan kaldırmaz. Müşteri bilgileri Meta'ya karma (hash) formatında gönderilir; yine de çerez ve veri aktarımı izinlerinizi sitenizin onay yönetimiyle uyumlu kurgulayın ve hukuk danışmanınızla teyit edin.
Lead toplayan işletmeler CAPI'yi nasıl kullanır?
Form dolduran kişinin CRM'de nitelikli müşteri ya da satışa dönüştüğü bilgisini Conversion API ile Meta'ya geri gönderebilirsiniz. Böylece Meta, form dolduran herkesi değil gerçekten satışa dönen kişileri bulmayı öğrenir.