Cet article explique l'import automatique d'abonnés aux programmes Loyalty. Les abonnements sont des card codes Loyalty, chacun représente l'appartenance à un programme qui peut être connecté à un contact. Quand vous importez un fichier d'abonnements, vous ajoutez des membres à votre programme loyalty. Dans cet article, vous découvrirez aussi comment changer le statut d'un batch de membres de Loyalty.

Prérequis

Connaissance du format CSV et de la procédure d'import.
Un éditeur de texte et un tableur compatible UTF-8.
La création du scope "subcriptions" dans le fichier de configuration
La connaissance de la clé unique de votre univers
La compréhension du modèle de données Loyalty dans Splio

Préparer un fichier d'import d'abonnements Loyalty

🚧
Veuillez limiter la taille de votre fichier à 200K lignes.

Préparez un fichier CSV contenant les colonnes du tableau ci-dessous.

Colonne	Obligatoire	Format	Description
card_code	Oui	Texte	Identifiant de la carte loyalty. Les codes sont uniques : si vous entrez un code existant, cette carte sera mise à jour. ⚠️ \| Un univers Splio peut être configuré pour générer des codes de cartes. Si c'est le cas, Splio fournira les valeurs "card_code" manquantes au format EAN13. Dans ce cas, la colonne peut contenir des valeurs vides (mais vous devez quand même l'inclure dans votre fichier).
customer_key	Oui	Texte	Colonne spécifique qui identifie le propriétaire de la carte. Au minimum, il contient habituellement l'adresse email. Si il est vide, le cardcode ne sera pas lié à un contact.
id_program	Oui	Entier positif	ID du programme loyalty auquel l'abonnement appartient. Ce chiffre vous est fourni par votre contact chez Splio. Vous pouvez aussi le trouver dans l'URL. ⚠️ \| Cette colonne ne devrait être utilisée que pour les nouvelles cartes. Enlevez-le pour les mises à jour : toutes les tentatives de mise à jour de l' "id_program" échoueront, et Splio ignorera les lignes en question.
join_date	Non	YYYY-MM-DD HH:MM:SS	La date à laquelle le membre a rejoint le programme. Si il est vide, sera complété avec la date et l'heure de l'import. Voir ci-dessous pour des détails sur les dates.
expiration_date	Non	YYYY-MM-DD HH:MM:SS	La date de fin de validité de la carte.
birthday	Non	YYYY-MM-DD HH:MM:SS	La date (sans heure) d'anniversaire du membre. Utilisée dans de nombreuses opérations.
id_tier	Non	Entier positif	L'ID du statut que doit rejoindre le membre (peut être un statut VIP). Si ce champ est vide, il attribuera le statut le plus bas du programme. Ce champ ne fonctionne que pour la création du cardcode, et pas pour sa mise à jour.

🚧
L'ordre des champs dans l'importation du cardcode est essentiel et doit respecter l'ordre suivant : "card_code" ; "customer_key" ; "id_program" ; "join_date" ; "custom_fields".

📘
N'oubliez pas que Splio ignorera le fichier si il rencontre un nom de colonne qu'il ne peut pas reconnaître, ou si le fichier ne contient pas les colonnes obligatoires. En outre, toutes les lignes dans lesquelles les valeurs des colonnes obligatoires sont manquantes seront ignorées en tant qu'erreurs.

Depuis Janvier 2024, il n'est plus possible d'attribuer plus d'un card code actif à un contact, pour un programme donné. Les card codes créés précédemment n'ont pas été supprimés ni expirés.

Exemple de fichier d'abonnement

L'exemple ci-dessous montre un fichier d'import. Les colonnes vides, comme ";;", sont importées en tant que valeurs NULL.

card_code;customer_key;id_program;join_date;expiration_date;birthday;id_tier
"my_card_code";"[email protected]";"1";"2019-01-01 00:00:01";"2020-01-01 00:00:01;1955-02-01";"2";
"[email protected]";"3";;;;"2"
"my_card_code1";"[email protected]";"1";;;;"4"

📘
Il n'y a aucune erreur évidente dans ce fichier. La première ligne contient beaucoup plus d'informations que les deux autres. Notez cependant que sur la ligne médiane, il n'y a pas de code de carte : si la génération automatique de code de carte est activée, Splio fournira le numéro. Sinon, cette ligne provoquera une erreur et ne sera pas importée.

Changement de statut

Importer des codes de carte peut également servir à changer le statut d'un batch de membres de votre programme Loyalty.

Pour ce faire, vous devrez préparer un fichier avec les champs suivants :

Colonne	Obligatoire	Format	Description
card_code	Oui	Texte	voir plus haut
tier_name	Oui	Texte	le nom du statut
context	Non	Texte	la raison pour laquelle vous avez changé de statut
value_date	Oui	YYYY-MM-DD HH:MM:SS	La date à laquelle le membre passe d'un niveau à un autre
last_downgrade_check	Non	YYYY-MM-DD HH:MM:SS	Indiquez la date de la dernière vérification du déclassement : elle sera prise en compte pour les vérifications périodiques du déclassement (quotidiennes, mensuelles, annuelles).

Nommez le fichier d'import

Splio requiert que vous nommiez vos fichiers d'import d'une manière spécifique. Chaque nom de fichier doit contenir le nom de l'univers, le scope ("cardcode" ou "tierchange"), la sous-section (vous devriez l'avoir obtenu auprès de votre contact chez Splio) et la date. L'ordre dans lequel les fichiers sont traités dépend des scopes et des dates.

Le schéma de dénomination est universe_scope_subsection_YYYYMMDD.csv. Cela signifie que le nom correct d'un fichier d'import dans un univers "myunivers", un scope "cardcode" ou "tierchange" et une sous-section "clients", datés du 14 février 2019, est :

myuniverse_cardcode_customers_20190214.csv

🚧
S'il y a plus d'un fichier de cardcode par jour, la sous-section est obligatoire dans le nom du fichier.

Explication : Dates

Toutes les dates utilisées dans les fichiers d'import d'abonnement doivent être formatées de la manière suivante : 4 chiffres pour l'année, 2 pour le mois et 2 pour le jour, suivis des heures, des minutes et des secondes, 2 chiffres chacun. Une date correcte pour le 9 août 2018, 10:00:05 prend la forme suivante :2018-08-09 10:00:05

Le jour et l'heure sont séparés par un espace vide. Vous pouvez omettre la partie heure et utiliser uniquement la date. Si vous le faites, Splio considérera l'heure la plus tôt possible pour la journée (minuit). Donc, 2018-09-09 équivaut à 2018-09-09 00:00:00.

🚧

Les dates doivent toujours être utilisées avec les heures et les minutes. 00:00:00 correspond à minuit et Splio considèrera cette heure telle qu'elle. Ceci peut causer de nombreuses erreurs et problèmes d'automatisation. En outre, toutes les données Loyalty sont toujours considérées comme des informations financières. Cela signifie que vous et votre entreprise êtes responsables de ces données et ne pouvez pas vous permettre de laisser des éléments au hasard.
Utiliser des dates complètes vous permettra de filtrer et rechercher ces champs avec plus de précision.

"birthday" est le seul champ de date qui doit être importé sans heure.

Lorsque vous importez des dates avec l'heure, utilisez toujours la timezone CEST.

Explication : valeurs de suppression

Pour le scope abonnements Loyalty uniquement, les valeurs NULL ne fonctionnent pas pour supprimer les données. Veuillez utiliser une valeur "" ou vide pour supprimer des valeurs des champs du cardcode.