Meta CAPI Deduplication Hataları

Meta CAPI kurulu ama purchase verisi hâlâ yanlışsa event_id, eventID, event_name ve Events Manager kontrol adımlarını izle.

Kısa cevap: Meta CAPI deduplication, aynı kullanıcı aksiyonunun hem Meta Pixel hem de Conversions API üzerinden iki kez gönderildiğinde tek bir olay olarak sayılmasını sağlar. E-ticarette en kritik kullanım alanı Purchase event'idir. Browser tarafındaki eventID ile server tarafındaki event_id aynı değilse Meta aynı siparişi iki ayrı purchase gibi okuyabilir.

Deduplication neden gerekir?

Meta, Pixel ve CAPI'yi birlikte kullanmayı önerir; bu redundant setup veri dayanıklılığını artırır. Ama aynı olay iki kanaldan gidiyorsa Meta'nın bunların aynı aksiyon olduğunu anlaması gerekir. Resmi dokümana göre önerilen yöntem, aynı kullanıcı aksiyonu için browser event'inde eventID, server event'inde event_id göndermek ve event adını da eşleştirmektir.

Browser Pixel	Conversions API	Eşleşme şartı
`eventID`	`event_id`	Aynı benzersiz değer
`event`	`event_name`	Aynı event adı, örnek: `Purchase`
Sayfa URL'i	`event_source_url`	Website eventleri için doğrulanmış domain ile uyumlu
Tarayıcı zamanı	`event_time`	Event'in gerçek gerçekleşme zamanı

En yaygın 7 CAPI deduplication hatası

Hata	Belirti	Çözüm
Browser `eventID` ile server `event_id` farklı	Purchase sayısı şişer	İki tarafta aynı sipariş ID'sini veya aynı üretilmiş UUID'yi kullan
Event adı farklı	Deduplication çalışmaz	Browser `Purchase`, server `Purchase` göndermeli
Order ID her sayfa yenilemede değişiyor	Aynı sipariş tekrar sayılır	Thank-you sayfasında kalıcı transaction ID kullan
Server event çok geç gidiyor	Event eşleşmesi bozulur	Queue gecikmesini izle; event_time gerçek olaya yakın olmalı
Browser event hiç gitmiyor, sadece server gidiyor	Deduplication değil, server-only ölçüm olur	Bu bilinçli tercihse sorun değil; iki kanal birlikteyse eşleştir
Birden fazla Pixel aynı event'i gönderiyor	Events Manager'da kaynak karmaşası	Tek Pixel ID ve tek purchase tetikleyici standardı kur
Consent reddinde server event devam ediyor	KVKK ve güven riski	CMP kararını server event akışına da taşı

Purchase event için doğru event ID modeli

Purchase için en pratik model, transaction_id veya sipariş numarasını deduplication ID olarak kullanmaktır. Meta'nın server event parametreleri dokümantasyonu da purchase gibi doğal ID'si olan eventlerde order number veya transaction ID'nin kullanılabileceğini belirtir. Dikkat: aynı kullanıcı iki ayrı sipariş verdiyse iki farklı event_id gerekir; aynı sipariş F5 ile tekrar yüklendiyse aynı event_id korunmalıdır.

Browser Pixel · Purchasefbq('track', 'Purchase', {
  value: 1499,
  currency: 'TRY'
}, {
  eventID: 'ORDER_12345'
});

Conversions API · Purchase{
  "event_name": "Purchase",
  "event_time": 1779115200,
  "event_id": "ORDER_12345",
  "action_source": "website",
  "event_source_url": "https://example.com/tesekkur",
  "custom_data": {
    "currency": "TRY",
    "value": 1499
  }
}

Events Manager'da nasıl kontrol edilir?

Meta Events Manager'da ilgili Pixel'i aç.
Test Events ekranında test siparişi oluştur.
Aynı sipariş için browser ve server event'lerinin geldiğini kontrol et.
Event adlarının aynı olduğundan emin ol: Purchase / Purchase.
Browser event eventID ve server event event_id değerlerini karşılaştır.
Diagnostics bölümünde duplicate, missing event_id veya poor match quality uyarılarını not al.
24 saat sonra Aggregated Event Measurement ve purchase sayısını GA4/ödeme paneliyle kıyasla.

Bu hata ROAS ve CPA'yı nasıl bozar?

Duplicate purchase varsa Meta paneli gelir ve satın alma sayısını olduğundan yüksek gösterebilir. Bu durumda ROAS iyi görünür ama gerçek ödeme paneli aynı şeyi söylemez. Tersi senaryoda, server event hiç gitmiyor veya event_id eşleşmediği için event kalitesi düşükse algoritma eksik sinyal alabilir; bu da CPA teşhisini zorlaştırır. Bu yüzden CAPI kontrolü sadece teknik kurulum değil, medya bütçesi kararıdır.

Önce genel mimariyi anlamak istersen server-side tracking nedir notundan başla. Meta tarafındaki sonuç etkisini görmek için Meta Ads CPA neden artıyor rehberini ve Meta CPA case study sayfasını da okuyabilirsin.

Kaynaklar

Meta CAPI deduplication hakkında sıkça sorulanlar

Meta CAPI deduplication için event_id şart mı?

Meta event_id alanını optional gösterir, fakat Pixel ve CAPI aynı olayı birlikte gönderiyorsa deduplication için önerilen yöntem event_id ile event_name eşleşmesidir. Browser tarafındaki eventID ile server tarafındaki event_id aynı olmalıdır.

Purchase event duplicate olursa ne olur?

Purchase duplicate olursa Meta panelinde satış ve ROAS şişebilir, kampanya optimizasyonu yanlış sinyalle beslenebilir ve bütçe kararları hatalı alınabilir. Özellikle aynı sipariş için browser ve server event'i farklı ID ile gidiyorsa risk yükselir.

Event deduplication ne kadar süre içinde çalışır?

Meta dokümantasyonuna göre aynı event_id ve event_name kombinasyonu browser ve server tarafından 48 saat içinde gelirse deduplication uygulanabilir. Geç veya farklı ID ile gelen event'lerde duplicate riski devam eder.