Varify URL Query Parameter werden aus der URL entfernt
Inhaltsverzeichnis
So erkennst du den Fehler
Beim Laden des Editors oder dem Anzeigen der Preview-Varianten über die entsprechenden Preview-Links, werden der URL wichtige URL Query Parameter angehängt.
Werden diese durch deine Website entfernt oder blockiert, kann der Editor oder andere Funktionen, wie die Preview-Links, nicht mehr richtig funktionieren.
So behebst du den Fehler
Viele Caching-Systeme, CDNs (z. B. Cloudflare), Tag-Manager oder Consent-Tools normalisieren URLs und entfernen dabei unbekannte Query Parameter – das kann Varify-Funktionalität brechen, wenn die Parameter beim Redirect, Reload oder Cache-Lookup verloren gehen. Deshalb müssen folgende Parameter explizit als Whitelist (bzw. als „preserve query params“) in eurer Cache-/Redirect-Konfiguration hinterlegt werden.
Die Varify-Parameter im Detail
| Parameter | Zweck |
|---|---|
varify-editor | Aktiviert den Visual Editor auf der Seite – wird gesetzt, wenn ein Experiment im Editor bearbeitet wird. Ohne diesen Parameter lädt die Seite nicht im Editor-Modus. |
varify-preview | Erzeugt eine Preview einer bestimmten Variante, bevor das Experiment live geschaltet ist. Wird u. a. für QA und Freigabe-Workflows genutzt. |
varify-force | Erzwingt eine bestimmte Variantenzuweisung, unabhängig von der regulären Traffic-Aufteilung (z. B. für Debugging oder gezieltes Testen einer Variante). |
varify-variation-id | Übergibt die ID einer konkreten Variante – wird typischerweise zusammen mit varify-force oder varify-preview verwendet, um genau diese Variante zu erzwingen bzw. anzuzeigen. |
varify-variation-name | Analog zu varify-variation-id, adressiert die Variante aber über ihren Namen statt über die ID – für besser lesbare Preview-/Debug-Links. |
va-red | Wird für Redirects im Kontext von Split-URL-Tests genutzt, damit Besucher korrekt der Zielvariante zugeordnet bleiben, auch nach einer Weiterleitung. |
Empfehlung fürs Whitelisting
- Trage alle sechs Parameter (exakt in Kleinschreibung, mit Bindestrich) in eure URL-Parameter-Whitelist ein – egal ob im CDN-Cache-Key, im Consent-/Tracking-Cleaner oder in Redirect-Regeln.
- Achte darauf, dass sie sowohl bei internen Redirects als auch bei Cache-Bypässen erhalten bleiben, da
varify-previewundvarify-forcesonst ihre Funktion verlieren. - Falls ihr mit Cloudflare Page Rules oder Cache Rules arbeitet: Diese Parameter müssen im „Cache Key“ berücksichtigt bzw. explizit ausgenommen werden, damit unterschiedliche Varianten nicht denselben Cache-Eintrag teilen.