Meta Deduplication: Pixel ve CAPI'de event_id Nasıl Kullanılır?
Meta deduplication nasıl çalışır? Pixel ve Conversions API olaylarını event_id ile tekilleştirme, 48 saat kuralı, GTM kurulumu ve Olay Yöneticisi kontrolü.
Meta deduplication (olay tekilleştirme), aynı kullanıcı eyleminin Meta Pixel’den ve Conversions API’den gelen iki kopyasını Meta’nın tek olay olarak saymasıdır. Bunun için iki olayda aynı olay adı ve aynı event_id bulunmalıdır. Pixel tarafında bu kimlik eventID adıyla fbq çağrısının dördüncü parametresine yazılır.
Bu yazıda tekilleştirmenin nasıl çalıştığını, hangi değerin event_id olarak seçileceğini ve kurulumu Google Tag Manager ile nasıl yaptığımı anlatıyorum. Son bölümde, kurulumun doğru çalıştığını Olay Yöneticisi’nde nasıl doğruladığımı paylaşıyorum.
Pixel ve Conversions API olayları neden çift sayılır?
Pixel ve Conversions API olayları, aynı eylem iki ayrı yoldan Meta’ya ulaştığı ve Meta bu iki kopyayı birbirine bağlayamadığı için çift sayılır. Meta, en iyi reklam performansı için Conversions API’nin Pixel ile birlikte kullanılmasını öneriyor ve bu yapıya “redundant setup”, yani yedekli kurulum diyor.[1] Aynı belge, yedekli kurulum kullanan reklamverenin bir tekilleştirme yöntemi kurması gerektiğini de açıkça yazıyor.
Yedekli kurulumun mantığı basit. Tarayıcıdaki Pixel, reklam engelleyici, sayfanın erken kapanması ya da çerez onayı yüzünden bazı olayları kaçırır. Sunucu ise siparişin ya da başvurunun kesin kaydını görür. İki kaynak birlikte daha eksiksiz bir tablo verir. Ancak her iki kaynak da çalıştığında aynı satış iki kez gelir.
Tekilleştirme yoksa sonuç doğrudan raporlara yansır. Ads Manager’daki satın alma sayısı, mağaza panelindeki sipariş sayısından belirgin biçimde yüksek görünür. ROAS olduğundan iyi görünür ve teklif algoritması gerçekte olmayan dönüşümlerle beslenir. Meta, iki kaynaktan da aynı olayı göndermeyen reklamverenlerin o olaylar için tekilleştirme kurmasına gerek olmadığını da belirtiyor.[1]
Meta deduplication nasıl çalışır?
Kısa cevap
Meta deduplication nasıl çalışır?
Meta, tarayıcıdan gelen olaydaki eventID ve olay adını, sunucudan gelen olaydaki event_id ve event_name ile karşılaştırır. Aynı Pixel kimliğine 48 saat içinde gelen ve iki değeri de eşleşen olaylardan sonra geleni atar. Olaylar içerik olarak belirgin farklı değilse Meta genellikle ilk alınan olayı tercih eder.
Meta’nın tekilleştirme belgesi iki yöntem tanımlıyor ve birincisini öneriyor.[1] İki yöntem de aynı türden bir şeyi karşılaştırır: tarayıcı olayıyla sunucu olayını. Farkları, hangi alanı anahtar olarak kullandıklarında ve hangi sırada çalıştıklarındadır.
Olay adı + event_id (önerilen)
- Pixel'de eventID, sunucuda event_id aynı değeri taşır
- Olay adları birebir eşleşir
- Olayların geliş sırası önemli değildir
- 48 saatlik pencere içinde çalışır
Olay adı + fbp ya da external_id
- İki tarafta aynı fbp ya da external_id gönderilir
- Olay adları birebir eşleşir
- Genellikle yalnızca önce tarayıcı, sonra sunucu olayı geldiğinde çalışır
- Tek kaynaktan art arda gelen olayları atmaz
event_id yönteminin kuralları
Meta’nın belgesine göre bir olayın tekilleştirilmesi için iki koşul gerekir. Pixel’deki eventID, Conversions API’deki event_id ile eşleşmelidir. Pixel’deki olay adı da Conversions API’deki event_name ile eşleşmelidir.[1] İki koşul da aynı Pixel kimliğine gönderilen olaylar için geçerlidir.
Zamanlama da kuralın bir parçasıdır. Meta, aynı anahtar çiftini 48 saat içinde görürse sonraki olayları atıyor. Sunucu olayı parametre belgesi bir ayrıntı daha ekliyor: Sunucu ve tarayıcı olayları yaklaşık aynı anda, yani birbirinden 5 dakika içinde gelirse Meta tarayıcı olayını tercih ediyor.[2]
fbp ve external_id yönteminin sınırları
İkinci yöntemde Meta, olay adını fbp ve/veya external_id değeriyle birlikte karşılaştırır. Bu yöntemin sınırı önemlidir. Meta’ya göre genellikle yalnızca tarayıcı olayı önce, sunucu olayı sonra geldiğinde çalışır.[1] Son 48 saatte bir tarayıcı olayı alınmadıysa sunucu olayı atılmaz; tarayıcı olayı sonradan gelse bile.
Aynı belge, yalnızca tek kaynak kullanıldığında bu yöntemin tekilleştirme yapmadığını da belirtiyor. Art arda gelen iki tarayıcı olayı ya da iki sunucu olayı aynı bilgiyi taşısa bile ikisi de tutuluyor.[1] Bu yüzden ben fbp ve external_id değerlerini eşleşme kalitesi için her olayda gönderiyorum, ama tekilleştirmeyi event_id’ye bırakıyorum.
event_id olarak hangi değer kullanılmalı?
event_id, aynı eylem için tarayıcıda ve sunucuda aynı olan, farklı eylemler için ise asla tekrar etmeyen bir değer olmalıdır. Meta’nın sunucu olayı belgesi, sipariş numarasını ya da işlem kimliğini iyi örnekler olarak gösteriyor.[2] Örneğin 123 ve 456 numaralı iki sipariş, iki ayrı event_id ile gönderilir ve Meta bunları iki ayrı satın alma olarak ayırır.
Olay türüne göre seçimim şöyle:
| Olay | event_id kaynağı | Dikkat edilecek nokta |
|---|---|---|
| Purchase | Sipariş numarası | Teşekkür sayfası yenilenirse Pixel aynı numarayla tekrar tetiklenir; tekilleştirme bunu yakalar |
| Lead | Form gönderiminde üretilen UUID | Aynı UUID hem fbq çağrısına hem sunucuya giden isteğe yazılmalı |
| InitiateCheckout | Sepet ya da ödeme oturumu kimliği + zaman damgası | Kullanıcı ödemeye iki kez girerse iki ayrı olay olabilir |
| CRM’den gelen sonraki olaylar | CRM kayıt numarası + aşama adı | Pixel karşılığı yoksa tekilleştirme gerekmez; kimlik yine benzersiz olmalı |
Tarayıcıda UUID üretmek için crypto.randomUUID() yeterlidir. Bu fonksiyon modern tarayıcılarda yerleşik olarak bulunur (MDN belgesi). Asıl iş, üretilen değeri sunucuya kaybetmeden taşımaktır.
Pixel ve CAPI tekilleştirmesi nasıl kurulur?
Kısa cevap
Pixel ve CAPI tekilleştirmesi nasıl kurulur?
Pixel ve CAPI tekilleştirmesi, her eylem için tek bir kimlik üretip bu kimliği Pixel’de eventID, Conversions API’de event_id olarak göndermekle kurulur. İki tarafta olay adı da birebir aynı olmalıdır. Kurulumdan sonra Olay Yöneticisi’nde tek bir test olayıyla eşleşme doğrulanır.
- Her dönüşüm eylemi için tek bir benzersiz kimlik üret.
- Kimliği dataLayer'a ya da sipariş kaydına yaz.
- Pixel çağrısında kimliği eventID olarak dördüncü parametreye ekle.
- Sunucu olayında aynı değeri event_id alanına yaz.
- İki tarafta olay adını birebir aynı tut.
- Test Events ekranında tek bir test olayıyla eşleşmeyi doğrula.
Pixel tarafında eventID, fbq çağrısının isteğe bağlı dördüncü parametresidir.[1] Olay value ve currency gibi parametreler taşımıyorsa üçüncü parametre boş nesne olarak bırakılır:
// Satın alma: sipariş numarası eventID olarak kullanılır
fbq('track', 'Purchase', { value: 1250, currency: 'TRY' }, { eventID: 'order-10482' });
// Lead: parametre yoksa üçüncü argüman boş nesne
fbq('track', 'Lead', {}, { eventID: leadEventId });
// Sayfada birden fazla Pixel varsa yalnızca birine göndermek için
fbq('trackSingle', 'PIXEL_ID', 'Purchase', { value: 1250, currency: 'TRY' }, { eventID: 'order-10482' });
Görsel etiketle (image pixel) çalışan kurulumlarda aynı değer eid parametresiyle verilir.[1] Sunucu tarafında ise aynı değer olayın event_id alanına yazılır:
{
"data": [{
"event_name": "Purchase",
"event_time": 1763640000,
"event_id": "order-10482",
"action_source": "website",
"event_source_url": "https://ornek.com/tesekkurler/",
"user_data": { "em": ["<sha256>"], "fbp": "fb.1.1763639000000.123456789", "client_user_agent": "…" },
"custom_data": { "value": 1250, "currency": "TRY" }
}]
}
Google Tag Manager ile çalışıyorsan akış genellikle şöyle kurulur. Ben bu kurulumları web kapsayıcısı ve server-side GTM birlikte olacak şekilde yapıyorum:
- Kimliği dataLayer'a yaz
Sipariş ya da form gönderimi olayında event_id değerini dataLayer'a ekle. Satın almada sipariş numarasını, formda gönderim anında üretilen UUID'yi kullan.
- Web kapsayıcısında değişken oluştur
dataLayer'daki event_id için bir Data Layer Variable tanımla. Bu değişkeni yalnızca bir yerden besle; etiket içinde ayrıca kimlik üretme.
- Pixel etiketine eventID ver
Meta Pixel etiketinde ya da özel HTML kodunda bu değişkeni eventID alanına bağla. Olay adını standart olay adıyla aynı yaz.
- Aynı değeri sunucu kapsayıcısına taşı
Sunucuya giden GA4 ya da özel istekte event_id parametresini gönder. Sunucu kapsayıcısındaki Conversions API etiketinde bu parametreyi event_id alanına eşle.
- Olay adlarını hizala
Tarayıcıda Purchase gönderiliyorsa sunucuda da Purchase gönder. GA4 olay adı purchase olsa bile Meta etiketinde standart Meta adına çevir.
- Test et
Test Events ekranında bir test siparişi ver. Aynı olayın tarayıcı ve sunucu kopyalarının tek olay olarak birleştiğini kontrol et.
Shopify ve benzeri platformların yerleşik Meta entegrasyonları kimliği genellikle kendileri üretir. Bu durumda ikinci bir Pixel ya da elle eklenmiş bir sunucu etiketi, entegrasyonun kimliğini bilmediği için çift sayım yaratır. Önce sitede hangi kaynakların aynı olayı gönderdiğini listelemek gerekir.
Tekilleştirme doğru çalışıyor mu, nasıl kontrol edilir?
Tekilleştirme, Olay Yöneticisi’nde ilgili olayın detayındaki Event Deduplication sekmesinden kontrol edilir. Meta’nın doğrulama belgesine göre bu sekme iki bilgi gösteriyor: her kaynaktan gelen olayların tekilleştirilme oranı ve her tekilleştirme anahtarının kullanım oranı.[3] Tekilleştirme oranı düşük kaldığında ekranda bir uyarı da çıkıyor.
Aynı sekmedeki Overlap (örtüşme) değeri, belirli bir anahtarla gelen olayların hem tarayıcıdan hem sunucudan alınan payıdır. Meta bu oranı, daha az olay gönderen kaynağa göre hesaplıyor. Düşük örtüşme, iki şeyden birine işaret ediyor: Bir ya da iki taraf benzersiz olmayan anahtar gönderiyor ya da anahtar yalnızca tek kaynaktan geliyor.[3]
Kontrol ederken şu ayrımı yapıyorum:
- Genel Bakış sayıları: Meta’nın belgesine göre Genel Bakış’taki olay sayısı, tekilleştirme ve politika nedeniyle atılan olaylardan önceki ham sayıdır.[3] Bu sayının sipariş sayısından yüksek olması tek başına sorun değildir.
- Olayların görünme süresi: Meta, gönderilen olayların yaklaşık 20 dakika içinde Olay Yöneticisi’nde doğrulanabileceğini söylüyor.[3] Test sonucunu daha erken okumak yanıltabilir.
- Gecikmeli sunucu olayları:
event_timeen fazla 7 gün geriye gidebilir, ama tekilleştirme penceresi 48 saattir.[2] Toplu gönderim yapan bir sunucu olayı bu iki süre arasında kalırsa, kopya ayrı olay olarak sayılabilir.
Tekilleştirmede en sık yapılan hatalar nelerdir?
Tekilleştirmede en sık hata, iki tarafın farklı kimlik ya da farklı olay adı göndermesidir. Bu hataların çoğu kurulum sırasında değil, sonradan yapılan bir site ya da etiket değişikliğiyle ortaya çıkar. Benim karşılaştığım tipik durumlar şunlar:
- Büyük-küçük harf farkı: Tarayıcıda
Purchase, sunucudapurchasegönderilir. Olay adı eşleşmediği için iki kopya ayrı sayılır. - Her etikette yeni kimlik: Kimlik etiket içinde üretilir ve tarayıcı ile sunucu ayrı değer alır.
- Sabit ya da boş kimlik: Tüm olaylar aynı
event_idile gider. Bu durumda Meta farklı siparişleri de tek olay sayabilir ve dönüşümler eksik görünür. - Pixel’i kapatmak: Çift sayımı çözmek için Pixel tamamen kaldırılır. Bu, Meta’nın önerdiği yedekli kurulumu bozar ve tarayıcı sinyallerini kaybettirir.
- Yeniden denemede yeni kimlik: Başarısız bir sunucu isteği yeni bir
event_idile tekrar gönderilir. Yeniden denemede her zaman ilk kimlik kullanılmalıdır.
Hasta ya da müşteri verisi taşıyan her sunucu olayında, tekilleştirme ayarından bağımsız olarak KVKK kurallarına uymak gerekir. E-posta ve telefon gibi alanlar SHA-256 ile hashlenmeli, aydınlatma metni ve gerekiyorsa açık rıza süreci tamamlanmış olmalıdır. Pixel tarafındaki tetiklemenin çerez onayına bağlanması da Consent Mode v2 ve onay yönetimi kurgusunun bir parçasıdır.
Sonuç
Meta deduplication, yedekli kurulumun doğru sayım vermesi için zorunlu olan adımdır. Kural kısadır: Aynı eylem için iki tarafta aynı olay adı, aynı event_id ve 48 saatten kısa bir aralık. Bu kural sağlanmadığında Pixel ile Conversions API’yi birlikte kullanmak, ölçümü iyileştirmek yerine ROAS’ı olduğundan yüksek gösterir.
Kuruluma yeni başlıyorsan önce Meta Conversions API yazısındaki temel yapıyı, ardından Meta Pixel kurulumu rehberindeki olay ayarlarını gözden geçir. Tekilleştirme oturduktan sonraki adım, Event Match Quality puanını yükseltmektir. Sunucu tarafı ölçümün genel çerçevesi için server-side tracking yazısına, bu işleri birlikte yürüttüğüm performans pazarlama hizmetine de göz atabilirsin.
Bu yazıdaki terimler
- event_id
- event_id, Conversions API olayına reklamverenin verdiği ve aynı eylemi benzersiz biçimde tanımlayan bir kimliktir. Meta, Pixel'deki eventID ile sunucudaki event_id aynıysa ve olay adları eşleşiyorsa iki kopyayı tek olay sayar. Satın almalarda genellikle sipariş numarası kullanılır.
- Tekilleştirme anahtarı
- Tekilleştirme anahtarı, Meta'nın tarayıcı ve sunucu olaylarının aynı eylem olduğunu anlamak için karşılaştırdığı alan birleşimidir. Önerilen anahtar olay adı ile event_id çiftidir; alternatif olarak olay adı ile fbp ya da external_id kullanılabilir.
- Yedekli kurulum
- Yedekli kurulum (redundant setup), aynı olayların hem tarayıcıdaki Meta Pixel ile hem de sunucudan Conversions API ile gönderildiği ölçüm yapısıdır. Meta bu yapıyı öneriyor; ancak iki kaynaktan gelen kopyaların tekilleştirilmesi için ortak bir anahtar gerekir.
Sık sorulan sorular
Meta deduplication nedir?
Meta deduplication, aynı kullanıcı eyleminin hem Meta Pixel'den hem Conversions API'den gelen iki kopyasını Meta'nın tek olay olarak saymasıdır. Meta, iki olayın aynı olay adını ve aynı event_id değerini taşıyıp taşımadığına bakar. Eşleşen kopyalardan genellikle ilk geleni tutar.
event_id olarak ne kullanılmalı?
Meta, satın almalar için sipariş numarası ya da işlem kimliği gibi tekrar etmeyen bir değer öneriyor. Form ve lead olaylarında, gönderim anında üretilen ve hem tarayıcıya hem sunucuya aynı şekilde verilen bir UUID iyi çalışır. Önemli olan, değerin iki tarafta birebir aynı ve her eylem için benzersiz olmasıdır.
Meta iki sunucu olayını da tekilleştirir mi?
Meta'nın tekilleştirme belgesi, Pixel ile Conversions API arasındaki kopyaları birleştirmeyi anlatıyor. fbp ya da external_id yöntemi için ise aynı kaynaktan art arda gelen iki olayın atılmadığını açıkça belirtiyor. Bu yüzden sunucu tarafında yeniden deneme yaparken aynı olayı yeni bir kimlikle göndermemek gerekir.
Tekilleştirme ne kadar süre içinde çalışır?
Meta, belirli bir event_id ile ilk olayı aldıktan sonraki 48 saat içinde gelen eşleşen olayları tekilleştirir. Bu sürenin dışında gelen bir kopya ayrı olay olarak sayılabilir. Sunucu olayını günler sonra gönderen kurulumlarda bu sınır çift sayım riskini artırır.
Tekilleştirmenin çalıştığı nereden anlaşılır?
Olay Yöneticisi'nde ilgili olayın detayındaki Event Deduplication sekmesi, her kaynaktan gelen olayların ne kadarının tekilleştirildiğini ve hangi tekilleştirme anahtarını taşıdığını gösterir. Overlap değerinin düşük olması, anahtarın bir tarafta eksik ya da tutarsız olduğuna işaret eder. Test Events ekranında tek bir test siparişiyle de kontrol yapılabilir.
Kaynaklar
Konunun tamamı: Meta Ads rehberi ↗ · Tracking rehberi ↗