Zum Inhalt springen

Installation

Welche Funktionen hat das Tracking-SDK?

Das SDK stellt init, setConsent, page, track, identify, conversion, goal und reset bereit, dazu paymentReference für Stripe und PayPal, fillForm für Formulare sowie renderSurvey und survey für die Nachkauf-Frage. Es lädt asynchron, sammelt Aufrufe vor dem Laden in einer Warteschlange und sendet Events gebündelt.

Welche JavaScript-Aufrufe stehen mir zur Verfügung?

metrunio.init({ siteId, writeKey, endpoint, consent, autoPageviews, testMode, debug });
metrunio.setConsent({ analytics: true, marketing: true });
metrunio.page({ bereich: 'start' });
metrunio.track('add_to_cart', { produkt: 'abc', preis: 24.9 });
metrunio.identify('kundennummer-4711');
metrunio.conversion({ orderId: '12345', value: 149.9, currency: 'EUR' });
metrunio.goal('shop_angelegt'); // Zielschritt, zählt je Kunde einmal
metrunio.paymentReference(); // Referenz für Stripe und PayPal, nur mit Einwilligung
metrunio.renderSurvey('#metrunio-frage', { orderId: '12345' }); // Nachkauf-Frage auf der Danke-Seite
metrunio.survey({ orderId: '12345', answer: 'podcast_radio' }); // Antwort aus eigener Oberfläche
metrunio.fillForm('#anfrage'); // Lead-Kennung und Herkunft ins Formular
metrunio.reset();

Verhalten

  • Asynchrones Laden; Aufrufe vor dem Laden landen in window.metrunioQueue und werden anschließend abgespielt.
  • Batch-Versand: standardmäßig zehn Events beziehungsweise 1,5 Sekunden; beim Verlassen der Seite über navigator.sendBeacon.
  • Bis zu drei Wiederholungen mit Backoff; danach bleibt der Batch lokal und wird beim nächsten Seitenaufruf erneut gesendet.
  • Die Event-ID entsteht vor dem Versand, damit Wiederholungen idempotent bleiben.
  • Ohne Marketing-Einwilligung verlassen Werbeevents das Gerät gar nicht erst.
  • Kein Fingerprinting: Die pseudonyme ID ist ein zufälliger First-Party-Wert im LocalStorage.
  • Ein eigenes Ereignis bekommt seinen Namen über event_name: metrunio.track('custom', { event_name: 'newsletter_signup' }). Buchstaben, Ziffern und _ . : -, höchstens 64 Zeichen; so steht es im Besuchsverlauf einer Journey.

Fehlermeldungen in der Konsole

CodeBedeutung
CONFIG_INCOMPLETEsiteId, writeKey oder endpoint fehlt, oder statt des Write Keys steht noch der Platzhalter
DOUBLE_INITinit() ein zweites Mal, meist durch eine doppelte Einbindung; es gilt der erste Aufruf
NOT_INITIALIZEDAufruf vor init()
CONVERSION_ORDER_ID_MISSINGKauf ohne Bestellnummer
GOAL_KEY_MISSINGZielschritt ohne Schlüssel
GOAL_KEY_INVALIDSchlüssel mit Leerzeichen, Umlauten oder Sonderzeichen außer _ . und -, oder länger als 64 Zeichen; Großbuchstaben schreibt das SDK selbst klein

Hinweis

debug: true protokolliert jede Entscheidung des SDK in der Browserkonsole. Das hilft besonders, wenn du sehen willst, warum ein Event wegen fehlender Einwilligung nicht gesendet wurde.

Zuletzt geprüft am 13.10.2026

Ebenfalls gefragt

  • JavaScript API
  • metrunio.track
  • Wie sende ich ein eigenes Event?
  • SDK Dokumentation

Weiterführende Artikel

  • Wie baue ich das Code-Snippet ein?

    Wie installiere ich Metrunio ohne Tag Manager?

    Der fertige Codeblock steht im Portal unter „Einrichtung → Snippet“ und enthält Site-ID und Collector-Adresse. Den Schreibschlüssel siehst du nur einmal, beim Anlegen; ist er nicht mehr bekannt, steht im Code der Platzhalter DEIN_WRITE_KEY, und daneben erzeugst du mit einem Klick einen neuen. Der Block gehört unmittelbar vor das schließende head-Tag und lädt asynchron.

  • Wie messe ich eine Single-Page-App?

    Was tun, wenn Seitenwechsel ohne Neuladen nicht gezählt werden?

    Mit automatischen Seitenaufrufen (autoPageviews, voreingestellt) zählt das SDK auch Seitenwechsel ohne Neuladen selbst: Es bemerkt jede Adressänderung über pushState, replaceState und die Zurück-Taste. Selbst rufst du metrunio.page() nur auf, wenn dein Router die Ansicht wechselt, ohne die Adresse zu ändern, oder wenn du autoPageviews abgeschaltet hast.

  • Welche Ereignisse misst Metrunio?

    Welche Eventtypen gibt es und welche Einwilligung brauchen sie?

    Es gibt fünfzehn Eventtypen. Die vier Werbeevents benötigen eine Marketing-Einwilligung, alle übrigen mindestens eine Analytics-Einwilligung; ohne passende Einwilligung wird ein Ereignis nicht gespeichert. Einzige Ausnahme sind Kauf und Erstattung, die dein Server ohne Einwilligung meldet: Sie zählen zur Umsatzabstimmung mit Bestellnummer, ohne Browser-, Kunden- und Werbekennungen, und werden nicht zugeordnet; nach einer Ablehnung gilt das nur mit aktivierter Zusatzweisung.

  • Wie melde ich einen Zielschritt?

    Wie sende ich die Schritte meines Funnels aus Browser oder Backend?

    Im Browser mit metrunio.identify(userId) einmal nach der Anmeldung und dann metrunio.goal('schluessel') je Schritt; aus dem Backend mit POST /v1/server/events und einem Ereignis vom Typ goal mit goal_key und user_id. Beide Wege sind gleichwertig; ein Schritt ohne Kundenkennung wird abgelehnt.

  • Wie frage ich nach dem Kauf, wie Kunden mich gefunden haben?

    Kann Metrunio nach dem Kauf fragen, wie jemand auf uns aufmerksam wurde?

    Mit der Nachkauf-Frage, in jedem Tarif. Du schaltest sie unter „Einstellungen → Messregeln“ ein und rufst auf deiner Danke-Seite metrunio.renderSurvey() mit der Bestellnummer auf. Die Antworten stehen als „angegeben“ unter „Kanäle & Attribution“: neben dem Gemessenen, nie im Umsatz und nie in einer Zuordnung.

  • Wie kommt die Herkunft einer Anfrage in mein CRM?

    Kann Metrunio Quelle, Kampagne und eine Kennung in mein Kontaktformular schreiben?

    Über dein Formular, in jedem Tarif: Gib ihm das Attribut data-metrunio-lead, dann füllt das SDK mit Einwilligung in Analyse die Felder metrunio_lead_id, metrunio_source, metrunio_medium, metrunio_campaign, metrunio_click_id und metrunio_click_platform; ohne Einwilligung bleiben sie leer, außer du schaltest für die Website „Herkunft auch ohne Einwilligung“ ein. Mit der Lead-Kennung findet der Offline-Import den späteren Abschluss aus dem CRM in der Journey wieder.

Sieh, was deine Daten erzählen.

Erst in der Demo umsehen. Ein eigenes Konto gibt es derzeit nur auf Einladung.

Demo öffnenZugang anfragen