CAPI na strane servera a sledovanie udalostí

Obíďte blokovače reklám a obmedzenia ITP smerovaním prenosov MousePlayer cez vlastný serverový kontajner GTM vo svojej doméne a sledujte podrobnú analytiku elektronického obchodu.

1. Prehľad režimov sledovania

MousePlayer V2 prináša výkonný smerovač udalostí, ktorý umožňuje ovládať tok údajov z prehliadača používateľa na naše servery. Vybrať si môžete z troch odlišných režimov:

  • Iba web (predvolené): Prenáša všetky údaje cez WebSockets priamo do MousePlayer. Najlepší pre živé zobrazenie v reálnom čase, no zraniteľný voči silným blokovačom reklám.
  • Hybridný režim: To najlepšie z oboch svetov. Posiela malé súradnice myši a posúvania cez WebSockets pre plynulé živé zobrazenie, zatiaľ čo objemné zmeny DOM a vlastné udalosti sa dávkujú a bezpečne smerujú cez serverový GTM pomocou HTTP POST.
  • Pure CAPI: 100 % dávkovanie cez HTTP POST. Maximálne súkromie, žiadne WebSockets, všetko vo vlastnej doméne. Poznámka: Živé zobrazenie je v tomto režime vypnuté.

2. Nastavenie Google Tag Manager (odporúčané)

Najjednoduchším spôsobom nasadenia hybridného režimu alebo Pure CAPI je použitie našich oficiálnych komunitných šablón GTM. Stiahnite súbory .tpl nižšie a importujte ich do pracovných priestorov GTM.

Stiahnuť šablóny:

↓ Webový GTM: Značka MousePlayer SDK

↓ Serverový GTM: Klient MousePlayer na príjem údajov

↓ Serverový GTM: Značka konektora MousePlayer

Krok 1: Nakonfigurovať serverového klienta a značku

V serverovom kontajneri GTM importujte šablónu Klient na príjem údajov. Nastavte počúvanie na vlastnej ceste (napr. /mp_capi). Potom importujte Značku konektoraa nastavte spúšťanie pri udalosti mouseplayer_batch a nasaďte kontajner.

Krok 2: Nakonfigurovať značku webového GTM

Vo webovom kontajneri GTM importujte Značku SDK. Ako typ značky vyberte „Konfigurácia a inicializácia“, zadajte Channel ID, vyberte Hybridný režima vložte URL koncového bodu ssGTM (napr. https://metrics.yourdomain.com/mp_capi).

3. Ručná inštalácia (bez GTM)

Ak uprednostňujete skript zapísaný priamo v kóde, musíte pred načítaním sledovacieho úryvku definovať objekt 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. Sledovanie lievika elektronického obchodu

Sledujte celú cestu zákazníka. Štandardizované názvy udalostí umožňujú MousePlayer automaticky vytvárať prehľadné správy o lievikoch elektronického obchodu v pracovnom priestore projektu. Všetky udalosti sú plne kompatibilné s režimami CAPI aj Iba web.

1. view_item

Spustite túto udalosť, keď používateľ zobrazí konkrétnu produktovú stránku.

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

2. add_to_cart

Spustite túto udalosť, keď používateľ pridá položku do nákupného košíka.

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

3. begin_checkout

Spustite túto udalosť, keď používateľ prejde na obrazovku pokladne.

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

4. purchase

Spustite túto udalosť po úspešnej platbe alebo potvrdení objednávky.

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

5. Vlastné udalosti a získavanie kontaktov

Nie ste obmedzení na elektronický obchod. Sledujte odoslania formulárov, prihlásenia na odber noviniek alebo vlastné interakcie jedinečné pre vašu webovú aplikáciu.

Získavanie kontaktov (odoslanie formulára)

Spustite túto udalosť, keď používateľ úspešne odošle kontaktný formulár alebo požiada o cenovú ponuku.

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

Vlastná interakcia s rozhraním

Pochopte, ako používatelia pracujú so zložitými prvkami, napríklad kalkulačkami, modálnymi oknami či prepínačmi kariet.

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

6. Limity parametrov a pokyny

Typovanie údajov: MousePlayer automaticky rozpoznáva typy parametrov. Čísla posielajte ako celé alebo desatinné čísla (napr. 150.00, nie "150.00"), aby ste v prehľade mohli používať pokročilé číselné filtrovanie (napr. „Cena > 100“).

Pravidlo Opis
Dĺžka názvu udalosti Najviac 128 znakov. Pre najlepšiu čitateľnosť používajte snake_case (napr. user_signup).
Dĺžka kľúča parametra Najviac 64 znakov na názov kľúča (napr. transaction_id).
Textové hodnoty Textové parametre sa skracujú na 255 znakov pre optimálny výkon databázy.
Ochrana osobných údajov Ako parametre udalostí neposielajte osobné identifikačné údaje (PII), napríklad nehašované e-mailové adresy, skutočné mená alebo heslá.