Comment fonctionne le mapping du catalogue de jeux de casino
Un agrégateur de jeux de casino reçoit des listes provenant de plusieurs éditeurs. Les identifiants, catégories, noms de jeux, visuels et rythmes de mise à jour varient d'un fournisseur à l'autre. Afficher directement ces données dans un lobby multiplie les risques de doublons, de filtres incohérents et d'erreurs de disponibilité. Le mapping crée une couche de correspondance : elle conserve la référence source, attribue un identifiant interne stable, harmonise les champs et soumet chaque publication aux règles de la marque et du marché. Cette méthode ne présume ni des formats proposés par tous les éditeurs ni des droits commerciaux attachés à un jeu.
Publié le
Le catalogue publié résulte d'une correspondance contrôlée, et non d'une copie brute des flux fournisseurs.
Sommaire
À quoi sert le mapping d'un catalogue de jeux ?
Le mapping associe les fiches de jeux reçues de fournisseurs à un référentiel interne dont l'identité, la provenance et les états de publication sont connus. Un code produit chez l'éditeur peut coexister avec un ID stable chez l'agrégateur et un titre traduit par l'opérateur : ces informations doivent rester liées sans être confondues.
La transformation implique davantage qu'un changement de format. Elle inclut l'import, le contrôle des valeurs, la validation des modifications et les règles de diffusion. L'enregistrement dans le référentiel, la présence dans le lobby et l'autorisation d'ouvrir une session sont trois opérations différentes. [1] [2]
Comment relier les codes fournisseurs à des identifiants stables ?
Un code externe n'est fiable qu'à l'intérieur de l'espace de noms du fournisseur. Deux éditeurs peuvent utiliser le même code, et une migration peut remplacer une ancienne référence. Attribuez un game_id interne immuable et conservez la correspondance avec provider_id, source_game_id, variante et version du connecteur. L'AIP-122 décrit l'intérêt des noms de ressources uniques dans leur périmètre. [2]
Identifiant
Rôle
Erreur à éviter
game_id interne
Référence stable pour le catalogue
Réutiliser l'ID
Provider ID
Distinguer les sources
Employer le nom comme clé
Source game ID
Code exact pour le fournisseur
Supposer une unicité globale
ID de variante
Séparer éditions et modes
Fusionner des jeux distincts
Alias externe
Conserver les anciens codes
Perdre les migrations
Version du mapping
Retracer la modification du lien
Réaffecter sans historique
Une contrainte d'unicité sur fournisseur et code source prévient de nombreux doublons. Des visuels semblables ou des noms presque identiques constituent un signal de vérification, pas une preuve d'équivalence.
Quelles métadonnées faut-il normaliser ?
Un modèle commun peut couvrir le nom affiché, l'éditeur, la catégorie générale, les appareils, les langues, les images, l'état du jeu et les capacités documentées. Chaque valeur doit conserver son origine et préciser si elle provient du flux, d'une transformation ou d'une correction validée. OpenAPI permet de formaliser les contrats exposés aux consommateurs. [1]
Distinguer les identifiants techniques des textes destinés aux joueurs.
Définir un vocabulaire fermé pour les filtres et un état 'inconnu'.
Contrôler types, longueurs, liens, médias et valeurs autorisées.
Archiver la valeur brute et la version de la règle de transformation.
Ne déduisez pas des caractéristiques de jeu, des taux ou des autorisations réglementaires d'un nom de fichier. Une donnée absente doit être examinée, pas inventée pour remplir la fiche.
Comment importer les modifications sans casser le lobby ?
Les sources peuvent proposer une liste complète, une API paginée ou des deltas. Le système enregistre la version et le curseur utilisés, récupère toutes les pages nécessaires et compare les résultats au dernier instantané approuvé. Un jeu absent d'une page partielle ne doit jamais être considéré comme supprimé. L'AIP-158 détaille le contrat de pagination. [3]
Recevoir un instantané complet ou un delta documenté et traçable.
Relier les codes entrants à des fiches internes déjà connues.
Vérifier les variations sensibles des IDs, droits et images.
Publier une version approuvée, éventuellement par groupe de marques.
⊕Agrandir le schémaLes changements sont validés avant qu'une nouvelle version du catalogue n'atteigne les marques.
Un même lot reçu deux fois doit produire le même résultat. Les clés d'import, empreintes de charge utile et versions publiées facilitent les reprises. AWS recommande l'idempotence pour protéger les opérations qui modifient l'état. [7]
Comment harmoniser catégories, options et filtres ?
Les intitulés fournis par les studios ne suivent pas toujours une classification commune. Créez une taxonomie interne utile aux filtres réels du lobby, en gardant la catégorie d'origine. Une caractéristique supposée à partir du titre ne doit pas devenir automatiquement un critère de recherche public.
Champ entrant
Traitement interne
Vérification
Type de jeu
Catégorie commune
Signaler les inconnus
Fonctionnalités
Tags confirmés
Ne pas deviner
Compatibilité
Clients pris en charge
Tester le lancement
Date de sortie
Métadonnée sourcée
Pas de date inventée
Popularité
Mesures de l'opérateur
Pas de chiffres fictifs
Versionnez les règles et prévisualisez les conséquences d'une modification de catégorie avant de la propager aux différents frontends.
Comment gérer titres traduits et visuels ?
Le jeu conserve la même identité entre langues, mais ses titres, résumés et textes alternatifs varient par locale. Harmonisez les codes linguistiques avec BCP 47 plutôt que de supposer que tous les fournisseurs utilisent les mêmes sigles. Prévoyez une langue de repli explicite en l'absence d'une version approuvée. [4]
Stocker la traduction séparément de la clé interne du jeu.
Valider droits d'image, formats, résolution et invalidation du cache.
Distinguer médias de l'éditeur et contenus créés par l'opérateur.
Conserver les anciens titres comme alias de recherche après un renommage.
Un fichier visuellement correct n'est pas forcément libre d'utilisation. La source, l'étendue des droits et la possibilité de revenir à la version précédente doivent faire partie du suivi des médias.
Pourquoi isoler droits, marchés et devises ?
Une fiche valide peut correspondre à un jeu non disponible pour une marque, une juridiction, un appareil ou une devise. Les droits de diffusion dépendent d'accords, de la variante et du statut opérationnel. ISO 4217 fournit des codes pour les devises fiduciaires, sans attester qu'un jeu les accepte. [5]
Relier chaque droit à une source vérifiée et une période de validité.
Évaluer séparément marque, opérateur, pays et monnaie.
Contrôler à nouveau l'autorisation à l'ouverture de la session.
Mettre les permissions inconnues en attente plutôt qu'en accès libre.
Une interface peut masquer un titre, indiquer son indisponibilité ou autoriser son lancement. L'existence d'une intégration éditeur ne donne pas accès à l'intégralité de sa ludothèque.
Que faire des doublons, variantes et jeux retirés ?
Des catalogues différents peuvent proposer le même nom, tandis qu'un seul éditeur peut distribuer plusieurs éditions réelles. La fusion doit s'appuyer sur les identifiants documentés et le comportement au lancement. Les correspondances incertaines passent en revue manuelle, sans perte d'historique.
Événement
Action catalogue
Précaution
Code déjà importé
Mise à jour idempotente
Pas de nouvelle fiche
Doublon présumé
Révision manuelle
Pas de fusion par nom
Variante nouvelle
Lien propre à la variante
Vérifier droits et session
Panne temporaire
État indisponible
Conserver l'entrée
Retrait fournisseur
Archivage traçable
Préserver les références
Un élément absent d'un flux peut résulter d'une erreur de pagination. Préférez des états explicites et une politique de conservation distincte de la synchronisation automatique.
Quels contrôles et indicateurs sont indispensables ?
La validation doit couvrir structure, clés, pages reçues, langues, liens, fichiers et droits. Une baisse massive du nombre de titres d'un fournisseur doit déclencher une alerte, pas la suppression immédiate d'une partie du lobby. Comparez les écarts à une version de référence fiable. [1] [3]
Surveiller les erreurs, retards, pages manquantes et changements en masse.
Tester les véritables parcours de lancement indépendamment de l'affichage.
Tracer les validations, modifications de mapping et retraits de jeux.
Vérifier l'accès à chaque objet via l'API, et pas seulement le rôle global. [6]
La qualité se mesure aussi à la fraîcheur des sources, aux dossiers non résolus, aux doublons suspects et aux incohérences de droits, pas seulement au volume importé.
Quelle checklist appliquer avant la mise en production ?
Soumettez le moteur à des cas limites : codes identiques chez deux fournisseurs, traduction absente, jeu renommé, droit expiré, livraison répétée et page API incomplète. Vérifiez qu'aucun cas ne réattribue silencieusement un identifiant ni n'étend l'accès à un marché.
Valider espaces de noms, schéma canonique et responsables des règles.
Tester la pagination, les reprises, le rollback et les archives avec des preuves.
Inspecter les lobbies localisés et les permissions de lancement par marché.
Désigner une personne responsable des anomalies et corrections fournisseur.
Un catalogue exploitable n'est pas la plus longue liste possible : c'est un ensemble vérifiable de liens entre données sources, choix éditoriaux et décisions d'accès au jeu.