FTP/SFTP import i Heyloyalty

Contents

    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 email, 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 email marketing.

    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 tracking database.
    • 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 automationer 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:

    • Email
    • 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å oversigtsiden. 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 ud fra filen oprette en kontakt på listen. Her skal hver linje i filen indeholde en mail eller et mobilnummer, som vi kan oprette kontakten på.
      • Købsdata: Vælger du købsdata, vil data hentes ned som købsevent i Heyloyalty trackingdatabase. Her vil du kunne se events i activity feedet. Hvis du skal importere købsdata, skal du sørger for at der er oprettet en tracking integration på listen ellers vil du ikke kunne vælge listen i indstillingen nedenfor.
    • Liste: Vælg den Heyloyalty liste 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. Regler der er opsat i forbindelse med hentning af filer lyder således:
      Hvis stien slutter på .csv så henter vi kun en fil
      Hvis stien slutter på / så henter vi alle .csv filer i den angivende mappe.
      Vi henter kun csv filer der kan findes 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 email, hvis det er, det unikke felt på kontakten. Hvis du ikke finder det felt du vil matche kontakten på, er det pga. 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. Det er forskelligt, hvilke import indstillinger du får, når du vælger mellem købs- eller kontaktdata.

    Først beskriver vi import indstillingerne for købsdata. Her skal følgende indstillinger udfyldes:

    • 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 f.eks. 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 emailadresse, der skal modtage besked om eventuelle fejl i importen.

    Hvis du vælger at importere kontaktdata får du lidt flere import indstillinger. Du skal stadig udfylde import indstillingerne 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ælge 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 første dublet, så den første forekomst af en kontakt bliver importeret.
      • Importer første dublet: Hvis der findes kontakter med samme feltværdi i matchene felt, vil den kun hente 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 emailadresse, 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 fra Kontaktdata til købsdata.

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

    Til venstre i feltmappingen ser du felterne i Heyloyalty og overfor ser du et input feltet, som knytter sig til navnet på din kolonne i FTP-fil og hermed værdien fra importfilen skal overføres til.

    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 af navnet i input feltet er 1-1 som den står i din FTP-fil. Mapping tager ikke højde for store og små bogstaver.

    I højre side kan du vælge Felttype. De forskellige typer betyder således:

    • 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 input feltet 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 pga. 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 customer felter på tracking integrationen. Det gør du ved at gå til tracking integrationen og tryk på de tre prikker i højre hjørne. Her skal du vælge Tilføj brugerdefineret felter. Du fra listens tracking integration trykker du på de tre prikker og vælger redigere felter. Her kan du tilføje ny tracking felter, som herefter vil kunne findes på FTP-importen for købsdata.

    Bemærk: Kontrollér, at felterne i Heyloyalty har de korrekte felttyper ift. det data der er i felterne i importfilen. Hvis felttypen ikke matcher det data der kan findes i import filen, vil dataene ikke blive importeret.

    Gem integrationen

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

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

    fra integrationsoversigten har du ud fra de tre prikker mulighed for redigere, kopier 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 emailadresse.

    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 popup, 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 automationer: 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.