Zum Hauptinhalt springen

Varify-URL-Query-Parameter werden aus der URL entfernt

Zuletzt aktualisiert am 14. Sept. 20262 Min. Lesezeit

So erkennst du den Fehler​

Beim Laden des Editors oder beim Anzeigen der Vorschau-Varianten über die entsprechenden Vorschau-Links werden wichtige URL-Query-Parameter an die URL angehängt.

Wenn diese von deiner Website entfernt oder blockiert werden, funktionieren der Editor oder andere Funktionen, wie die Preview-Links, möglicherweise nicht mehr richtig.

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—dies kann die Varify-Funktionalität beeinträchtigen, wenn die Parameter während eines Redirects, Reloads oder Cache-Lookups verloren gehen. Daher müssen die folgenden Parameter explizit als Whitelist (oder als „preserve query params“) in deiner Cache-/Redirect-Konfiguration angegeben werden.

Die Varify-Parameter im Detail​

ParameterZweck
varify-editorAktiviert 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-previewErzeugt eine Vorschau einer bestimmten Variante, bevor das Experiment live geht. Wird unter anderem für QA- und Freigabe-Workflows verwendet.
varify-forceErzwingt eine bestimmte Varianten-Zuweisung, unabhängig von der regulären Traffic-Verteilung (z. B. zum Debuggen oder gezielten Testen einer Variante).
varify-variation-idGibt die ID einer bestimmten Variante zurück—wird typischerweise zusammen mit varify-force oder varify-preview verwendet, um diese bestimmte Variante zu erzwingen oder anzuzeigen.
varify-variation-nameÄhnlich wie varify-variation-id, bezieht sich aber auf die Variante über ihren Namen statt über ihre ID—für besser lesbare Vorschau- und Debug-Links.
va-redWird für Redirects im Kontext von Split-URL-Tests verwendet, um sicherzustellen, dass Besucher auch nach einem Redirect korrekt der Zielvariante zugeordnet bleiben.

Empfehlung für das Whitelisting​

  • Füge alle sechs Parameter (genau wie angegeben, in Kleinbuchstaben und mit Bindestrichen) zu deiner URL-Parameter-Whitelist hinzu—egal ob im CDN-Cache-Key, im Consent-/Tracking-Cleaner oder in Redirect-Regeln.
  • Stelle sicher, dass sie sowohl bei internen Redirects als auch bei Cache-Bypasses erhalten bleiben, da varify-preview und varify-force andernfalls ihre Funktion verlieren.
  • Wenn du Cloudflare Page Rules oder Cache Rules verwendest: Diese Parameter müssen im „Cache Key“ enthalten sein oder explizit ausgeschlossen werden, damit unterschiedliche Varianten nicht denselben Cache-Eintrag teilen.