Opsæt Loby-integrationen

Med Loby-integrationen kan du forbinde Heyloyalty med Loby og automatisk overføre kunder, medlemskaber og billetkøb til Heyloyalty. Bruger dit museum, din attraktion eller dit spillested Loby til billetter og medlemskaber, kan du bruge dataene til at byde nye medlemmer velkommen, minde medlemmer om at forny og følge op på billetkøb.

I denne guide gennemgår vi, hvordan integrationen fungerer, hvordan du opsætter den, og hvordan du henter tidligere kontakter og billetter fra Loby.

Hvilken værdi giver Loby-integrationen?

Velkomst til nye medlemmer

Byd nye medlemmer velkommen, når medlemskabet starter. Start et flow med en datobaseret trigger på feltet Loby Membership valid from, og brug feltet Loby Membership is renewal til at skelne nye medlemmer fra medlemmer, der har fornyet.

Påmindelse, før medlemskabet udløber

Send en påmindelse et antal dage før datoen i Loby Membership valid to, så medlemmet når at forny i tide. Udelad medlemmer, hvor Loby Membership auto renew er Ja, da deres medlemskab fornyes automatisk.

Winback af tidligere medlemmer

Når et medlemskab er udløbet, kan du forsøge at vinde medlemmet tilbage. Start et flow et antal dage efter datoen i Loby Membership valid to med en invitation til at blive medlem igen.

Opfølgning efter billetkøb og events

Billetter og event-billetter kommer ind i trackingen som køb. Brug dem til at sende en tak eller et relevant tilbud efter et køb. Event-billetterne har eventets start- og slutdato (event_start og event_end), så du kan finde dem, der har købt billet til et bestemt event, og følge op efter eventet.

Events i dine mails

Integrationen opretter produktfeedet Loby events med dine publicerede events i Loby. Vis dine events med navn, billede, pris og link til billetkøb i dine kampagner og automations.

Integrationsspecifikationer

I dette afsnit får du en bedre forståelse af, hvordan de forskellige dele af integrationen fungerer.

Efter opsætningen kører integrationen løbende:

Integrationen er envejs. Data flyder kun fra Loby ind i Heyloyalty, og intet skrives tilbage til Loby.
Integrationen henter kunder fra Loby, placerer dem på den valgte liste og matcher dem på e-mail eller mobilnummer.
Hvert 5. minut henter integrationen nye og ændrede kunder og medlemskaber samt nye billetter fra Loby. Nye kontakter oprettes, og eksisterende kontakter opdateres.
Integrationen henter kun data fra det tidspunkt, du opretter den. Tidligere kontakter og billetter henter du med en indledende import.
Billetter og event-billetter, som kendte kunder har købt, oprettes som køb i listens tracking.
Dine publicerede events i Loby bliver til produktfeedet Loby events.
Hver nat afstemmer integrationen listen med Loby. Kontakter, der er slettet i Loby, slettes og anonymiseres i Heyloyalty, og refunderede billetter annulleres i trackingen.

I integrationen henter vi data fra disse endpoints i Lobys API:

Kunder: /customers
Medlemskaber og medlemstyper: /memberships og /membership-types
Billetter og event-billetter: /tickets og /event-tickets
Events: /events

Du kan se alle felter, der mappes, i feltmappingen for Loby.

Kontakter og permission

Som standard importerer integrationen kun kunder, der har sagt ja til nyhedsbrev i Loby. Det styres af indstillingen Importér kun nyhedsbrevstilmeldte. Sætter du den til Nej, importeres alle kunder, også dem, der ikke har sagt ja til nyhedsbrev.

Feltet Loby Newsletter consent viser kundens samtykke i Loby:

Ja: Kunden har sagt ja til nyhedsbrev i Loby.
Nej: Kunden har ikke sagt ja til nyhedsbrev i Loby eller har frameldt sig.

Kontakter, der senere framelder sig nyhedsbrevet i Loby, bliver i Heyloyalty, men deres Loby Newsletter consent sættes til Nej. Findes en kunde allerede på listen, bliver kontakten også opdateret med data fra Loby, selvom kunden ikke har sagt ja til nyhedsbrev i Loby. Også her sættes Loby Newsletter consent til Nej.

Bemærk: Når du sender nyhedsbreve til listen, så brug et segment, der udelader kontakter, hvor Loby Newsletter consent er Nej.

Medlemskaber

Når Inkludér medlemskaber står til Ja, udfylder integrationen medlemsfelterne på kontakten med kontaktens nyeste medlemskab i Loby, fx medlemstype, start- og udløbsdato, og om medlemskabet fornyes automatisk. Står indstillingen til Nej, som er standard, udfyldes medlemsfelterne ikke.

Medlemstyperne i Loby bliver valgmuligheder i feltet Loby Membership type, og nye medlemstyper tilføjes løbende.

Feltet Loby Membership status kan have fire værdier:

active: Medlemskabet er aktivt.
expiring: Medlemskabet er aktivt, men udløber inden for 30 dage.
lapsed: Medlemskabet er ikke længere aktivt.
never: Kunden har aldrig haft et medlemskab i Loby.

