Serversäiteg CAPI & Eventverfollegung

Ëmgitt Reklammeblocker an ITP-Aschränkungen, andeems Dir de MousePlayer-Trafic duerch Ären eegene First-Party-Server-Side-GTM-Container leet, a verfollegt detailléiert E-Commerce-Analysen.

1. Iwwerbléck vun de Verfollegungsmodi

MousePlayer V2 stellt e staarken Event Router vir, mat deem Dir kontrolléiert, wéi Donnéeë vum Browser vun Ärem Benotzer op eis Servere fléissen. Dir kënnt tëschent dräi verschiddene Modi wielen:

  • Nëmme Web (Standard): Streamt all Donnéeën iwwer WebSockets direkt op MousePlayer. Am beschte fir d'Live-Usiicht an Echtzäit, mee empfindlech géint staark Reklammeblocker.
  • Hybridmodus: Dat Bescht aus béide Welten. Schéckt kleng Maus-/Scrollkoordinaten iwwer WebSockets fir eng fléissend Live-Usiicht, wärend grouss DOM-Ännerungen an eegendefinéiert Eventer gebündelt a sécher iwwer HTTP POST duerch Äre Server-Side GTM geleet ginn.
  • Reng CAPI: 100% gebündelt HTTP POST. Maximal Privatsphär, keng WebSockets, ganz iwwer Är eege Partei. Hiweis: D'Live-Usiicht ass an dësem Modus ausgeschalt.

2. Google Tag Manager ariichten (recommandéiert)

Deen einfachste Wee, den Hybrid- oder rengem CAPI-Modus ëmzesetzen, ass eis offiziell GTM-Community-Virlag ze benotzen. Luet déi hei ënne verlinkten .tpl -Dateien erof an importéiert se an Är GTM-Aarbechtsberäicher.

Virlagen eroflueden:

↓ Web GTM: MousePlayer-SDK-Tag

↓ Server GTM: MousePlayer-Ingest-Client

↓ Server GTM: MousePlayer-Connector-Tag

Schrëtt 1: Server-Side-Client & Tag konfiguréieren

Importéiert an Ärem Server-Side-GTM-Container d'Virlag Ingest Client . Setzt se esou, datt si op en eegene Wee lauschtert (z. B. /mp_capi). Importéiert duerno den Connector Tag, konfiguréiert en esou, datt en beim Event mouseplayer_batch ausgeléist gëtt, a setzt Äre Container an.

Schrëtt 2: Web-GTM-Tag konfiguréieren

Importéiert an Ärem Web-GTM-Container den SDK Tag. Wielt „Konfiguratioun & Initialiséierung“ als Tag-Typ, gitt Äre Channel IDan, wielt Hybridmodusa setzt Är ssGTM-Endpunkt-URL an (z. B. https://metrics.yourdomain.com/mp_capi).

3. Manuell Installatioun (ouni GTM)

Wann Dir de Skript léiwer fest am Code abannt, musst Dir den Objet window.mp_config definéieren, éier de Verfollegungs-Code-Schnipsel geluede gëtt.

<!-- 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-Commerce-Trichterverfollegung

Verfollegt déi ganz Clientsrees. Standardiséiert Eventnimm erlaben MousePlayer, automatesch iwwersiichtlech E-Commerce-Trichterberichter an Ärem Projetsaarbechtsberäich ze generéieren. All Eventer si voll mat CAPI- an Nëmme-Web-Modi kompatibel.

1. view_item

Léist dësen Event aus, wann e Benotzer eng bestëmmte Produktsäit kuckt.

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

2. add_to_cart

Léist dësen Event aus, wann e Benotzer en Artikel a säi Wuerekuerf leet.

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

3. begin_checkout

Léist dësen Event aus, wann e Benotzer op de Keessecran weidergeet.

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

4. purchase

Léist dësen Event no erfollegräicher Bezuelung oder Bestellbestätegung aus.

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

5. Eegendefinéiert Eventer & Gewënnung vu potenzielle Clienten

Dir sidd net op E-Commerce begrenzt. Verfollegt d'Ofschécke vu Formulairen, Newsletter-Umeldungen oder eege Interaktiounen, déi spezifesch fir Är Webapplikatioun sinn.

Gewënnung vu potenzielle Clienten (Formular ofschécken)

Léist dësen Event aus, wann e Benotzer e Kontaktformular erfollegräich ofschéckt oder eng Offer ufreet.

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

Eegendefinéiert UI-Interaktioun

Verstitt, wéi Benotzer mat komplexen Elementer ewéi Rechneren, Dialogfënsteren oder Reiderwiesselen interagéieren.

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

6. Parameterlimiten & Richtlinnen

Datentypiséierung: MousePlayer erkennt Parametertypen automatesch. Schéckt Zuelen als ganz oder Flottkommazuelen (z. B. 150.00, net "150.00"), fir fortgeschratt numeresch Filterung (z. B. „Präis > 100“) um Dashboard ze erméiglechen.

Reegel Beschreiwung
Längt vum Eventnumm Héchstens 128 Zeechen. Benotzt snake_case fir déi bescht Liesbarkeet (z. B. user_signup).
Längt vum Parameterschlëssel Héchstens 64 Zeeche pro Schlësselnumm (z. B. transaction_id).
Zeechekettewäerter Textparametere ginn op 255 Zeeche gekierzt, fir optimal Datebankleeschtung ze garantéieren.
Dateschutz Schéckt keng perséinlech identifizéierbar Donnéeën (PII) ewéi réi E-Mail-Adressen, richteg Nimm oder Passwierder als Eventparameter.