# URL parameters

URL: https://docs.ablyft.com/de/developers/reference/url-parameters/

> Parameter in der Page-URL, die das Snippet liest, mit Format, Wirkung und Beispielen.



Das Snippet liest einige Parameter aus der URL der aktuellen Seite. Alle Namen beginnen mit `ablyft_`. Du verwendest sie, um
Variations in der Preview anzusehen, die Debug-Ausgabe einzuschalten, ein Opt-out durchzuführen und eine Variation-Zuweisung von einer Domain an eine andere zu übergeben.

| Parameter                                                                                                                                                | Wert                                        | Zweck                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------- |
| [`ablyft_preview`](#ablyft_preview)                                                                                                                      | `experimentId_variationId`, kommagetrennt   | Bestimmte Variations anzeigen                                                 |
| [`ablyft_exclude_running`](#ablyft_exclude_running)                                                                                                      | `true` oder `false`                         | Andere laufende Experiments während einer Preview ausblenden oder beibehalten |
| [`ablyft_set_bucketing`](#ablyft_set_bucketing)                                                                                                          | JSON-Liste von `"experimentId_variationId"` | Die Zuweisungen des Visitors setzen                                           |
| [`ablyft_show_debug`](#ablyft_show_debug)                                                                                                                | `true`                                      | Debug-Ausgabe anzeigen, wenn der Debug-Modus eingeschränkt ist                |
| [`ablyft_opt_out`](#ablyft_opt_out)                                                                                                                      | `true` oder `false`                         | Den Browser von ABlyft ausschließen                                           |
| [`ablyft_check`](#ablyft_check)                                                                                                                          | `true`                                      | Prüfen, ob das Snippet installiert ist                                        |
| [`ablyft_qa_token`](#ablyft_qa_token)                                                                                                                    | Token                                       | Das Quality-Assurance-Tool starten                                            |
| [`ablyft_editor_variation`](#ablyft_editor_variation-and-ablyft_editor_token), [`ablyft_editor_token`](#ablyft_editor_variation-and-ablyft_editor_token) | Variation-ID, Token                         | Den Visual Editor öffnen                                                      |

> Parameter werden anhand des exakten Namens erkannt. Das Präfix `ablyft_` ist fest, außer bei `ablyft_set_bucketing`, dessen Name du
> in den Project-Einstellungen ändern kannst.

## ablyft_preview

Zeigt die angegebenen Variations in deinem Browser an, für den Rest der Browser-Tab-Session. Der Wert ist eine kommagetrennte
Liste von `experimentId_variationId`-Paaren.

```text
https://www.example.com/product?ablyft_preview=12345678_87654321
https://www.example.com/product?ablyft_preview=12345678_87654321,23456789_98765432
```

Gut zu wissen:

* Die Einstellung wird im Tab gespeichert (`sessionStorage`) und bleibt daher aktiv, wenn du auf der Website navigierst.
* Im Preview-Modus werden **Goals nicht gezählt**.
* Experiments im Status **Preview** laufen nur in Browsern, die eine ihrer Variations mit diesem Parameter ausgewählt haben.
* Der Parameter wird ignoriert, wenn ABlyft die URL mit deinen [Pages](https://docs.ablyft.com/de/guides/audiences-and-delivery/pages/) vergleicht, er verändert das Targeting also nicht.

Normalerweise baust du diese Links nicht von Hand: ABlyft erstellt sie im Preview-Modus des Experiments, siehe
[Preview & QA](https://docs.ablyft.com/de/guides/experiments/preview-and-qa/).

## ablyft_exclude_running

Steuert, was mit deinen anderen, laufenden Experiments passiert, während du eine Preview ansiehst.

| Wert    | Wirkung                                                                                                |
| ------- | ------------------------------------------------------------------------------------------------------ |
| `true`  | Im Preview-Modus werden laufende Experiments, die du nicht ausgewählt hast, nicht angezeigt (Standard) |
| `false` | Laufende Experiments verhalten sich wie gewohnt                                                        |

ABlyft hängt `ablyft_exclude_running=false` an den Preview-Link an, wenn du **Exclude other running experiments** ausschaltest.

```text
https://www.example.com/product?ablyft_preview=12345678_87654321&ablyft_exclude_running=false
```

Die Auswahl wird für die Tab-Session gespeichert. Andere Werte werden ignoriert.

## ablyft_set_bucketing

Weist den Visitor Variations zu, ohne Preview. Der Wert ist eine JSON-Liste von `"experimentId_variationId"`-Strings. Das
Snippet führt sie mit den gespeicherten Zuweisungen des Visitors (`ablyft_exps`) zusammen; Einträge für dasselbe Experiment werden überschrieben.

```text
https://www.example.com/?ablyft_set_bucketing=["12345678_87654321","23456789_98765432"]
```

Kodiere den Wert in einem echten Link: `?ablyft_set_bucketing=%5B%2212345678_87654321%22%5D`.

So wird eine Variation-Zuweisung an eine andere Domain übergeben, zum Beispiel von deinem Shop an eine separate Checkout-Domain:

1. Gib unter **Settings → Project Settings** die andere Domain bei **External tracking domains** ein.
2. ABlyft hängt den Parameter an Links an, die auf diese Domain zeigen.
3. Auf der Zielseite liest das Snippet den Parameter und behält den Visitor in derselben Variation.

Der Parametername ist standardmäßig `ablyft_set_bucketing`. Du kannst ihn unter **Bucketing handover query parameter** ändern (gleiche Einstellungen).

Um den Wert für den aktuellen Visitor selbst zu erzeugen, nutze [`getSetBucketingUrlExtension()`](https://docs.ablyft.com/de/developers/reference/javascript-api/tools/):

```js
const value = ablyft.getTools().getSetBucketingUrlExtension();
// '["12345678_87654321"]' or null if the visitor is in no experiment
```

> **Ungültige Werte:** Ist der Wert kein gültiges JSON oder keine nicht-leere Liste, wird der Parameter ignoriert und im Debug-Modus ein Fehler protokolliert.

## ablyft_show_debug

Ist der [Debug-Modus](https://docs.ablyft.com/de/developers/debugging/preview-and-live-log/#debug-mode) mit **Restrict debug mode** eingeschaltet, schreibt das Snippet nur für Visitors in die
Browser-Konsole, die eine URL mit `ablyft_show_debug=true` geöffnet haben. Die Einstellung wird für die Tab-Session gespeichert.

```text
https://www.example.com/?ablyft_show_debug=true
```

Ohne Einschränkung erzeugt jeder Visitor Konsolenausgaben, solange der Debug-Modus an ist. Der Parameter hat keine Wirkung, wenn der Debug
Mode aus ist.

## ablyft_opt_out

Schließt den Browser auf dieser Website von ABlyft aus. Details stehen unter [Storage & privacy](https://docs.ablyft.com/de/developers/consent-and-security/storage-and-privacy/#opt-out).

```text
https://www.example.com/?ablyft_opt_out=true
https://www.example.com/?ablyft_opt_out=false
```

`true` führt das Opt-out durch, `false` hebt es wieder auf. In beiden Fällen wird eine Meldung angezeigt. Andere Werte bewirken nichts.

## ablyft_check

Zeigt einen Browser-Alert "ABlyft is implemented", wenn das Snippet auf der Seite installiert ist. Ein schneller Test für Nicht-Entwickler.

```text
https://www.example.com/?ablyft_check=true
```

## ablyft_qa_token

Startet das Quality-Assurance-Tool. ABlyft erzeugt die Links mit diesem Parameter, du erstellst den Wert also nicht selbst.
Das Token wird für die Tab-Session gespeichert. Wie `ablyft_preview` wird der Parameter beim URL-Targeting ignoriert.
Nutze **Open with quality assurance tool** in der Preview eines Experiments, siehe [Preview & QA](https://docs.ablyft.com/de/guides/experiments/preview-and-qa/).

## ablyft_editor_variation und ablyft_editor_token

Öffnen den Visual Editor auf deiner Seite. ABlyft hängt beide Parameter an deine Beispiel-URL an, wenn du den Editor öffnest, du
erstellst sie also nicht selbst.

```text
https://example.com/product?ablyft_editor_variation=12345&ablyft_editor_token=YOUR_EDITOR_TOKEN
```

| Parameter                 | Bedeutung                                                    |
| ------------------------- | ------------------------------------------------------------ |
| `ablyft_editor_variation` | Die ID der Variation, die du bearbeitest.                    |
| `ablyft_editor_token`     | Ein persönliches Access-Token, das **8 Stunden** gültig ist. |

Findet das Snippet das Token, lädt es den Editor über deiner Seite. Siehe [Visual Editor](https://docs.ablyft.com/de/guides/experiments/visual-editor/).

## Nächste Schritte

- [Debugging](https://docs.ablyft.com/de/developers/debugging/): Überprüfe die Integration.
- [Read the bucketing](https://docs.ablyft.com/de/developers/reference/javascript-api/get/#bucketing): Lies die Zuweisung des Visitors mit ablyft.get().

