Skip to main content

​
What does exporting segmentation labels to Voyado do?

Exporting segmentation labels to Voyado lets you push Dema customer set labels directly to Voyado contacts. Once enabled, customers in a set receive Voyado labels in a consistent format (for example, DEMA|My Set|VIP), so you can use them in selections, automations, and other targeting.

​
Prerequisites

Both steps are required. Dema matches your customers to Voyado contacts using the shared contact data, and writes labels back through the Voyado API.

​
Share Voyado contact data with Dema

Activate Delta Share for the Contact dataset in Voyado and share the activation link or .share credentials file with our Customer Success team through a secure channel. Dema uses this data to match customers with their Voyado contact records. For setup instructions, see Delta sharing in the Voyado developer documentation.
The Delta Share credentials contain a sensitive bearer token. Treat the credentials like an API key or password.
Delta Share credentials have an expiry date. When they expire, Dema stops receiving contact updates and labels are no longer applied to new contacts. Send us fresh credentials before the expiry date to avoid an interruption.

​
Provide Voyado API access

Create an API key in Voyado under Configure > API connections, and send our Customer Success team:
  • The API key
  • Your tenant base URL, for example https://<client>.voyado.com
The base URL is the address of your Voyado tenant, not a link to a specific page inside Voyado. The API key must belong to that same tenant. We recommend a dedicated key for Dema so you can revoke it independently of your other integrations.

​
How to export segmentation labels to Voyado

  1. Click the ••• button on the right side of the customer set.
  2. Click “Manage export integrations.”
  3. From the list, opt in for Voyado.
  4. Click “Apply”.
Voyado processes label updates in the background. Changes usually appear within about 10 minutes, but can occasionally take longer. If you do not see updates after 30 minutes, contact us.

​
How it works

Labels in Voyado are updated:
  • Every morning
  • When the Voyado export is enabled for a customer set
  • Whenever the customer set is updated (clicking “Save” inside the set)
  • When the name of the customer set is changed
Labels in Voyado are removed:
  • When the Voyado export is disabled for a customer set
  • When the customer set is deleted
Customers whose email address does not match a Voyado contact will not receive a label. Renaming a Dema customer set renames the existing labels in Voyado rather than creating new ones, so selections and automations that use those labels keep working.
Both disabling the export and deleting a Dema customer set remove its labels from Voyado, so any Voyado selection or automation that relies on those labels stops working. Disabling is reversible — re-enabling the export reapplies the labels — while deleting the set is not.

​
How labels look

Labels in Voyado follow this format:
Example: If the set name is “My Set” and the label name is “VIP”, the label in Voyado will be:
A contact can have labels from multiple Dema customer sets.

​
How to use labels in Voyado

Voyado labels work like static segments: they group contacts without requiring the contacts to meet criteria defined in Voyado. Dema keeps the exported labels up to date as customers move between labels in a customer set. You can use Dema labels to:
  • Find contacts with a specific label, or combination of labels, in Voyado’s filtering tool
  • Build segments based on a label
  • Include or exclude contacts in automations
  • Target messages to a labeled group of contacts
  • View the labels assigned to an individual contact in the Labels section of their contact card
For example, filter by DEMA|My Set|VIP to find customers assigned to the VIP label in the My Set customer set. You can view and manage all labels from the Targeting menu in Voyado.
Dema fully manages every label that starts with DEMA|. Each update removes these labels from all contacts and reapplies them, so do not rename or delete them in Voyado, and do not assign them to contacts manually — those changes are lost on the next update.