How to choose your unique key?

Choose your unique key

The unique_key is a Splio Customer Platform system field you can use to attach a unique user identifier to a contact. That user identifier will act as a 1-1 mapping identifier between Splio universe and your external systems.

The unique key must be:

  • Unique and immutable (stable over time)
  • Ideally known by most of your systems (e.g. Marketing Automation, e-commerce, etc.).

Ideally, we do not recommend using the email or the phone number as the unique key since they are not immutable (i.e. not stable over time). A typical edge case in this configuration: as the email can be often be changed and one user can have different email you will systematically loose the order history.


Soit tu choisis comme unique key email tu peux avoir différentes sources mais pour champs mappés aux différentes source en mode last win.

si email change on te dit prends un autre => cas fusalp (même si on a pas de système tiers qui attribue ID) on a cette idée de search et on peut faire la demande de forcer l'unicité sur email

et soit première source crée identifiant qui attribue et autre su plug dessus car search par email avant de créer => ajd on veut déplacer la logique de l'intégrateur vers chez splio

et il faut juste s'assurer que toutes les sources connaissent la clé

soit source est pas APIs et fait du list & search soit par fichier et il faut connaître en amont


When and how to change a universe's key?

  • Migration from an e-commerce to another
  • Change of data mapping between your systems