Events und dataLayer-Felder
Nachschlagewerk für Webentwickler. Welche Events der Konfigurator über das Tracking-Skript in den dataLayer schreibt und welche Felder jedes Event mitsendet.
Der Konfigurator schickt seine Events per postMessage an die Seite, in der er steht. Das Tracking-Skript (mp-tracking.js) schreibt sie in window.dataLayer und löst zusätzlich ein meetpiloot-Event auf document aus, mit der ursprünglichen Nachricht in detail.
Events
| Event | Wann |
|---|---|
meetpiloot_configurator_started | Der Besucher öffnet den Konfigurator. |
meetpiloot_product_selected | Der Besucher wählt ein Produkt und gegebenenfalls einen Typ (Wintergarten, Carport und so weiter). |
meetpiloot_step_completed | Der Besucher schließt einen Schritt ab, mit Schrittnummer und -name. |
meetpiloot_option_selected | Der Besucher wählt eine Option in einem Schritt. |
meetpiloot_lead_submitted | Der Besucher schickt die Anfrage ab. Das ist die Conversion, mit Wert und Transaktions-ID. |
Felder
Jedes Event enthält die Felder unten, soweit sie bei diesem Event bekannt sind. Nutze sie in GTM als dataLayer-Variablen.
| Feld | Typ | Beispiel |
|---|---|---|
mp_product_type | Text | veranda, lamellen |
mp_veranda_subtype | Text | tuinkamer, serre, carport |
mp_step | Zahl | 3 |
mp_step_name | Text | color, placement |
mp_total_steps | Zahl | 12 |
mp_selected_option | Text | Anthrazit |
mp_session_id | Text | UUID |
mp_lead_id | Text | UUID, nur bei lead_submitted |
mp_company_slug | Text | terrassendach-jan |
mp_value | Zahl | 8086, nur bei lead_submitted |
mp_currency | Text | EUR |
mp_transaction_id | Text | UUID, zur Deduplizierung zwischen Plattformen |
mp_event_id | Text | mp-<Lead-ID>-Lead, nur bei lead_submitted: als eventID des Meta-Pixels verwenden. meetpiloot sendet serverseitig dieselbe ID, damit Meta den Lead einmal zählt |
mp_em_sha256, mp_ph_sha256 | Text | SHA-256 von E-Mail und Telefon, für Enhanced Conversions |
mp_gclid, mp_gbraid, mp_wbraid | Text | Klick-IDs von Google Ads |
mp_msclkid | Text | Klick-ID von Microsoft Ads |
mp_fbclid | Text | Klick-ID von Meta |
mp_ttclid | Text | Klick-ID von TikTok |
mp_utm_source bis mp_utm_content | Text | die fünf UTM-Parameter |
mp_timestamp | Zahl | Zeitpunkt in Millisekunden |
Jeder Lead kommt einmal als meetpiloot_lead_submitted an, auch wenn der Besucher zweimal absendet oder die Seite neu lädt. Verwende mp_transaction_id als transaction_id in GA4 und als Bestell-ID in Google Ads, dann zählt auch dort ein Lead nie doppelt.
Felder ohne Wert sind leer oder fehlen. Die Klick-IDs und UTM-Parameter kommen aus der Adresse deiner eigenen Seite, auch wenn der Besucher zuerst auf einer anderen Seite deiner Website gelandet ist: Das Skript speichert sie für die ganze Sitzung.
Auch interessant
Kommst du nicht weiter?
Schreib uns oder öffne ein Ticket in deinem Dashboard. Antwort innerhalb von 1 bis 2 Werktagen.