ABlyftDocs
Open app
DokumentationAPI Reference
ABlyft integrierenDebugging

Preview & Live Log

Debug-Modus, Preview-Modus, das QA-Tool, erzwungene Variations und der Live Log.

Diese Seite beschreibt die Tools, die dir zeigen, was ABlyft auf einer Seite tut und welche Events es sendet.

ToolNutze es, um
Debug-ModusIn der Konsole zu sehen, warum Experiments laufen oder nicht laufen
Preview-ModusEine Variation anzusehen, ohne Teil des echten Traffics zu sein
QA-ToolTargeting und Goals zu prüfen, während du dich durch die Website klickst
Variation erzwingenEine bestimmte Variation aus deinem eigenen Code zu zeigen
Live LogDie Events zu sehen, die ABlyft tatsächlich empfangen hat

Debug-Modus

Der Debug-Modus schreibt die Entscheidungen des Snippets in die Browser-Konsole. Jede Zeile beginnt mit ABlyft #.

Einschalten

  1. Öffne dein Project und gehe zu Settings → Project Settings.
  2. Aktiviere im Abschnitt Debug Mode die Option Debug mode.
  3. Aktiviere optional Restrict debug mode. Dann zeigen nur Browser die Ausgabe, die eine Seite mit ?ablyft_show_debug=true geöffnet haben. Die Einstellung wird für die Browser-Session gemerkt.
  4. Speichere und warte auf die Publication.

Der Debug-Modus schaltet sich selbst aus

Der Debug-Modus schaltet sich nach 8 Stunden automatisch aus und deaktiviert das Snippet-Caching, solange er an ist. Lass ihn nicht länger als nötig an und nutze auf einer Live-Website Restrict debug mode, damit Visitors keine Konsolenausgabe sehen.

Was du siehst

Bei eingeschaltetem Debug-Modus zeigt die Konsole die Initialisierung des Snippets (Project, Revision, Storage) und danach eine Zeile pro Entscheidung, nach Ebene eingerückt:

  • Initiated PAGE "…": eine Page hat gepasst und wurde aktiv
  • Initiated EXPERIMENT "…", Initiated ENVIRONMENTS LOOKUP, Initiated AUDIENCES LOOKUP: das Experiment wird geprüft
  • ENVIRONMENT "…" is matching, AUDIENCES passed, Passed all exclusion groups, Exclusion group not passed
  • EXPERIMENT "…" not running - User is excluded: der Visitor wurde zuvor ausgeschlossen und bleibt ausgeschlossen
  • Triggering BUCKETING Event: der Visitor wurde einer Variation zugewiesen
  • Applying JS, Applying VisualChanges: Variation-Code wird ausgeführt
  • Triggered GOAL "…": ein Goal wurde ausgelöst
  • General Prerequisite Rules NOT met, Tracking Prerequisite Rules NOT met, Rated as Bot- Exiting: das Snippet stoppt oder trackt nicht

Fehler in Regeln oder in deinem JavaScript werden als ERROR on … in Rot angezeigt und zusätzlich als Browser-Event ablyftError ausgelöst, siehe Integration prüfen.

Preview-Modus

Mit dem Preview-Modus kannst du dir eine Variation eines Experiments ansehen, auch wenn das Experiment noch nicht läuft.

Am einfachsten geht das über den Abschnitt Preview auf der Experiment-Seite. Wähle eine Variation to preview und eine URL to preview und öffne den Link Open preview directly in browser. Du kannst auch die Preview/Sharing URL kopieren oder den QR-Code scannen, um die Preview auf einem Smartphone zu sehen. Siehe Preview & QA.

Im Hintergrund enthält der Preview-Link die URL-Parameter ablyft_preview und ablyft_exclude_running, siehe URL parameters. Die Einstellungen werden für die Browser-Session (in sessionStorage) gehalten, sodass du dich durch deine Website klicken kannst, ohne die Parameter zu wiederholen.

Welche Experiments und Prüfungen während einer Preview gelten, steht unter Preview & QA. Ausgelöste Goals werden nicht gesendet, sondern lokal aufgezeichnet, siehe unten.

Prüfe den Zustand des Preview-Modus in der Konsole:

ablyft.get('data').isPreview;        // true in preview mode
ablyft.get('preview_bucketing');     // { experimentId: variationId } from the preview parameter
ablyft.get('pingedGoals');           // goals that fired in preview mode: [{ id, time, value }]

pingedGoals wird nur im Preview-Modus gefüllt. Es listet Goals, die in der aktuellen Browser-Session ausgelöst wurden, und ist damit ein schneller Weg, Goals zu testen, ohne deine Results zu verändern.

Um den Preview-Modus zu verlassen, schließe den Tab oder lösche die Session-Storage-Schlüssel, die mit ablyft_ beginnen (ablyft_preview_combs, ablyft_exclude_running).

QA-Tool

Das QA-Tool zeigt ein Panel über deiner Website, während du sie im Preview-Modus durchsuchst. Es hilft dir, Targeting und Goals zu prüfen.

  1. Öffne das Experiment und gehe zum Abschnitt Preview.
  2. Klicke auf Open with quality assurance tool.

Das öffnet deine Seite mit dem zusätzlichen Parameter ablyft_qa_token=<token>. Das Snippet lädt das Tool, nachdem die Seite geladen wurde, und behält das Token für die Browser-Session.

Erlaube das QA-Tool auf deiner Website

Wenn deine Website eine Content Security Policy verwendet, muss app.ablyft.com für das QA-Tool in connect-src erlaubt sein. Siehe Network and Content Security Policy.

Variation erzwingen

Um einem Visitor aus deinem eigenen Code eine bestimmte Variation zu zeigen, zum Beispiel in einem automatisierten Test, pushe ein forceVariation-Event. Den Aufruf und seine Grenzen findest du unter ablyft.push(). Erzwungene Visitors sind echte Participants; für einen schnellen Blick auf eine Variation nutze den Preview-Modus.

Opt-out für Tester

Um deine eigenen Besuche aus den Daten herauszuhalten, öffne deine Website einmal mit ?ablyft_opt_out=true. Siehe Opt-out.

Live Log

Der Live Log (Project → Activity Log → Live Log) zeigt die neuesten Events, die ABlyft von den Snippets deines Projects empfangen hat. Spalten, Filter und wie du sie liest, sind beschrieben unter Check events in the Live Log.

Goals, die im Preview-Modus ausgelöst werden, werden nicht gesendet und erscheinen daher nicht im Live Log.

Nächste Schritte

Integration prüfen

Prüfe im Browser, dass das ABlyft-Snippet geladen, aktuell und am Senden von Events ist.

Häufige Probleme

Typische technische Probleme mit dem ABlyft-Snippet und wie du sie löst.

On this page

Debug-ModusEinschaltenWas du siehstPreview-ModusQA-ToolVariation erzwingenOpt-out für TesterLive LogNächste Schritte