Server-Side CAPI & Event Tracking

Umgehen Sie Adblocker und ITP-Einschränkungen, indem Sie den MousePlayer-Traffic durch Ihren eigenen Server-Side GTM-Container leiten.

1. Übersicht der Tracking-Modi

MousePlayer V2 führt einen leistungsstarken Event Router ein. Sie können aus drei Modi wählen:

  • Web Only (Standard): Streamt alle Daten über WebSockets direkt zu MousePlayer.
  • Hybrid Mode: Sendet leichte Koordinaten über WebSockets für Live View, während schwere DOM-Mutationen über SS-GTM gesendet werden.
  • Pure CAPI: 100% HTTP POST Batching. Maximale Privatsphäre, keine WebSockets.

2. Google Tag Manager Einrichtung

Der einfachste Weg zu den Modi Hybrid und Pure CAPI sind unsere offiziellen GTM-Community-Vorlagen. Laden Sie die .tpl-Dateien unten herunter und importieren Sie sie in Ihre GTM-Arbeitsbereiche.

Download Templates:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Schritt 1: Client und Tag serverseitig einrichten

Importieren Sie im serverseitigen GTM-Container die Vorlage Ingest Client. Stellen Sie sie auf einen eigenen Pfad ein (etwa /mp_capi). Importieren Sie danach das Connector Tag, lassen Sie es auf das Ereignis mouseplayer_batch auslösen und veröffentlichen Sie den Container.

Schritt 2: Das Web-GTM-Tag einrichten

Importieren Sie im Web-GTM-Container das SDK Tag. Wählen Sie als Tag-Typ „Configuration & Initialization“, tragen Sie Ihre Channel ID ein, wählen Sie den Hybrid Mode und fügen Sie die Adresse Ihres ssGTM-Endpunkts ein (etwa https://metrics.ihre-domain.de/mp_capi).

3. Manuelle Installation

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'IHRE_ID_HIER', mode: 'hybrid', // 'web_only', 'hybrid', oder 'pure_capi' capi_endpoint: 'https://metrics.ihredomain.de/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; </script>

4. E-Commerce-Trichter

Verfolgen Sie den gesamten Weg des Kunden. Mit standardisierten Ereignisnamen erzeugt MousePlayer die E-Commerce-Trichterberichte in Ihrem Projekt von selbst. Alle Ereignisse funktionieren im CAPI- und im Web-Only-Modus gleichermaßen.

1. view_item

Lösen Sie dieses Ereignis aus, wenn ein Nutzer eine Produktseite ansieht.

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ösen Sie dieses Ereignis aus, wenn ein Nutzer einen Artikel in den Warenkorb legt.

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

3. begin_checkout

Lösen Sie dieses Ereignis aus, wenn ein Nutzer zur Kasse geht.

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

4. purchase

Lösen Sie dieses Ereignis nach erfolgreicher Zahlung oder Bestellbestätigung aus.

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

5. Eigene Ereignisse und Leadgewinnung

Sie sind nicht auf den Handel festgelegt. Erfassen Sie abgeschickte Formulare, Newsletter-Anmeldungen oder Interaktionen, die es nur in Ihrer Anwendung gibt.

Leadgewinnung (Formular abgeschickt)

Lösen Sie dieses Ereignis aus, wenn ein Nutzer ein Kontaktformular absendet oder ein Angebot anfordert.

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

Eigene Bedienelemente

Verstehen Sie, wie Nutzer mit aufwendigen Elementen umgehen - Rechnern, Modalen oder Reiterwechseln.

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

6. Parametergrenzen und Richtlinien

Data Typing: MousePlayer automatically detects parameter types. Send numbers as integers or floats (e.g., 150.00, not "150.00") to enable advanced numerical filtering (e.g., "Price > 100") in the dashboard.

Regel Beschreibung
Länge des Ereignisnamens Höchstens 128 Zeichen. Am besten lesbar in snake_case, etwa user_signup.
Länge des Parameternamens Höchstens 64 Zeichen je Name, etwa transaction_id.
Textwerte Textparameter werden bei 255 Zeichen abgeschnitten, damit die Datenbank schnell bleibt.
Datenschutz Senden Sie keine personenbezogenen Daten als Ereignisparameter - keine E-Mail-Adressen, keine Klarnamen, keine Kennwörter.