T.V
- En tant que client Qualifio, vous avez la possibilité d'automatiser le transfert quotidien des données de participation sur un de vos serveurs. L'intégration "Push CSV" vous permet de copier automatiquement les données de participation sur un serveur spécifié sur base quotidienne.
Introduction
L'envoi de données à votre serveur sFTP/FTPs est l'un des moyens les plus simples d'obtenir automatiquement les données collectées avec Qualifio. Cette fonction permet aux données de participation d'être transférées automatiquement et périodiquement sur votre serveur, au format CSV. Le dépôt est pris en charge sur des serveurs suivants les protocoles sFTP, FTPs et sur Amazon S3.
Quelles sont les données incluses ?
Nous travaillons avec un template standard qui contient les informations principales de chaque participation au format CSV. Le fichier sera constitué de toutes les participations à toutes les campagnes pour lesquelles l'intégration a été activée, collectées depuis le dernier dépôt de données.
Comme il s'agit d'une intégration standard offerte par Qualifio, l'ordre des colonnes, le séparateur (;) et le format des données ("") ne peuvent pas être modifiés.
Remarque importante :
Le nom du fichier que Qualifio transfère sur votre serveur sera toujours "qualifio_{YYYYYMMDD}.csv"
Structure du fichier
- playTime : Date et heure de participation (p.ex. 2019-08-12T13:39:28.+0000)
- participationID : Identificateur unique pour cette participation
- siteName : Nom du site sur lequel la participation a eu lieu
- siteCountry : Pays du site sur lequel la participation a eu lieu
- campaignID : Identifiant unique de la campagne
- campaignName : Titre de la campagne dans laquelle la participation a eu lieu
- campaignLanguage : Langue de la campagne dans laquelle la participation a eu lieu
- themes : Thèmes assignés à la campagne (et donc à la participation)
- Paramètres utm
- userAgent : p. ex. Mozilla/5.0 (Macintosh Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.100 Safari/537.36
- ip : Adresse IP de la participation (masquée)
- device : Dispositif utilisé pour participer
- crmId : Identifiant unique pour identifier le profil du ou de la participant(e) dans le CRM de Qualifio.
- newProfile : Permet de déterminer si ce profil existait auparavant dans le CRM Qualifio. La valeur retournée peut être TRUE - si le profil est effectivement nouveau pour le CRM - ou FALSE.
- Données du ou de la participant(e) : Les données que vous avez collectées sur le participant par le biais du formulaire de campagne (p. ex. nom, prénom, nom, adresse e-mail, date de naissance, adresse, genre, société, code postal, etc.) - uniquement les champs d'identification standard, automatiquement associés à une variable CRM
- Format de la date d'anniversaire: AAAA/MM/JJ
Vous avez besoin d'un format spécifique?
Si le format standard présenté ne vous convient pas, l'intégration Push CSV ne correspond donc pas à ce que vous recherchez.
Si vous souhaitez voir d'autres ou plus d'informations présentes dans votre fichier CSV (comme les optins ou des informations spécifiques liées à la configuration de la campagne comme un code marketing), veuillez contacter votre Expert Qualifio pour entamer des discussions avec l'équipe en charge des intégrations.
Qualifio dispose d'une autre fonctionnalité appelée "Exports Automatisés" qui vous permet de définir - avec l'aide de l'équipe Qualifio - le format exact du fichier que vous souhaitez recevoir sur vos serveurs. Pour en savoir plus sur le flux de connexion des données, lisez Comment mettre en place un export automatisé?
Exemple
Vous pouvez télécharger un exemple de fichier CSV.
À chaque nouvelle participation, nous ajouterons une ligne supplémentaire à ce fichier CSV.
Activer le Push CSV dans le back-office
- Aller dans les Paramètres.
- Cliquez sur Intégrations & Partenaires.
- Sélectionnez Fichier CSV vers serveur FTP/SFTP dans la liste.
- Utilisez le bouton ON/OFF pour activer ou désactiver cette intégration.
Cliquez maintenant sur Paramétrer. Vous serez dirigé vers une page où vous pourrez entrer des informations relatives au transfert des fichiers.
Configuration du serveur
Pour configurer l'intégration Push CSV, vous devez spécifier les paramètres pour les champs suivants pour permettre à Qualifio de déposer des fichiers sur votre serveur :
File server host : L'adresse du serveur sur lequel les données doivent être déposées. Cette adresse peut être entrée sous forme d'adresse IP numérique ou d'adresse DNS valide.
File server login : Le nom d'utilisateur requis pour se connecter au serveur.
File server password : Le mot de passe requis pour se connecter au serveur.
File server port : Le port utilisé par votre serveur FTP ou SFTP.
File server path : La structure de répertoire que le Push FTP doit suivre pour déposer les fichiers.
Cliquez sur Sauvegarder.
Remarque importante :
Il est possible qu'il vous faille configurer la liste d'IP Qualifio pour permettre le dépôt de fichiers sur votre serveur. La liste complète des ces dernières est disponibles ici: Liste blanche d'IP.
Activer le Push pour un site, un Master Form ou une campagne
Après avoir activé l'intégration Push CSV, elle apparaîtra dans le menu Paramètres > Règle de push de données.
En tant qu'Admin ou Marketer, c'est là que vous pouvez configurer vos push de données actifs par défaut ou spécifiques à un site, un Master Form ou une campagne. De plus amples détails peuvent être trouvés ici.
Remarques
- Le fichier est déposé sur votre serveur FTP tous les jours à 2h00 du matin (heure GMT/Bruxelles). Ce délai est prédéfini et ne peut pas être modifié.
- La logique de la connexion est incrémentielle, ce qui signifie qu'un fichier sera transféré avec les données collectées dans toutes les campagnes depuis le dernier transfert. Cela évite d'avoir à gérer la duplication des données.
- Si le dépôt sur votre serveur de fichiers échoue cinq fois de suite le lundi, nous réessayerons le mardi. Le mardi, vous recevrez donc à la fois les données du lundi et du mardi. Toutefois, ces données seront compilées dans un seul fichier.
- La possibilité de transférer les données de participation vers un serveur FTP vous permet de les stocker indéfiniment, au lieu de les stocker dans Qualifio, qui a une période maximale de conservation des données de 2 ans.
- Il est possible d'avoir à la fois un push CSV et un push en temps réel activé pour une campagne.
Si vous avez besoin d'aide pour utiliser le Push FTP après avoir lu cet article, veuillez contacter votre Expert(e) Qualifio.
Lire aussi : Connectez Qualifio aux outils utilisés par votre équipe et réunissez toutes vos données au même endroit.