Mettre en place Engage dans Actito
La première étape de l'intégration d'Engage est de préparer un formulaire standard dans Actito, qui sera utilisé pour stocker les participations.
Pour vous aider dans cette tâche, Actito peut déployer un formulaire prêt à l'emploi qui sera préconfiguré avec toutes les questions standards. Il ne nécessitera que quelques adaptations minimes pour l'adapter à votre base de données, vous aidant ainsi à disposer d'un formulaire fonctionnel pour collecter les données de Qualifio en un rien de temps.
Pour déployer ce formulaire dans votre licence, veuillez contacter votre gestionnaire de compte ou le support Actito, et préciser sur quelle table de profil il doit être créé.
Une fois le formulaire déployé, il sera disponible dans les brouillons de l'application 'Formulaires et pages', où vous pourrez le finaliser et l'activer.
Vous pouvez réaliser cette étape seul en suivant le guide ci-dessous. Si vous souhaitez l'aide des équipes Actito pour configurer votre intégration, n'hésitez pas à prendre contact avec votre gestionnaire de compte.
Guide de finalisation d'un formulaire Standard Engage
Rendez-vous dans l'onglet "Brouillons" de l'application "Formulaires et Pages" et sélectionnez le formulaire nommé "engageCampaigns-{nom de votre DB}.
Si plusieurs formulaires sont déployés sur la même base de données, le nom du formulaire sera suffixé par un incrément numérique. Une configuration spécifique dans Qualifio est requise pour intégrer des campagnes Engage avec plusieurs formulaires dans votre licence. Veuillez en discuter avec votre gestionnaire de compte.
Etapes 1, 2 & 3
Ce formulaire sera uniquement utilisé pour sa capacité à stocker des données et non pour sa structure. Les profils ne verront jamais son design car ils participeront au formulaire Qualifio.
Allez directement à l'étape 4, car vous ne devez rien modifier dans les 3 premières étapes : le formulaire est prédéfini avec les informations de base de votre DB.
Les étapes 1, 2, 5, 7, 8 et 9 peuvent être complètement sautées durant la création du formulaire car elles n'ont aucun impact.
Etape 4 - Définir les questions
Toutes les questions suivantes sont pré-définies: elles correspondent aux champs standards qui sont synchronisés par défaut. Cela comprend à la fois les données techniques de la participation et les données d'identification du participant.
Toutes ces questions sont synchronisées automatiquement par l'intégration. Veillez à garder toutes les questions dans votre formulaire Actito, même si votre base de données ne contient pas ces attributs. En effet, une question obligatoire manquante pourrait empêcher l'intégration entière de fonctionner.
Vous pouvez choisir les questions d'identités qui seront demandées dans votre campagne Qualifio, seul le formulaire Actito doit inclure tous les champs standards.
Voici, pour information, toutes les questions prédéfinies, leur nom et leur typage :
| Données | Question | Type de présentation & de réponse |
|---|---|---|
| Prénom | firstName | Champ ouvert - Texte |
| Nom | lastName | Champ ouvert - Texte |
| emailAddress | Champ ouvert - Adresse e-mail | |
| Adresse | addressStreet | Champ ouvert - Texte |
| Numéro | addressNumber | Champ ouvert - Texte |
| Boite | addressBox | Champ ouvert - Texte |
| Code postal | addressPostalCode | Champ ouvert - Texte |
| Localité | addressLocality | Champ ouvert - Texte |
| Pays | addressCountry | Boutons radio – Pays |
| Anniversaire | birthDate | Champ ouvert - Date |
| Genre | sex | Boutons radio – Gender Value : “M” ou “F” |
| Fonction | profession | Champ ouvert - Texte |
| Téléphone | telephoneNumber | Champ ouvert - N° de téléphone |
| Compagnie | company | Champ ouvert - Texte |
| Nom de la campagne | surveyName | Champ ouvert - Texte |
| Id du type de campagne | surveyType | Champ ouvert - Texte |
| Date de la participation | surveyDate | Champ ouvert - Date (YYYY-MM-DD) |
| Nom de l'appareil du participant | deviceName | Champ ouvert - Texte |
| User Agent | userAgent | Champ ouvert - Texte |
| Mettre à jour la source | updateSource | Champ ouvert - Texte |
| Langue de la campagne | motherLanguage | Liste déroulante – Langue |
Vous n'avez pas besoin d'éditer les questions existantes. Vous devez seulement ajouter une question basée sur votre DB (voir ci-dessous).
Ajouter la question Abonnements
En plus de ces 21 questions prédéfinies, vous devez aussi ajouter une question supplémentaire basée sur les Abonnements présent dans votre DB. Ceci doit être fait manuellement car les réponses doivent correspondre à vos abonnements.
Pour ce faire, cliquez sur "+ Ajouter un élément dans la page" en bas de l'étape 4.
Ensuite, choisissez "Définir une question à partir d'un attribut de la DB".
Dans la liste des attributs, choisissez l'option "subscriptions", identifiée par l'icône multi-valeur.
Gardez le texte par défaut et ne cochez pas les cases (l'enrichissement de la DB sera défini à une étape ultérieure). cliquez sur "Suivant".
La question est créée avec tous les abonnements existants de la DB comme réponses possibles !
La création de ces 22 questions est nécessaire pour synchroniser tous les champs standards de l'integration Engage. Vous pouvez également créer des questions additionnels pour synchroniser des champs personnalisés.
Etape 5 - Définir les pages annexes
Il n'y a pas de configuration requise pour cette étape. Vous pouvez donc la sauter.
Etape 6 - Enrichir la DB
L'enrichissement de bases de données est ce qui vous permet de créer ou de mettre à jour des profils dans votre base de données sur base de participations à des formulaires. Dans le cadre de l'integration Engage, l'enrichissement est optionnel : même sans enrichissement de DB, les participations seront synchronisées entre Qualifio et Actito et toutes les données seront stockées dans la participation du formulaire en elle-même.
Néanmoins, l'enrichissement est un avantage majeur des formulaires. Nous vous conseillons toujours de définir au moins une règle basée sur un attribut clé pour faire le lien entre la participation et un profil : elle doit être associée à un profil pour lancer un scénario par exemple.
Si la clé de vote DB est l'e-mail, vous pouvez facilement demander aux participants à votre campagne Qualifio de s'identifier via cette adresse.
Si la clé est plutôt un ID client, vous devrez rajouter une question (cachée) que vous pourrez pré-remplir avec les données de votre table de profil quand vous partagez votre campagne Qualifio à travers un canal Actito.
- Créer une nouvelle règle
- Dans la définition de règle, sélectionnez les options suivantes :
- Lorsque que la participation au formulaire est complète
- Mode d'enrichissement : mixte
- Depuis la liste d'attributs de la base de données à gauche, glissez l'attribut clé pour lier les profils et déposez-le sur la règle d'enrichissement.
- Cliquez ensuite sur le bouton 'Editer' à gauche de l'attribut clé sélectionné.
- Sélectionnez “Conserver la valeur actuelle”
C'est le principe de base requis pour lier une participation à un profil. Les règles d'enrichissement peuvent être configurées pour toutes les questions correspondant à un attribut de DB. Vous trouverez des instructions additionnelles et les bonnes pratiques pour l'enrichissement de DB dans une autre section.
Etapes 7, 8 & 9
Il n'y a pas de configuration requise pour cette étape. Vous pouvez donc les passer et retourner dans les brouillons pour la suite.
Définir les noms techniques
C'est via le nom technique que la participation dans Qualifio sera poussée dans Actito par API. Il est donc très important de les définir correctement.
Le nom technique des 21 questions prédéfinies sera déjà configuré, mais vous devrez assigner le bon nom technique à la question "Abonnements" créée à l'étape 4.
Retournez dans la liste des formulaires en définition, sélectionnez le formulaire et cliquez sur 'Plus' puis 'Définir le nom technique'.
Enquête
Il s'agit du nom technique du formulaire, que vous lierez à votre intégration dans Qualifio.
Il est prédéfini en "engageCampaigns*{nomDeLaDB}*, sans le tiret du nom d'affichage.
Questions
Le nom technique des 21 questions prédéfinies est déjà configuré. Pour information, ils sont listés ci-dessous.
Contrairement au nom du formulaire, qui permet certaines personnalisations, il est obligatoire que le nom technique des questions correspondent exactement à la spécification ci-dessous. Toutes les questions devraient être configurées.
| Texte court | Nom technique |
|---|---|
| Prénom | firstName |
| Nom | lastName |
| emailAddress | |
| Adresse | addressStreet |
| Numéro | addressNumber |
| Boite | addressBox |
| Code postal | addressPostalCode |
| Localité | addressLocality |
| Pays | addressCountry |
| Anniversaire | birthDate |
| Genre | sex |
| Fonction | profession |
| Téléphone | telephoneNumber |
| Compagnie | company |
| Nom de la campagne | surveyName |
| Id du type de campagne | surveyType |
| Date de la participation | surveyDate |
| Langue de la campagne | motherLanguage |
| Nom de l'appareil du participant | deviceName |
| User Agent | userAgent |
| Mettre à jour la source | updateSource |
De plus, vous devez définir le nom technique de la question "Abonnements" créée à l'étape 4.
Il doit être "subscriptions".
Indiquez cette valeur et cliquez sur "Valider".
Etape 10 – Publier le formulaire
Retournez dans l'éditeur de formulaire pour publier votre formulaire.
- Sélectionnez l'accès : Adresse publique, tout le monde peut y accéder
- Il n'est pas nécessaire de copier et coller l'URL du formulaire Actito, car les participations sont poussées directement depuis Qualifio par API
Créer un utilisateur API
La synchronisation entre les campagnes dans Qualifio et le formulaire Actito, seront mappés par appels API.
Ces appels sont pré-programmés et ne requièrent pas d'intervention d'un développeur! Néanmoins, vous devrez créer une clé API, que vous implémenterez dans Qualifio.
Veuillez suivre le processus de création d'utilisateur API
L'utilisateur API devrait être configuré comme suit :
- Entité : Sélectionnez l'entité de la table de profils liée au formulaire.
- Droit d'accès : Accordez au moins les droits D'ECRITURE dans la catégorie 'Data exchange - Forms'.
Prenez note de la clé API et de l'environnement de votre licence pour la prochaine étape : Mettre en place Engage dans Qualifio.