Meta Pixel ve Conversions API: Olay Eşleştirme Rehberi

Meta Conversions API, tarayıcıdan gelen Meta Pixel olaylarını sunucu verileriyle tamamlayabilir. Aynı işlemin iki kez sayılmasını önlemek için iki kaynaktan da aynı olay adını ve olay kimliğini göndermeniz gerekir.

Kurulumdaki asıl risk, eksik ölçüm kadar fazla dönüşüm sayılmasıdır. Yanlış eşleştirme, satış gerçekleşmediği hâlde reklam raporlarınızda yüksek performans görmenize neden olabilir.

Sağlıklı reklam yönetimi için önce veri kaynaklarının görevini ayırmalı, ardından olay kimliğini üretimden teste kadar tutarlı taşımalısınız.

Meta Pixel ve Conversions API arasındaki fark

Meta Pixel (önceki adıyla Facebook Pixel), web sitenizde çalışan JavaScript koduyla olayları kullanıcının tarayıcısından gönderir. Bu yaklaşım, istemci tarafı izleme (client-side tracking) veya tarayıcı tabanlı izleme (browser-based tracking) olarak adlandırılır.

Conversions API, kısaca CAPI, olayları sunucunuzdan doğrudan Meta’ya iletir. Facebook Conversions API, ayrı bir ürün değil, aynı çözüm için kullanılan başka bir addır. Bu yöntem, sunucu tarafı izleme (server-side tracking) olarak bilinir.

İki yöntemin görevlerini şöyle ayırabilirsiniz:

Özellik	Meta Pixel	Conversions API
Veri kaynağı	Kullanıcının tarayıcısı	Sunucu, platform veya CRM
Temel kullanım	Sayfa ve kullanıcı etkileşimleri	Satış, form ve arka uç olayları
Başlıca sınırlama	Reklam engelleyiciler ve tarayıcı kısıtları	Kaynak verinin ve entegrasyonun doğruluğu
Kurulum	JavaScript veya platform entegrasyonu	Bağlayıcı ya da sunucu entegrasyonu
Birlikte kullanım	Tarayıcı sinyali sağlar	İkinci veri aktarım kanalı sağlar

Reklam engelleyiciler (ad blockers), çerez kısıtlamaları ve iOS gizlilik güncellemeleri (iOS privacy updates) Pixel verisini azaltabilir. CAPI, sunucuda mevcut olan olayları aktararak tarayıcı kaynaklı kayıpları azaltmanıza yardımcı olur. Ancak bütün kayıpları gidermez ve kullanıcı izinlerini geçersiz kılmaz.

Meta, iki yöntemin birlikte kullanılmasını önerir. Pixel, hedef kitle oluşturma ve yeniden pazarlama için değerlidir. CAPI ise ödeme sistemi veya CRM tarafından doğrulanmış sonuçları göndermenizi sağlar.

Bu ayrım, performans pazarlama raporlarında tıklama ile gerçek ticari sonucu birbirinden ayırmanızı kolaylaştırır.

Olay planını işletmenizin hedeflerine göre kurun

Etiket eklemeden önce hangi işlemin başarı sayılacağını tanımlayın. Sayfa görüntüleme, form gönderimi ve satış aynı iş değerini taşımaz. Kampanyanızın optimizasyon hedefi, işletmenizin elde etmek istediği sonuçla örtüşmelidir. Meta’nın standart olayları hedefinizi karşılamıyorsa, uygun ad ve parametrelerle custom events tanımlayın; her biri gerçek bir iş sonucunu temsil etsin.

E-ticarette satın alma anını netleştirin

ViewContent, AddToCart, InitiateCheckout ve Purchase, alışveriş sürecinin farklı aşamalarını gösterir. Purchase olayını ödeme veya sipariş sisteminizde tanımladığınız başarılı işlem koşuluna bağlayın.

Teşekkür sayfasının açılması tek başına güvenilir satış kanıtı olmayabilir. Sayfa yenilendiğinde aynı siparişin yeniden gönderilmesini önleyin. Satın alma değerini ve para birimini iki kaynakta aynı iş kuralıyla hesaplayın.

Kargo, vergi ve indirimlerin tutara nasıl yansıtılacağını da baştan belirleyin. Böylece reklam geliriyle sipariş raporunuzu karşılaştırırken kapsam farklarını açıklayabilirsiniz.

Hizmet işletmelerinde başvuru ile satışı ayırın

Form düğmesine basılması yerine başarılı form kaydını Lead olarak ölçün. Telefon veya WhatsApp düğmesine tıklanmasını da tamamlanmış satışla eşitlemeyin.

