Créer une récompense et la lier à un événement
Configure ton modèle de récompense puis associe-le à un événement pour activer le jeu à gratter.
Avant de pouvoir distribuer des gains aux voyageurs, tu dois créer un modèle de récompense puis le lier à un événement. Voici la procédure complète.
Si tu débutes, lis d'abord Comprendre le jeu à gratter pour maîtriser le vocabulaire.
Étape 1 — Créer le modèle de récompense
Va sur /partners/rewards.
- Clique sur « Nouvelle récompense ».
- Remplis les champs (voir détails ci-dessous).
- Valide. Ton modèle est prêt à être lié à un ou plusieurs événements.

Champs disponibles
- Type — choisis le type qui correspond le mieux :
goodie,discount,gift,offer,experience,access,content,service,product,advantage,surprise,prize,custom. Le type influence l'icône et le wording côté voyageur. - Titre — court et concret (ex. « Verre offert », « -10 € sur l'addition »).
- Description — précise les conditions (sur place uniquement, à présenter au comptoir, etc.).
- Image — un visuel clair (objet ou ambiance), JPG ou PNG.
- Probabilité par défaut — le pourcentage de tickets gagnants (1 % à 100 %). Tu pourras l'override par événement.
Étape 2 — Lier la récompense à un événement
Ouvre l'événement concerné depuis /partners/events et va sur l'onglet « Récompenses » de la fiche. Au départ, la liste est vide.

Clique sur « + Ajouter une récompense » : une fenêtre s'ouvre pour configurer le lien.

- Sélectionne le modèle de récompense créé à l'étape 1.
- Renseigne la quantité de gains à distribuer pour cet événement.
Laisse la probabilité de gain vide pour utiliser la valeur par défaut, ou indique un nouveau pourcentage pour cet événement précis.
- Vérifie que le switch « Actif » est activé.
- Clique sur « Ajouter ».
La somme des probabilités des récompenses actives sur un événement doit rester ≤ 100 %. Casabee t'indique en temps réel la marge restante (ex. « Marge restante : 70 % »).
Étape 3 — Configurer le jeu à gratter
Va ensuite sur l'onglet « Paramètres » de la fiche événement. Tu y règles les conditions géographiques et temporelles du jeu à gratter.

| Paramètre | Description | Défaut |
|---|---|---|
| Délai après le début (minutes) | Temps après le début de l'événement avant que le ticket n'apparaisse | 60 min |
| Rayon (mètres) | Distance maximale entre le voyageur et l'événement pour pouvoir gratter | 100 m |
| Heure de fin (optionnel) | Date et heure limite pour gratter le ticket. Si vide, calcul auto = délai + 60 minutes | — |
Clique sur « Enregistrer » pour valider.
Un rayon trop large dilue l'effet « ici, maintenant » qui fait la magie du jeu. Reste serré (200-500 m en ville, 1 km en zone rurale) pour maximiser le sentiment d'opportunité.
Modifier ou supprimer une récompense
Tu peux ajuster un modèle de récompense à tout moment depuis /partners/rewards, mais plusieurs garde-fous protègent les voyageurs :
- La suppression est bloquée tant qu'il existe des gains en cours (statut « En attente »). Attends qu'ils soient réclamés ou expirés. - La modification de la probabilité après publication peut être désactivée pour préserver l'équité du jeu. - Le changement de titre ou d'image reste possible mais s'applique à tous les gains futurs, pas aux gains déjà gagnés.
Suivre les gains
Depuis le dashboard pro ou la fiche de l'événement (onglet « Gains »), tu vois en temps réel :
- les gains en attente (à venir réclamer),
- les gains réclamés (validés en boutique),
- les gains expirés (non utilisés).
Quand un voyageur arrive en boutique pour réclamer son gain, demande-lui d'ouvrir BeeHive et de te montrer l'écran de validation : un simple clic et le gain bascule en « Réclamé ».