Tanım
Fark, eventin anlamında değil gönderildiği yoldadır.
“Purchase” veya “Lead” gibi event adları işte gerçekleşen olayı tarif eder. Pixel bu olayı tarayıcı bağlamından, CAPI ise sunucu ya da bağlı iş sisteminden iletebilir. İki kanalın aynı iş olayını farklı zaman veya anlamla göndermesi raporu güvenilmez hâle getirir.
Bu nedenle kurulum, web sitesine kod yapıştırmakla başlamamalıdır. Önce hangi olayın optimizasyon sinyali olduğu, ne zaman kesinleştiği, hangi parametreleri taşıdığı ve iptal/iade gibi sonraki durumların nasıl ele alınacağı tanımlanmalıdır.
| Boyut | Meta Pixel | Conversions API |
|---|---|---|
| Kaynak | Kullanıcının tarayıcısı | Sunucu, platform, CRM, uygulama veya başka iş sistemi |
| Güçlü bağlam | Sayfa görüntüleme ve tarayıcı etkileşimi | Sunucuda kesinleşen veya daha sonra oluşan iş olayı |
| Etkilendiği alan | Tarayıcı yükleme hataları, bağlantı ve engelleyiciler | Sunucu entegrasyonu, veri kalitesi ve iş kuralı hataları |
| Bakım | Ön yüz ve etiket değişiklikleri | API, sunucu, veri eşleme ve izleme |
| Gizlilik | Geçerli politika ve izin gereksinimlerine tabidir | Aynı şekilde politika ve izin gereksinimlerine tabidir |
Ölçüm tasarımı
Her butonu dönüşüm yapmayın; iş değerini modelleyin.
Bir sayfayı açmak, formu başlatmak ve doğrulanmış talep göndermek aynı değer düzeyinde değildir. Kampanya optimizasyonunda çok erken ve düşük niyetli event seçmek, sistemi kolay ama iş açısından zayıf sonuca yönlendirebilir. Event merdivenini ziyaret → ilgi → niyet → doğrulanmış sonuç şeklinde kurun.
Event adı kadar tetik koşulu da belgelenmelidir. “Lead”, yalnız teşekkür sayfası açıldığında mı; sunucu formu kabul ettiğinde mi; yoksa CRM kaydı doğrulandığında mı oluşuyor? Cevap net değilse Pixel ile CAPI arasında tutarlılık kurulamaz.
| Event | Tetik koşulu örneği | Doğrulama |
|---|---|---|
| ViewContent | Ana hizmet veya ürün içeriği gerçekten görüntülendi | URL/öğe kimliği ve tek tetik |
| InitiateCheckout | Kullanıcı ödeme akışına geçti | Sepet ve para birimi tutarlı |
| Lead | Form sunucu tarafından başarıyla kabul edildi | Spam/tekrar ayrımı ve CRM kaydı |
| Purchase | Ödeme sağlayıcıdan başarı durumu döndü | Sipariş kimliği, değer, para birimi ve iade süreci |
Çift sayımı önleme
Aynı event iki kanaldan gidiyorsa tekilleştirme zorunlu bir tasarım konusudur.
Pixel ve CAPI aynı satın alma veya lead olayını ilettiğinde platformun bunları tek olay olarak eşleştirebilmesi gerekir. Bunun için aynı olayın tarayıcı ve sunucu kopyasında tutarlı event adı ile aynı benzersiz event kimliği kullanılır. Kimlik her sayfa yenilemede değil, gerçek iş olayı oluştuğunda üretilmelidir.
Tekilleştirmeyi yalnız arayüzde “deduplicated” etiketi görerek bırakmayın. Aynı siparişin bir kez, farklı siparişlerin ayrı ayrı sayıldığını; retry mekanizmasının yeni kimlik üretmediğini ve test eventlerinin production raporuna karışmadığını doğrulayın.
- Tarayıcı ve sunucu aynı iş olayı için aynı event_name kullanıyor.
- Aynı olayın iki kopyası aynı event_id değerini taşıyor.
- Retry aynı event_id ile yapılıyor; yeni dönüşüm üretmiyor.
- Sipariş/lead kimliği tahmin edilebilir kişisel veri olarak gönderilmiyor.
- Test ile production veri kaynakları ve olayları ayrılmış.
- İade, iptal ve geçersiz lead davranışı iş kuralında tanımlı.
Veri sorumluluğu
CAPI, tarayıcı sınırlamalarını veya veri koruma yükümlülüklerini aşmak için kullanılmaz.
Meta, Conversions API’nin iOS App Tracking Transparency veya Avrupa’daki gizlilik kuralları gibi veri paylaşımı politikalarını aşma aracı olmadığını açıkça belirtir. Hangi verinin, hangi amaç ve hukuki dayanakla işlendiği; saklama, sağlayıcı ve kullanıcı tercihlerinin nasıl yönetildiği hedef pazara göre yetkili hukuk danışmanıyla değerlendirilmelidir.
Teknik ekip “gönderilebilir” alanları değil “gerekli ve izinli” alanları almalıdır. E-posta veya telefon gibi eşleştirme verilerinin normalleştirme, hash, erişim ve log davranışı dokümante edilmeli; gereksiz kişisel veri debug loglarına yazılmamalıdır.
Kalite güvencesi
Kurulum kabul testini beş kanıtla tamamlayın.
- Semantik kanıt: Event adı ve tetik koşulu yazılı iş tanımıyla eşleşiyor.
- Teknik kanıt: Gerekli parametreler doğru tür, değer ve para birimiyle ulaşıyor.
- Tekilleştirme kanıtı: Pixel + CAPI aynı gerçek olayı raporda bir kez gösteriyor.
- Hata kanıtı: Sunucu hatası, retry ve başarısız ödeme yeni dönüşüm üretmiyor.
- İş kanıtı: Event sayısı belirli bir dönemde sipariş/CRM kaydıyla açıklanabilir fark içinde uzlaştırılıyor.
Birincil kaynaklar
Kaynaklar ve kapsam.
Bağlantılar içerikteki değişebilir veya dış doğrulama gerektiren bilgilerin kaynağıdır. Ticari ilişki veya sponsorlu bağlantı değildir.
İlgili rehberler