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 | experimentId_variationId, kommagetrennt | Bestimmte Variations anzeigen |
ablyft_exclude_running | true oder false | Andere laufende Experiments während einer Preview ausblenden oder beibehalten |
ablyft_set_bucketing | JSON-Liste von "experimentId_variationId" | Die Zuweisungen des Visitors setzen |
ablyft_show_debug | true | Debug-Ausgabe anzeigen, wenn der Debug-Modus eingeschränkt ist |
ablyft_opt_out | true oder false | Den Browser von ABlyft ausschließen |
ablyft_check | true | Prüfen, ob das Snippet installiert ist |
ablyft_qa_token | Token | Das Quality-Assurance-Tool starten |
ablyft_editor_variation, 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.
https://www.example.com/product?ablyft_preview=12345678_87654321
https://www.example.com/product?ablyft_preview=12345678_87654321,23456789_98765432Gut 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 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.
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.
https://www.example.com/product?ablyft_preview=12345678_87654321&ablyft_exclude_running=falseDie 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.
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:
- Gib unter Settings → Project Settings die andere Domain bei External tracking domains ein.
- ABlyft hängt den Parameter an Links an, die auf diese Domain zeigen.
- 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():
const value = ablyft.getTools().getSetBucketingUrlExtension();
// '["12345678_87654321"]' or null if the visitor is in no experimentUngü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 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.
https://www.example.com/?ablyft_show_debug=trueOhne 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://www.example.com/?ablyft_opt_out=true
https://www.example.com/?ablyft_opt_out=falsetrue 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.
https://www.example.com/?ablyft_check=trueablyft_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.
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.
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.