Tixly integration

In this guide, you’ll get a complete overview of the Tixly integration in Heyloyalty – from overview and business value to setup, possibilities, and technical details. The purpose of the integration is to enable you to work data-driven with your Tixly customers and actively use ticket, subscription, and membership data in email marketing and marketing automation.

What value does the Tixly integration provide?

Improved communication before, during, and after shows
Heyloyalty’s Tixly integration ensures that you can send timely and relevant messages based on data from Tixly, you can improve the audience’s overall experience. This could be practical information before shows, follow-up after visits, or personal recommendations for upcoming experiences based on previous purchases.

Targeted and personalized communication
Heyloyalty’s segmentation options make it possible to communicate in a targeted way to specific target groups. You can segment on purchase history, performances, dates, number of tickets, engagement, and permissions – and thus ensure that your messages are perceived as relevant and personal.

Correct consents and better data basis for your communication
With Heyloyalty’s Tixly integration, you collect ticket and membership data in one place and can use them actively in your communication. You choose whether the integration should synchronize membership data between Tixly and Heyloyalty – depending on your needs. If you set up synchronization, membership data and consents are synchronized between Tixly and Heyloyalty, so your consents are always up-to-date across the systems.

Streamlining of marketing processes
Automation of data exchange between Tixly and Heyloyalty reduces manual work and ensures a more efficient and data-driven marketing effort. Regardless of whether the integration is set up to synchronize data or not, it ensures that relevant messages are automatically sent to the right recipients at the right time.

Options for setup with Tixly integration

With the integration activated, you can easily set up automations targeting customers when they purchase or book events.

Examples of automations

These are just examples of automations that can be set up:

• Welcome flow
• Updated profile details
• Has purchased
• Har booket 
  • Has booked more than X times within Y period
  • Has booked more than X tickets in the same order
  • Has booked an event, then added dining in a new order

• Has booked more than X times within Y period
• Has booked more than X tickets in the same order
• When a ticket is scanned (depends on when this becomes available to us; we retrieve data continuously)

The above lists are just examples.

Examples of segmentation options

For campaigns and automations, you can segment on all the data that is retrieved from the integration. If you have added more fields for mapping yourself, these are of course also available.

• Booked a specific event
• Booked on a specific date
• Booked for an aggregated total amount over Y period
• Has membership
• Has booked Online
• Has booked X tickets for one event
• Has booked X tickets over Y period
• Has booked a specific zone, seat, row

The above are just examples of segmentation and automations that can be built with the Tixly integration.

Integration specifications

In this section, you get a better understanding of how the various functions work in the integration.

After setting up the integration, it will run automatically:

• Data is retrieved from Tixly every 5 minutes
• Both member and order data are checked
• The integration retrieves members, order data and product data
  

In the integration, we retrieve data from the endpoints below:

• Customers endpoint
• Events/sales endpoint
• Events endpoint
• Customers/{id}/subscriptions (Not available now, but coming soon)
• Mapping to product feeds

It is possible to add or remove field mappings (fields from which data is retrieved) in the integration. As long as it is from the above endpoints, you can map as desired.

You can see which fields are mapped in the integrationen here.

With the integration, you will get a lot of data, which contains: Member data (name, address, etc.), purchase data, product information. Member data can also be activated to be 2-way integration. Read more about the various functionalities below.

Members and permissions

We retrieve everyone, who makes a purchase and says yes to the newsletter, into the Heyloyalty system. This means that people who have completed a purchase without subscribing to the newsletter will also be found in Heyloyalty.

If you experience that data is missing on a member, it may be because the field has not been created on the list and mapped on the Tixly integration page.

Permission

We retrieve permission data from Tixly every 5 minutes. If you need to retrieve permission retroactively, this must be done via a manual import.

Permission is created as a multi-select field on the list. The field will then be created on the contact if there is data in the field.

Note: The Permission field should not be filled in in the mapping on the integration page. 

If you want your members to be able to update their permissions themselves, you must create an update form. Read here how to create it.

2-way integration

When you activate 2-way integration, Heyloyalty and Tixly will automatically keep membership data and permissions synchronized. Be aware that if you delete or update a field in Heyloyalty, the change will also be sent to Tixly.

If 2-way integration is activated, and you delete, unsubscribe, or anonymize a member in Heyloyalty, the member’s permissions will be removed in Tixly.

If you anonymize a member in Heyloyalty, the member will not be anonymized in Tixly – only permissions will be removed. If, on the other hand, you anonymize a member in Tixly, the member will also be anonymized in Heyloyalty. We therefore recommend that anonymization be carried out in Tixly.

Field mapping

Fields shown in light grey under field mapping will not be mapped into Heyloyalty.

You can see which fields are mapped in the integrationen here.

Setting up the Tixly integration

The Tixly integration is available to anyone with a premium or premium+ license. In addition, you must have an active list and a Tracking integration set on the list. Read here how to set up a list and how to set up a tracking integration.

If you previously have created a Heyloyalty account before setting up the Tixly integration, we recommend that you create a list and tracking integration for Tixly, in order to maintain any historical data from an existing list.

