Description

Vous avez un nombre important de dotations ? Si oui, l'option "Import par fichier" est faite pour vous ! Paramétrez le fichier de configuration et uploadez un grand nombre de dotations en une seule fois. Associez des images et/ou codes si nécessaires.

Avant de commencer

ℹ️ Cette fonctionnalité est disponible exclusivement en mode "Par date". Si vous souhaitez créer des dotations par participation ou par tirage au sort, consultez cet article.

✅ Vérifiez que vous disposez de toutes les informations nécessaires pour importer massivement des dotations (noms, quantités, dates de distribution, etc.)

✅ Vous devez avoir accès à un logiciel de tableur comme Google Sheets ou Microsoft Excel par exemple

💡 Nous vous conseillons de créer un dossier sur votre ordinateur contenant l'ensemble des fichiers nécessaires pour l'import massif.

Préparation des fichiers optionnels

Cette étape est nécessaire si vous souhaitez associer des images à vos dotations et/ou créer des dotations codes. Si ce n'est pas le cas, passez à l'étape suivante.

Fichiers images

Formats d’images acceptés : PNG / JPEG / GIF / SVG
Dimensions : 800x800px
Poids : 300 Ko maximum

Fichiers codes

Un fichier codes doit contenir un code par ligne
Format .csv
Un fichier est limité à 1 million de codes maximum
Si vous avez plusieurs dotations différentes de type codes, il faudra 1 fichier / dotation !
Exemple de fichier code.csv :

Placez vos fichiers optionnels dans un dossier pour faciliter l'importation.

Préparation du fichier global

Pour commencer, téléchargez le fichier de configuration :

Télécharger

Une fois le fichier téléchargé, ouvrez-le avec un logiciel de tableur comme Google Sheets ou Microsoft Excel. Avant de mettre le fichier sur la plateforme, supprimez les deux premières lignes. Elles donnent des conseils pour bien organiser vos dotations.

Notez les noms de vos images de dotations et de vos fichiers de code si vous en avez, puis ajoutez-les en plus lorsque vous importez les dotations automatiquement. Si vous avez des dotations dans plusieurs langues, faites une ligne pour chaque langue avec la même quantité et traduisez son nom.

Description des colonnes du fichier global

Cliquez sur un titre pour afficher la description.

start_date

Date à partir de laquelle la dotation doit être distribuée (mettre un start_date et un end_date identique pour définir une date et une heure exacte de distribution)
⚠️ Champ Obligatoire
Le format demandé est soit "DD/MM/YYYY hh:mm:ss" pour inclure les secondes, soit "DD/MM/YYYY hh:mm" pour exclure les secondes (qui seront alors automatiquement configurées à 00).

Vérifiez bien le format des cellules "dates", celles-ci doivent être obligatoirement en format "Date heure"

end_date (Date de fin)

Date de fin jusqu'à laquelle la dotation peut être distribuée (mettre un start_date et un end_date identique pour définir une date et une heure exacte de distribution)
⚠️ Champ Obligatoire
Le format demandé est soit "DD/MM/YYYY hh:mm:ss" pour inclure les secondes, soit "DD/MM/YYYY hh:mm" pour exclure les secondes (qui seront alors automatiquement configurées à 00).

Vérifiez bien le format des cellules "dates", celles-ci doivent être obligatoirement en format "Date heure"

associated_page

Page associée (page ID) : L'identifiant de la ou les page(s) d'instant-gagnant sur lequel(s) la dotation sera distribuée.
⚠️ Champ Obligatoire
En cas de pages d'IG multiples, séparer les valeurs par une virgule.
Pour spécifier toutes vos pages d'Instants-gagnants indiquer le mot "all".
Pour récupérer votre identifiant de page, placez-vous sur la page souhaitée et dans l'url, cherchez la suite de chiffres après le wording /page/.
Exemple
Le page ID est constitué de 6 chiffres, voici un exemple :
https://admin.adictiz.io/editor/42821/view/page/332691/lang/1/platform/68328/panel/settings

reward_type

Type de la dotation : physical ou code
⚠️ Champ Obligatoire

reward_key

Insérez un identifiant unique pour la dotation (en cas de dotation multilingue, veuillez spécifier le même identifiant ainsi que la même quantité)
⚠️ Champ Obligatoire

reward_lang

Langue dans laquelle la dotation doit être paramétrée (associez le code pays de la langue configurée sur votre campagne, voir tous les codes pays ici)
⚠️ Champ obligatoire

reward_name

Nom de la dotation
⚠️ Champ obligatoire

reward_quantity

Quantité de dotations à distribuer
Si les dotations sont de type code, ne spécifiez pas de quantité. Le fichier de code associé définira automatiquement le nombre de codes.
En cas de dotation physique multilingue, veuillez spécifier le même identifiant unique (reward_key) ainsi que la même quantité.
⚠️ Champ Obligatoire

reward_url

URL associé à la dotation
Champ optionnel

reward_image

