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).

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.

🚧

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

Voici les colonnes disponibles dans le scope "masterreward" :

🚧

• N'oubliez pas que Splio n'importera pas les fichiers dont les colonnes obligatoires sont manquantes ou qu'il ne peut pas reconnaître. Les lignes contenant des valeurs vides dans les colonnes obligatoires seront ignorées.
• 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.

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 : 2021-03-09 10:00:05

Le jour et l'heure sont séparés par un espace blanc. La date et l'heure doivent être complètes - les lignes qui, par exemple, ne contiennent que des heures et des minutes ne seront pas importées.

Si la partie relative à l'heure est omise, Splio prendra l'heure la plus proche possible pour le jour (00:00:00). Par conséquent, 2018-09-09 équivaut à 2018-09-09 00:00:00.

🚧

• Cela ne devrait jamais être une option pour les dates et les heures : 00:00:00 correspond à minuit et Splio essaiera de traiter la date comme telle. Cela peut entraîner des erreurs et certains déclencheurs associés à des dates échoueront. 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 que vous ne pouvez pas vous permettre de laisser des détails au hasard.
  Utiliser des dates complètes vous permettra de filtrer et rechercher ces champs avec plus de précision.
• Lorsque vous importez des dates avec l'heure, veillez à toujours utiliser le même fuseau horaire (GMT+1).

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.