CAPI, CRM integration (CRM entegrasyonu) ile CRM’deki uygun aşamaları ve offline conversions (çevrimdışı satışları) aktarmanıza imkân verir. Desteklenen veri yapılarıyla müşteri yaşam boyu değeri gibi bilgileri de kullanabilirsiniz.

Dönüşüm optimizasyonunu yalnızca başvuru sayısına bağlamayın. Başvurunun niteliğini ve satışa dönüşme durumunu ayrı izleyin.

Olay eşleştirme: event_id ile çift sayımı önleyin

Tekilleştirme (event deduplication), aynı kullanıcı işlemi Pixel ve CAPI üzerinden iki kez ulaşsa da tek olay olarak değerlendirilir. Bunun için olayların aynı veri kaynağına gönderilmesi ve eşleştirme alanlarının tutarlı olması gerekir.

Olay kimliğini bir kez üretin

Satın alma gerçekleştiğinde benzersiz bir olay kimliği oluşturun. Aynı kimliği hem tarayıcıya hem sunucu gönderimine taşıyın. UUID kullanabilir veya işlem kimliğini olay türüyle birlikte benzersizleştirebilirsiniz.

Pixel’deki eventID ve CAPI’deki event_id alanları aynı event ID değerini taşımalıdır. Alan adları farklı olsa da değer aynı olmalıdır.

Tarayıcı ve sunucuda birbirinden bağımsız kimlik üretmeyin. İki farklı UUID, aynı satın almayı temsil etse bile eşleşmez. İletim hatası nedeniyle yeniden gönderim yapıyorsanız ilk olayın kimliğini koruyun.

Kimliği yalnızca sayfa yüklenirken üretmek de sorun çıkarabilir. Siparişin tamamlanma kaydında saklanan kimlik, sayfa yenilemelerinde ve sunucu tekrarlarında daha tutarlı bir yapı sağlar.

Olay adını ve işlem kapsamını koruyun

Kimlik eşleşmesinin yanında olay adı da aynı olmalıdır. Tarayıcıda Purchase, sunucuda farklı yazılmış bir olay adı kullanmayın. Büyük ve küçük harfleri tutarlı gönderin.

Pixel olay kimliği eşleştirmesi hakkındaki teknik tartışma, kimliğin iki gönderimde paylaşılması gereken değer olduğunu somutlaştırır.

Aynı kimliği bütün ziyaretçilerde veya bütün olay türlerinde kullanmayın. Sepete ekleme ile satın alma farklı işlemlerdir ve ayrı kimlikler gerektirir.

Sunucu isteğini yeniden denerken yeni event_id üretirseniz aynı işlem ikinci kez sayılabilir ve duplicate events (yinelenen olaylar) oluşabilir.

Ayrıca value, currency ve işlem kapsamını karşılaştırın. Tekilleştirme doğru çalışsa bile farklı tutarlar gönderirseniz gelir raporunuz güvenilir olmaz.

Kurulum seçenekleri: Shopify, WordPress ve özel altyapı

Kurulum yöntemini mevcut platformunuza ve bakım kapasitenize göre seçin. Hazır entegrasyonun karşıladığı ihtiyacı özel yazılımla tekrar kurmanız gerekmeyebilir.

Shopify’da veri paylaşımını yapılandırın

Shopify’ın Meta satış kanalındaki müşteri veri paylaşımı ayarlarında Standard, Enhanced ve Maximum seçenekleri bulunur. Standard Pixel kullanır; Enhanced ve Maximum seçenekleri Pixel ile CAPI’yi birlikte kullanır.

Shopify’ın Meta Pixel kurulum rehberi, platform üzerinden kurulum ve yeniden pazarlama ilişkisini açıklar.

Doğru veri kaynağını bağlayın. Tema kodu veya başka uygulamalar üzerinden eklenmiş ikinci bir Pixel kurulumu bırakmayın.

WordPress ve WooCommerce’de tek entegrasyon kullanın

Pixel ve CAPI desteği olan entegrasyonun hangi olayları gönderdiğini belirleyin. Aynı Purchase olayını hem eklentiden hem Google Tag Manager üzerinden bağımsız biçimde göndermeyin.

Önbellek, ödeme yönlendirmeleri ve sipariş durumu değişikliklerini test kapsamına alın. Tema veya ödeme eklentisi güncellendiğinde satın alma akışını yeniden deneyin. Çalışan temel kod, satış olayının da doğru çalıştığı anlamına gelmez.

Özel altyapıda sunucu sorumluluğunu ayırın

