Serverové CAPI a sledování událostí

Obejděte blokování reklam a omezení ITP směrováním provozu MousePlayer přes vlastní serverový kontejner GTM na vaší doméně a sledujte podrobnou analytiku elektronického obchodování.

1. Přehled režimů sledování

MousePlayer V2 přináší výkonný směrovač událostí , kterým řídíte tok dat z prohlížeče uživatele na naše servery. Můžete vybrat ze tří režimů:

  • Pouze web (výchozí): Přenáší všechna data přes WebSockets přímo do MousePlayer. Nejlepší pro živé zobrazení v reálném čase, ale citlivé na přísné blokování reklam.
  • Hybridní režim: To nejlepší z obou světů. Lehké souřadnice myši a posunu posílá přes WebSockets pro plynulé živé zobrazení, zatímco objemné změny DOM a vlastní události dávkuje a bezpečně směruje přes serverové GTM pomocí HTTP POST.
  • Čisté CAPI: 100% dávkování HTTP POST. Maximální soukromí, žádné WebSockets, plně na vaší doméně. Poznámka: živé zobrazení je v tomto režimu vypnuté.

2. Nastavení Google Tag Manager (doporučeno)

Nejjednodušší implementace hybridního režimu nebo čistého CAPI využívá naše oficiální komunitní šablony GTM. Stáhněte níže uvedené soubory .tpl a importujte je do pracovních prostorů GTM.

Stáhnout šablony:

↓ Webové GTM: značka SDK MousePlayer

↓ Serverové GTM: klient pro příjem dat MousePlayer

↓ Serverové GTM: značka konektoru MousePlayer

Krok 1: nastavení serverového klienta a značky

V serverovém kontejneru GTM importujte šablonu Ingest Client . Nastavte naslouchání na vlastní cestě (například /mp_capi). Potom importujte Connector Tag, nastavte spuštění při události mouseplayer_batch a nasaďte kontejner.

Krok 2: nastavení webové značky GTM

Ve webovém kontejneru GTM importujte SDK Tag. Jako typ značky vyberte „Configuration & Initialization“, zadejte Channel ID, vyberte Hybrid Modea vložte adresu URL endpointu ssGTM (například https://metrics.yourdomain.com/mp_capi).

3. Ruční instalace (bez GTM)

Pokud skript raději vkládáte přímo do kódu, musíte definovat objekt window.mp_config před načtením sledovacího snippetu.

<!-- 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. Sledování trychtýře elektronického obchodování

Sledujte celou cestu zákazníka. Standardizované názvy událostí umožňují MousePlayer automaticky vytvářet přehledné reporty trychtýřů elektronického obchodování v pracovním prostoru projektu. Všechny události jsou plně kompatibilní s režimy CAPI a Pouze web.

1. view_item

Spusťte událost, když uživatel zobrazí konkrétní produktovou 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

Spusťte událost, když uživatel přidá položku do košíku.

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

3. begin_checkout

Spusťte událost, když uživatel přejde k pokladně.

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

4. purchase

Spusťte událost při úspěšné platbě nebo potvrzení 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í události a získávání kontaktů

Nejste omezeni na elektronické obchodování. Sledujte odesílání formulářů, přihlášení k newsletteru nebo vlastní interakce specifické pro vaši webovou aplikaci.

Získávání kontaktů (odeslání formuláře)

Spusťte událost, když uživatel úspěšně odešle kontaktní formulář nebo požádá o nabídku.

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

Vlastní interakce s rozhraním

Zjistěte, jak uživatelé pracují se složitými prvky, jako jsou kalkulačky, modální okna nebo přepínání karet.

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

6. Limity parametrů a doporučení

Datové typy: MousePlayer automaticky rozpoznává typy parametrů. Čísla posílejte jako celá nebo desetinná čísla (například 150.00, nikoli "150.00"), aby v dashboardu fungovalo pokročilé číselné filtrování (například „Cena > 100“).

Pravidlo Popis
Délka názvu události Nejvýše 128 znaků. Pro nejlepší čitelnost použijte snake_case (například user_signup).
Délka klíče parametru Nejvýše 64 znaků v názvu klíče (například transaction_id).
Textové hodnoty Textové parametry se zkracují na 255 znaků kvůli optimálnímu výkonu databáze.
Ochrana osobních údajů Jako parametry událostí neposílejte osobní identifikační údaje (PII), například nezpracované e-mailové adresy, skutečná jména nebo hesla.