CAPI pe server și urmărirea evenimentelor

Ocoliți blocatoarele de reclame și restricțiile ITP direcționând traficul MousePlayer prin propriul container GTM de primă parte de pe server și urmăriți în detaliu datele analitice de comerț electronic.

1. Prezentarea modurilor de urmărire

MousePlayer V2 introduce un puternic router de evenimente care vă permite să controlați fluxul datelor din browserul utilizatorului către serverele noastre. Puteți alege între trei moduri distincte:

  • Doar web (implicit): Transmite toate datele prin WebSocketuri direct către MousePlayer. Ideal pentru vizualizarea live în timp real, dar vulnerabil la blocatoarele de reclame agresive.
  • Mod hibrid: Avantajele ambelor variante. Trimite coordonatele ușoare ale mouse-ului și derulării prin WebSocketuri pentru o vizualizare live fluidă, în timp ce modificările DOM voluminoase și evenimentele personalizate sunt grupate în loturi și direcționate securizat prin GTM-ul de pe server prin HTTP POST.
  • Doar CAPI: 100% loturi HTTP POST. Confidențialitate maximă, fără WebSocketuri, integral de primă parte. Notă: vizualizarea live este dezactivată în acest mod.

2. Configurarea Google Tag Manager (recomandată)

Cel mai simplu mod de a implementa modurile Hibrid sau Doar CAPI este să folosiți șabloanele noastre oficiale din comunitatea GTM. Descărcați fișierele .tpl de mai jos și importați-le în spațiile de lucru GTM.

Descărcați șabloanele:

↓ GTM web: eticheta SDK MousePlayer

↓ GTM pe server: clientul de preluare MousePlayer

↓ GTM pe server: eticheta conectorului MousePlayer

Pasul 1: configurați clientul și eticheta de pe server

În containerul GTM de pe server, importați șablonul Client de preluare. Setați-l să asculte pe o cale personalizată (de ex. /mp_capi). Apoi importați Eticheta conectorului, configurați-o să se declanșeze la evenimentul mouseplayer_batch și publicați containerul.

Pasul 2: configurați eticheta GTM web

În containerul GTM web, importați Eticheta SDK. Selectați „Configurare și inițializare” ca tip de etichetă, introduceți Channel ID, selectați Mod hibrid și lipiți URL-ul endpointului ssGTM (de ex. https://metrics.yourdomain.com/mp_capi).

3. Instalare manuală (fără GTM)

Dacă preferați să includeți scriptul direct în cod, trebuie să definiți obiectul window.mp_config înainte de a încărca fragmentul de urmărire.

<!-- 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. Urmărirea pâlniei de comerț electronic

Urmăriți întregul parcurs al clientului. Numele standardizate de evenimente permit MousePlayer să genereze automat rapoarte vizuale despre pâlnia de comerț electronic în spațiul de lucru al proiectului. Toate evenimentele sunt pe deplin compatibile cu modurile CAPI și Doar web.

1. view_item

Declanșați acest eveniment când un utilizator vizualizează o anumită pagină de produs.

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

2. add_to_cart

Declanșați acest eveniment când un utilizator adaugă un articol în coș.

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

3. begin_checkout

Declanșați acest eveniment când un utilizator trece la ecranul de finalizare a comenzii.

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

4. purchase

Declanșați acest eveniment după plata reușită sau confirmarea comenzii.

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

5. Evenimente personalizate și atragerea clienților potențiali

Nu sunteți limitați la comerțul electronic. Urmăriți trimiterea formularelor, abonările la buletine informative sau interacțiunile personalizate specifice aplicației dvs. web.

Atragerea clienților potențiali (trimitere de formular)

Declanșați acest eveniment când un utilizator trimite cu succes un formular de contact sau solicită o ofertă.

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

Interacțiune personalizată în interfață

Înțelegeți cum interacționează utilizatorii cu elemente complexe, precum calculatoare, ferestre modale sau comutatoare de file.

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

6. Limite și recomandări pentru parametri

Tipurile de date: MousePlayer detectează automat tipurile parametrilor. Trimiteți numerele ca întregi sau numere în virgulă mobilă (de ex. 150.00, nu "150.00") pentru a permite filtrarea numerică avansată (de ex. „Preț > 100”) în tabloul de bord.

Regulă Descriere
Lungimea numelui evenimentului Cel mult 128 de caractere. Folosiți snake_case pentru lizibilitate optimă (de ex. user_signup).
Lungimea cheii parametrului Cel mult 64 de caractere pentru fiecare nume de cheie (de ex. transaction_id).
Valori de tip șir Parametrii text sunt trunchiați la 255 de caractere pentru performanță optimă a bazei de date.
Confidențialitatea datelor Vă rugăm să nu trimiteți informații care permit identificarea persoanelor (PII), precum adrese de e-mail în clar, nume reale sau parole, ca parametri ai evenimentelor.