FTP/SFTP-import i Heyloyalty

Med FTP/SFTP-importen kan du automatisk hente kontaktdata og købsdata fra en FTP- eller SFTP-server ind i Heyloyalty. Det giver dig mulighed for at samle data fra andre systemer og bruge dem til segmentering, personaliserede kampagner og marketing automation.

I denne guide gennemgår vi, hvordan du opsætter integrationen, vælger dine importindstillinger og mapper felter, så dine data bliver placeret korrekt i Heyloyalty.

*Billeder til denne guide kommer senere.

Hvilken værdi giver FTP/SFTP-integrationen?

Automatisk import af kontaktdata

Overfør kontaktoplysninger fra dit eksterne system til Heyloyalty uden at skulle importere filer manuelt.

Du kan eksempelvis hente oplysninger som e-mail, telefonnummer og kundenummer, så du kan arbejde med dine kontakter i Heyloyalty.

Brug købsdata til målrettet kommunikation

Med købsdata i Heyloyalty kan du arbejde med kundernes købshistorik og skabe mere relevant kommunikation.

Du kan eksempelvis oprette segmenter baseret på tidligere køb og bruge dem til at målrette kampagner mod bestemte kundegrupper.

Automatisér kommunikationen

Brug dine importerede data til at arbejde med marketing automation.

Du kan eksempelvis opsætte automatiske beskeder til nye kontakter eller bruge købshistorik til at målrette relevant kommunikation.

Saml data fra forskellige systemer

FTP/SFTP-integrationen er relevant, hvis du arbejder med et system, der kan eksportere data til en FTP- eller SFTP-server, men som ikke har en direkte integration til Heyloyalty.

På den måde kan du stadig bruge data fra systemet i din e-mailmarketing.

Integrationsspecifikationer

I dette afsnit får du en bedre forståelse af, hvordan FTP/SFTP-integrationen fungerer, og hvilke muligheder du har.

Integrationen understøtter følgende funktioner:

• Import af kontaktdata til en valgt liste i Heyloyalty.
• Import af købsdata til Heyloyaltys trackingdatabase.
• Automatisk hentning af filer fra en FTP- eller SFTP-server hver 4., 8., 12. eller 24. time.
• Valg af importinterval og starttidspunkt for importen.
• Feltmapping mellem importfilen og datafelter i Heyloyalty.
• Mulighed for at aktivere automations i forbindelse med importen.

Kontaktdata

Ved import af kontaktdata overføres oplysninger fra importfilen til den valgte liste i Heyloyalty.

Det kan eksempelvis være:

• E-mail
• Telefonnummer
• Kundenummer
• Navn
• Andre relevante kontaktoplysninger

Hvilke oplysninger der kan importeres, afhænger af de felter, der findes i din fil, og hvilke felter du har oprettet på din Heyloyalty-liste.

Bemærk: Vær opmærksom på, at importerede kontaktoplysninger ikke i sig selv dokumenterer, at kontakten har givet samtykke til at modtage markedsføring. Sørg derfor for at håndtere permissions korrekt, inden du bruger kontakterne i dine kampagner.

Købsdata

Du kan også vælge at hente købsdata gennem importen.

Købsdata kan bruges til at arbejde med kundernes købshistorik i Heyloyalty og skabe segmenter baseret på deres tidligere køb.

For at kunne anvende data korrekt er det vigtigt, at felterne i importfilen bliver mappet til de relevante felter i Heyloyalty.

Automatisk import

Når integrationen er opsat, kan Heyloyalty automatisk hente filer fra den angivne server.

Du bestemmer selv, hvor ofte integrationen skal forsøge at hente data, og hvilket tidspunkt importen skal starte.

Det kræver, at filerne ligger i den mappe, du har angivet i integrationen, og at Heyloyalty har adgang til serveren.

Opsæt FTP/SFTP import

I dette afsnit gennemgår vi, hvordan du opretter importen og udfylder de nødvendige indstillinger.

Indstillinger til importen

Start med at gå til Integrationer → Listeintegrationer. Find FTP-importen, og klik på Opsæt integration.

Opret en ny FTP-import, så du kommer til siden med importindstillingerne.

Her skal du angive, hvilken type data du vil importere, hvilken liste der skal bruges, og hvordan Heyloyalty skal forbinde til din server.

Under Indstillinger skal du udfylde følgende felter:

• Navn på import-job: Giv importen et sigende navn, så du nemt kan identificere den på oversigtssiden. Det kan eksempelvis være “Købsdata” eller “Kontaktimport”.
• Importer køb- eller kontaktdata: Vælg, om importen skal hente købsdata eller kontaktdata.
  • Kontaktdata: Hvis du vælger Kontaktdata, vil importen oprette kontakter på listen ud fra filen. Hver linje i filen skal indeholde en mail eller et mobilnummer, som vi kan oprette kontakten på.
  • Købsdata: Vælger du Købsdata, bliver data hentet ned som købsevents i Heyloyaltys trackingdatabase. Her vil du kunne se eventsene i Activity feedet. Hvis du skal importere købsdata, skal du sørge for, at der er oprettet en trackingintegration på listen. Ellers vil du ikke kunne vælge listen i indstillingen nedenfor.
