Meta CAPI event_id ile Pixel Dedup Nasıl Yapılır?

Meta Pixel ve Meta Conversions API’yi birlikte kullandığınızda en sık sorun, aynı etkileşimin iki kez raporlanmasıdır. Bu durum özellikle optimizasyon hedeflerinde bütçeyi ve ROAS yorumlarını etkiler. Çözüm, Meta’nın deduplication mantığıyla uyumlu biçimde event_id ve event_name eşleşmesini doğru kurgulamaktır. Bu yazı, sadece dedup ana problemine odaklanarak uygulanabilir bir yol haritası sunar. Konuya bütüncül yaklaşımı Fora Growth sunar.

Meta Pixel ve CAPI çift sayım neden oluşur

Meta Pixel ve CAPI aynı kullanıcı etkileşimini farklı kanallardan ilettiğinde, Meta bu etkileşimi ayrı olaylar olarak görebilir. Pixel tarayıcıdan gelir; CAPI ise sunucu tarafında gönderilir. Zamanlama farklılıkları, yeniden deneme mekanizmaları veya tarayıcı olayının gecikmesi, aynı “gerçekleşti” anının iki kez işlenmesine yol açabilir. Sonuç olarak raporlarda dönüşüm sayısı şişer, kampanya öğrenmesi bozulur ve hedefleme modelleri yanlış sinyaller görür. Bu yüzden dedup yapılandırması ölçüm doğruluğunun çekirdeğidir.

Meta dedup mantığı, Pixel ve CAPI’nin aynı olayı temsil ettiğini anlaması üzerine kuruludur. Kaynak içgörüsü, dedup için her event’te hem event_name hem de event_id gönderilmesi gerektiğini vurgular. Bu ayrıntı pratikte şunu gerektirir: Aynı kullanıcı davranışı tetiklendiğinde, server ve browser tarafında aynı event_id üretilmeli ve aynı event_name ile birlikte iletilmelidir. Aksi hâlde Meta event’i eşleştiremeyebilir ve iki ayrı dönüşüm kaydı oluşabilir. Dedup başarısı, doğru kimliklendirme disiplinine bağlıdır.

• event_deduplication için Pixel ve CAPI olaylarında aynı event_id ve aynı event_name kullanın
• event_id üretimini deterministik ve senkron olacak şekilde tasarlayın; rastgele ama farklı değer üretmeyin
• event_name değerlerini sabitleyin; aynı aksiyon için farklı yazımlar kullanmayın
• tek kullanıcıda tek dönüşüm akışıyla test edin; raporlarda çift kayıt oluşup oluşmadığını kontrol edin
• loglarda event_name ve event_id alanlarını birlikte doğrulayın; eşleşme yoksa dedup çalışmayabilir

event_deduplication mantığı: event_id + event_name eşleşmesi

Meta Conversions API event_deduplication, Pixel’den gelen dönüşüm ile CAPI’den gelen dönüşümün aynı olduğunu ispatlamaya çalışır. Bunun için event_id ve event_name eşleşmesi kritiktir. event_id tek başına çoğu senaryoda yeterli olmayabilir; çünkü event_name farklıysa Meta event’i farklı tür dönüşüm sayabilir. Bu nedenle aynı kullanıcı aksiyonu gerçekleştiğinde event_name’i de aynı değerle, aynı semantik anlamla iletmeniz gerekir. Dedup hedefi, raporlama katmanında çift girişin tek girişe indirgenmesini sağlamaktır.

Kaynak, dedup için event’lerin hem event_id hem de event_name ile etiketlenmesi gerektiğini ortaya koyar. Buradan pratik bir uygulama çıkarımı yapılabilir: event_id üretiminizi tek bir mantıkla standardize edin ve Pixel ile CAPI’nin her ikisine de aynı event_id’yi ulaştırın. Örneğin, bir sipariş verisi varsa sipariş numarası temel alınabilir ya da etkileşimi tanımlayan deterministik bir anahtar türetilebilir. Ayrıca event_name değerlerinin birebir aynı kalması önemlidir; farklı sayfalarda aynı aksiyon için bile tutarlılık sağlanmalıdır.

event_id’yi tek kaynaktan üretme ve iletmeyi tasarlama

