Membres
Soldes et lectures des membres.
Origine du solde
Guide opérateur · mis à jour le 12 novembre 2026 · version 0.9.1
Le fonctionnement actuel
Le service attribue des points réels à partir des lectures vérifiées. Les Stars disponibles se dépensent contre les offres publiées ; les XP mesurent la progression et ne sont jamais débités ni convertis.
- Synchroniser et calculer les données OKAST et Bitmovin depuis Administration → Synchronisation.
- Contrôler les soldes et les lectures depuis Membres.
- Préparer les avantages : choisir un produit Shoppable, créer une offre, importer les coupons et publier.
- Échanger : le membre confirme dans le widget et reçoit son coupon immédiatement si les conditions sont remplies.
À quoi servent les entrées du dashboard ?
- Membres
- Solde disponible, XP acquis, origine des gains, dépenses/remboursements et historique des lectures du compte choisi.
- Offres
- Une liste et une fiche unique par offre. La fiche regroupe le prix, la période, les codes, la diffusion et les échanges récents. Les produits et partenaires restent gérés dans Shoppable.
- Synchronisation, Sources, Journaux
- Synchronisation relit OKAST et Bitmovin sur 7 jours et recalcule les gains. Sources liste les lots, événements et écritures reçus. Journaux montre les synchronisations planifiées et la sécurité des comptes.
Le barème Stars et XP
Le barème détaillé est généré depuis la configuration du service : ouvrez Pilotage → Règles pour voir les seuils, les plafonds et des exemples calculés.
Solde Stars = gains crédités − échanges + remboursements. Les anciennes attributions restent conservées ; un recalcul crédite uniquement le complément dû, sans doubler les gains.
Lire les données et attribuer les gains
OKAST fournit l’identité du compte, les observations déclarées et les métadonnées disponibles des contenus, notamment titre et durée. Bitmovin mesure les passages uniques regardés. Le calcul rapproche les sources sans additionner deux fois la même lecture.
Le temps regardé n’est pas la durée totale du contenu. Une ligne OKAST peut déclarer un temps regardé ; une ligne Bitmovin de l’historique regroupe des passages par contenu et journée, pas nécessairement une session isolée. Le nombre d’observations n’est donc pas un nombre de vues uniques.
- Dans Administration → Synchronisation, renseigner la clé Bitmovin temporaire puis lancer Synchroniser et calculer. Le service collecte OKAST et Bitmovin sur les 7 derniers jours, rapproche les sources puis attribue les gains vérifiés.
- Dans Membres, choisir le compte et consulter le solde et chaque lecture. Les données source affichées correspondent à la ligne ouverte.
- Utiliser Sources ou Reprendre une journée précise seulement pour un import unitaire, l’examen d’un lot, des événements ou du journal de points. Actualiser relit les données enregistrées sans nouvelle collecte.
Les pourcentages OKAST seuls ne constituent pas une preuve suffisante pour un crédit réel. Une durée absente ou incohérente, une identité non vérifiée ou des passages insuffisants peuvent laisser une lecture en attente. Le détail indique la cause ; le journal contient les gains effectivement attribués.
L’attribution courante traite les franchissements des 7 derniers jours. Un recalcul historique plus ancien relève de l’outil opérateur. Les dates et plafonds utilisent UTC. Les filtres et la pagination parcourent toute la liste ; dans le bilan, les indicateurs généraux portent sur l’historique complet du compte.
Créer et diffuser une offre
Dans Offres → Créer une offre, choisissez un produit Shoppable. Le titre, l’image et le partenaire sont repris automatiquement. Une seule fiche rassemble ensuite la configuration, les codes et la diffusion.
- Créer le brouillon : renseignez le prix en Stars, la durée, la période et confirmez l’accord partenaire. Les propriétés rarement modifiées restent dans Options avancées.
- Ajouter les codes : le stock existant et sa pagination sont visibles dans la même fiche. Vérifiez un nouveau lot puis confirmez son import.
- Activer : le pied de la fiche explique ce qui manque. Activer l’offre est distinct d’Enregistrer et publie seulement une offre prête. Une offre active peut être mise en pause par une action dédiée.
Fermer ne sauvegarde rien. Les textes spécifiques au coupon sont facultatifs et restent repliés ; le titre, l’image et la présentation proviennent de Shoppable. Le bouton de la liste dit Modifier pour un brouillon ou une offre en pause, et Voir pour les autres états.
La publication exige des codes valides, une période en cours, une validation partenaire et un produit disponible dans Shoppable. La mise en pause reste possible même si Shoppable est indisponible.
Durée d’accès ≠ date limite d’activation. La durée décrit l’avantage après activation ; la date du lot indique jusqu’à quand un code peut être attribué. Les codes sont chiffrés en base et visibles seulement par les administrateurs et leur bénéficiaire.
États affichés
Brouillon · non publié, En pause · masquée, Terminée · masquée, Programmée, Sans codes · masquée et Disponible sous conditions. Ce dernier état signifie que la période et le stock sont valides ; le pays, le solde Stars et la limite par membre déterminent encore l’éligibilité.
Échanger et retrouver un coupon
Dans le widget, les offres apparaissent à droite des compteurs Stars et XP (en dessous sur mobile), avec image, titre et progression en Stars vers la première offre. Les XP ne sont pas convertis en Stars. Le membre ouvre une offre, consulte les conditions, confirme son éligibilité et choisit Échanger. Le serveur vérifie le compte authentifié, le solde, le prix et la version de l’offre, sa période, les pays, la limite par compte et le stock.
Le débit des Stars et l’attribution exclusive d’un code se font ensemble. Un double clic ou une reprise de la même demande ne crée pas un second débit. Le coupon reste accessible via le bouton Mes coupons en haut du widget, dans une fenêtre centrée sur ordinateur et une vue plein écran sur téléphone, avec copie du code, échéance, instructions et lien d’activation chez le partenaire.
Exemple fictif : un compte avec 60 Stars et 16 XP échange une offre à 20 Stars. Il reste 40 Stars et 16 XP. Le prix réel se définit pour chaque offre ; il n’existe pas de conversion universelle entre euros et Stars.
Remplacer ou rembourser
Ouvrir Offres → Voir les échanges, puis le détail concerné. Choisir le remplacement ou le remboursement, expliquer le motif et confirmer que le partenaire a révoqué le code précédent ou l’a déclaré inutilisable. Un remplacement utilise un autre code disponible sans nouveau débit. Un remboursement restitue une seule fois le prix payé. Aucun code attribué n’est remis dans le stock.
Coupon remis ne signifie pas abonnement activé. La confirmation automatique d’utilisation chez le partenaire et l’envoi d’e-mails ne sont pas encore intégrés. Les restrictions « nouveaux clients » sont présentées et acceptées ; leur vérification effective appartient au partenaire.
Accès au widget et langues
Depuis le bilan, Ouvrir le widget utilisateur génère un lien personnel authentifié. Un UUID seul ne permet pas de consulter le compte ni de dépenser ses Stars. Ne pas publier un lien personnel commun à tous les visiteurs.
Le widget reconnaît lang et language, pour en, fr, es, it et de. Dans OKAST, les variables utilisées par Shoppable sont {{ uuid }} et {{language}} ; la transmission du jeton personnel reste nécessaire. Utiliser une URL HTML simple dans src, sans syntaxe de lien Markdown.
Le lien généré par le dashboard expire actuellement après 30 minutes : si l’accès expire, en générer un nouveau depuis le bilan. Les accès de développement créés autrement peuvent avoir une autre échéance. La connexion administrateur est distincte et dure 8 heures.
L’iframe doit disposer d’une hauteur suffisante. Le script /widget-embed.js coordonne le redimensionnement ; la page hôte ne doit pas tenter de lire directement le document d’une iframe d’un autre domaine.
Dépannage rapide
Des lectures existent mais le solde ne change pas
Vérifier que les données des deux sources ont été importées, que le bon compte est sélectionné et que l’attribution a été lancée. Consulter la cause sur la ligne : qualification non atteinte, contenu trop court, preuve manquante, durée incohérente, plafond ou gain déjà attribué. Relancer ne double pas les crédits.
Une offre n’apparaît pas dans le widget
Vérifier son statut Publiée, sa période, le solde Stars du membre, le pays, sa limite d’échanges et les codes encore disponibles. Pour activer, confirmer la validation partenaire et disposer de coupons non expirés. Aucun texte à recopier depuis Shoppable. Vérifier aussi la disponibilité du produit et ses pays dans Shoppable.
Un échange est refusé ou la réponse s’est interrompue
Vérifier le solde, le stock, la limite par compte, le territoire et les conditions actualisées. Après une interruption, réessayer dans le même panneau ou consulter Mes coupons pour retrouver un échange déjà confirmé.
Un code ne fonctionne pas chez le partenaire
Vérifier sa date, la formule et les conditions (pays, nouveau client, carte bancaire). Contacter le partenaire pour connaître son état avant tout remplacement ou remboursement. L’absence de confirmation d’activation ne prouve pas que le code est inutilisé.
Le parcours des données
Du lot reçu à la qualification.
Qualité des observations
Sur tous les lots filtrés
Derniers lots importés
100 derniers lots au maximum · cliquez sur un lot pour l’inspecter