Bemærk: Loby Membership status beregnes, når kontakten hentes fra Loby, og opdateres kun, når kunden eller medlemskabet ændres i Loby. Brug derfor datofeltet Loby Membership valid to, når et flow skal sendes i forhold til udløbsdatoen.

Billetter i trackingen

Billetter og event-billetter, som en kendt kunde har købt i Loby, importeres som køb i listens tracking. Hver billet bliver sit eget køb, og kontakten findes via det felt, du matcher på.

For event-billetter er eventet produktet, og billettypen gemmes i ticket_type. For andre billetter er billettypen produktet.
Prisen på købet er billettypens pris i kroner. Integrationen henter ikke ordrer fra Loby, så rabatter, gebyrer og ordrens samlede beløb kommer ikke med.
Billetter uden en kunde i Loby, fx billetter solgt i kassen uden kunde, kan ikke kobles til en kontakt og bliver ikke importeret. Det samme gælder billetter, hvor kunden ikke har en værdi i det felt, du matcher på.
Refunderede billetter annulleres i trackingen ved den natlige afstemning.

Har listen ikke en trackingintegration, opretter Loby-integrationen en, når du gemmer.

Produktfeedet Loby events

Når du gemmer integrationen, opretter den produktfeedet Loby events med alle publicerede events i din Loby-konto. Hvert event har bl.a. navn, beskrivelse, billede, link til billetkøb, start- og slutdato samt laveste og højeste billetpris. Har listens trackingintegration ikke et produktfeed i forvejen, kobles Loby events på den.

Brug feedet i dine kampagner på samme måde som andre produktfeeds. Læs mere i Produktfeed i kampagne.

Natlig afstemning

Hver nat kl. 2 afstemmer integrationen listen med Loby:

Kontakter med et Loby Customer id, der er slettet i Loby, slettes fra listen og anonymiseres i Heyloyalty.
Loby Newsletter consent rettes, så feltet svarer til kundens nyhedsbrevstilmelding i Loby.
Billetter fra de seneste 90 dage, som ikke længere findes i Loby, fx fordi de er refunderet, annulleres i trackingen.

Feltmapping

På opsætningssiden er felterne udfyldt på forhånd. En feltmapping, du lader stå tom, bliver ikke overført til Heyloyalty. Du kan se alle felterne, og hvad de indeholder, i feltmappingen for Loby.

Step 1: Opret integrationen

Gå til Integrationer → Loby, og klik på Opret ny Loby. Du kommer nu til siden Ny Loby-integration.

Step 2: Udfyld indstillingerne

Under Indstillinger udfylder du forbindelsen til Loby og vælger den liste, kontakterne skal lande på:

Liste: Vælg den liste i Heyloyalty, som kontakter og billetkøb fra Loby skal importeres til. Har du ikke en liste, kan du læse, hvordan du opretter den.
Match kontakter på felt: Vælg, om kontakter skal matches på e-mail eller mobilnummer. Feltet skal findes på listen, og kunder uden en værdi i feltet bliver ikke importeret.
Token: Indsæt API-tokenet til jeres Loby-konto. Kontakt Loby, hvis du ikke har et token.
Importér kun nyhedsbrevstilmeldte: Står som standard til Ja, så kun kunder, der har sagt ja til nyhedsbrev i Loby, bliver importeret. Læs mere under Kontakter og permission.
Inkludér medlemskaber: Vælg Ja, hvis medlemsfelterne på kontakten skal udfyldes med kontaktens nyeste medlemskab i Loby. Så vises afsnittet Medlemsfelter også.

Når du har indsat dit token, henter Heyloyalty medlemstyperne fra Loby og viser dem under Medlemstyper i Loby i afsnittet Medlemsfelter.

Step 3: Tjek importindstillinger og felter

Afsnittene Importindstillinger, Kundefelter, Loby-felter, Billetfelter og Medlemsfelter er udfyldt på forhånd, så du kan som udgangspunkt lade dem stå. Læs mere om dem under Avancerede indstillinger.

Step 4: Gem integrationen

Klik på Opret integration. Når integrationen gemmes, sker der følgende:

Loby-felterne og medlemsfelterne oprettes på listen. Medlemsfelterne udfyldes dog kun, når Inkludér medlemskaber står til Ja.
Medlemstyperne fra Loby bliver valgmuligheder i feltet Loby Membership type.
Listen får en trackingintegration, hvis den ikke allerede har en, og billetfelterne oprettes i trackingen.
Produktfeedet Loby events oprettes.

Herefter henter integrationen data fra Loby hvert 5. minut.

Step 5: Hent tidligere kontakter og billetter

Integrationen henter kun data fra det tidspunkt, du opretter den. Derfor kan det være relevant at hente tidligere kontakter og billetter fra Loby. Det gør du fra oversigten over dine Loby-integrationer, hvor du klikker på de tre prikker (⋮) ud for integrationen og vælger Importer tidligere kontakter og billetter.

I importvinduet vælger du, hvilken periode der skal hentes, og hvordan kontakterne skal behandles:

Fra dato og Til dato: Vælg perioden. Kontakter, der er oprettet i Loby i perioden, bliver importeret sammen med de billetter og event-billetter, kendte kunder har købt i perioden. Du kan hente op til ét år ad gangen. Skal du bruge en længere periode, henter du ét år ad gangen.
Håndtering af tidligere afmeldte kontakter: Vælg Ignorér tidligere afmeldte, hvis kontakter, der er afmeldt i Heyloyalty, ikke skal tilmeldes igen. Feltet står som udgangspunkt til Opret afmeldte igen.
Send opt-in-besked: Vælg, om importen skal sende listens opt-in-besked.
Send automations: Vælg, om de importerede kontakter skal kunne starte dine aktive automations, fx et velkomstflow.

Står Importér kun nyhedsbrevstilmeldte til Ja, importeres kun kunder, der har sagt ja til nyhedsbrev i Loby. Kontakterne hentes altid med deres nuværende oplysninger i Loby, så du kan hente perioderne i den rækkefølge, du vil.

Bemærk: Om billetkøbene i importen kan starte automations, afhænger af Send aktive automations under Importindstillinger og ikke af feltet Send automations i importvinduet.

Klik på Importer tidligere kontakter og billetter for at starte importen. Data hentes i baggrunden, og det kan tage et par minutter. Tjek derefter under Lister, at kontakterne er kommet ind på listen.

Avancerede indstillinger

Importindstillinger

Under Importindstillinger bestemmer du, hvordan kontakter behandles, når integrationen importerer data. Indstillingerne er sat til standardværdierne, og vi anbefaler, at du kun ændrer dem, hvis jeres opsætning kræver det.

Importtype: Vælg mellem Opdatér eller opret, Opret kontakter og Opdatér eksisterende. Vi anbefaler Opdatér eller opret, så nye kunder bliver oprettet, og eksisterende kontakter holdes opdateret. Opret kontakter opdaterer ikke kontakter, der allerede findes, og Opdatér eksisterende opretter ikke nye kontakter.
Datoformat: Formatet for datoer i importen. Lad det stå til standarden.
Tegn der adskiller valgmuligheder: Står til punktum (.). Lad det stå, da integrationen bruger tegnet til at læse medlemsfelter som membership.validTo fra Loby.
Må tidligere afmeldte importeres igen: Lad den stå til standardværdien. Hvordan tidligere afmeldte kontakter håndteres, når du henter tidligere data, vælger du i importvinduet (se Step 5).
Send aktive automations: Står som standard til Nej. Sæt den til Ja, hvis billetkøb fra Loby skal kunne starte dine aktive automations, fx et flow efter køb.
Send webhooks: Står som standard til Nej. Vælg Ja, hvis kontakter, der importeres fra Loby, skal udløse dine webhooks, fx til et CRM-system.
Send eventuelle fejl i importfilen til: Indtast en intern e-mailadresse, der skal have besked, hvis kontakter eller billetter fejler i importen.

Map felter mellem Loby og Heyloyalty

Mappingen bestemmer, hvor data fra Loby placeres i Heyloyalty. I alle afsnit står felterne i Heyloyalty til venstre og feltet i Loby til højre.

Kundefelter: Forbinder kundens oplysninger i Loby med felterne på din liste, fx fornavn, e-mail og postnummer. Til højre skriver du navnet på feltet i Loby.
Loby-felter: De felter, integrationen holder opdateret på din liste, fx Loby Customer id og Loby Newsletter consent. Felter markeret med Oprettes ved gem bliver tilføjet til listen, når du gemmer. Loby Customer id kan ikke ændres, da integrationen bruger det til at genkende kontakten.
Billetfelter: Forbinder felterne på Loby-billetten med felterne i trackingen. Loby-felterne oprettes i trackingen, når du gemmer.
Medlemsfelter: Vises, når Inkludér medlemskaber står til Ja. Felterne udfyldes med kontaktens nyeste medlemskab i Loby, og under Medlemstyper i Loby kan du se de medlemstyper, der er hentet fra Loby.

Mangler du et felt, kan du tilføje det via linket Tilføj felter til listen under Kundefelter eller Tilføj trackingfelter under Billetfelter.

Bemærk: Gem integrationen, før du følger linkene. Alt, der ikke er gemt, går tabt, når siden skifter.

Brug dine Loby-data aktivt

Du har nu forbundet Loby med Heyloyalty, valgt, hvilke data der skal overføres, og hentet tidligere kontakter og billetter. Dermed har du kunder, medlemskaber, billetkøb og events samlet ét sted.

Brug medlemsfelterne og billetkøbene til at oprette segmenter og flows, der rammer dine medlemmer og gæster på de rigtige tidspunkter: når medlemskabet starter, før det udløber, efter et billetkøb og efter et event. Vis dine events fra Loby events i dine nyhedsbreve, og husk segmentet på Loby Newsletter consent, når du sender dem.

Bemærk: Segmentering og flows på trackingdata, fx billetkøb, kræver en Premium licens. Læs mere i Tracking segmentering.