event_id’nin başarısında asıl konu, Pixel ve CAPI tarafında aynı event_id’nin gerçekten aynı anda üretilmesidir. Bunun için en sağlam yöntem, tek bir kaynakta oluşturulan event_id’nin hem browser’a hem de sunucuya taşınmasıdır. Örneğin checkout başlangıcında tarayıcıda üretilen event_id, aynı akışın sunucu tarafına da gönderilerek CAPI olayında kullanılmalıdır. Tam tersine, sunucuda üretilen event_id’nin de Pixel’e geri taşındığı bir tasarım mümkün olabilir. Kritik nokta, event_id’yi “benzer” üretmek değil, aynı üretmek ve aynı event_name ile eşleştirmektir.

event_id üretiminde deterministik olma ilkesi iş görür. Rastgele ama senkronize olmayan değerler dedup’u zayıflatır; çünkü eşleşme olmaz. Dönüşümün anahtarı olan veriyi (sipariş id, lead id, abonelik id gibi) kullanarak kararlı bir event_id türetmek çoğu işletmede daha iyi sonuç verir. Ayrıca event_name değerlerini sabitleyin; örneğin “Purchase” yerine bir yerde “PurchaseEvent” gibi farklı yazımlar kullanmayın. event_deduplication’in çalışması, bu iki alanın tutarlılığına dayanır. Böylece çift raporlama yerine tek kayıt oluşur.

Uygulamada doğrulama: dedup gerçekten çalışıyor mu?

Dedup yapılandırmasını doğru yaptığınızdan emin olmak için test ve doğrulama adımlarını ölçüm katmanında gerçekleştirin. Aynı kullanıcı davranışını hem Pixel hem de CAPI tetiklerken, raporlarda tek dönüşüm kaydı görmeniz beklenir. Bu aşamada event_name ve event_id alanlarının loglarda gerçekten eşleştiğini kontrol edin. Eğer iki dönüşüm hâlâ görünüyorsa, genellikle ya event_id üretimi senkron değildir ya da event_name değerleri farklıdır. Basit bir senaryo üzerinden gidip, tek kullanıcıda tek satın alma akışını tekrar ederek tutarsızlığı yakalayın.

Doğrulama sırasında zamanlama farklılıklarına da bakın. CAPI olayları belirli gecikmelerle gelebilir; bu normaldir, ancak event_id eşleşmesi korunmalıdır. Ayrıca yeniden denemeler nedeniyle aynı CAPI olayı farklı isteklerle gönderilebilir; bu, dedup’un doğru çalışmasını engellemez, fakat event_id’nin aynı kalması gerekir. Kaynak içgörüsü, dedup’un event_name ve event_id eşleşmesiyle anlaşılacağını desteklediği için, log seviyesinde bu iki alanı birlikte incelemek en verimli yaklaşımdır. Tutarlı eşleşme varsa, çift sayım azalmalıdır.

Karşılaşılan tipik hatalar ve düzeltme yaklaşımı

En yaygın sorunlardan biri event_id’nin farklı formatlarda üretilmesidir. Örneğin bir tarafta “ORDER-123” gibi bir değer kullanırken diğer tarafta sadece “123” göndermek eşleşmeyi bozar. Bir diğer hata, event_name alanında küçük değişikliklerdir: aynı aksiyon için “Lead” yerine “generate_lead” gibi farklı isimler kullanmak Meta’nın event’leri eşleştirmesini engelleyebilir. Ayrıca event_id’nin yalnızca bir kanalda ayarlanması, diğer kanalda otomatik oluşturulmuş farklı bir event_id ile sonuçlanabilir. Bu durumda Meta iki ayrı dönüşüm yakalayabilir.

Düzeltme yaklaşımı, önce alan tutarlılığını sağlamaktır: event_name değerlerini tek bir sözlükten yönetin ve event_id üretimini deterministik hale getirin. Ardından Pixel ve CAPI tarafında aynı event_id’nin taşındığını doğrulayın. Bazı ekipler browser tarafında oluşturulan event_id’yi sunucu tarafına aktarmayı atlar; dedup hedefi bu nedenle kaçırılır. Kaynak içgörüsüyle uyumlu biçimde, dedup için her event’te event_name ve event_id birlikteliğini koruyun. Son olarak raporlamada görünen dönüşüm türlerini karşılaştırın; çift sayımı azaltmak için öncelikle doğru eşleşen event çiftlerini hedefleyin.

Uygulama desteği için Meta Ads Yönetimi hizmetini inceleyebilirsiniz.

Kaynak: Adobe Experience League (Meta CAPI event deduplication için event_id + event_name şartı).