Introduktion
Om du har tillgång till en fil med dina kunders orderhistorik från er nuvarande eller en tidigare E-handelsplattform så kan du via vårt öppna API importera den datan till ditt Rule-konto så att du har dina kunders tidigare köp registrerade i systemet.
VIKTIGT
En import av orderhistorik rekommenderas alltid att göras först, innan andra medlemmar importeras till kontot.
Annars kan orderdata hamna i fel kronologisk ordning samt orderdubbletter skapas.
Detta är en avancerad funktion och kräver att ni är noggranna, följer varje steg och helst har förkunskaper kring filimport via API.
Filformat
Importen sker via en fil som vanligtvis kan exporteras från ert E-handelssystem.
Filen ska helst vara max 50 000 rader och om filen är större än så så kan ni dela upp den i flera filer som ni importerar efter varandra.
Kom ihåg att rubriker för varje kolumn måste vara med i alla filer ni importerar.
Filen behöver vara sparad i CSV-format med kommaavgränsning.
Excel kan ibland spara denna typ av fil med fel kodstruktur, då kan ni behöva öppna filen i exempelvis Sublime och välja "Save with encoding - UTF8" för att den ska sparas med rätt filstruktur.
Filstruktur
Dessa två kolumner är obligatoriska oavsett övrigt innehåll i filen:
Mailadress - En mailadress krävs för att systemet ska kunna skapa medlemmen.
Telefonnummer - Denna kolumn behöver finnas i filen men raderna kan lämnas tomma om telefonnummer inte finns tillgängligt för medlemmarna.
Utöver dessa så kan ni inkludera valfri vidare data men om ni ska integrera ert Rule-konto med en E-handelsplattform så rekommenderar vi att kolumnernas rubriker stämmer överens med de rubriker som den plattformen använder för framtida orderanrop.
Benämns exempelvis totalsumma för ordern som "Pris" i filen men skickas in som "TotalAmount" från er E-handelsplattform så kommer samma värde att ligga i olika fält beroende på om de importerats här eller automatiskt via E-handelsplattformen.
För just orderdata så behöver varje order placeras på en egen rad i importfilen och alla produkter i ordern behöver placeras i ett eget fält.
Följs inte strukturen ovan så kan det exempelvis skapas separata orderposter i medlemsprofilen för varje produkt i ordern.
Exempelvis Product ID och SKU enligt nedan.
Flervalsfält
I Rule så kan ni använda fält av typen "Flerval".
Dessa ger er möjlighet att skapa förbestämda värden istället för fritext, dessa kan ni sedan använda för t.ex. Segmentering;
För att importera dessa så behöver ni först skapa upp fälten som ni vill placera dessa i och välja Flerval som typ för dessa;
När detta är klart så behöver ni först se till att kolumnen med exempelvis produkterna ni vill inkludera har exakt samma namn som fältet i Rule.
Därefter så behöver ni se till att varje värde i den kolumnen är separerat med "|", inte komma eller semikolon;
Postman
För att importera filen så rekommenderar vi att använda programmet Postman.
Ni kan läsa mer om och ladda ned programmet på deras officiella hemsida;
Postman Download
API-nyckel
För att Postman ska kunna placera orderdatan på ert konto så behöver ni generera en API-nyckel.
Detta gör ni under "Utvecklare" i era kontoinställningar genom att klicka på knappen "Ny API-nyckel"
Importprocess
Nu när fil, API-nyckel och Postman är ordnade så kan vi påbörja importprocessen som vi kommer att gå igenom steg för steg nedan;
Starta Postman
Skapa ett nytt anrop via knappen "New" och välj "HTTP"
Välj anropstyp "POST" och lägg till följande URL:
https://app.rule.io/api/v2/subscribers/historical-import
Gå till "Body" och lägg till följande "Keys";
file - Denna ska även ha "File" som typ, här laddar du upp din fil via knappen "Select files"
email_field - Här skriver du rubriken på kolumnen i er fil som innehåller kundernas mailadresser
phone_field - Här skriver du rubriken på kolumnen i er fil som innehåller kundens telefonnummer
(Denna kolumn kan som sagt vara tom om ni inte har tillgång till telefonnummer)separator - Hur värden separeras i filen, här anger ni “;”
(Även om filen är sparad som kommaavgränsad CSV så är det semikolon som anges i Postman)tags - Denna dikterar vilken Tagg medlemmarna ska placeras i, vi rekommenderar “OrderCompleted” då den är standardtaggen för inkommande orderdata.
Gå till fliken "Authorization"
Välj type "API Key" och klistra in API-nyckeln som ni genererade i era inställningar i fältet "Value"
Skicka in anropet
Dubbelkolla all information i stegen ovan och klicka sedan på "Send".
Viktigt: Anropet kan ta tid så klicka endast en gång och ge systemet tid att slutföra processen.
Valfritt: Spara anropet
Om ni planerar att importera flera filer så kan ni spara anropet i Postman och använda det för import av vidare filer.
Kontrollera datan i Rule
Ge anropet tid att slutföra importen och kontrollera sedan så att all data har importerats korrekt.
Klart!
Om all data har kommit in och placerats rätt på kontot så är ni klara och har nu orderhistoriken från ert tidigare system på ert Rule-konto.