To set up the Tixly integration, you must start by going to list integrations and from Tixly press set up integration. If you are setting up your first Tixly integration, the page looks like this:

Here you come to the integration page, where there are many different settings. As a minimum, you must consider the four points under settings:

Under Settings, you need to configure the following:

1. List: Select the list in Heyloyalty to which you want your members from Tixly to be sent.
2. Match members by field:
   Choose which field members should be identified by (email or mobile).
3. Token: (also known as API key) This provides access to your Tixly solution*.
4. Key to Tixly product feed: Is a unique key from your Tixly feed. If this is added, we will automatically set up your product feed.
   The key can be found at the end of your product feed url. Your feed url can e.g. look like this: https://eventapi.tix.dk/v2/Events/f973k4393bac48ae/. Here your key will be: f973k4393bac48ae

Note: If you do not know your Token, you must contact your consultant at Tixly. 

As mentioned above, this is sufficient to retrieve members, products and purchase data from Tixly. If you need to set up a more advanced integration, you can read more here.

Finally, press save. The integration will then retrieve new contacts every five minutes and insert the permissions that you have set up in the integration.

Initial import

Once the integration is set up, you can retrieve retroactive data. You do this from the overview page, where you click on the three dots (•••) next to the selected integration. Here you select “Get data from Tixly”.

When you open the import modal, you will see 6 options. These can override the general integration settings for an initial/manual import:

• Date range:
  Date range: To and from date you want to import data from and to. (You can download data back one year at a time).
• Get event info: Do you want to import Tracking data this time? This can e.g. be ticket info etc.
• Get members:
  Whether you want to import member data this time.
• How to handle previously unsubscribed members:
  If members in the import have previously unsubscribed, you can choose whether they should be created again.
• Sent opt-in message: Do you want your created members to confirm their registration.
• Send automations:
  If you want to send welcome emails and automations directly related to the member sign-up, field updates, etc., set this to Yes.

Note: When you do a manual import, you can only do one year of import at a time. 

To get confirmation that the data from Tixly is being retrieved into Heyloyalty, you can under the menu item Lists, see if contacts have entered your list. In addition, under the menu item statistics under activity feed, you can see if different events have entered the list.

Advanced setup and customization

Field mapping

As standard, we map a number of fields on customer and purchase. You can see these at the bottom of the integration page under Field mapping. If there are fields that you do not use, or that are not active in your list or tracking, you can choose to remove them in Heyloyalty’s field mapping.

• Mapping for Customer: We retrieve membership data from “Customers” in Tixly. These fields will be found on the list in Heyloyalty.
• Sales mapping: We retrieve Tracking data from Event/Sales in Tixly. Data will be found in the activity feed.

If you want to add more data fields than those already mapped on the integration page, you must first ensure that the data is found in Tixly’s API endpoints before they can be mapped over to Heyloyalty. These extra data fields can then be attached to the fields that are displayed under the field mapping on the integration page.

Note: Note: If changes are made to the data available in the API, you must update the mapping when the changes are implemented in the API. If you want to see the changes immediately, remember to run a manual import after you have made the mapping in Heyloyalty.  

Import settings

On the integration page, you can set advanced settings if you have more requirements for the integration. This is done under Import settings. Here you can control how the creation and updating of members should take place, via the fixed import of members, which runs every five minutes.

You can find an explanation of the different settings here:

• Import type: Here you must choose how the contacts from Tixly should be created
• Date format: If you have a setup or other date format, this can be changed here.
  The date format in the field matches what Tixly delivers as standard.
• Character that separates options: This field indicates how your data is divided. If you need further mapping than standard mapping, you can choose which character should be used as a separator.
  If your data has indentation (arrays), you can retrieve values by using a period or another character. Example:
  ”cards” {
  ”Cardnumber”: 1234,
  ”Cardname”: ”Pension”,
  ”startdate”: ”01.01.2025”,
  ”enddate”: ”31.12.2025”
  In this case, you can map fields below by using a point: cards.Cardnumber
  This composition will retrieve the card number.
• Should previously unsubscribed be able to be imported again: By default, members are created if they are not already found as active members on the list. If you do not want members who have previously unsubscribed from your list to be created again, you can change the option to “No”.
• Send active automations:
  If you want automations (welcome emails) to be sent when a member is created on the list, set this to Yes.
• Send webhooks: If you want creation and updating from Tixly to activate a webhook, you can activate the function here (this is relevant if you have a CRM system or similar that you want to be notified). If you choose “No”, Heyloyalty will not send webhooks when we receive data from Tixly. However, Heyloyalty will send webhooks to other systems, e.g. Sleeknote.
• Send any errors in import file to: This function sends an error message to your mail incl. a list of members if the import from Tixly fails.

Summary of Tixly integration

You now have control over the foundation of your Tixly integration. A list has been created of all Tixly members you are allowed to send newsletters to. We have created a product feed with your Tixly products. In addition, we track purchase data on members who buy through Tixly.

This means that you are ready to send out campaigns to your subscribers! Here you can read how to set up a campaign. Remember, you can create segments to target your campaigns specifically to your Tixly subscribers.

As an extra bonus, you can also build an automation flow that automatically sends emails based on Tixly purchases – completely without manual work.

---