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 Medlemmet opdateres på listen, så permissionen fremgår, og styres derfra med et segment. Den enkleste, og den vi anbefaler.
- 2 Medlemmet opdateres, og en medlemshandling flytter det til nyhedsbrevslisten.
- 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å.
| Tixly | Heyloyalty | Note |
|---|---|---|
| Id | Tixly-id | Låst felt |
| FirstName | Firstname | |
| LastName | Lastname | |
| 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 |
-
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.
| Tixly | Heyloyalty | Note |
|---|---|---|
| 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 |
-
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.
| Tixly | Heyloyalty | Note |
|---|---|---|
| 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 |
-
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.
| Tixly | Heyloyalty | Note |
|---|---|---|
| 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 |
-
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.