• Liste: Vælg den Heyloyalty-liste, som importen skal importere data til.
• Link til server: Indtast adressen på den FTP- eller SFTP-server, hvor dine importfiler ligger.
• Sti til folder filer ligger i: Angiv stien til filen. Reglerne for hentning af filer lyder således:
  Hvis stien slutter på .csv, henter vi kun én fil.
  Hvis stien slutter på /, henter vi alle .csv-filer i den angivne mappe.
  Vi henter kun CSV-filer, der ligger i mappen. 
• Username: Indtast brugernavnet til serveren.
• Password: Indtast adgangskoden til serveren.
• Protokol: Vælg FTP eller SFTP afhængigt af den forbindelse, din server understøtter.
• Port: Indtast den port, som serveren benytter. SFTP anvender typisk port 22, mens FTP typisk anvender port 21.

Bemærk: Serveradresse, mappesti, brugernavn, adgangskode og port skal stemme overens med oplysningerne fra din serverudbyder. Vi anbefaler at bruge SFTP, da forbindelsen er krypteret.

Når du importerer kontaktdata, skal du også vælge Match kontakter på felt under de grundlæggende indstillinger. Her vælger du det felt, som Heyloyalty skal bruge til at identificere eksisterende kontakter. Det kan eksempelvis være e-mail, hvis det er det unikke felt på kontakten. Hvis du ikke kan finde det felt, du vil matche kontakten på, er det, fordi det ikke er oprettet på listen.

Vælg importindstillinger

Under Import indstillinger bestemmer du, hvornår Heyloyalty skal hente dine filer, og hvordan data skal behandles. Hvilke importindstillinger du får, afhænger af, om du vælger købsdata eller kontaktdata.

Først beskriver vi importindstillingerne for købsdata. Her skal du udfylde følgende indstillinger:

• FTP import interval: Vælg, hvor ofte Heyloyalty skal hente data fra serveren. Her kan du vælge mellem hver 4., 8., 12. eller 24. time.
• Starttidspunkt: Vælg det tidspunkt, hvor den planlagte import skal starte. Herefter vil intervallet køre.
• Delimiter, tegn der adskiller data i din fil: Angiv det tegn, der adskiller værdierne i importfilen. Hvis din fil bruger semikolon, skal du indtaste ;. Dette gælder fx ved CSV-filer.
• Datoformat: Angiv datoformatet, hvis filen indeholder datoer, som skal fortolkes i et bestemt format.
• Send aktive automations: Vælg, om importen skal aktivere aktive automations i Heyloyalty. Vælger du Nej, vil importen ikke udløse aktive automations gennem denne indstilling.
• Send eventuelle fejl i importfil til: Indtast den e-mailadresse, der skal modtage besked om eventuelle fejl i importen.

Hvis du vælger at importere kontaktdata, får du lidt flere importindstillinger. Du skal stadig udfylde importindstillingerne for købsdata, som er beskrevet ovenfor, men derudover skal du udfylde nedenstående indstillinger:

• Importtype: Vælg, hvordan importen skal behandle kontakterne i importfilen. Vælg mellem nedenstående:
  • Opdatér eller opret: Eksisterende kontakter opdateres, og nye kontakter oprettes.
  • Opret kontakter: Importen tager kun højde for nye kontakter og opretter dem.
  • Opdater eksisterende: Importen tager kun højde for kontakter der oprettet gennem importen og opdatere kontakterne
• Håndtering af kontakt dubletter: Vælg, hvordan importen skal håndtere dubletter i importfilen. Du kan vælge mellem nedenstående:
  • Importer ingen dubletter: Hvis der findes dubletter i det matchede felt, bliver de ikke importeret.
  • Importer første dublet: Hvis der findes kontakter med samme feltværdi i det matchede felt, henter importen kun den første, den finder i filen.
  • Importer alle: Her importeres alle kontakter, der findes i filen, selvom der er dubletter.
• Tegn der adskiller valgmuligheder: Angiv det tegn, der adskiller flere værdier i samme felt, hvis din importfil indeholder felter med flere valgmuligheder.
• Undgå at tilmelde aktuelt afmeldte kontakter: Vælg Ja, hvis kontakter, der tidligere har afmeldt sig, ikke skal tilmeldes igen i forbindelse med importen.
• Send aktive automations: Vælg, om importen skal kunne aktivere eksisterende automations i Heyloyalty. Vælg Ja, hvis relevante automations skal kunne sendes til kontakten, eller Nej, hvis de ikke skal aktiveres gennem importen.
• Send webhooks: Vælg, om der skal sendes webhooks i forbindelse med importen. Vælg Ja for at aktivere funktionen eller Nej for at deaktivere den.
• Send eventuelle fejl i importfil til: Indtast den e-mailadresse, der skal modtage besked om eventuelle fejl i importen.

Map felter mellem importfilen og datafelter i Heyloyalty

Under Feltmapping bestemmer du, hvordan oplysningerne fra din importfil skal placeres i Heyloyalty. Feltmappingen er forskellig for kontaktdata og købsdata.

