CAPI via de server en gebeurtenistracking

Omzeil advertentieblokkeerders en ITP-beperkingen door MousePlayer-verkeer via uw eigen serverzijdige GTM-container op uw eigen domein te leiden en gedetailleerde e-commerceanalyses bij te houden.

1. Overzicht van trackingmodi

MousePlayer V2 introduceert een krachtige gebeurtenisrouter waarmee u bepaalt hoe gegevens van de browser van uw gebruiker naar onze servers stromen. U kunt uit drie modi kiezen:

  • Alleen web (standaard): Stuurt alle gegevens via WebSockets rechtstreeks naar MousePlayer. Het beste voor realtime liveweergave, maar kwetsbaar voor strenge advertentieblokkeerders.
  • Hybride modus: Het beste van beide werelden. Stuurt lichte muis- en scrollcoördinaten via WebSockets voor vloeiende liveweergave, terwijl omvangrijke DOM-wijzigingen en aangepaste gebeurtenissen in batches veilig via uw serverzijdige GTM worden doorgestuurd met HTTP POST.
  • Zuivere CAPI: 100% batchverwerking via HTTP POST. Maximale privacy, geen WebSockets en volledig op uw eigen domein. Let op: liveweergave is in deze modus uitgeschakeld.

2. Google Tag Manager instellen (aanbevolen)

De eenvoudigste manier om de modi Hybride of Zuivere CAPI te implementeren is via onze officiële GTM-communitytemplates. Download de onderstaande .tpl bestanden en importeer ze in uw GTM-werkruimten.

Templates downloaden:

↓ Web-GTM: MousePlayer SDK-tag

↓ Server-GTM: MousePlayer-ingestieclient

↓ Server-GTM: MousePlayer-connectortag

Stap 1: serverzijdige client en tag instellen

Importeer in uw serverzijdige GTM-container de template Ingestieclient . Stel deze in om op een eigen pad te luisteren (bijvoorbeeld /mp_capi). Importeer vervolgens de Connectortag, stel deze in om te worden geactiveerd bij de gebeurtenis mouseplayer_batch en publiceer uw container.

Stap 2: de web-GTM-tag instellen

Importeer in uw web-GTM-container de SDK-tag. Selecteer “Configuratie en initialisatie” als tagtype, voer uw Channel IDin, selecteer Hybride modusen plak de URL van uw ssGTM-endpoint (bijvoorbeeld https://metrics.yourdomain.com/mp_capi).

3. Handmatige installatie (zonder GTM)

Als u het script liever rechtstreeks in de code opneemt, moet u het object window.mp_config definiëren voordat u het trackingsnippet laadt.

<!-- 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. E-commercetrechters volgen

Volg de volledige klantreis. Met gestandaardiseerde gebeurtenisnamen kan MousePlayer automatisch aantrekkelijke rapporten over e-commercetrechters in uw projectwerkruimte maken. Alle gebeurtenissen zijn volledig compatibel met de modi CAPI en Alleen web.

1. view_item

Activeer deze gebeurtenis wanneer een gebruiker een specifieke productpagina bekijkt.

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

2. add_to_cart

Activeer deze gebeurtenis wanneer een gebruiker een artikel aan de winkelwagen toevoegt.

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

3. begin_checkout

Activeer deze gebeurtenis wanneer een gebruiker naar het afrekenscherm gaat.

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

4. purchase

Activeer deze gebeurtenis bij een geslaagde betaling of bestelbevestiging.

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

5. Aangepaste gebeurtenissen en leadgeneratie

U bent niet beperkt tot e-commerce. Volg formulierverzendingen, nieuwsbriefinschrijvingen of eigen interacties die specifiek zijn voor uw webapplicatie.

Leadgeneratie (formulierverzending)

Activeer deze gebeurtenis wanneer een gebruiker met succes een contactformulier verstuurt of een offerte aanvraagt.

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

Aangepaste interface-interactie

Begrijp hoe gebruikers omgaan met complexe elementen zoals rekenhulpen, modale vensters of tabbladwisselingen.

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

6. Parameterlimieten en richtlijnen

Gegevenstypen: MousePlayer herkent parametertypen automatisch. Stuur getallen als gehele of kommagetallen (bijvoorbeeld 150.00, niet "150.00") om geavanceerde numerieke filters (bijvoorbeeld “Prijs > 100”) in het dashboard mogelijk te maken.

Regel Beschrijving
Lengte van gebeurtenisnaam Maximaal 128 tekens. Gebruik snake_case voor optimale leesbaarheid (bijvoorbeeld user_signup).
Lengte van parametersleutel Maximaal 64 tekens per sleutelnaam (bijvoorbeeld transaction_id).
Tekstwaarden Tekstparameters worden afgekapt op 255 tekens om optimale databaseprestaties te garanderen.
Gegevensprivacy Stuur geen persoonlijk identificeerbare informatie (PII), zoals onbewerkte e-mailadressen, echte namen of wachtwoorden, als gebeurtenisparameters.