Image associée à la dotation
Insérez le nom et l'extension du fichier image. Exemple : dotation.png
Le nom est sensible à la casse. Le nom doit être totalement similaire, majuscule et accent conservé.
Champ optionnel

file_code

Nom et extension du fichier de code associé à la dotation (uniquement si type de dotation = code). Exemple : dotation.csv
Le nom est sensible à la casse. Le nom doit être totalement similaire, majuscule et accent conservé.
Un seul fichier de code autorisé avec un maximum de 1 million de codes par fichier
Si vous avez plusieurs dotations différentes de type codes, il faudra 1 fichier / dotation !
Champ optionnel

expiration_date

Date d'expiration de la dotation (uniquement disponible en mode date fixe)
Le format demandé est soit "DD/MM/YYYY hh:mm:ss" pour inclure les secondes, soit "DD/MM/YYYY hh:mm" pour exclure les secondes (qui seront alors automatiquement configurées à 00).
Champ optionnel

shop

Point(s) de vente(s) associé(s) à la dotation
Consultez cet article pour savoir comment importer vos points de vente.
Veillez à bien séparer les valeurs par une virgule (si vous souhaitez associez tous vos points de vente à une dotation, mettre le mot ""all"" dans la cellule).
Si vous ne voulez pas associer de point de vente à une dotation, laissez ce champ vide
Champ optionnel

exclusion

Période d'exclusion de la dotation (pas la nuit ou pas le weekend) : night/week ou vide
Champ optionnel

priority

Priorité de la dotation (1, 2,3 ou vide)
Champ optionnel

distribute

Répartir quotidiennement les dotations (yes=1/no=0)
Champ optionnel

mark_test

Marquer la dotation comme test (uniquement les utilisateurs du compte peuvent gagner une dotation marquée comme test, oui = 1 / non = 0)
Champ optionnel

Exemple de configuration pour un import massif de dotations physiques et codes avec images associées :

Exportation du fichier global

Lorsque vous avez terminé de compléter les colonnes de votre fichier, suivez ces étapes pour l'exporter :

Exporter via Google Sheets

Cliquez sur Fichier puis cliquez sur Télécharger.
Dans le menu déroulant, sélectionnez "Valeurs séparées par des virgules (.csv)"

Exporter via Microsoft Excel

Cliquez sur "Fichier" puis cliquez sur "Enregistrer sous...".
Dans le menu déroulant, sélectionnez "Séparateur point virgule (.csv)"

⚠️ Attention : Votre fichier doit obligatoirement être intitulé "global_config.csv"

Renommez le fichier après exportation si nécessaire

Exemple de dossier contenant l'ensemble des fichiers prêts à l'importation :

Importer des dotations par fichier

Étape 1

Une fois que vos fichiers de configuration sont prêts, déposez-les dans la zone d'importation ou cliquez pour parcourir :

Vos fichiers vont être analysés, des erreurs de configuration peuvent être présentes. Corrigez ces erreurs en réimportant les fichiers corrigés ou manquants.

Cliquez sur Générer pour passer à l'étape suivante.

Étape 2

Vous accédez au récapitulatif des dotations.

Vérifiez l'ensemble des informations puis cliquez sur Valider.

✅ La configuration est validée, publiez votre campagne pour mettre en ligne vos dotations.

💡 Lors de la publication de votre campagne, certaines dotations peuvent prendre un certain temps pour être générées. Vous pouvez quitter cette page pour laisser l'opération se dérouler en tâche de fond

Erreurs de configuration

Une ou plusieurs erreurs de configuration peuvent survenir lors de l'importation des fichiers. Deux catégories d'erreur peuvent être identifiées et corrigées :

Erreur liée à un fichier manquant

Réimportez les fichiers absents. Veillez à ce son nom et extension correspondent aux informations saisies dans le fichier global_config.csv.

Erreur liée à un problème de configuration du fichier global

1. Rouvrez votre fichier global_config dans un logiciel de tableur et identifiez les erreurs remontées lors de l'importation. L'éditeur vous indique les lignes concernées.

2. Corrigez ces erreurs et exportez à nouveau votre fichier au format .csv

3. Supprimez le fichier global_config.csv précédemment importé et réimportez votre fichier corrigé.

💡 Si vous constatez qu'un fichier a été incorrectement nommé dans votre fichier global_config mais que son extension est correcte, il serait plus efficace de le renommer plutôt que de procéder à des modifications dans le fichier global. Cela vous permettra d'économiser du temps.

Q&A

Pourquoi certains fichiers sont optionnels ?

Les fichiers optionnels se réfèrent aux images liées aux dotations, ainsi qu'aux dotations de type code. Vous avez la possibilité de ne pas les inclure, car il est tout à fait envisageable de générer des dotations physiques sans les accompagner d'images.

Pourquoi associer une image à ma dotation ?

Associer des images à vos dotations vous permet de les afficher dynamiquement grâce à des widgets images. Affichez par exemple sur la page "Gagné" d'un instant gagnant l'image de la dotation remportée par l'utilisateur. En savoir plus.

global_config.xlsx