Ajout de paramètres
La configuration distante est définie comme un ensemble de paires clé-valeur appelées « paramètres », qui peuvent être ajoutées et modifiées dans l’onglet Parameter de la page app config.
Pour ajouter des paramètres :
- Cliquez sur EDIT
- Cliquez sur ADD PARAMETER
Puis ajoutez les paramètres manuellement en remplissant les champs suivants :
| Donnée | Description | Recommandation |
|---|---|---|
| Nom du paramètre | Nom du paramètre | - Le nom doit être en minuscules |
- Le nom ne doit pas commencer par un préfixe d’un seul caractère comme « a_parameter » |
| Type | Type du paramètre. Il peut avoir les valeurs suivantes :
- String
- Int
- Float
- Boolean
- JSON | |
| Valeur par défaut | Valeur que vous souhaitez définir pour ce paramètre | |
| Description | Description du paramètre, quel est son impact fonctionnel ? | Non obligatoire mais fortement recommandé |
Il est également possible d’importer une liste de paramètres depuis un fichier CSV en cliquant sur IMPORT CSV.
Le CSV doit contenir les colonnes suivantes :
- parameter_name
- variable type
- description
- default_value
Un exemple de CSV est disponible ici : geryon param csv.csv.
⚠️ L’import CSV ajoute les clés absentes et met à jour les valeurs des clés existantes, mais ne supprime pas les clés déjà présentes.
Création de scopes et overrides de scope
Les scopes sont créés dans l’onglet Parameter.
Un scope cible un OS et, éventuellement, une liste de pays. Cela permet de surcharger la configuration par défaut (par ex. modifier la valeur d’un ou plusieurs paramètres) ou de lancer des tests A/B.
👉 Ce mécanisme est utilisé pour différencier le comportement du jeu selon les plateformes et zones géographiques — typiquement quand les audiences ne réagissent pas de la même façon à certaines fonctionnalités (pression publicitaire, difficulté, systèmes spécifiques).
Par défaut, 2 scopes sont créés : iOS et Android.
Pour créer un nouveau scope :
- Cliquez sur Add scope
- Sélectionnez l’OS et les pays correspondants
Pour surcharger la valeur d’un paramètre dans un scope :
- Cliquez sur le scope à modifier
- Cliquez sur EDIT
- Cliquez sur EDIT PARAMETER VALUE
- Ajoutez la clé du paramètre et la nouvelle valeur pour définir l’override
Limitations des scopes :
- Les scopes doivent cibler des ensembles de pays mutuellement exclusifs (ex. il n’est pas possible d’avoir un scope « iOS US » et un scope « iOS US + CA » actifs en même temps)
- Un scope doit être actif pour que ses overrides aient un effet
- Un scope doit être actif pour pouvoir être utilisé comme cible d’un test A/B
Comment fonctionnent les overrides de scope ?
La configuration distante et les overrides de scope sont récupérés par le client du jeu juste après l’installation, lors de la première ouverture de l’application.
👉 Par conséquent, la configuration d’un jeu reste statique après la première ouverture.
Les overrides de scope n’affectent donc que les joueurs qui installent le jeu après la mise en place de l’override.
Comment surcharger la configuration pour les utilisateurs existants ?
Il est possible de définir des overrides qui s’appliquent aussi aux joueurs existants.
Ces overrides seront pris en compte lors de la prochaine ouverture de l’application après leur définition.
Cela se fait dans l’onglet Apply all players de la page app config.
Pour surcharger la configuration dans cet onglet :
- Sélectionnez le scope souhaité
- Créez une nouvelle version
- Ajoutez les paramètres et les valeurs désirées
- Enregistrez et appliquez
⚠️ Note : une valeur définie de cette manière prend le dessus sur la configuration définie dans l’onglet Parameter.
Elle ne pourra plus être utilisée dans un test A/B.