🚀 Récompensez les événements entrants dans votre portail

Événements entrants

Les événements entrants personnalisés vous permettent de récompenser des actions qui se produisent en dehors de Qualifio, par exemple sur votre site web, votre application mobile, votre CRM ou d’autres outils externes.

Ils constituent un moyen simple de :

• Récompenser les membres pour des actions dans le monde réel
• Accroître l’engagement
• Obtenir des insights plus riches sur votre audience

En seulement quelques étapes, vous pouvez connecter vos systèmes externes à votre programme de fidélité.

Création d’événements entrants

Les événements entrants utilisent un point de terminaison API sécurisé pour envoyer les actions des membres vers la plateforme. Ces actions peuvent être :

• Lire un article
• Regarder une vidéo
• Effectuer un achat
• Visiter un magasin
• Cliquer sur un CTA dans un email
• Terminer un sondage

Lorsqu’un événement est envoyé, il peut ensuite déclencher une attribution de points via les règles de gain.

Configuration d’un événement entrant

1. Allez dans Paramètres > Événements entrants, cliquez sur + Nouvel événement entrant
2. Saisissez un nom clair (ex. : Article Read)
3. Sélectionnez et définissez la méthode d’authentification
4. Sélectionnez le type d’événement correspondant à déclencher
   • Utilisez Custom > Basic pour une flexibilité totale
   • Utilisez Ecommerce > Purchase pour les événements d’achat
   • Les deux versions standard sont documentées ici.
5. Complétez la section de mappage pour votre payload
6. Sauvegardez

Une fois créé, le connecteur vous fournit une URL d'endpoint unique à cibler (voir étape 5 sur la capture). Ces informations doivent être transmises à vos développeurs.

Étape 2 : Authentification des événements entrants

Chaque événement doit être authentifié avec un token pour être traité via votre point de terminaison dédié. Vous choisissez la méthode :

• Ajouter un token comme paramètre de requête
• Ajouter un token dans un en-tête (ex. : X-Authorization)
• Utiliser une signature hub avec un secret

🔒 Seules les requêtes avec le token correct seront acceptées.

Étape 4 : Mappage de vos données

Les systèmes externes envoient des données sous différents formats. Pour les rendre compatibles, vous mappez votre payload à l’aide de JSONata.

Le mapping permet de :

• Identifier l’utilisateur
• Convertir les timestamp
• Ajouter des tags (champs textuels)
• Ajouter des compteurs (champs numériques)

Exemple de mapping :

{
  "clientEventId": eventId,
  "profile": { "kind": "default", "value": profile.email },
  "payload": {
    "timestamp": timestamp,
    "tags": [ { "name": "theme", "value": article.theme } ],
    "counters": [ { "name": "total", "value": totalArticlesRead } ]
  }
}

Une fois mappés, les tags et compteurs sont disponibles comme critères dans les règles de gain.

👉 Nos Solutions Architects peuvent vous accompagner pour le mappage JSONata. N’hésitez pas à nous contacter à integrations@qualifio.com.

Création de règles de gain

Lors de la création d’une règle de gain :

• Sélectionnez Custom comme source
• Choisissez votre événement entrant dans la liste déroulante (ex. : Article Read)

Critères disponibles dans les règles :

• Tags → critères textuels (ex. : theme dans l’exemple ci-dessus)
• Compteurs → critères numériques (ex. : total dans l’exemple ci-dessus)

Tester votre événement

Vous pouvez envoyer des événements de test via :

• Des scripts ou systèmes backend
• Des plateformes de données clients (CDPs)
• Des webhooks CRM ou ESP
• Des gestionnaires de tags

Chaque requête doit inclure :

• L’URL du point de terminaison
• Le token
• Un payload JSON valide

Les événements peuvent être envoyés individuellement ou en lots. Les tests vous permettent de :

• Valider le mappage
• Vérifier la résolution de l’identifiant du profil
• Simuler les règles de gain

🧪 Les tests sont sûrs : les données sont enregistrées mais peuvent être facilement effacées avant un lancement grâce à notre mécanisme de purge.

Suivi & dépannage

Chaque événement entrant est journalisé et traçable. Vous pouvez vérifier :

• Les profils membres (historique d’activité)
• Les journaux d’événements

⚠️ Les événements sans identifiant valide sont ignorés. Utilisez les journaux pour déboguer.

Bon à savoir

• Événements en lot : pris en charge avec des tableaux
• Taille du payload : contactez votre account manager pour connaître les limites
• Latence : les récompenses apparaissent en quelques secondes
• Propagation : les mises à jour de profil sont en temps réel