Mit dem nShift Returns-Widget können Ihre Kunden Retouren direkt auf Ihrer Website einleiten, ohne Ihren Shop zu verlassen.
Voraussetzungen
- Zugriff auf die Konfigurationsoberfläche von nShift Returns
- Möglichkeit, den HTML-Code Ihrer Website zu bearbeiten (oder Zugriff auf einen Entwickler, der dies kann)
- Eine Marktkennung (siehe Schritt 1)
Schritt 1. Ihre Kennung finden
- Melden Sie sich bei der nShift Returns configuration interface an
- Gehen Sie zu Widget Settings > Market Setup
- Die folgenden Kennungen sind verfügbar. Verwenden Sie eine der unterstützten Kombinationen:
| Kombination | Verwendete Parameter |
|---|---|
| Nur Market ID | marketId |
| Nur Company Name | customerName |
| Company Name + Market Name | customerName + marketName |
| Kennung | Wo Sie sie finden |
|---|---|
| Market ID | Klicken Sie bei Ihrem Markt auf Open widget – die UUID wird in der Adressleiste des Browsers angezeigt |
| Market Name | Direkt in der Liste unter Market Setup sichtbar |
| Company Name | Ihr Unternehmensname, wie er in nShift konfiguriert ist |
Welche Option sollte ich verwenden?
marketIdwird nach Möglichkeit empfohlen. Wenn ein Kunde zur Anmeldeseite weitergeleitet wird, stellt dies sicher, dass sofort das richtige Branding und die richtige Sprache angezeigt werden.customerNameallein funktioniert, wenn Sie nur einen Markt haben. Verwenden SiecustomerName+marketName, wenn Sie mehrere Märkte unter demselben Unternehmen haben.Hinweis: Wenn Sie nur Company Name verwenden, leitet nShift Returns den Kunden anhand seiner Eingaben automatisch zum richtigen Markt weiter.
Schritt 2. Berechtigungen für die Einbettung konfigurieren
Bevor das Widget auf Ihrer Website geladen werden kann, müssen Sie nShift Returns mitteilen, unter welcher URL es angezeigt werden darf.
- Gehen Sie in der Konfigurationsoberfläche zu Widget Settings > Market Setup > Embed permissions
- Geben Sie die vollständige URL der Seite ein, auf der das Widget angezeigt werden soll, zum Beispiel:
https://www.yourstore.com/returns - Speichern Sie Ihre Änderungen
Dies funktioniert als Positivliste – das Widget wird nur dargestellt, wenn es genau von dieser URL geladen wird.
Schritt 3. Das Widget zu Ihrer Website hinzufügen
Fügen Sie das folgende Code-Snippet auf der Seite ein, auf der das Widget angezeigt werden soll, und ersetzen Sie den src-Wert durch die für Ihre Konfiguration passende URL (siehe Kombinationen unten).
<!-- nShift Returns Widget --> <iframe src="INSERT_URL_HERE" frameborder="0" marginheight="0" marginwidth="0" width="100%" height="700px" style="border: none;" title="Returns portal"> </iframe>
Unterstützte URL-Kombinationen für src:
| Kombination | URL |
|---|---|
| Market ID | …/redirect?marketId=YOUR_MARKET_ID |
| Nur Company Name | …/redirect?customerName=YOUR_COMPANY_NAME |
| Company Name + Market Name | …/redirect?customerName=YOUR_COMPANY_NAME&marketName=YOUR_MARKET_NAME |
Language — wenn kein lang-Parameter angegeben ist, verwendet das Widget die für den Markt konfigurierte Standardsprache. Unterstützte Sprachcodes:
Base URLs by environment:
| Umgebung | Basis-URL |
|---|---|
| Produktion | https://www.nshiftreturns.com/ui/widget |
| QA | https://www.qa.nshiftreturns.com/ui/widget |
Kundendaten vorausfüllen
Wenn auf Ihrer Website Bestellinformationen verfügbar sind – zum Beispiel, wenn ein Kunde von einer Bestellbestätigungsseite kommt – können Sie diese Angaben direkt in der Widget-URL übergeben. Wenn gültige Anmeldedaten vorhanden sind, überspringt das Widget den Anmeldebildschirm und führt den Kunden direkt zur Bestellseite. Andernfalls gelangt der Kunde zur Anmeldeseite und gibt seine Daten manuell ein.
Diese Werte werden in der Regel serverseitig von Ihrer Plattform eingefügt, wenn die Seite geladen wird. Dadurch bleibt das Einbettungs-Snippet statisch, während die Werte für jede Sitzung dynamisch hinzugefügt werden.
Unterstützte Kombinationen von Anmeldedaten
Das Widget akzeptiert die folgenden Kombinationen. Wenn mehrere davon in der URL vorhanden sind, wird der erste Treffer gemäß dieser Prioritätsreihenfolge verwendet:
| Priorität | Parameter | Codierung |
|---|---|---|
| 1 | order + customerId | Klartext |
| 2 | order + email | Klartext |
| 3 | orderBase + customerId | Bestellung Base64-codiert |
| 4 | emailBase + orderBase | Beide Base64-codiert |
Beispiele
Klartext – E-Mail und Bestellung:
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&email=customer@example.com&order=1234
Klartext – Kunden-ID und Bestellung:
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&order=1234
Base64-codiert – E-Mail und Bestellung (empfohlen — blendet die Werte in der URL aus):
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&emailBase=Y3VzdG9tZXJAZXhhbXBsZS5jb20=&orderBase=MTIzNA==
Base64-codierte Bestellung mit Kunden-ID als Klartext:
https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&orderBase=MTIzNA==