URL-Parameter
Die Get-Methode ist die am weitesten verbreitete HTTP-Request-Methode, um Inhalte (Ressourcen) durch einen Browser (oder anderen Client) von einem Server anzufordern. Da die übertragenen Seiteninhalte oder Dateien mithilfe von URLs angefordert werden, ist auch die Bezeichnung URL-Parameter gebräuchlich: Diese Methode wird bei WEBSALE V8s angewendet.
Fragt ein Browser bei einem Webserver einen bestimmten Inhalt an, übermittelt der Browser dem Server mit der angefragten URL bestimmte Parameter (GET-Parameter). Diese Parameter sind Paare aus Namen und dazugehörigen Werten – sogenannte Name-Wert-Paare. WEBSALE V8s fügt diese mit den Zeichen ? oder & an die URL an und teilt dem Server dadurch mit, welche Inhalte gemeint sind. Name und Wert werden dabei stets durch ein = voneinander getrennt.
Die Syntax einer WEBSALE Shop-URL sieht folgendermaßen aus:
http://www.ihr-shop.de/<sprechender Name>?name=wert
Wegweiser: SEO-URLs
WEBSALE V8s unterstützt nicht nur einzelne, sondern auch mehrere Parameter bis hin zu ganzen Listen, die an den Server übermittelt werden können. Dafür werden die einzelnen Parameter immer mit dem &-Zeichen bzw. mit dem ?-Zeichen voneinander getrennt. Der erste Parameter wird mit dem ?-Zeichen getrennt, alle folgenden Parameter mit dem &-Zeichen.
http://www.ihr-shop.de/<sprechender Name>?name1=wert&name2=wert&name3=wert&name4=wert
Bei den Parametern unterscheidet WEBSALE V8s zwischen Basis- und Zusatzparametern.
Basis-Parameter müssen – abhängig davon, welche Seite geöffnet werden soll – zwingend in der URL enthalten sein, um die Shopfunktionalität der gewählten Seite zu gewährleisten.
Wegweiser: Basis-Parameter
Neben den Basis-Parametern unterstützt WEBSALE V8s noch eine Vielzahl von Zusatz-Parametern. Während einige dieser Zusatz-Parameter nur bei ihrem direkten Aufruf gültig sind, werden andere Zusatz-Parameter in der Shopsession gespeichert. Ihre Werte können innerhalb dieser Session auf jeder beliebigen Seite des Shops ausgegeben werden. Dazu müssen sie nicht einmal mehr Bestandteil der URL sein.
Wegweiser: Zusatz-Parameter
Mit einer speziellen Konfiguration können einige dieser Zusatz-Parameter aus der URL der Start-, Produkt- und Kategorieseite entfernt werden. Dadurch kann den Suchmaschinen immer ein SEO-freundlicher "Basis-Link" mitgeteilt werden.
Materialien: Parameterentfernung aus der URL
Inhalt
3 Übersicht der WEBSALE-Parameter
1 Schreibweise der Parameter in einer WEBSALE-URL
Parameter-Namen müssen immer in Kleinbuchstaben geschrieben werden.
Nur der erste Parameter wird mit dem ?-Zeichen vom Domainnamen getrennt. Alle folgenden Parameter werden mit dem &-Zeichen angefügt. Hinter dem Parameternamen folgt stets ein =, hinter dem der Wert des Parameters angegeben wird.
Eine URL mit Parametern sieht demnach wie folgt aus:
www.domain.de/?parameter1=wert1¶meter2=wert2¶meter3=wert3 usw.
In der WEBSALE V7 und der V8 Version ist der erste Parameter unserer URL immer ?websale8=
Weitere Parameter konnten somit immer mit dem kaufmännischen Und & angehängt werden:
www.shop.de/?websale8=shopid¶meter2=wert2¶meter3=wert3
Mit Umstellung auf die SEO-URLs in der V8s entfällt unser ?websale8-Parameter aber für alle suchmaschinenrelevanten Seiten, wie Startseite, Kategorie, Produkte oder Informationsseiten. Möchte man also einen Parameter an die URL anhängen, muss geprüft werden, an welcher Stelle in der URL der Parameter steht:
www.shop.de/?parameter1=wert¶meter2=wert2¶meter3=wert3
Diese neue URL muss auch bei der Verwendung von URL- resp. Link-Tags bedacht werden, denn an jeden URL- bzw. Link-Tag von WEBSALE V8s können Parameter angehängt werden.
Je nach Verwendungszweck können in der vom Tag erzeugten URL bereits Parameter enthalten sein oder nicht. Dadurch kann keine Aussage darüber getroffen werden, ob an einen URL- oder Link-Tag ein Parameter mit Fragezeichen ? oder mit & angehängt werden muss.
Aus diesem Grund sollte vor jeden URL- bzw. Link-Tag , an den ein Parameter angehängt werden soll, immer das Tag ~WS-EnsureNextLinkContainsURLParams~ vorangestellt werden. So kann man Parameter an das nachgestellte Tag immer mit & anhängen, z. B.
~WS-EnsureNextLinkContainsURLParams~~PR-Link~¶meter1=wert1
~WS-EnsureNextLinkContainsURLParams~~CAT-Link~¶meter1=wert1
~WS-EnsureNextLinkContainsURLParams~~WS-LoadTpl(tpl_agb.htm)~¶meter1=wert1
Auch URL- oder Link-Tags, an die ein Anker # angehängt wurde, muss das Tag ~WS-EnsureNextLinkContainsURLParams~ vorangestellt werden, z. B.
~WS-EnsureNextLinkContainsURLParams~~WS-LoadTpl(tpl_agb.htm)~#ende
Referenz: WS-EnsureNextLinkContainsURLParams
2 Reihenfolge der URL-Parameter
Zuerst können die folgenden Basis-Parameter angehängt werden:
&pi=<ProduktIndex> (entfällt in der V8s, wird aber noch unterstützt)
&ci=<Kategorieindex> (entfällt in der V8s, wird aber noch unterstützt)
&tpl=<Templatename> (entfällt in der V8s in manchen Fällen, wird aber noch unterstützt)
Nach diesen Parametern können folgende Parameter angehängt werden:
&act=<Aktion>
&ref=<Referer>
&subref=<SubReferer>
&fp1=<FreierParameter>
&fp2=<FreierParameter>
&fp3=<FreierParameter>
&dp1=<DesignParameter>
&dp2=<DesignParameter>
&dp3=<DesignParameter>
&otp1=<OneTimeParameter>
&otp2=<OneTimeParameter>
&otp3=<OneTimeParameter>
Zu Testzwecken können danach die folgenden Parameter angehängt werden:
&test=on
&design-test=
&event-test=
&campaign-test=
&w2p-test
&geoip-test=
&sslonly-test=
&linkoptimization-test=
&ab-test-id=
Achtung: |
|
|
Wenn einer oder mehrere Parameter verwendet werden, ist jedoch eine Reihenfolge zur Vermeidung von Duplicate Content in Suchmaschinen einzuhalten. Beispiel: WEBSALE V8s verfügt über Mechanismen, diese korrekte Reihenfolge automatisch herzustellen. Nähere Informationen hierzu finden Sie unter |
3 Übersicht der WEBSALE-Parameter
Jeder der folgenden Parameter muss – abhängig davon, welche Seite geöffnet wird – zwingend in der URL eines WEBSALE Shops enthalten sein. Für das Anhängen von Parametern ist die Reihenfolge zu beachten.
Parameter |
Erklärung |
&pn=... |
Erzwingt stets die Anzeige eines Produktes über die Produktnummer auf der Einzelproduktansicht unabhängig davon, welche weiteren Parameter angegeben sind.
|
&pi= |
Erzwingt stets die Anzeige eines Produktes über den Produktindex auf der Einzelproduktansicht unabhängig davon, welche weiteren Parameter angegeben sind. Kann für Deep-Links auf externen Seiten oder für Test-Aufrufe verwendet werden.
|
&ci=... |
Erzwingt stets die Anzeige einer Kategorie über den Kategorieindex unabhängig davon, welche weiteren Parameter angegeben sind. Kann für Deeplinks auf externen Seiten oder für Test-Aufrufe verwendet werden.
|
&tpl=... |
Verwendung des angegebenen Templates. Wird verwendet und generiert, wenn: |
&sid=... |
Zu Debug-Zwecken hilft es eine neue Session zu starten. Damit werden alle in der Session gespeicherte Daten wie z. B. Login, Warenkorb, Zahlungs- und Versandarten, usw. entfernt. Hängen Sie folgenden Parameter an die Shop-URL: &sid=new |
&act=... |
Mit diesem Action-Parameter können besondere Funktionen schon beim Shop-Aufruf ausgelöst werden. Beispiel: &act=subscription lädt das Abo-Modul |
Jeder der folgenden Parameter kann für sich allein oder in Kombination angehängt werden, z. B. für spezielle Funktionen, Tracking oder Tests, dies ist aber nicht zwingend notwendig. Beim Anhängen der Zusatz-Parameter bitte die Reihenfolge beachten.
Parameter |
Erklärung |
&ref=... |
Deeplinks können stets mit einem Referer und einem Subreferer versehen werden. Damit erkennen Sie, woher ein Deeplink stammt.
|
&subref=... |
Deeplinks können stets mit einem Referer und einem Subreferer versehen werden. Damit erkennen Sie, woher ein Deeplink stammt.
|
&fp1…3=... |
Mit Free-Parametern wird z. B. der Shop mit beliebigen Werten beim Shopstart oder innerhalb der Session aufgerufen, ein Wert an beliebigen Stellen im Template ausgegeben oder ein Bereich in Abhängigkeit vom aktuellen Wert angezeigt. Die Free-Parameter werden im Canonical-Link mit ausgegeben.
|
&dp1…3=... |
Mit Design-Parametern wird z. B. der Shop mit beliebigen Werten beim Shopstart oder innerhalb der Session aufgerufen, ein Wert an beliebigen Stellen im Template ausgegeben oder ein Bereich in Abhängigkeit vom aktuellen Wert angezeigt. Die Design-Parameter werden im Canonical-Link nicht mit ausgegeben.
|
&otp1…3=... |
Mit OneTime-Parametern wird z. B. der Shop mit beliebigen Werten beim Shopstart oder innerhalb der Session aufgerufen, ein Wert an beliebigen Stellen im Template ausgegeben oder ein Bereich in Abhängigkeit vom aktuellen Wert angezeigt. Die OneTime-Parameter werden im Canonical-Link nicht mit ausgegeben.
|
&m=... |
Der Parameter m steht für die Mall-ID. Diese wird vor allem zur Kennzeichnung von Testshops verwendet (&m=test oder &m=devpak) |
&voucher_number=... |
Dieser Parameter überträgt beim Shop-Aufruf die angegebene Gutscheinnummer in das Eingabefeld "Gutschein einlösen" während des Checkout-Prozesses.
|
Parameter |
Erklärung |
&test=... |
Aktiviert den Testmodus für Ihre aktuelle Session, indem Sie den Parameter &test=on anhängen. Es öffnet sich eine Seite mit dem Eingabefeld für das Passwort. Nach korrekter Eingabe wird auf die ursprünglich aufgerufene Seite gesprungen, der Shop befindet sich dann im Testmodus. Für unterschiedliche Shop-Funktionalitäten stellt WEBSALE weitere, spezielle Testmodi zur Verfügung, die ebenfalls mittels zusätzlicher URL-Parameter aufgerufen werden. Diese und weitere Informationen finden Sie in nachfolgender Tabelle sowie unter
|
&design-test= |
Zum De-/Aktivieren des Designtestmodus
|
&event-test= |
Mit Event-Klammerungen können Sie steuern, wann bestimmte Bereiche auf einem Template angezeigt werden sollen oder nicht.
|
&campaign-test= |
Kampagnen-Testmodus für zeitlich begrenzte Shop-Aktionen
|
&w2p-test |
Wird das Feature "Web2Print" in einen Shop integriert, kann es mit diesem Modus getestet werden.
|
&geoip-test= |
Mit GeoIP-Klammerungen können Sie Kunden aus bestimmten Ländern gezielt Informationen anzeigen lassen, wenn diese Ihren Shop besuchen.
|
&sslonly-test= |
Der SSL-Only-Modus, mit dem alle Seiten des Shops verschlüsselt übertragen werden, kann mit diesem Modus getestet werden.
|
&linkoptimization-test= |
Zum Testen der URL-Optimierung
|
&ab-test-id= |
Mit dem A/B-Test-Modul kann die Konversionsrate verschiedener Versionen einer Shop-Seite verglichen werden.
|
&payment-test= |
Aktiviert den Testmodus für Zahlungsarten. Beispiel für den allgemeinen, den Zahlungsarten- und den Kreditkarten-Testmodus: Die spezielleren Testmodi für einzelne Zahlungsarten finden Sie im |
Hinweis: |
|
|
Weitere Test-Parameter finden Sie unter |
3.4 Externe Parameter in der WEBSALE-URL
Selbstverständlich unterstützt WEBSALE V8s auch Parameter von externen Systemen. Diese können problemlos an die URL eines WEBSALE Shops angefügt werden:
Der erste Parameter wird mit ? an die URL angefügt, alle weiteren mit &..
Als Beispiel kann hier zum Beispiel das Kampagnen-Tracking von Google Analytics genannt werden. Hier stellt Google spezielle Kampagnenparameter als Zusatz zu Ihrer URL zur Verfügung, um zu ermitteln, über welche Kampagnen, z. B. Facebook-Aktion, Zugriffe auf Ihre Website erfolgen. Wenn ein Nutzer auf einen solchen Link mit Kampagnenparametern klickt, werden diese Parameter an Google Analytics gesendet. So kann die Effektivität der einzelnen Kampagnen analysiert werden.
Quelle: Google Analytics-Hilfe > Tool zur URL-Erstellung
Beispiel einer WEBSALE-URL mit Google Kampagnenparametern:
http://www.ihr-shop.de/<sprechender Name>?utm_campaign=Weihnachten&utm_medium=Banner&utm_source=Facebook
Referenz: WS-EnsureNextLinkContainsURLParams