Sunucu Tarafı CAPI & Olay Takibi

MousePlayer trafiğini kendi birinci taraf sunucu tarafı GTM kapsayıcınızdan yönlendirerek reklam engelleyicileri ve ITP kısıtlamalarını aşın; ayrıntılı e-ticaret analizlerini takip edin.

1. Takip modlarına genel bakış

MousePlayer V2, verilerin kullanıcınızın tarayıcısından sunucularımıza nasıl aktığını kontrol etmenizi sağlayan güçlü bir Olay Yönlendiricisi sunar. Üç ayrı mod arasından seçim yapabilirsiniz:

  • Yalnızca Web (Varsayılan): Tüm verileri WebSocket üzerinden doğrudan MousePlayer'a aktarır. Gerçek zamanlı canlı görünüm için en iyisidir; ancak güçlü reklam engelleyicilere karşı savunmasızdır.
  • Hibrit Mod: Her iki yaklaşımın en iyi yönleri. Akıcı canlı görünüm için hafif fare/kaydırma koordinatlarını WebSocket üzerinden gönderir; ağır DOM değişiklikleri ve Özel Olaylar ise gruplandırılıp HTTP POST aracılığıyla sunucu tarafı GTM'nizden güvenle yönlendirilir.
  • Yalnızca CAPI: Yüzde 100 HTTP POST gruplandırması. En üst düzey gizlilik, sıfır WebSocket, tamamen birinci taraf. Not: Bu modda canlı görünüm devre dışıdır.

2. Google Tag Manager kurulumu (önerilen)

Hibrit Mod veya Yalnızca CAPI modlarını uygulamanın en kolay yolu resmi GTM Topluluk Şablonlarımızı kullanmaktır. Aşağıdaki .tpl dosyalarını indirin ve GTM çalışma alanlarınıza içe aktarın.

Şablonları indirin:

↓ Web GTM: MousePlayer SDK Etiketi

↓ Sunucu GTM: MousePlayer Veri Alım İstemcisi

↓ Sunucu GTM: MousePlayer Bağlayıcı Etiketi

Adım 1: Sunucu tarafı istemciyi ve etiketi yapılandırın

Sunucu tarafı GTM kapsayıcınıza şu şablonu içe aktarın: Veri Alım İstemcisi . Özel bir yolu dinleyecek şekilde ayarlayın (örneğin /mp_capi). Ardından şu şablonu içe aktarın: Bağlayıcı Etiketi; şu olayda tetiklenecek şekilde yapılandırın: mouseplayer_batch . Kapsayıcınızı dağıtın.

Adım 2: Web GTM etiketini yapılandırın

Web GTM kapsayıcınıza şu şablonu içe aktarın: SDK Etiketi. Etiket Türü olarak “Yapılandırma ve Başlatma” seçin, şu bilgiyi girin: Channel ID; şu modu seçin: Hibrit Mod. Ardından ssGTM Uç Nokta URL'nizi yapıştırın (örneğin https://metrics.yourdomain.com/mp_capi).

3. Elle kurulum (GTM olmadan)

Betiği doğrudan koda eklemeyi tercih ediyorsanız takip kod parçacığını yüklemeden önce şu nesneyi tanımlamalısınız: window.mp_config .

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. E-ticaret hunisi takibi

Müşteri yolculuğunun tamamını takip edin. Standart olay adlarını kullanmak, MousePlayer'ın proje çalışma alanınızda güzel e-ticaret hunisi raporlarını otomatik oluşturmasını sağlar. Tüm olaylar CAPI ve Yalnızca Web modlarıyla tam uyumludur.

1. view_item

Kullanıcı belirli bir ürün sayfasını görüntülediğinde bu olayı tetikleyin.

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

Kullanıcı alışveriş sepetine bir ürün eklediğinde bu olayı tetikleyin.

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

Kullanıcı ödeme ekranına geçtiğinde bu olayı tetikleyin.

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

Başarılı ödeme veya sipariş onayında bu olayı tetikleyin.

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. Özel olaylar ve potansiyel müşteri oluşturma

E-ticaretle sınırlı değilsiniz. Form gönderimlerini, bülten kayıtlarını veya web uygulamanıza özgü etkileşimleri takip edin.

Potansiyel müşteri oluşturma (form gönderimi)

Kullanıcı bir iletişim formunu başarıyla gönderdiğinde veya fiyat teklifi istediğinde bu olayı tetikleyin.

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

Özel arayüz etkileşimi

Kullanıcıların hesaplayıcılar, açılır pencereler veya sekme geçişleri gibi karmaşık öğelerle nasıl etkileştiğini anlayın.

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. Parametre sınırları ve yönergeler

Veri türleri: MousePlayer parametre türlerini otomatik algılar. Gösterge panelinde gelişmiş sayısal filtrelemeyi (örneğin “Fiyat > 100”) etkinleştirmek için sayıları tam sayı veya ondalıklı sayı olarak gönderin (örneğin 150.00; şu biçimde değil: "150.00").

Kural Açıklama
Olay adı uzunluğu En fazla 128 karakter. En iyi okunabilirlik için snake_case kullanın (örneğin user_signup).
Parametre anahtarı uzunluğu Anahtar adı başına en fazla 64 karakter (örneğin transaction_id).
Dize değerleri En iyi veritabanı performansını sağlamak için metin parametreleri 255 karakterle sınırlandırılır.
Veri gizliliği Olay parametreleri olarak ham e-posta adresleri, gerçek adlar veya parolalar gibi kişiyi tanımlayabilecek bilgileri (PII) göndermeyin .