Conversion API (Meta'nın Türkçe arayüzündeki adıyla Dönüşümler API'si) sitenizdeki satış, form ya da sepete ekleme olaylarını sunucunuzdan doğrudan Meta'ya gönderen bağlantıdır. Meta Pixel aynı olayları ziyaretçinin tarayıcısında çalışan bir kodla yollar. Meta ikisini birlikte kullanmanızı önerir. Aynı olay iki kanaldan ulaştığında Meta ortak olay kimliğine bakıp onu bir kez sayar.
Conversion API nedir, ne işe yarar?
Conversion API reklamverenin kendi sunucusundan, e-ticaret altyapısından, mobil uygulamasından ya da CRM (müşteri ilişkileri yönetimi) sisteminden Meta'ya olay verisi taşımaya yarayan sunucudan sunucuya bir bağlantıdır. Addaki API uygulama programlama arayüzü anlamına gelir. Sektörde kısaca CAPI denir. Meta bu veriyi reklamın kime gösterileceğini optimize etmek ve kampanya sonuçlarını ölçmek için kullanır.
Sunucudan gelen olaylar pikselle aynı veri kümesine bağlanır. Events Manager'da aynı piksel kimliğinin altında görünür, raporlamada da tarayıcı olaylarıyla aynı biçimde işlenir. Reklam hesabınız açısından bir satın alma olayının hangi kanaldan geldiği fark etmez, önemli olan olayın eksiksiz ulaşmasıdır.
CAPI'yi pikselden ayıran ikinci özellik kapsamıdır. Piksel yalnız sitede olan biteni görür. Sunucu bağlantısı ise uygulama olaylarını, mağazada gerçekleşen satışları, CRM'de sonradan nitelendirilen başvuruları ya da WhatsApp sohbetinde kapanan siparişleri de Meta'ya iletebilir.
Meta Pixel nedir, nasıl çalışır?
Meta Pixel sitenizin sayfalarına eklenen ve ziyaretçinin tarayıcısında çalışan bir JavaScript kodudur. Eski adı Facebook Pixel'dir. Sayfa açıldığında PageView olayını gönderir. Ziyaretçi bir ürünü incelediğinde ya da sepete eklediğinde ViewContent, AddToCart gibi standart olayları iletir.
Piksel ilk ziyarette sitenizin alan adına _fbp adlı bir çerez yazar. Ziyaretçi bir Meta reklamına tıklayarak geldiyse adresteki fbclid parametresini _fbc çerezine kaydeder. Bu iki kimlik olayın hangi tarayıcıya ve hangi reklam tıklamasına ait olduğunu bulmaya yarar.
Pikselin ikinci görevi kitle biriktirmektir. Sepeti yarıda bırakanlara ya da ürün sayfasını gezenlere yeniden reklam göstermek bu kodun topladığı ziyaret verisine dayanır. Piksel her zaman reklam veren şirketin işletme portföyünde oluşturulmalıdır. Portföyün nasıl açılıp yetkilerin nasıl verildiğini Meta Business Manager kurulumunu anlattığımız yazıda bulabilirsiniz.
Conversion API ile Meta Pixel arasındaki fark ne?
Temel fark olayı kimin gönderdiğidir: pikselde ziyaretçinin tarayıcısı, Conversion API'de sizin sunucunuz. Diğer farkların çoğu bu tek ayrımdan doğar.
| Konu | Meta Pixel | Conversion API |
|---|---|---|
| Çalıştığı yer | Ziyaretçinin tarayıcısı | Sunucunuz, e-ticaret altyapınız ya da CRM sisteminiz |
| Reklam engelleyici ile çerez kısıtları | Olayın hiç gitmemesine yol açabilir | Olayın gönderimini etkilemez ama tarayıcı kimlikleri eksik kalabilir |
| Gönderebildiği olaylar | Yalnız sitede tarayıcıda gerçekleşen eylemler | Site, uygulama, fiziksel mağaza, CRM ile mesajlaşma olayları |
| Gönderim zamanı | Eylem anında | Anlık ya da toplu olarak; olay zamanı en fazla 7 gün geriye yazılabilir |
| Kişiyle eşleştirme | Çerezleri ile tarayıcı bilgisini kendiliğinden ekler | Sizin eklediğiniz e-posta, telefon, IP ya da tarayıcı kimliğiyle eşleşir |
| Kurulum emeği | Kod parçası ya da platform ayarı | Hazır entegrasyon, bulut sunucusu ya da yazılım ekibi |
| Bozulma riski | Tema değişikliği ya da kodun sayfadan düşmesi | Sipariş sistemi güncellemesi ya da geçersiz kalan erişim anahtarı |
Tablodaki farklar iki aracın birbirine rakip olmadığını gösterir. Meta'nın geliştirici belgeleri de Dönüşümler API'sinin pikselin yanında kullanılmasını ve aynı olayların iki araçla da gönderilmesini önerir. Yalnız sunucu olaylarıyla çalışmak teknik olarak mümkündür. O durumda tarayıcının kendiliğinden eklediği sinyaller kaybolur, eşleşme için gereken her bilgiyi sunucunuzun toplaması gerekir.
Piksel hangi olayları kaçırır?
Piksel tarayıcıda hiç çalışamadığı ya da çalışması yarıda kaldığı her durumda olayı kaçırır. Kurulum denetimlerinde kayıpların çoğunu şu altı durumda görüyoruz:
- Reklam engelleyici eklentinin Meta'nın kod dosyasını ya da isteğini durdurması
- Ziyaretçinin çerez panelinde pazarlama çerezlerini reddetmesi
- Ödemenin başka bir alan adındaki sayfada tamamlanması, ziyaretçinin teşekkür sayfasına hiç dönmemesi
- Sipariş onay sayfası yüklenmeden sekmenin kapatılması ya da bağlantının kopması
- Bazı tarayıcıların izleme korumalarının çerez ömrünü kısaltması ya da tıklama kimliğini adresten silmesi
- Satışın sitede değil telefonda, mağazada ya da CRM'de günler sonra kapanması
Bu kayıpların bir kısmını CAPI kapatır, hepsini değil. Çerez reddi en önemli istisnadır: ziyaretçi pazarlama çerezlerine izin vermediyse aynı veriyi sunucudan göndermek verilmeyen rızanın dolanılması anlamına gelebilir. Kişisel Verilerin Korunması Kanunu'nu (KVKK) uygulayan Kurumun Çerez Uygulamaları Hakkında Rehberi reklam amaçlı çerezleri açık rıza gerektiren grupta sayar. Sunucu olaylarını çerez onayına bağlayıp bağlamayacağınızı hukuk danışmanınızla netleştirmenizi öneririz.
Tarayıcı ve sunucu olayları nasıl tek sayılır?
Tarayıcı ile sunucudan gelen aynı olayı Meta olay adına ve olay kimliğine bakarak tekilleştirir. Pikselde gönderilen eventID değeri sunucudaki event_id ile birebir aynı olmalıdır. Olay adı da iki tarafta aynı yazılmalıdır. Meta'nın tekilleştirme belgesine göre eşleştirme ilk olayın alınmasından sonraki 48 saat içinde gelen olaylar için yapılır.
Pratikte en sağlam kimlik sipariş numarasıdır. Örneğin 10452 numaralı sipariş için tarayıcı da sunucu da "purchase_10452" değerini gönderirse Meta bunu tek satın alma olarak kaydeder. Denetimlerde en sık rastladığımız hata iki tarafın kimliği ayrı ayrı üretmesidir. Piksel rastgele bir değer, sunucu sipariş numarasını yolladığında olaylar eşleşmez ve satın almalar raporda neredeyse iki kat görünür.
Olay kimliği gönderilemeyen kurulumlar için Meta tarayıcı kimliğine (fbp) ya da harici kimliğe (external_id) dayanan ikinci bir yöntem de sunar. Önerilen yol yine olay kimliğidir.
Eşleşme kalitesi puanı neyi gösterir?
Eşleşme kalitesi puanı sunucu olayındaki müşteri bilgilerinin olayı bir Meta hesabıyla eşleştirmeye ne kadar yettiğini 10 üzerinden gösterir. Puan Events Manager'da her sunucu olayı için ayrı hesaplanır.
Puanı besleyen bilgiler iki gruba ayrılır. E-posta, telefon, ad, soyad ya da şehir gibi alanlar gönderilmeden önce SHA-256 ile hash'lenir. IP adresi, tarayıcı bilgisi ile fbc ve fbp değerleri ise hash'lenmeden gönderilir. Satın alma olayına yalnız IP ile tarayıcı bilgisi ekleyen bir kurulumun puanı, sipariş formundaki e-postayı da gönderen kurulumdan genellikle daha düşük kalır.
Düşük puan olayın sayılmadığı anlamına gelmez. Olayın doğru kişiye bağlanma ihtimalinin zayıf olduğunu, bu yüzden optimizasyona daha az katkı verdiğini gösterir. Hash'lenmiş bilgi de kişiyle eşleştirmek amacıyla paylaşılır. Hangi alanların gönderileceğine aydınlatma metninizle birlikte karar verin, bu kararı da hukuk danışmanınıza onaylatın.
Dönüşümler API'si hangi yollarla bağlanır?
Dönüşümler API'si dört ana yolla bağlanır ve seçim sitenizin altyapısına göre yapılır. Kurulum adımları her yolda farklı olduğu için burada yalnız seçenekleri tanıtıyoruz.
- Hazır platform entegrasyonu. Shopify, WooCommerce gibi altyapılarda Meta'nın uygulaması ya da eklentisi CAPI'yi birkaç ayarla açar. Altyapıların çoğunda ek ücret gerektirmez.
- Conversions API Gateway. Events Manager üzerinden kodsuz kurulan, sizin bulut hesabınızda çalışan bir sunucudur. Meta'ya göre tek maliyeti bulut kaynağı ya da iş ortağı ücretidir.
- Sunucu taraflı Google Tag Manager. Olay akışını tek merkezden yönetmek isteyen ekiplerin yoludur. Aynı olayı Meta'nın yanında GA4 gibi başka araçlara da dağıtabilir, barındırma gideri çıkarır.
- Doğrudan entegrasyon. Yazılım ekibiniz Events Manager'da üretilen erişim anahtarıyla olayları API'ye kendisi gönderir. En esnek seçenektir ama bakımı tamamen size aittir.
Hazır entegrasyonun kapsamı panele göre değişir. Bazı altyapılar satın almayı sunucudan gönderirken sepete ekleme olayını yalnız pikselle bırakır. Hangi olayın hangi kaynaktan geldiğini kurulumdan sonra mutlaka kontrol edin.
CAPI hangi işletmeler için gerekli?
CAPI satışı ya da başvurusu sitede ölçülen ve Meta'da düzenli reklam veren her işletme için gereklidir, ama ihtiyacın derecesi iş modeline göre değişir. Aşağıdaki karar tablosunu işletmelerle yaptığımız ön görüşmelerde kullanıyoruz:
| Durumunuz | Değerlendirme |
|---|---|
| Siteniz yok, siparişler yalnız Instagram mesajlarından geliyor | Piksel kurulacak bir sayfa yoktur. Sohbette kapanan satışı iletmek için mesajlaşma olaylarını destekleyen bir iş ortağı gerekir. |
| Shopify ya da WooCommerce mağazası, satış sitede kapanıyor | Hazır entegrasyonla CAPI'yi açın, ardından bir test siparişiyle çift sayım olmadığını doğrulayın. |
| Ödeme başka bir alan adında ya da uygulamada tamamlanıyor | Satın alma olayını sunucudan göndermek en güvenilir yoldur çünkü piksel onay sayfasını göremeyebilir. |
| Form topluyorsunuz, satış telefonda kapanıyor | Formu pikselle, CRM'de satışa dönen başvuruyu CAPI ile göndermek kampanyanın form sayısına değil nitelikli başvuruya bakmasına yardım eder. |
| Fiziksel mağazanız da var | Mağaza satışları çevrim dışı olay olarak CAPI ile gönderilir. Meta bu iş için eski ayrı API yerine Dönüşümler API'sini öneriyor. |
| Bütçe küçük, ayda birkaç dönüşüm alıyorsunuz | Önce pikselin doğru olayı doğru sayfada tetiklediğinden emin olun. Ayrı sunucu kurulumu bu ölçekte maliyetine değmeyebilir. |
Katalog reklamı kullanan mağazalarda sunucu olaylarındaki ürün kimliklerinin katalogdaki kimliklerle aynı olması gerekir. Bu eşleşmenin nasıl kontrol edildiğini Meta katalog reklamlarının kurulumunu anlattığımız yazıda ele aldık.
Conversion API'nin başka reklam platformlarında karşılığı var mı?
Evet. Conversion API'nin sunucudan olay gönderme mantığı büyük reklam platformlarının çoğunda var. TikTok'ta bu bağlantının adı Events API'dir. LinkedIn'de ise Meta'daki gibi Conversions API adını taşır.
Google Ads'te benzer işi gelişmiş dönüşümler görür. Sitenizde toplanan e-posta ya da telefon hash'lenerek dönüşümle birlikte Google'a iletilir. Ayarların nerede açıldığını Google Ads dönüşüm izleme kurulumu rehberimizde anlattık. Google etiketlerinin çerez onayına göre nasıl davrandığını ise Consent Mode v2 yazımızda bulabilirsiniz. Her platform dönüşümü kendi ilişkilendirme kuralıyla saydığı için Meta, Google ve GA4 rakamlarının birebir tutması beklenmez.
CAPI kurulumunun doğru çalıştığı nasıl anlaşılır?
Doğru çalışan bir kurulumda her önemli olay hem tarayıcıdan hem sunucudan gelir, raporda ise tek kez sayılır. Kurulum sonrasında şu yedi maddelik kontrol listesini kullanabilirsiniz:
- Events Manager genel bakış ekranında satın alma ya da potansiyel müşteri olayının bağlantı yöntemi olarak tarayıcı ile sunucuyu birlikte gösterdiğini görün.
- Test olayları sekmesinde bir deneme siparişi verin, iki kaynaktan gelen olayın aynı olay kimliğini taşıdığını kontrol edin.
- Olay ayrıntısındaki tekilleştirme bilgisini okuyun.
- Satın alma olayında tutar ile para biriminin doğru geldiğini doğrulayın.
- Eşleşme kalitesi puanını olay bazında izleyin, düşüşü fark ettiğinizde hangi müşteri bilgisinin kesildiğine bakın.
- Meta'nın bir haftalık satın alma sayısını sipariş panelinizle kıyaslayın. Aradaki farkın bir bölümü ilişkilendirme ayarından gelir.
- Tema, ödeme altyapısı ya da çerez aracı değiştiğinde bu listeyi baştan uygulayın.
Piksel ile sunucu olaylarınızın aynı satışı doğru sayıp saymadığından emin değilseniz altyapınıza göre planladığımız ölçüm kurulumunu da kapsayan Meta reklam yönetimi hizmetinin kapsamına göz atabilirsiniz.