Manuel Pixel kurulumu, temel JavaScript kodunun site başlığına eklenmesiyle başlar. Dönüşüm olayları ayrıca yapılandırılır.

CAPI için sunucu entegrasyonu, platform bağlayıcısı veya sunucu taraflı etiketleme gerekir. Erişim anahtarını tarayıcı koduna koymayın. Gönderim hataları için kayıt ve kontrollü yeniden deneme mekanizması kurun.

Kurumsal web tasarım projenizde olay kimliğinin ödeme sistemiyle birlikte planlanması, sonradan yapılacak düzeltmeleri azaltır. Nexasignal’da Meta Conversion API kurulumu kapsamında olay planını, tekilleştirmeyi ve izin kontrollerini birlikte değerlendiriyoruz.

Events Manager’da test ve tanılama

Test sırasında yalnızca olayın ulaşıp ulaşmadığına bakmayın. Kaynağını, kimliğini, değerini ve eşleşme durumunu da inceleyin.

1. Events Manager’da ilgili veri kaynağını açın ve Test Events bölümüne geçin. Tarayıcı testiyle sitenizde hedef işlemi gerçekleştirin.
2. CAPI testinde panelin verdiği test_event_code değerini sunucu isteğine ekleyin. Test tamamlandığında bu geçici parametreyi canlı gönderimden kaldırın.
3. Gelen olay ayrıntılarında tarayıcı ve sunucu kaynaklarını karşılaştırın. Olay adının ve kimliğinin aynı olduğunu doğrulayın.
4. Olay adı veya kimliği eşleşmiyorsa Pixel ve sunucu payload’larını kontrol edin. İki payload’da da olay adı ile kimliğin aynı olduğundan emin olun.
5. Diagnostics bölümündeki parametre ve kurulum uyarılarını inceleyin. Olay ayrıntılarındaki tekilleştirme ve eşleşme kalitesi bilgilerini ayrıca değerlendirin.

Başarılı gönderim yanıtı, tek başına doğru ölçüm anlamına gelmez. Yanlış tutar veya hatalı olay kimliği de teknik olarak kabul edilmiş bir istekte bulunabilir.

Normal ödeme akışının yanında sayfa yenileme, başarısız ödeme ve yeniden gönderim senaryolarını deneyin. İzin reddedildiğinde gönderim davranışının belirlediğiniz kurallara uyduğunu da test edin.

Canlıya geçtikten sonra veri doğruluğunu (data accuracy) kontrol etmek için sipariş sistemiyle olay sayılarını aynı tarih aralığında karşılaştırın. Events Manager’da olay görülmesi, olayın mutlaka bir reklama atfedileceği anlamına gelmez.

Event Match Quality ve kullanıcı izinleri

Event Match Quality, kısaca EMQ, sunucu olaylarıyla gönderdiğiniz müşteri bilgilerinin Meta hesaplarıyla eşleşme kalitesini gösterir. Events Manager’da ilgili web olayları için 0 ile 10 arasında puanlanır.

Eşleşme kalitesini doğru verilerle geliştirin

İzinli ve mevcut müşteri bilgilerinin doğru biçimde gönderilmesi eşleşmeye yardımcı olabilir. E-posta ve telefon gibi alanları Meta’nın biçimlendirme kurallarına uygun hazırlayın.

Uygun olduğunda fbp, fbc, IP adresi ve kullanıcı aracısı gibi alanları da entegrasyon kapsamına alın. Eksik değerleri uydurmayın. Bulunmayan reklam tıklaması bilgisini varmış gibi üretmeyin.

EMQ ile tekilleştirmeyi ayrı değerlendirin. Yüksek eşleşme puanı, aynı satışın iki kez sayılmadığını kanıtlamaz. Düşük puan da olayın hiç ulaşmadığı anlamına gelmez. Önce hangi bilginin eksik veya hatalı olduğunu ayırın.

Hashing, izin yönetiminin yerine geçmez

Meta’nın gerektirdiği müşteri alanlarını uygun normalizasyon sonrasında SHA-256 ile hash’leyin. Platform entegrasyonunuz bu işlemi yapıyorsa aynı veriyi ikinci kez hash’lemeyin.

Hashing veriyi otomatik olarak anonim hâle getirmez. KVKK ve kapsamınıza giriyorsa GDPR yükümlülüklerini ayrıca değerlendirin. Reklam amaçlı veri aktarımını gerekli kullanıcı izinlerine bağlayın.

Sağlık bilgileri gibi hassas verileri olay adlarına, URL parametrelerine veya özel alanlara taşımayın. Form alanlarını topluca CAPI’ye aktarmak yerine yalnızca gerekli ve uygun alanları gönderin.

