Gå til indhold
Heyloyalty
← Tixly-integrationen

Teknisk beskrivelse

Felter og mapping for Tixly

Hvad vi henter fra Tixly, hvor ofte, og hvad felterne hedder i Heyloyalty. Siden er til jeres udvikler eller integrationspartner. Skal I bare vide, hvad integrationen kan, hører den anden side bedre hjemme.

Sådan kører den

Efter opsætning henter integrationen data fra Tixly hvert femte minut og kontrollerer både medlemmer og ordrer. Den trækker fra Tixlys endpoints for kunder, events og salg, plus produktfeedet. En manuel import startes fra de tre prikker på integrationens oversigt og kan højst hente ét år ad gangen.

Hvad der skal bruges

Et adgangstoken og en feed-nøgle fra Tixlys support, en Premium-licens eller højere, en aktiv liste og en tracking-integration på listen. I Heyloyalty vælges liste og matchfelt: e-mail eller mobilnummer.

To veje, hvis I vil

To-vejs for medlemsdata slås til på integrationssiden. Så følger rettelser, sletning og anonymisering med tilbage til Tixly. Permissions går tilbage uanset. Se nedenfor.

Marketingpermission

Permissions hentes fra Tixly og oprettes som et flervalgsfelt på listen. Feltet skal ikke udfyldes i integrationsopsætningen. Det udfylder sig selv, når der er data på medlemmet. Historiske permissions følger ikke med automatisk og kræver en manuel import.

Kommer et medlem ind fra Tixly uden permission, skal samtykket komme et andet sted fra, for eksempel fra en tilmeldingsformular eller en pop-up. Der er tre måder at håndtere det:

  1. 1 Medlemmet opdateres på listen, så permissionen fremgår, og styres derfra med et segment. Den enkleste, og den vi anbefaler.
  2. 2 Medlemmet opdateres, og en medlemshandling flytter det til nyhedsbrevslisten.
  3. 3 Medlemmet opdateres, og en medlemshandling opretter en kopi på nyhedsbrevslisten.

Uanset hvilken I vælger, kan adfærdsdata bruges på tværs af lister.

Når nogen afmelder sig

Afmelder I et medlem i Heyloyalty uden to-vejs slået til, fjernes medlemmets permission i Tixly, men medlemmet bliver liggende. Er to-vejs slået til, sker det samme, når I sletter, afmelder eller anonymiserer: Permissions ryger, og medlemmet kan stadig findes i Tixly uden dem.

Feltmapping

69 felter fordelt på fire kilder. Tixlys navn til venstre, Heyloyaltys til højre. Felter, der ikke står her, hentes ikke i standardopsætningen. De kan mappes til i integrationsopsætningen, men så gælder de kun for data, der kommer ind derefter.

Gæsten

Fra Tixlys Customers-endpoint. Det er de felter, der lander på medlemmet i Heyloyalty, og som du segmenterer på.

  • Id → Tixly-id

    Låst felt

  • FirstName → Firstname

  • LastName → Lastname

  • Email → Email

    Enten denne eller Mobile er påkrævet

  • Mobile → mobile

    Enten denne eller Email er påkrævet

  • Gender → Sex

    Tal fra Tixly: 0 = ingen, 1 = mand, 2 = kvinde

  • DateOfBirth → birthday

    Datoen alene, klokkeslættet skæres fra

  • AddressOne → address

  • ZipCode → Zip_code

  • City → City

  • CompanyName → Firmanavn

    Customfield

  • Tags → Tixly-tags

    Flervalgsfelt på listen. Hentes kun fra Tixly og sendes aldrig tilbage

  • permissions.name → Tixly Permission Type

    Flervalgsfelt. Oprettes på medlemmet, når der er data. Skal ikke udfyldes i integrationsopsætningen

Forestillingen

Fra Event-endpointet. Bruges til at berige varelinjerne på et køb, så du kan segmentere på, hvad gæsten så, og ikke bare på at de købte noget.

  • Id → productid

    Beriges altid fra id og kan ikke ændres

  • Name → Product_name

  • SubTitle → description

  • Venue → Venue

  • Hall → Hall

  • Season → season

  • EventGroup → EventGroup

  • Categories.Name → Category_name

    Opdeles efter importindstillingen

  • Categories.Id → Category_id

    Opdeles efter importindstillingen

  • Tags.Name → Tags_name

    Det er navnet, der vises i Heyloyalty, ikke id’et

  • Tags.Id → Tags_id

  • StartDate → StartDate

  • EndDate → EndDate

  • Promoter → Promoter

  • Sold → Sold

    Tal

  • Capacity → Capacity

    Tal

  • AvailableOnline → AvailableOnline

  • OnlineReservationAllowed → OnlineReservationAllowed

  • IsFreeEvent → IsFreeEvent

  • Created → Created

Købet

Fra Events/sales-endpointet. Det er den enkelte billet: hvad den kostede, hvor man sad, og om den blev scannet ved indgangen.

  • OrderId → Order_number

  • SaleTicketId → SaleTicketId

  • EventId → Product_id

  • CustomerId → Tixly_CustomerId

    Bruges til at finde medlemmet og berige e-mailfeltet

  • TicketType → TicketType

  • TicketCount → TicketCount

  • Price → Product_price

  • Fee → Fee

  • PriceZone → PriceZone

  • Section → Section

  • Row → Row

  • Seat → Seat

  • Entrance → Entrance

  • Online → BoughtOnline

    Ja/nej: købt online eller i lugen

  • Scanned → Scanned

    Ja/nej: om billetten blev scannet

  • ScannedDate → ScannedTime

  • Created → Created_at

  • OrderUrl → url

  • SubscriptionTypeId → Sub_Id

    Kommer snart. Beriges med mere fra abonnements-endpointet, når Tixly åbner for det

Produktfeedet

Feedet er det, der tegner forestillingerne i nyhedsbrevet: billede, pris og link. Det sættes op med en feed-nøgle fra Tixly.

  • EventGroupId → ProductId

  • Name → Productnavn

  • Description → Beskrivelse

  • SubTitle → SubTitle

  • Organisation → Organisation

  • EventImagePath → Image_url

  • PurchaseUrls[0].Link → url

  • Categories → Kategorinavn

  • Season → Season

  • Duration → Duration

  • StartDate → StartDate

  • EndDate → EndDate

  • OnlineSaleStart → OnlineSaleStart

  • OnlineSaleEnd → OnlineSaleEnd

  • SoldOut → SoldOut

    Ja/nej

  • MinPrice → Udsalgspris

  • MaxPrice → OriginalPrice

Det integrationen ikke kan i dag

  • Abonnementer. Tixlys endpoint for kundens abonnementer er ikke åbnet endnu, så sæsonkort og abonnementstyper kommer ikke over.
  • Scanningsdata kræver, at Tixly stiller dem til rådighed for jer. Felterne er der, men data kommer kun, hvis I scanner.
  • Felter, Tixlys API ikke har, kan ikke mappes. Ændrer Tixly deres API, skal mappingen opdateres og data hentes ind igen.
  • Anonymiserer I et medlem i Heyloyalty, anonymiseres det ikke i Tixly. Den vej virker kun den anden retning, så anonymisér i Tixly.