Zum Inhalt springen

Query-Parameter-Filterung

Standardmäßig macht jeder Query-Parameter eine Anfrage nicht-cachefähig — ein Link ?utm_source=newsletter und die nackte URL würden sonst eigene Cache-Einträge erzeugen, was die Cache-Größe sprengt und für jeden Tracking-Link in Ihrem Marketing einen MISS erzwingt.

Die Einstellung Ignorierte Query-Parameter behebt das, indem sie Parameter listet, die der Cache vor der Berechnung des Cache-Keys aus der URL entfernen soll.

Konfiguriert unter Einstellungen → Speed Boost → Dashboard → Query-Parameter-Filterung → Ignorierte Query-Parameter.

Die Eingabe ist ein Tag-artiges Feld — Parametername tippen, Enter drücken, wiederholen. Das Plugin liefert eine sinnvolle Standardliste mit, die die üblichen Tracking-Parameter abdeckt.

Übliche Einträge zum Hinzufügen:

  • utm_source, utm_medium, utm_campaign, utm_term, utm_content
  • gclid (Google Ads)
  • fbclid (Facebook)
  • msclkid (Microsoft Ads)
  • mc_cid, mc_eid (Mailchimp)
  • _ga, _gid (Google Analytics)
  • Jeder interne Tracking-Parameter, den Ihr Team hinzufügt

Wenn die Anfrage eingeht:

  1. Jeder Query-Parameter wird gegen die Liste Ignorierte Query-Parameter verglichen.
  2. Parameter aus der Liste werden aus dem Cache-Key entfernt, sodass der gecachte Eintrag mit der nackten URL geteilt wird.
  3. Die Parameter sind weiterhin für Ihren Storefront / JavaScript sichtbar — Shopware erhält die volle Anfrage, was bedeutet, dass Analytics-Skripte weiterhin die UTM-Werte sehen.

So profitiert der Besucher von einem Cache-HIT und Ihr Tracking funktioniert weiter.

Ein Query-Parameter, der nicht in der Liste steht, disqualifiziert die Anfrage vom Caching:

  • Die Antwort wird normal generiert
  • Sie wird unter keinem Cache-Key gespeichert
  • Folgende Anfragen mit demselben Parameter bauen die Seite neu auf

Wenn Sie merken, dass ein interner Parameter still den Cache umgeht, fügen Sie ihn zur Liste hinzu.

Manche Parameter ändern die Antwort tatsächlich — diese nicht ignorieren:

  • Paginierung (p, page) — andere Seite = anderer Inhalt
  • Sortierung (order) — andere Reihenfolge = anderer Inhalt
  • Filter (min-price, max-price, Properties) — gehören zum AJAX-Listing-Flow mit eigenem Caching
  • Suche (search) — andere Suche = anderer Inhalt

Das Plugin behandelt diese bereits korrekt über die AJAX-Listing-Routen — Sie müssen sie nicht selbst hinzufügen.

Die Liste lässt sich pro Sales Channel überschreiben. In den meisten Shops halten Sie eine globale Liste.

Öffnen Sie eine Produktseite zweimal:

Terminal-Fenster
curl -sI 'https://example.com/p/foo' | grep -i p2lab
curl -sI 'https://example.com/p/foo?utm_source=newsletter' | grep -i p2lab

Beide sollten HIT zurückgeben (vorausgesetzt, utm_source ist in der Liste und der Eintrag ist bereits gecacht).