Datahub – Récompenses Loyalty (rewards)

Cet article présente trois scopes qui permettent d'importer des données de récompenses :

• masterreward – permet de créer des master rewards, qui sont utilisés pour l'attribution de récompenses,
• earnreward – avec lequel les récompenses sont attribuées à des cartes de fidélité,
  
• burnreward – avec lequel les récompenses peuvent être dépensées (brûlées).
  

Vous trouverez trois exemples de fichiers pour ces scopes à la fin de l'article.

Pré-requis

• Connaissance du format CSV et de la procédure d'import ;
• Un éditeur de texte ou un tableur compatible UTF-8 ;
• Une certaine compréhension des données de fidélité importées dans Splio ;
• Le scope d'import master reward doit être configurée par votre Project Manager dans Splio

Préparation d'un fichier pour importer des master rewards

Les fichiers dans le scope "masterreward" vous permettent d'ajouter des récompenses à votre catalogue. Quand les master rewards sont utilisés pour attribuer des récompenses, les membres recoivent des récompenses qui sont les copies exates du master reward.

Voici les colonnes disponibles dans le scope "masterreward" :

💡 | Les colonnes qui ne sont pas en gras représentent des "sous-champs". Ils contiennent des données qui dépendent de la valeur d'un autre champ.

⚠️ | 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. 

📗 | Veuillez noter que les colonnes "validity_period" et "validity_interval_type" peuvent être forcées lors de l'attribution.

Exemple 1 : un fichier “ Master Reward ”

L'exemple ci-dessous montre un fichier d'import qui utilise toutes les colonnes standard. Les colonnes vides, comme «;;», sont importées en tant que valeurs NULL.

external_id;name;monetary;monetary_type;monetary_value;nqp_value;description;rich_description;holding_days;validity_interval_count;validity_interval_type;forced_validity;is_limited;max_attribution_count
"mastertest_missing_price";"mastertest";;;"2";;;;"0";"1";"day";"0";;
"master_missing_auto_generation";"mastertest";;;"9";"10";;;"0";"1";"day";"0";;"0"
"master_bad_stock";"mastertest";;;"9";"10";;;"0";"1";"week";"0";"1";"0"
"masterlight";"salad";;;"9";"10";;;"0";"1";"month";"0";"1";"100"
"Masteritem_0_stock";"mastertest_item";;;;"10";;;"0";"1";"week";"0";;"0"
"masteritem_bad_stock";"mastertest_item";;;;"10";;;"0";"1";"week";"0";;

📗 | Notez que la plupart des lignes de cet exemple ne seront pas importées avec succès. La valeur "external_id" indique l'erreur, comme un prix manquant, ou une valeur de stock incorrecte. Par exemple, la seconde ligne ne fonctionnera pas, puisqu'il manque le prix.

Préparer un fichier "earn rewards"

Vous pouvez utiliser les fichiers "earnreward" pour assigner (earn) des récompenses aux membres loyalty . Techniquement, l'attribution d'une récompense créée un lien entre la définition de la récompense et une carte loyalty.

Voici la liste des colonnes disponibles dans un fichier "earnreward" :

⚠️ | Utilisez toujours des dates telles que : 2021-02-12 08:30:22 (avec les heures, minutes et secondes) pour les champs "earn_date", "validity_end_date", "validity_start_date", et "burn_date". Quand la date est remplie grâce au serveur, elle est à GMT+1 pour les clients européens et à GMT+8 pour les clients chinois. Voir les détails sur les dates ci-dessous pour en savoir plus.

📗 | Il n'y a pas de colonnes personnalisées pour les fichiers "earnrewards".

Exemple 2 : un fichier "earnreward"

"reward_id";"card_code";"attribution_id";"quantity";"context";"earn_date";"validity_start_date";"validity_end_date"
"1066";"CC0001";"oc_0002750875";"1";"web";"2012-06-19 23:25:00";"2012-06-20 00:00:00";"2012-06-26 00:00:00"
"1086";"CC0003";"oc_0002750876";"1";"web";"2012-06-19 06:55:00";"2012-06-20 00:00:00";"2012-06-26 00:00:00"
"1455";"CC0002";"oc_0043302300";"1";"web";"2014-12-23 12:04:00";"2014-12-24 00:00:00";"2015-01-06 00:00:00"
"1455";"CC0004";"oc_0043243103";"1";"web";"2014-12-20 21:54:00";"2014-12-21 00:00:00";"2015-01-06 00:00:00"
"1455";"DD0001";"oc_0043244548";"1";"web";"2014-12-20 11:32:00";"2014-12-21 00:00:00";"2015-01-06 00:00:00"
"1455";"EE0001";"oc_0039303830";"1";"web";"2014-12-13 14:28:00";"2014-12-14 00:00:00";"2015-01-06 00:00:00"
"1455";"XXX00000";"oc_0043243488";"1";"web";"2014-12-20 09:10:00";"2014-12-21 00:00:00";"2015-01-06 00:00:00"
"1455";"abcde";"oc_0043302697";"1";"web";"2014-12-23 08:42:00";"2014-12-24 00:00:00";"2015-01-06 00:00:00"
"1455";"CC111";"oc_0043303913";"1";"web";"2014-12-23 12:54:00";"2014-12-24 00:00:00";"2015-01-06 00:00:00"
"1455";"SM123";"oc_0043286685";"1";"web";"2014-12-22 15:33:00";"2014-12-23 00:00:00";"2015-01-06 00:00:00"

