Server-Side CAPI i Śledzenie Zdarzeń

Omiń adblockery i restrykcje ITP, kierując ruch MousePlayer przez swój własny kontener Server-Side GTM.

1. Przegląd trybów śledzenia

MousePlayer V2 wprowadza potężny Router Zdarzeń, który pozwala kontrolować przepływ danych. Możesz wybrać jeden z trzech trybów:

  • Web Only (Domyślny): Przesyła wszystkie dane przez WebSockety bezpośrednio do MousePlayer. Najlepszy do Live View, ale podatny na ostre adblockery.
  • Hybrid Mode: Złoty środek. Wysyła lekkie koordynaty przez WebSockety do podglądu na żywo, podczas gdy ciężkie mutacje DOM i zdarzenia są wysyłane bezpiecznie przez SS-GTM za pomocą HTTP POST.
  • Pure CAPI: 100% pakietowanie HTTP POST. Maksymalna prywatność, brak WebSocketów. Uwaga: Tryb Live View jest wyłączony.

2. Konfiguracja Google Tag Manager (Zalecane)

Najprostsza droga do trybów Hybrid i Pure CAPI to nasze oficjalne szablony GTM Community. Pobierz poniższe pliki .tpl i zaimportuj je do swoich obszarów roboczych GTM.

Pobierz Szablony GTM:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Krok 1: Konfiguracja klienta i tagu po stronie serwera

W kontenerze GTM po stronie serwera zaimportuj szablon Ingest Client. Ustaw go na własną ścieżkę (na przykład /mp_capi). Następnie zaimportuj Connector Tag, skonfiguruj go tak, aby uruchamiał się przy zdarzeniu mouseplayer_batch, i opublikuj kontener.

Krok 2: Konfiguracja tagu Web GTM

W kontenerze Web GTM zaimportuj SDK Tag. Jako typ tagu wybierz „Configuration & Initialization“, wpisz swój Channel ID, wybierz Hybrid Mode i wklej adres swojego punktu końcowego ssGTM (na przykład https://metrics.twoja-domena.pl/mp_capi).

3. Ręczna instalacja (bez GTM)

Jeśli preferujesz dodanie skryptu ręcznie, musisz zdefiniować obiekt window.mp_config przed załadowaniem skryptu.

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'TWOJE_UNIKALNE_ID', mode: 'hybrid', // 'web_only', 'hybrid', lub 'pure_capi' capi_endpoint: 'https://metrics.twojadomena.pl/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; </script>

4. Lejek e-commerce

Śledź całą drogę klienta. Dzięki standardowym nazwom zdarzeń MousePlayer sam tworzy w Twoim projekcie raporty lejka e-commerce. Wszystkie zdarzenia działają tak samo w trybie CAPI i Web-Only.

1. view_item

Wyzwól to zdarzenie, gdy użytkownik ogląda stronę produktu.

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

2. add_to_cart

Wyzwól to zdarzenie, gdy użytkownik dodaje towar do koszyka.

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

3. begin_checkout

Wyzwól to zdarzenie, gdy użytkownik przechodzi do kasy.

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

4. purchase

Wyzwól to zdarzenie po udanej płatności lub potwierdzeniu zamówienia.

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

5. Zdarzenia własne i pozyskiwanie leadów

Nie ograniczasz się do handlu. Rejestruj wysłane formularze, zapisy do newslettera albo interakcje, które występują tylko w Twojej aplikacji.

Pozyskanie leada (wysłanie formularza)

Wyzwól to zdarzenie, gdy użytkownik wyśle formularz kontaktowy albo poprosi o wycenę.

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

Własne elementy interfejsu

Zrozum, jak użytkownicy korzystają ze złożonych elementów - kalkulatorów, okien modalnych czy przełączania zakładek.

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

6. Limity parametrów i wytyczne

Typy danych: MousePlayer sam rozpoznaje typ parametru. Wysyłaj liczby jako liczby, nie jako tekst (150.00, a nie "150.00") - tylko wtedy w panelu zadziała filtrowanie liczbowe, na przykład "Cena > 100".

ZasadaOpis
Długość nazwy zdarzeniaMaksymalnie 128 znaków. Używaj snake_case (np. user_signup).
Długość nazwy parametruMaksymalnie 64 znaki na nazwę, np. transaction_id.
Wartości tekstoweParametry tekstowe są skracane do 255 znaków, aby baza danych pozostała szybka.
Prywatność Danych (PII)Nie wysyłaj danych takich jak e-maile czy hasła jako parametrów zdarzeń.