Bu sınırlar, yapay zekâ pazarlama veya AI marketing uygulamalarınızda kullanacağınız müşteri verileri için de geçerlidir.

Küçük işletmeler için maliyet ve önceliklendirme

Conversions API kullanımı için Meta ayrıca API ücreti almaz. Ancak sunucu, bulut barındırma, entegrasyon sağlayıcısı ve bakım maliyetleri oluşabilir.

Stape’in Meta CAPI Gateway paketi, Pixel başına aylık 10 ABD doları karşılığında 10 milyon olaya kadar kullanım sunar. Bu ücret sağlayıcının paketine aittir, Meta’nın API kullanım bedeli değildir. GTM sunucu konteyneri barındırması da ayrı bir üründür.

Google Tag Manager ile sunucu taraflı etiketleme, birden fazla platforma veri gönderecekseniz değerlendirilebilir. Yalnızca Meta olaylarını gönderecekseniz hazır platform bağlantısı daha az bakım gerektirebilir. Entegrasyon kararını reklam harcamasını (ad spend) belirlemeden önce kapsamı dikkate alarak verin.

CAPI, arama motoru optimizasyonu sağlamaz veya organik trafiği doğrudan artırmaz. SEO uzmanınızın teknik SEO ve sayfa hızı çalışmalarını ölçüm entegrasyonundan ayrı değerlendirin. Gereksiz etiket tekrarlarının mobil performansı bozmasını önleyin.

Google Ads kullanıyorsanız Meta’ya gönderdiğiniz olayların Google’a otomatik aktarılmadığını unutmayın. Google Ads dönüşüm takibi kurulumu için ayrı yapılandırma gerekir. Kanallar arasında aynı satışın raporlanmasıyla aynı kanal içinde çift sayım yapılmasını birbirine karıştırmayın.

Öne çıkan noktalar

• Aynı işlemi Pixel ve CAPI üzerinden gönderirken olay adını ve kimliğini ortak kullanın.
• EMQ puanını, tekilleştirme durumunu ve satış tutarını ayrı kontrollerle değerlendirin.
• Kurulum maliyetine barındırma, bakım ve hata takibini de ekleyin.

Dijital pazarlama raporunuzda temel referansınız sipariş veya CRM kaydı olsun. Reklam platformundaki dönüşüm, bu kaydın ölçüm ve atıf kurallarıyla değerlendirilmiş karşılığıdır.

Sık sorulan sorular

Tek başıma çalışıyorsam CAPI gerekli mi?

Düzenli dönüşüm odaklı reklam veriyorsanız ve platformunuz hazır entegrasyon sunuyorsa birlikte kullanım anlamlıdır. Özel sunucu kurulumuna yatırım yapmadan önce mevcut bağlantıyı değerlendirin. Düşük işlem hacminde önceliğiniz, az sayıdaki olayın bile doğru gönderilmesi olmalıdır.

Conversions API, ROAS’ı hemen artırır mı?

Hayır. Daha tutarlı veri, kampanya optimizasyonunu destekleyebilir; ancak teklifinizi, reklam içeriğinizi veya satış sayfanızı düzeltmez. Etkiyi değerlendirirken kurulum öncesi çift sayımın raporlanan ROAS’ı şişirip şişirmediğini de hesaba katın. Daha doğru ölçüm başlangıçta daha düşük sonuç gösterebilir.

CAPI kurduktan sonra Pixel’i kaldırmalı mıyım?

Genellikle birlikte kullanım tercih edilir. Pixel tarayıcı etkileşimlerini, CAPI ise sunucuda kayıtlı sonuçları aktarır. Entegrasyonunuzun aynı olayları doğru eşleştirdiğinden emin olun. Pixel’i kaldırmak yerine gereksiz veya yinelenen kurulumları temizleyin; her olayın hangi sistemden gönderildiğini kayıt altında tutun.

Sonuç: Her işlemi tutarlı biçimde ölçün

Meta Pixel ve Conversions API kurulumunda önceliğiniz, her gerçek işlemi tek ve tutarlı dönüşüm verisine dönüştürmek olmalı. Ortak olay kimliği, doğru parametreler ve izin yönetimi bu yapının temelidir.

Önce satın alma veya nitelikli başvuru akışınızı test edin. Ardından ölçüm altyapınızı kampanya hedeflerinizle birlikte geliştirin.

Kurulumdan raporlamaya uzanan ihtiyaçlarınız için Dijital pazarlama stratejinizi birlikte planlayalım.