SOMMAIRE
Les données qui peuvent être récupérées
Paramétrer un export personnalisé
Étape 1 : Débuter l’export personnalisé
Étape 2 : Choix des données de l’export
Étape 3 : Paramétrer les champs sélectionnés (facultatif)
Étape 4 : Ajouter des conditions (facultatif)
Étape 5 : Configurer le flux de l’export
Étape 6 : Activer le chiffrement des données GPG (facultatif)
Étape 7 : Les déclencheurs automatiques de l’export
Les données qui peuvent être récupérées :
Retrouvez la liste des champs disponibles dans l’onglet paramétrage de l’export personnalisé lorsque vous l’avez débuté. Ces champs vont vous permettre de récupérer des données précises sur vos participants.
Formulaire Principal : Dans la partie formulaire principale, la liste des champs proposés correspond aux champs ajoutés sur le formulaire de l’opération. Cela inclut également les champs des formulaires additionnels. Cette liste propose également les champs dédiés à la mécanique (Quizz, Battle…).
is_optin = 0,1 ou 2 (Identifie les participants optin ou double optin)
contest_entry_hash_id = Id unique du participant
is_anonymous = 1 ou 0 (si 1 = le participant a été anonymisé)
created_at = la date de participation
Optin ou champ extend de type checkbox = 1 ou 0
Champ libre et question ouverte = contenu en clair
can_participate = Valeur 1 ou 0 (Si 1 = autorisé à participer)
Périphérique : Dans cette partie, ce sont des champs qui permettent de récupérer les données sur l’appareil utilisé.
mobile : 1 ou 0 (Si 1 cela veut dire que le participant provient d’un mobile)
L’url de provenance : Permet d’identifier l’url utilisé par le participant pour accéder à l’opération
l’adresse IP
user_informations.agent_browser : le navigateur utilisé
user_informations.agent_platform (Système utilisé): windows, mac, ou microsoft
le pays
Champ width et height : La taille du device utilisé
Opération : Les champs de cette catégorie sont ceux qui vous apporteront des informations sur l’opération
Chrono : Temps en seconde passé sur l’opération
Hash_id de l’opération : Code de l’opération exemple DRrv3d
Nom de l’opération
*Code d’accès : Cette partie liste un champ, le code d’accès, cela est utile pour connaître le code d’accès utilisé par le participant.
Code d’accès : contenu en clair
Externe : Si l’opération est lié à Sogec ou à 76310, vous retrouvez les champs suivants:
PAL : Le pal associé à la dotation délivrée ex:PAL03
Participation_sogec_id : exemple 2000056
Sogec last state : Le statut de la preuve d’achat
reason not conformity : La raison du refus
rnvp.email : 1 ou 0
rnvp.email.status : Selon les 3 statut défini, validé, suspect, invalide
rnvp.email.detail : Le détail exemple : MailboxDisabled
Rnvp.adresse 1 ou 0
rnvp.adresse.status : selon les 3 statut défini, validé, douteux, invalide
rnvp.adresse.detail : exemple : Adresse correcte
rnvp.api.count : Le nombre d’appel effectué vers l’api de 76310 par participation
Dotation : Les données liées à la dotation.
Contest gift hash_id : L’id de la dotation délivrée
Contest gift title : Le nom de la dotation délivrée
Contest gift description : la description
Contest gift code : le code unique délibrée avec la dotation
Custom : Le custom/Le champ personnalisé permet d’ajouter un champ avec une valeur définie. Vous pouvez ajouter autant de champs custom que vous souhaitez
2. Paramétrer un export personnalisé :
Étape 1 : Débuter l’export personnalisé
Utiliser le bouton « créer un export ».
Saisir le nom.
Choisir le type d’export personnalisé
Sélectionner l’opération qui sera associée à cet export.
Activer l’export uniquement des participants et/ou l’export uniquement des gagnants Par défaut, le contenu de l’export est basé sur les participations. Lors de la sélection d’une opération “instant gagnant”, vous avez la possibilité d'exporter uniquement les gagnants.
Étape 2 : Choix des données de l’export
Les paramètres de votre jeu et les champs de votre (vos) formulaires(s) déterminent les données qui peuvent être récoltées.
Cliquez sur les données de droite pour qu’elles apparaissent dans la zone de gauche.
Vous pouvez également modifier l’ordre d’affichage en glissant les éléments sur la zone de conception.
Les données disponibles ↓ La zone de conception ↓
Exemple après construction : La première ligne correspond à la première colonne que vous retrouverez dans l’export.
Étape 3 : Editer les champs sélectionnés (facultatif)
L’édition des champs permet de :
Renommer le titre du champ
Saisir une valeur par défaut
Ajouter une condition sur la taille minimum* et/ou maximum sur le nombre de caractères.
Les valeurs peuvent être transformées lors de la génération du fichier selon le filtre associé au champ.
Lexique des options disponible lors de l’édition du champ
Nom de colonne : L’intitulé qui sera affiché sur la colonne dans l’export
Valeur par défaut : Les champs qui appartiennent au formulaire (Form badge rouge) peuvent avoir une valeur par défaut lorsqu’il n’y a pas de donnée saisie par le participant.
Taille max : Le nombre de caractères maximum de la valeur saisie
Taille minimum : Le nombre de caractères minimum de la valeur saisie.
L’option “taille minimum” contient un champ numérique qui vous permet de saisir le nombre de caractères souhaités. Lorsque vous choisissez un nombre de caractères minimum, il faut choisir le type de caractères qui viendra compléter la valeur si elle n’atteint pas ce nombre de caractères. Le choix se porte sur un intervalle vide (espace) ou sur le caractère 0. Vous devez choisir s’il faut compléter devant (en préfixe) ou derrière (en suffixe) la valeur.
Lexique des filtres Les filtres sont utiles pour transformer les valeurs sous une autre forme.
Age en fonction d’une date : Utile pour les données date de naissance.
Transformer la chaîne en boléen : Les données deviennent True (Si =1) ou Fasle (Si=0). Exemple : Lorsque l’utilisateur gagne une dotation avec un code de dotation, la valeur sera “true”
0 si la chaîne est vide sinon 1.Exemple : Lorsqu’un participant remporte une dotation la valeur sera de 1 pour les autres participants “perdants” la valeur sera 0
Civilité au format long : Utile pour les données civilités.
Civilité au format court : Exemple : Monsieur pour Mr, Madame pour Mme…
Code pays au format long : Exemple : Fr pour France, Es pour Espagne…
Code pays au format court
Chaîne en minuscule.
Date au format DDMMYYYY. Exemple : 18 juin 1991 devient 18081991.Sera vide si ça ne correspond pas.
Retire les espaces vides lorsqu’il y a des espaces supplémentaires entre les mots.
Retourne une chaîne en majuscule.
Retourne une chaîne de caractère avec une majuscule sur la première lettre
Retourne le champ téléphone avec +33
Retourne le champ téléphone en 10 chiffres (Retire le +33 et remplacé par le 0)
Retourne le format date et heure YYYY-MM-DD HH:MI:SS
Retourne le format date YYYY-MM-DD
Retourne le format date et heure sans espace YYYYMMDD
Étape 4 : Ajouter des conditions (facultatif)
Les conditions vous permettent d’exporter des données triées. Si vous souhaitez récolter les données uniquement des participants qui ont partagé l’opération sur Facebook alors il doit paramétrer une condition.
Pour ajouter une condition sur un champ spécifique, il faut que le champ soit ajouté à la liste “champ sélectionné dans l’export “.
Vous pouvez ajouter plusieurs conditions, elles seront additionnées. Par exemple: Ajouter une condition sur les gagnants et les participants optin.
Exemple : Si l’utilisateur souhaite récolter les données uniquement des participants optin alors il doit paramétrer une condition de cette manière :
Étape 5 : Configurer le flux de l’export
Attention : L’export vers un CRM n’est pas fonctionnel.
Le format du fichier :
CSV : Permet d’afficher les données sous forme de tableau. Préférable lorsqu’il y a beaucoup de données.
XML : Permet d’afficher les données sous forme de hiérarchie. Utile en fonction du système sur lequel est envoyé le fichier.
JSON : Permet d’afficher les données sous une forme structurée
Note : Le “pattern” = le nom du fichier lorsqu’il sera exporté.
TXT : Un fichier dont le contenu représente uniquement une suite de caractères
Attention, les extensions de fichier de type CSV et XML comportent des champs qui doivent être obligatoirement configurés.
Le système à configurer :
Local : Export sur l’ordinateur depuis la page d’accueil de l’outil.
FTP : Transfert du fichier sur un FTP défini. C’est une méthode de transfert de fichier non sécurisé.
Le protocole FTPS est une déclinaison sécurisée du protocole FTP. Le chiffrement SSL/TLS vient s'ajouter pour sécuriser les communications entre le client FTP et le serveur FTP.
GCS : Stocké sur Google cloud.
S3 : Envoyé et stocké sur un serveur AWS.
SFTP : C’est une méthode de transfert de fichier sécurisé avec Secure Shell qui établit une seule connexion sécurisée fournissant aux clients un haut niveau de sécurité pour les transferts de fichiers.
Étape 6 : Activer le chiffrement des données GPG (facultatif)
Permet de protéger vos données à l’aide d’un système de paires de clés de sécurité publique-privée.
Les données entrantes peuvent être déchiffrées et les données sortantes chiffrées.
La commande à taper (sous linux ou osx) est "gpg --quick-generate-key" pour créer un couple de clé privée/public.
Étape 7 : Les déclencheurs automatiques de l’export
Immédiat : L’envoi de l’export se fait automatiquement
A la clôture de l’opération : Lorsque l’opération est se clôture définitivement
Récurrence hebdomadaire : Toutes les semaines à un jour précis
Planifié : Vous définissez la date et l’heure de l’export
Export journalier : Tous les jours à un horaire précis.
Il y a 3 types de configuration pour le contenu de l’export journalier :
1 : La donnée de la journée précédente
Uniquement les nouveaux participants
Si le participant revient le 2ème jour il ne sera pas dans le contenu de l’export.
2 : Les données du jour uniquement
Uniquement les nouveaux participants
Si le participant revient le 2ème jour il ne sera pas dans le contenu de l’export.
3 : Toutes les données
Si le participant revient le 2ème jour ses données seront mises à jour dans l’export.