Préparer un fichier "burnrewards"

Un fichier "burnreward" contient des informations sur les récompenses à "brûler" par les membres du programme Loyalty. Brûler une récompense signifie qu'elle a été utilisée ou récupérée par le membre. Techniquement, cela ne change pas le statut du "masterreward" mais des informations des "earned rewards".

Voici les colonnes disponibles dans un fichier "burnreward" :

⚠️ | Utilisez toujours des dates comme 2021-02-12 08:30:22 (avec les heures, minutes et secondes) pour "burn_date".

📗 | Il n'y a pas de colonnes personnalisées pour les fichiers "burnrewards".

Exemple 3 : un fichier "burnreward"

card_code;context;burn_date;attribution_id
CC0001;An incredible corgi designed bowl (empty unique_key);2018-08-09 11:03:05;NULL
invalidcardcode;An incredible corgi designed bowl;2018-08-09 11:03:05;test
CC0001;Welcome reward (valid burn);2018-08-09 10:00:05;EG2563
CC0003;Chocolate bone;2018-09-09 12:43:05;invalidattrid
CC0003;Chocolate bone(invalid date: future);2018-09-09 08:12:10;DE-0009-3981
CC0003;Chocolate bone(invalid date bis);2018-09-09;DE-0009-3981
CC0002;already_burned;2018-08-09 11:03:05;DE-0009-3981
CC0004;An incredible corgi designed bowl(valid burn);2018-08-09 08:12:10;BB-0001

Nommez le fichier d'import

Splio requiert que l'on nomme les fichiers d'import d'une manière spécifique. Chaque nom de fichier doit contenir le nom de l'univers, le scope (« master reward », « gagner une récompense » ou « brûler la récompense »), la sous-section (vous devriez l'avoir obtenu auprès de votre Projet Manager) 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 toujours univers_scope_subsection_YYYYMMDD.csv. Cela signifie que les fichiers d'import comprenant les trois scopes de cet article, dans un univers « my company » et une sous-section « silver », datés du 14 février 2019, pourraient être nommés comme ceci :

mycompany_masterreward_silver_20190214.csv
mycompany_earnreward_silver_20190214.csv
mycompany_burnreward_silver_20190214.csv

Explication : Dates

Toutes les dates utilisées dans les fichiers d'import de récompenses 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. Les parties de la date et de l'heure doivent être complètes - les lignes qui, par exemple, ne contiennent que des heures et des minutes ne seront pas importées.

Vous avez la possibilité d'utiliser uniquement la date (mais vous ne devriez pas). Si vous le faites, Splio considérera l'heure la plus tôt possible pour la journée (00:00:00). Donc,

2018-09-09

Équivaut à

2018-09-09 00:00:00

Cependant, vous devez toujours considérer toutes les données Loyalty 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 détails au hasard. Par conséquent, il est essentiel que vous utilisiez la date et l'heure complètes dans la mesure du possible (à l'exception des dates de naissance).

Un avantage supplémentaire de l'utilisation de dates complètes est que vous pourrez rechercher et filtrer par date avec une précision beaucoup plus grande.

⚠️ | 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.

📗 | Utiliser des dates complètes vous permettra de filtrer et rechercher ces champs avec plus de précision. 

Explications : NULL et valeurs de suppression

NULL est une valeur spéciale qui indique à la base de données que le champ qui la contient est vide. Votre univers Splio peut être configuré pour interpréter les valeurs NULL comme des instructions pour vider les champs. Vous pouvez l'utiliser pour effacer les valeurs stockées dans la base de données. Pour ce faire, assurez-vous que la valeur importée est exactement NULL. Vous devez éviter les espaces de début ou de fin: "NULL " ou " NULL" seront reconnus comme des valeurs de chaîne. Si cette option n'est pas définie, Splio conservera les valeurs des champs où la valeur importée est NULL.

Différence entre NULL et une chaîne vide

"" est une chaîne vide. Dans la plupart des cas, NULL et "" seront importés en tant que valeur vide. Plus important encore, la chaîne vide "" n'est jamais considérée comme une valeur NULL, donc elle n'entraînera pas l'effacement d'une valeur existante.