Custom Script

Ein Skript. Alle Funktionen. Fügen Sie ein schlankes Snippet in den Quellcode Ihrer Website ein und schalten Sie die volle Power von Positive User frei: Besucher-Tracking, Live-Chat, Kontakt-Identifizierung und ereignisbasierte Automatisierung. Kein Plugin, keine CMS-Abhängigkeit, kein Entwickler nötig, abgesehen vom Zugriff auf das HTML.

Get started

View Documentation

Funktioniert auf jeder Website

Kein CMS-Plugin? Kein Problem. Das Positive User-Skript lässt sich in jede Website integrieren: statisches HTML, individuell entwickelte Anwendungen, Headless-Architekturen oder Plattformen ohne dediziertes Plugin. Fügen Sie das Snippet unmittelbar vor dem schließenden </body>-Tag ein, und das Tracking läuft sofort.

Vom anonymen Besucher zum bekannten Kontakt

Sobald das Skript geladen ist, vergibt Positive User jedem Besucher einen eindeutigen Schlüssel und beginnt mit dem Tracking von Seitenaufrufen, Gerät, Browser und Standort, alles anonym. Wenn Sie bereit sind, Nutzer zu identifizieren, übergeben Sie über das Skript Attribute wie E-Mail, Name oder Telefonnummer. Die gesamte Vor-Identifizierungs-Aktivität wird dann mit dem identifizierten Kontaktprofil zusammengeführt.

Beliebige Daten übergeben

Das window.civchat-Objekt akzeptiert Standard-Attribute (Name, E-Mail, Telefonnummer, Status, Score) sowie Unternehmensdaten (Firmenname, ID, Umsatz), alles in einem einzigen Code-Block. Verwenden Sie statische Werte, GTM-Variablen oder dynamisches JavaScript, um das Objekt zu befüllen. Was Sie übergeben, landet sofort im Kontaktprofil.

Skript kopieren

Öffnen Sie in Ihrer Positive User-App den Bereich Settings > Setup & Integrations > Basic Integration. Kopieren Sie das Skript. Es enthält bereits Ihren API-Schlüssel und Ihre App-Domain.

Skript in Ihre Website einfügen

Fügen Sie das Skript unmittelbar vor dem schließenden </body>-Tag im Quellcode Ihrer Website ein. Alternativ können Sie es über Google Tag Manager mit einem Trigger ausrollen, der auf allen Seiten ausgelöst wird.

Tracking überprüfen

Rufen Sie Ihre Website auf und öffnen Sie anschließend den Bereich Kontakte in Positive User. Innerhalb weniger Sekunden sollten neue anonyme Besuchereinträge erscheinen. Für eine technische Prüfung öffnen Sie die Browser-Konsole, geben civchat ein und bestätigen, dass das Objekt definiert ist. Das Tracking ist live.

Brauche ich Programmierkenntnisse, um das Skript zu integrieren?
‍Sehr wenig. Sie benötigen Zugriff auf den HTML-Quellcode Ihrer Website (oder auf Google Tag Manager) und fügen ein vorgefertigtes Snippet ein. Das Skript wird direkt aus Ihren Positive User-Einstellungen kopiert, ohne Bearbeitung. Wer eine Website-Datei öffnen oder ein Tag in GTM einfügen kann, ist gut aufgestellt.
‍

Was ist der Unterschied zwischen Basis- und erweitertem Skript?
‍Das Basis-Skript enthält ausschließlich Ihren API-Schlüssel. Es aktiviert das anonyme Besucher-Tracking, die Erfassung von Seitenaufrufen und das Chat-Widget. Das erweiterte Skript fügt ein window.civchat-Objekt hinzu, in dem Sie Nutzer-Attribute (E-Mail, Name, Telefon) und Unternehmensdaten übergeben können. Besucher landen damit von Anfang an als identifizierte Kontakte in Positive User.
‍

Wird das Skript meine Website verlangsamen?
‍Nein. Das Skript wird asynchron geladen und ist schlank. Es blockiert weder das Rendering der Seiten noch beeinträchtigt es die Performance Ihrer Website.
‍

Kann ich diese Integration über Google Tag Manager nutzen, statt meinen Quellcode zu bearbeiten?
‍Ja. Sie können das Positive User-Skript als Custom-HTML-Tag in GTM einbinden. Setzen Sie den Trigger so, dass er auf allen Seiten ausgelöst wird. Das ist der empfohlene Weg, wenn Ihr Team bereits andere Tags über GTM verwaltet oder Sie keinen direkten Zugriff auf den Quellcode der Website haben.
‍

Wie funktioniert das anonyme Besucher-Tracking?
‍Sobald das Skript geladen wird, generiert es einen eindeutigen user_key und legt ein Cookie im Browser des Besuchers ab. Jeder Seitenaufruf wird mit diesem Schlüssel erfasst. Der Besucher erscheint in Positive User als anonymer Eintrag, bis er sich identifiziert (Chat-Interaktion, Formular-Übermittlung oder Attribute über das erweiterte Skript).
‍

Welche Datenformate werden für Attribute benötigt?
‍Datumsangaben müssen dem ISO-8601-Format entsprechen (z. B. 2017-07-25T14:14:08.612Z). Telefonnummern müssen das E.164-Format nutzen (z. B. +44754123434). Andere Attribute akzeptieren Strings, Zahlen oder Booleans, je nach dem in Ihrer Positive User-App definierten Feldtyp.
‍

Kann ich Unternehmensdaten zusammen mit Nutzerdaten übergeben?
‍Ja. Das window.civchat-Objekt akzeptiert ein verschachteltes company-Objekt mit Attributen wie name, company_id und revenue. Damit werden in einem einzigen Aufruf sowohl das Kontaktprofil als auch der zugehörige Unternehmens-Datensatz in Positive User erstellt oder aktualisiert, wobei die Verknüpfung automatisch erhalten bleibt.
‍

Was, wenn ich nicht möchte, dass das Chat-Widget erscheint?
‍Sie können das Skript trotzdem ausschließlich für Tracking und Datenerfassung nutzen. Öffnen Sie Settings > Chat Widget Settings > Widget Visibility und setzen Sie den Widget-Status auf „Hidden". Das Skript läuft im Hintergrund unverändert weiter.
‍

Wie überprüfe ich, ob das Skript funktioniert?
‍Zwei Wege. Erstens: Prüfen Sie den Bereich Kontakte in Ihrer Positive User-App — nach einem Besuch Ihrer Website sollten neue anonyme Einträge erscheinen. Zweitens: Öffnen Sie die Entwicklerkonsole Ihres Browsers auf Ihrer Website und geben Sie civchat ein. Ist das Objekt definiert, ist das Skript geladen und das Tracking aktiv.
‍

Kann ich mit diesem Skript benutzerdefinierte Events tracken?
‍Das Skript selbst kümmert sich um Besucher-Identifikation und Attribut-Übergabe. Um benutzerdefinierte Events zu senden (Käufe, Formular-Übermittlungen, Button-Klicks), müssen Sie separat Event-Tracking-Aufrufe ergänzen — entweder über die Positive User-JavaScript-API oder über Google-Tag-Manager-Trigger. Unser Team unterstützt Sie dabei, den passenden Ansatz für Ihren Anwendungsfall zu definieren.
‍

Custom Script