T.V
- Qualifio vous permet de limiter les participations à votre campagne sur base d'actions de conversion spécifiques. Ce tutoriel explique comment utiliser le jeton sécurisé pour récupérer des informations externes et définir en temps réel qui peut participer à votre campagne.
Voici une table des matières si vous voulez prendre un peu d'avance :
- Cas d'utilisation
- Limiter l'accès des utilisateurs à une campagne Qualifio
- Intégrer le jeton dans votre compte Qualifio
- Configuration de votre campagne
Si vous souhaitez simplement définir le nombre de participations maximum à votre campagne, veuillez consulter cet article.
Cas d'utilisation
Les limites de participation personnalisées reposent sur des informations externes à votre campagne et sont donc très flexibles. Cette fonctionnalité étend les capacités de Qualifio à limiter les participations à une campagne. Voici quelques scénarios où cela est utile :
- Le premier cas d'utilisation concerne les concours avec obligation d'achat. Disons que votre objectif est d'augmenter le montant qu'un client dépense :
- il peut être autorisé à participer à votre campagne uniquement s'il a dépensé au moins 30 € dans votre magasin au cours des quatre dernières semaines, par exemple ;
- la limite pourrait également être fixée à une participation par tranche d'achat de 10 €. Dans ce cas, vous augmenteriez le nombre de participations autorisées avec chaque achat.
- Une autre façon de contrôler le nombre de participations d'un utilisateur est de définir une limite basée sur les points de fidélité. Par exemple, il pourrait devoir collecter un nombre minimum de points bonus avant d'être autorisé à participer à votre campagne ou concours.
- Enfin, vous pouvez également restreindre l'accès à une campagne aux abonnés payants, ou aux abonnés d'un segment spécifique. Si votre objectif est d'acquérir des abonnés payants, offrez-leur l'accès à des campagnes exclusives auxquelles seuls vos abonnés Premium peuvent participer.
Mais comment faire pour mettre cela en place ? Découvrons cela ensemble 😉
Limiter l'accès des utilisateurs à une campagne Qualifio
Maintenant que vous savez pourquoi vous pourriez vouloir limiter les utilisateurs qui peuvent participer à votre campagne, voyons comment faire.
Vous utiliserez un jeton Web JSON pour définir une limite. Celui-ci constitue un moyen standardisé et sécurisé de transmettre des informations externes à une campagne Qualifio.
Génération de jetons Web JSON (JWT)
La première chose à faire est de créer dynamiquement un jeton pour chaque participation, contenant un ensemble minimal de données permettant à Qualifio d'accorder ou de refuser l'accès à la campagne.
Spécifications techniques
D'un point de vue technique, les informations externes seront partagées par le biais d'un jeton Web JSON signé (JWS) que vous aurez généré en suivant la structure standard définie par Qualifio.
Note : Vous avez la responsabilité de partager toutes les informations nécessaires afin que Qualifio soit en mesure d'excercer la limite. Dans la section suivante, nous vous expliquons comment faire.
Structure d'un jeton Web JSON (JWT)
Le jeton contient une série d'informations (des "déclarations", qui sont en fait des paires clé/valeur) sur une entité (l'utilisateur). Décomposons-en les différentes parties.
Déclarations réservées
Les déclarations suivantes sont nécessaires pour valider un jeton JWT :
- sub
- exp
- campaignId (Trouvez l'ID de votre campagne)
Pour plus d'informations sur ces déclarations, voir Comment le jeton sécurisé fonctionne-t-il ?
Déclarations supplémentaires
Pour la limite de participation personnalisée, vous pouvez fournir les déclarations supplémentaires suivantes dans la charge utile du jeton :
limit
Cet élément d'information indique si un utilisateur est autorisé à participer à la campagne et/ou combien de fois il est autorisé à le faire. L'objet JSON contient deux déclarations :
- limit.canPlay est utilisé pour autoriser l'accès à une campagne. Elle a deux états possibles : true et false (booléen). Si limit.canPlay renvoie la valeur true, l'utilisateur peut participer. Si elle renvoie la valeur false, l'utilisateur ne peut pas participer.
- limit.nb représente le nombre de participations autorisées pour l'utilisateur, en fonction de son statut spécifique dans vos applications. Il est de votre responsabilité de définir les règles d'accès et de les calculer pour partager ce nombre dans le jeton.
| "limit.nb" est présente | "limit.nb" n'est pas présente | |
“limit.canPlay”: true |
L'utilisateur peut participer un nombre donné de fois. | L'utilisateur peut participer, qu'il ait déjà participé ou non. |
“limit.canPlay”: false |
L'utilisateur ne peut pas participer. | L'utilisateur ne peut pas participer. (Nous ignorons la sous-déclaration limit.nb.) |
| "limit.canPlay" n'est pas présente | L'utilisateur peut participer un nombre donné de fois. | L'utilisateur ne peut pas participer. |
Exemple
Conformément au standard ouvert défini dans la RFC-7519, le fragment de code suivant montre à quoi ressemble la charge utile du jeton :
{
"sub": "1234567890",
"iat": 1619102989,
"exp": 1619101489,
"iss": "ABC Company",
"campaignId": "123456",
"limit": {
"canPlay": true,
"nb": 4
}
}
Si vous rencontrez des problèmes de configuration, veuillez créer une demande d'assistance.
Partage du jeton avec Qualifio
Vous devez être en mesure de partager le jeton avec Qualifio au moment du chargement de la page. Ceci peut être fait soit via l'URL, soit via JavaScript : Partage des jetons sécurisés.
Intégrer le jeton dans votre compte Qualifio
Remarque : La possibilité d'intégrer votre jeton dans Qualifio n'est pas automatiquement activée.
Pour vérifier si cette intégration a été activée sur votre compte, il vous suffit de vous connecter en tant qu'administrateur de votre compte, de cliquer sur "Paramètres" dans le menu supérieur et de sélectionner "Intégrations & partenaires" et activez l'intégration "Jeton sécurisé". Veuillez consulter la section "Implémenter le jeton sécurisé dans Qualifio" de cette page pour intégrer votre jeton.
Configuration de votre campagne
Étape 1 : Une fois que votre jeton sécurisé est prêt, allez dans Campagnes > étape Paramètres de votre campagne.
Étape 2 : Cliquez sur le menu déroulant Limite individuelle sous la section Limites.
Vous verrez alors apparaître une liste d'options parmi lesquelles choisir. Faites défiler la liste et sélectionnez Limite personnalisée :
Étape 3 : Ajoutez un message au cas où une personne non-autorisée essaierait de participer !
Vous trouverez ci-dessous un exemple de ce qui peut être affiché si vous essayez de participer et ne répondez pas aux critères :
Étape 4 : Cliquez sur Sauvegarder.
Voilà, c'est fait ! Vous savez maintenant comment avoir recours à des informations externes pour limiter la participation à une campagne Qualifio.
Pour en savoir plus
Référez-vous aux ressources suivantes pour obtenir de l'aide supplémentaire :
- Pour en savoir plus sur les moyens standard de limiter la participation, consultez ce guide sur la mise en place de limites de participation à votre campagne.
- Des questions sur Qualifio ? Utilisez notre système de support client.
- Vous avez une nouvelle idée pour nous ? Utilisez le formulaire "Suggérer une fonctionnalité" pour demander de nouvelles fonctionnalités ou suggérer des améliorations.