Upota Returns Widget verkkosivustollesi – nShift Help Center

nShift Returns -widgetin avulla asiakkaasi voivat aloittaa palautuksen suoraan verkkosivustollasi poistumatta verkkokaupastasi.

Edellytykset

Pääsy nShift Returns -määritysliittymään
Mahdollisuus muokata verkkosivustosi HTML-koodia (tai käytettävissäsi on kehittäjä, joka voi tehdä sen)
Markkinatunniste (katso vaihe 1)

Vaihe 1. Etsi tunnisteesi

Kirjaudu nShift Returns configuration interface -liittymään
Siirry kohtaan Widget Settings > Market Setup
Seuraavat tunnisteet ovat käytettävissä. Käytä jotakin tuetuista yhdistelmistä:

Yhdistelmä	Käytetyt parametrit
Vain Market ID	`marketId`
Vain Company Name	`customerName`
Company Name + Market Name	`customerName` + `marketName`

Tunniste	Mistä se löytyy
Market ID	Napsauta markkinasi kohdalla Open widget – UUID näkyy selaimen osoiterivillä
Market Name	Näkyy suoraan Market Setup -luettelossa
Company Name	Yrityksesi nimi sellaisena kuin se on määritetty nShiftissä

Mitä minun pitäisi käyttää? marketId-parametria suositellaan aina kun mahdollista – jos asiakas ohjataan kirjautumissivulle, sen avulla oikea brändi-ilme ja kieli näytetään heti. Pelkkä customerName toimii, kun käytössäsi on yksi markkina. Käytä yhdistelmää customerName + marketName, kun samalla yrityksellä on useita markkinoita.
Huomautus: Jos käytät vain Company Name -arvoa, nShift Returns ohjaa asiakkaan automaattisesti oikealle markkinalle asiakkaan syöttämien tietojen perusteella.

Vaihe 2. Määritä upotuksen käyttöoikeudet

Ennen kuin widget voidaan ladata verkkosivustollesi, sinun on määritettävä nShift Returnsissa URL-osoite, jolla widgetin näyttäminen sallitaan.

Siirry määritysliittymässä kohtaan Widget Settings > Market Setup > Embed permissions
Anna sen sivun täydellinen URL-osoite, jolla widget näytetään, esimerkiksi:
https://www.yourstore.com/returns
Tallenna muutokset

Tämä toimii sallittujen osoitteiden luettelona – widget näytetään vain, kun se ladataan täsmälleen tästä URL-osoitteesta.

Vaihe 3. Lisää widget verkkosivustollesi

Liitä seuraava koodinpätkä sivulle, jolla widgetin tulee näkyä, ja korvaa src-arvo määrityksellesi sopivalla URL-osoitteella (katso yhdistelmät alta).

<!-- 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>

Tuetut URL-yhdistelmät src-arvolle:

Yhdistelmä	URL
Market ID	`…/redirect?marketId=YOUR_MARKET_ID`
Vain Company Name	`…/redirect?customerName=YOUR_COMPANY_NAME`
Company Name + Market Name	`…/redirect?customerName=YOUR_COMPANY_NAME&marketName=YOUR_MARKET_NAME`

Language — jos lang-parametria ei ole määritetty, widget käyttää markkinalle määritettyä oletuskieltä. Tuetut kielikoodit:

Base URLs by environment:

Ympäristö	Perus-URL
Tuotanto	`https://www.nshiftreturns.com/ui/widget`
QA	`https://www.qa.nshiftreturns.com/ui/widget`

Asiakastietojen esitäyttö

Jos tilaustiedot ovat saatavilla verkkosivustollasi – esimerkiksi kun asiakas saapuu tilausvahvistussivulta – voit välittää tiedot suoraan widgetin URL-osoitteessa. Kun kelvolliset tunnistetiedot ovat mukana, widget ohittaa kirjautumisnäytön ja vie asiakkaan suoraan tilaussivulle. Ilman niitä asiakas päätyy kirjautumissivulle ja syöttää tietonsa manuaalisesti.

Nämä arvot lisätään tavallisesti palvelinpuolella alustasi toimesta sivun latautuessa. Näin upotuskoodi pysyy muuttumattomana, mutta arvot lisätään dynaamisesti kullekin istunnolle.

Tuetut tunnistetietoyhdistelmät

Widget hyväksyy seuraavat yhdistelmät. Jos URL-osoitteessa on useita yhdistelmiä, käytetään ensimmäistä vastaavuutta tässä prioriteettijärjestyksessä:

Prioriteetti	Parametrit	Koodaus
1	`order` + `customerId`	Pelkkä teksti
2	`order` + `email`	Pelkkä teksti
3	`orderBase` + `customerId`	Tilaus Base64-koodattuna
4	`emailBase` + `orderBase`	Molemmat Base64-koodattuina

Esimerkit

Pelkkä teksti – sähköposti ja tilaus:

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&email=customer@example.com&order=1234

Pelkkä teksti – asiakastunnus ja tilaus:

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&order=1234

Base64-koodattu – sähköposti ja tilaus (suositeltu — piilottaa arvot URL-osoitteessa):

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&emailBase=Y3VzdG9tZXJAZXhhbXBsZS5jb20=&orderBase=MTIzNA==

Base64-koodattu tilaus ja asiakastunnus pelkkänä tekstinä:

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&orderBase=MTIzNA==