CAPI på serversiden og hændelsessporing

Omgå annonceblokkere og ITP-begrænsninger ved at sende MousePlayer-trafik gennem din egen førsteparts-GTM-container på serversiden, og få detaljeret e-handelsanalyse.

1. Oversigt over sporingstilstande

MousePlayer V2 introducerer en effektiv hændelsesrouter der lader dig styre datastrømmen fra brugerens browser til vores servere. Du kan vælge mellem tre tilstande:

  • Kun web (standard): Streamer alle data via WebSockets direkte til MousePlayer. Bedst til livevisning i realtid, men sårbar over for omfattende annonceblokering.
  • Hybrid-tilstand: Det bedste fra begge verdener. Sender lette muse- og rullekoordinater via WebSockets til flydende livevisning, mens omfattende DOM-ændringer og brugerdefinerede hændelser samles og sendes sikkert gennem din GTM på serversiden via HTTP POST.
  • Ren CAPI: 100% samlet HTTP POST-overførsel. Maksimalt privatliv, ingen WebSockets, udelukkende førstepart. Bemærk: Livevisning er deaktiveret i denne tilstand.

2. Opsætning af Google Tag Manager (anbefales)

Den nemmeste måde at implementere Hybrid eller ren CAPI på er med vores officielle GTM-communityskabeloner. Download .tpl-filerne nedenfor, og importér dem i dine GTM-arbejdsområder.

Download skabeloner:

↓ Web-GTM: MousePlayer SDK-tag

↓ Server-GTM: MousePlayer-modtagelsesklient

↓ Server-GTM: MousePlayer-forbindelsestag

Trin 1: Konfigurer klient og tag på serversiden

Importér i din GTM-container på serversiden skabelonen Modtagelsesklient. Indstil den til at lytte på en brugerdefineret sti (f.eks. /mp_capi). Importér derefter Forbindelsestag, indstil det til at udløses ved mouseplayer_batch-hændelsen, og udgiv din container.

Trin 2: Konfigurer web-GTM-tagget

Importér i din web-GTM-container SDK-tagget. Vælg »Konfiguration og initialisering« som tagtype, indtast dit Channel ID, vælg Hybrid-tilstand, og indsæt dit ssGTM-endepunkts URL (f.eks. https://metrics.yourdomain.com/mp_capi).

3. Manuel installation (uden GTM)

Hvis du foretrækker at indsætte scriptet direkte, skal du definere window.mp_config-objektet, før du indlæser sporingskodestykket.

<!-- 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. Sporing af e-handelstragte

Følg hele kunderejsen. Standardiserede hændelsesnavne lader MousePlayer automatisk generere overskuelige e-handelstragtrapporter i dit projektarbejdsområde. Alle hændelser er fuldt kompatible med CAPI og tilstanden Kun web.

1. view_item

Udløs hændelsen, når en bruger ser en bestemt produktside.

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

2. add_to_cart

Udløs hændelsen, når en bruger lægger en vare i indkøbskurven.

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

3. begin_checkout

Udløs hændelsen, når en bruger går til betalingssiden.

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

4. purchase

Udløs hændelsen ved gennemført betaling eller ordrebekræftelse.

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

5. Brugerdefinerede hændelser og leadgenerering

Du er ikke begrænset til e-handel. Spor formularindsendelser, nyhedsbrevstilmeldinger og egne interaktioner, der er særlige for din webapplikation.

Leadgenerering (formularindsendelse)

Udløs hændelsen, når en bruger indsender en kontaktformular eller anmoder om et tilbud.

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

Brugerdefineret UI-interaktion

Forstå, hvordan brugere anvender komplekse elementer som beregnere, dialoger eller faneskift.

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

6. Parametergrænser og vejledning

Datatyper: MousePlayer registrerer automatisk parametertyper. Send tal som heltal eller decimaltal (f.eks. 150.00, ikke "150.00") for at aktivere avanceret talfiltrering (f.eks. »Pris > 100«) i dashboardet.

Regel Beskrivelse
Hændelsesnavnets længde Højst 128 tegn. Brug snake_case for bedst læsbarhed (f.eks. user_signup).
Parameternøglens længde Højst 64 tegn pr. nøglenavn (f.eks. transaction_id).
Tekstværdier Tekstparametre afkortes til 255 tegn for at sikre optimal databaseydelse.
Databeskyttelse Send ikke personoplysninger som rå e-mailadresser, rigtige navne eller adgangskoder som hændelsesparametre.