Hvis du vælger at importere kontaktdata, ser du felterne fra den valgte liste i feltmappingen. Hvis du importerer købsdata, vil feltmappingen vise standardfelterne fra Heyloyaltys tracking.

Til venstre i feltmappingen ser du felterne i Heyloyalty, og ud for hvert felt ser du et inputfelt. Her angiver du navnet på den kolonne i FTP-filen, som værdien fra importfilen skal overføres fra.

Hvis du eksempelvis har feltet email i din importfil, kan du mappe det til feltet Email i Heyloyalty og vælge Overskriv med.

Bemærk: Det er vigtigt, at navnet i inputfeltet er skrevet 1-1, som det står i din FTP-fil. Mappingen tager ikke højde for store og små bogstaver.

I højre side kan du vælge Felttype. De forskellige typer betyder følgende:

• Overskriv med: Bruges til at overføre værdien fra importfilen til det valgte felt i Heyloyalty.
• Se bort fra: Bruges, hvis et felt fra importfilen ikke skal importeres.
• Fast værdi: Her kan du i inputfeltet indtaste en fast værdi, der skal sættes i Heyloyalty-feltet i forbindelse med importen.

Hvis et felt ikke findes i mappingen, er det, fordi det ikke er oprettet på listen eller i trackingen. Du kan læse her, hvordan du opretter felter på listen. Hvis du skal oprette felter til tracking, skal de tilføjes som customfelter på trackingintegrationen. Det gør du ved at gå til trackingintegrationen og trykke på de tre prikker i højre hjørne. Her skal du vælge Tilføj brugerdefineret felter. Fra listens trackingintegration trykker du på de tre prikker og vælger redigere felter. Her kan du tilføje nye trackingfelter, som herefter vil kunne findes på FTP-importen for købsdata.

Bemærk: Kontrollér, at felterne i Heyloyalty har de korrekte felttyper i forhold til de data, der er i felterne i importfilen. Hvis felttypen ikke matcher de data, der findes i importfilen, bliver dataene ikke importeret.

Gem integrationen

Når du har udfyldt indstillingerne og gennemgået din feltmapping, skal du gemme integrationen. Klik på Gem integration.

Hvis du gerne vil kontrollere, om data kommer korrekt ind, kan du vælge at lave en manuel import. Læs her, hvordan du gør det.

Fra integrationsoversigten kan du via de tre prikker redigere, kopiere eller slette importen.

Kontrollér din import

Når integrationen har haft mulighed for at hente en fil, anbefaler vi, at du kontrollerer, om data er kommet korrekt ind i Heyloyalty.

Ved import af kontaktdata kan du gå til Lister og åbne den liste, du har valgt i integrationen. Kontrollér, at kontakterne er oprettet eller opdateret som forventet, og at oplysningerne er placeret i de korrekte felter.

Ved import af købsdata kan du kontrollere de importerede køb i Heyloyaltys Activity feed.

Hvis data ikke bliver importeret korrekt, kan du gennemgå følgende:

• Om serveradresse og loginoplysninger er korrekte.
• Om den angivne mappesti indeholder de forventede filer.
• Om protokol og port stemmer overens med serverens opsætning.
• Om delimiter og datoformat passer til filens indhold.
• Om felterne er mappet korrekt.
• Om der er modtaget en fejlrapport på den angivne e-mailadresse.

Manuel import

Når importen er sat op, henter den kun data fremadrettet. Derfor kan det være relevant at starte med at hente data manuelt for at få et indblik i, om dataene hentes korrekt. Det gør du fra integrationsoversigten, hvor du klikker på de tre prikker (•••) ud for importen og vælger Importer aktuel data.

Herefter kommer der en pop-up, hvor du vælger Importer aktuel data.

Herefter kan du kontrollere under Lister, om kontakterne er kommet ind i Heyloyalty. Du kan ligeledes se, om købsdata er hentet ind i Heyloyalty ved at tjekke, om der er kommet køb ind i Activity feedet.

Brug dine FTP/SFTP-data aktivt

Når FTP/SFTP-integrationen er opsat, kan du begynde at bruge dine importerede kontaktdata og købsdata til at skabe mere relevant kommunikation i Heyloyalty.

Du kan eksempelvis:

• Segmentere på købshistorik: Opret målgrupper baseret på de køb, dine kunder tidligere har foretaget.
• Personalisere dine kampagner: Brug importerede kontaktoplysninger til at tilpasse indholdet til den enkelte modtager.
• Arbejde med automations: Brug relevante kontaktdata og købshændelser som grundlag for automatiserede kunderejser.
• Holde dine kontaktdata opdaterede: Lad integrationen hente nye filer automatisk, så du undgår gentagne manuelle importer.

Med FTP/SFTP-integrationen kan du dermed samle data fra eksterne systemer og gøre dem anvendelige i Heyloyalty.

Det giver dig et bedre grundlag for at arbejde med segmentering, målrettede kampagner og marketing automation, uden at du manuelt skal overføre data mellem dine systemer.