# Preview & Live Log

URL: https://docs.ablyft.com/de/developers/debugging/preview-and-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.

| Tool                                      | Nutze es, um                                                             |
| ----------------------------------------- | ------------------------------------------------------------------------ |
| [Debug-Modus](#debug-mode)                | In der Konsole zu sehen, warum Experiments laufen oder nicht laufen      |
| [Preview-Modus](#preview-mode)            | Eine Variation anzusehen, ohne Teil des echten Traffics zu sein          |
| [QA-Tool](#qa-tool)                       | Targeting und Goals zu prüfen, während du dich durch die Website klickst |
| [Variation erzwingen](#force-a-variation) | Eine bestimmte Variation aus deinem eigenen Code zu zeigen               |
| [Live Log](#live-log)                     | Die 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](https://docs.ablyft.com/de/developers/installation/publishing/).

> **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](https://docs.ablyft.com/de/developers/debugging/verify-integration/#6-react-to-snippet-events-in-your-code).

## 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](https://docs.ablyft.com/de/guides/experiments/preview-and-qa/).

Im Hintergrund enthält der Preview-Link die URL-Parameter `ablyft_preview` und `ablyft_exclude_running`, siehe
[URL parameters](https://docs.ablyft.com/de/developers/reference/url-parameters/#ablyft_preview). 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](https://docs.ablyft.com/de/guides/experiments/preview-and-qa/#the-preview-box).
Ausgelöste Goals werden nicht gesendet, sondern lokal aufgezeichnet, siehe unten.

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

```js
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](https://docs.ablyft.com/de/developers/installation/requirements/#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()`](https://docs.ablyft.com/de/developers/reference/javascript-api/push/#forcevariation).
Erzwungene Visitors sind echte Participants; für einen schnellen Blick auf eine Variation nutze den [Preview-Modus](#preview-mode).

## 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](https://docs.ablyft.com/de/developers/consent-and-security/storage-and-privacy/#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](https://docs.ablyft.com/de/guides/goals-and-measurement/verify-measurement/#check-events-in-the-live-log).

> Goals, die im [Preview-Modus](#preview-mode) ausgelöst werden, werden nicht gesendet und erscheinen daher nicht im Live Log.

## Nächste Schritte

* [Integration prüfen](https://docs.ablyft.com/de/developers/debugging/verify-integration/)
* [Häufige Probleme](https://docs.ablyft.com/de/developers/debugging/common-issues/)
* [URL parameters](https://docs.ablyft.com/de/developers/reference/url-parameters/)

