Zum Inhalt springen
usertraxusertraxDokumentation

Erste Schritte

Diese Checkliste bringt dich von leerem Dashboard zu einem laufenden Live-Test. Voraussetzung: ein usertrax-Konto und Zugriff auf den HTML-<head> deiner Seite (oder eine der Integrationen).

10-Minuten-Checkliste

Section titled “10-Minuten-Checkliste”

  1. Domain anlegen

    Melde dich im usertrax Dashboard an, gehe zu Domains und lege deine Website an. Kopiere den API-Schlüssel.

  2. Tracking-Script einbinden

    Füge das Script in den <head> ein (Key ersetzen):

    <script
      src="https://usertrax.io/cvs.js"
      data-key="IHR_API_KEY"
      defer
    ></script>

    Details und Alternativen: Schnellstart.

  3. Conversion-Ziel vorbereiten

    Stelle sicher, dass mindestens ein Event gefeuert wird (z. B. purchase oder signup) — per push() oder data-usertrax. Das wird später dein Primärziel im Test.

    Siehe Events & Parameter.

  4. Ersten A/B-Test anlegen

    Im Dashboard unter A/B-Tests → Neuen Test erstellen: Test-Schlüssel, Primärziel, Traffic-Aufteilung und mindestens zwei Varianten. Schritt-für-Schritt: Tests erstellen.

  5. Variante auf der Seite ausspielen

    Wähle einen Ansatz:

    • HTML-Sichtbarkeit — Elemente mit data-usertrax-ab-test-* (einfachste Variante)
    • CSS/JS in der Varianten-Konfiguration — Änderungen ohne Markup-Duplikate
    • Eigene Logik — window.usertrax.getVariant(...) in deinem Code

  6. Live prüfen

    Öffne die Seite im Inkognito-Fenster, prüfe in der Konsole:

    window.usertrax.getAssignments();

    Löse eine Test-Conversion aus und schaue im Dashboard unter A/B-Tests → Analytics, ob Sessions und ggf. Conversions ankommen.

Grundkonfiguration

Section titled “Grundkonfiguration”

A/B-Tests aktivieren

Section titled “A/B-Tests aktivieren”

A/B-Tests sind standardmäßig aktiviert, sobald das Tracking-Script läuft und im Dashboard aktive Tests für die Domain existieren. Du steuerst das Verhalten über die Tracker-Konfiguration (usertraxConfig) und die Test-Einstellungen im Dashboard — nicht über ein separates Feature-Flag im Script.

Automatische Initialisierung

Section titled “Automatische Initialisierung”

Das A/B-Test-System erledigt beim Seitenaufbau Folgendes:

  1. Aktive Tests laden — Beim Session-Start holt der Tracker die aktiven Tests und Zuweisungen für die Domain.
  2. Variante anwenden — CSS wird in den <head> injiziert, JS der Variante ausgeführt, HTML-Sichtbarkeit gesetzt.
  3. Zuweisung speichern — Die Variante landet in sessionStorage unter usertrax_ab_<test_key>, damit die Sitzung stabil bleibt.
  4. Mit Conversions mitsenden — Jedes Conversion-Event erhält automatisch ab_test_data mit den aktuellen Zuweisungen.
// Nicht nötig: manuelles Laden oder Anwenden
// Der Tracker initialisiert A/B-Tests mit der Session

Sobald cvs.js geladen ist und die Session steht, sind Varianten aktiv. Für bedingte Eigenlogik reicht getVariant — siehe JavaScript-API.

Nächste Schritte

Section titled “Nächste Schritte”