Limite de participation personnalisée

Tabata Vossen -

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 :

  1. Cas d'utilisation
  2. Limiter l'accès des utilisateurs à une campagne Qualifio
  3. Intégrer le jeton dans votre compte Qualifio
  4. 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.

Remarque : Cette information est destinée aux développeurs. Qualifio offre cette fonctionnalité et la structure attendue du jeton, mais ne prend pas en charge la personnalisation du code pour développer ce dernier.

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 :

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.

Screenshot_2021-04-15_at_17.29.09.png

Étape 2 : Cliquez sur le menu déroulant Limite individuelle sous la section Limites.

Schermafbeelding_2021-12-21_om_12.18.39.png

Vous verrez alors apparaître une liste d'options parmi lesquelles choisir. Faites défiler la liste et sélectionnez Limite personnalisée :

Schermafbeelding_2021-12-21_om_12.20.19.png

É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 :

Schermafbeelding_2021-12-21_om_12.30.39.png

É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 :

Cet article vous a-t-il été utile ?

Can’t find the answer you need?

Send us a question and connect with an expert to get personal assistance.

Contact support

Vous ne trouvez pas les réponses que vous cherchez ?

Nous sommes là pour vous aider. Envoyez-nous une demande en direct !

Contacter le support
helpcenter experts