# Brancher ton jeu à Analytics

> Canal public — documentation de l’application 4.1.0. Respecter les mentions de disponibilité propres à chaque service.

Source : [Brancher ton jeu à Analytics](/services/analytics/brancher/)

Pour le propriétaire du projet, une fois Analytics pris pour le jeu.

Une fois Analytics pris pour un jeu, l’entrée Analytics de la barre de l’onglet Mon jeu perd son cadenas, pour le propriétaire du projet. Elle ouvre l’étape « Brancher ton jeu », à faire une seule fois. Une ligne d’état dit où en est le jeu, de la clé au premier joueur :

| Ligne d’état | Ce qu’elle veut dire |
| --- | --- |
| « Clé à choisir pour Analytics » | Analytics n’a encore aucune clé enregistrée pour ton compte. |
| « Clé enregistrée : une permission manque sur ce jeu » | La clé existe, mais son test refuse une permission. |
| « Clé prête : branche le jeu » | Il reste à cliquer Brancher le jeu. |
| « Branché · dans Studio, autorise HTTP puis publie ton jeu, et attends ton premier joueur » | Les deux gestes de Studio, puis un premier joueur. |
| « Premier joueur mesuré le … » | Les chiffres arrivent. |

## La clé d’Analytics

Analytics a besoin d’une clé Roblox Open Cloud avec ses droits. Elle sert à deux choses : ranger dans les secrets Roblox de ton jeu la clé avec laquelle le module envoie ses mesures, et lire chaque jour les chiffres que Roblox mesure lui-même sur ton jeu (découverte, miniatures, audience, revenus). Ses droits :

| Système Roblox | Droits |
| --- | --- |
| `universe-analytics` | `universe.analytics:read` |
| `secret-store` | `universe.secret:read` et `universe.secret:write` |
| `universe` | `universe:read` |

Tu as le choix entre deux clés :

-   **Ta clé Roblox**, celle des Paramètres, si tu lui ajoutes ces droits : une seule clé pour tous tes services. Analytics en reçoit une copie, avec ton accord.
-   **Une clé dédiée**, créée seulement pour Analytics. Ta clé Roblox garde ses autres services et nos serveurs ne gardent qu’une clé limitée à Analytics.

Dans les deux cas, la clé est gardée **chiffrée sur les serveurs de VibeStarter** : la lecture des chiffres Roblox se fait chaque jour, même quand l’app est fermée. Une fois enregistrée, elle ne s’affiche plus nulle part, et VibeStarter ne s’en sert pour aucune autre écriture dans ton jeu. **Une seule clé suffit pour tous tes jeux** : elle est enregistrée pour ton compte, pas pour un jeu. Ta clé personnelle suffit aussi pour un jeu de groupe, si ton compte a les droits sur ce groupe. Voir aussi [Lier ton compte Roblox et ta clé Open Cloud](/application/studio/compte-roblox/#analytics-avec-ta-cl%C3%A9-ou-une-cl%C3%A9-d%C3%A9di%C3%A9e).

## Les trois étapes

1.  **Choisis la clé d’Analytics.** Deux choix : Utiliser ta clé Roblox et Utiliser une clé dédiée. Le premier est proposé quand ta clé Roblox existe et que son dernier test ne l’exclut pas ; sinon, c’est la clé dédiée.
    
    **Avec ta clé Roblox**, l’étape dit d’abord où en est ta clé, d’après son dernier test dans les Paramètres :
    
    | Ce que l’étape affiche | Ce qu’il faut faire |
    | --- | --- |
    | « Ta clé a les droits d’Analytics. » | Lis l’accord, puis envoie la copie (ci-dessous). |
    | « Teste d’abord ta clé : l’app lit chez Roblox les droits qu’elle a. » | Clique Tester ta clé. |
    | « Il manque à ta clé : … » | Ajoute ces droits dans le Creator Hub, puis Tester à nouveau. |
    | « Ta clé ne couvre pas ce jeu : ses droits sont limités à d’autres expériences sur Roblox. … » | Ouvre la clé à ce jeu dans le Creator Hub, puis teste-la à nouveau. |
    | « Tu n’as pas encore de clé Roblox dans l’app. … » | Ouvrir les Paramètres : ajoute ta clé avec les droits d’Analytics, puis reviens. |
    | « La clé Roblox de ce PC n’est pas liée à ton compte : reprends-la ou remplace-la dans les Paramètres. » | Ouvrir les Paramètres. |
    | « Roblox n’a pas dit les droits de ta clé. Teste-la à nouveau dans un instant. » | Réessaie un peu plus tard. |
    
    Ouvrir les Paramètres mène directement à la ligne « Analytics » de Paramètres → Roblox → Qui publie quoi. Quand la clé a les droits, l’accord s’affiche **avant tout envoi** : « En cliquant sur « J’accepte : envoyer une copie », tu envoies une copie de ta clé Roblox aux serveurs VibeStarter, qui la gardent chiffrée. Ils s’en servent chaque jour, même app fermée, pour relever les chiffres Roblox de tes jeux branchés (revenus compris) et pour poser la clé d’envoi dans le jeu. La copie porte tous les droits de ta clé ; nos serveurs ne se servent que de ceux d’Analytics. Si tu remplaces ta clé dans les Paramètres, la copie est mise à jour toute seule. Tu peux la retirer ici ou dans Paramètres → Roblox : ta clé reste alors sur ce PC. » Rien ne part avant J’accepte : envoyer une copie. La valeur de la clé ne s’affiche pas : l’app la lit dans le trousseau de ton ordinateur et l’envoie elle-même.
    
    **Avec une clé dédiée**, l’étape montre en images « Où cliquer dans le Creator Hub ». Clique Ouvrir le Creator Hub. En haut à gauche, garde ton compte sélectionné, même pour un jeu de groupe si ton compte a les droits sur ce groupe. Clique « Create API Key », donne-lui un nom (par exemple « VibeStarter Analytics ») et ajoute-lui les trois systèmes ci-dessus, via « Select API System ». Laisse « Restrict by Experience » désactivé, n’ajoute aucune adresse IP et choisis « No Expiration » : une seule clé pour ton compte, qui marche sur tous tes jeux, au lieu d’une clé à refaire pour chaque jeu. Clique « Save & Generate Key », copie la clé, colle-la dans le champ « Clé Analytics », puis clique Enregistrer et tester. Avant, l’étape le dit : « En cliquant sur « Enregistrer et tester », tu envoies la clé aux serveurs VibeStarter, qui la gardent chiffrée. Ils s’en servent chaque jour, même app fermée, pour relever les chiffres Roblox de tes jeux branchés (revenus compris) et pour poser la clé d’envoi dans le jeu. »
    
2.  **Teste la clé sur ce jeu.** « La clé est testée sur ce jeu dès qu’elle est envoyée. » Le test essaie chaque permission sur ce jeu et l’écrit en mots : « OK », « présumée », « manquante », « refusée sur ce jeu » ou « non vérifiable pour le moment ». L’écriture des secrets n’est jamais essayée pour de vrai : une clé complète affiche « Trois permissions vérifiées sur ce jeu ; l’écriture des secrets est présumée (Roblox l’autorise, rien n’a été écrit). » Une clé que Roblox refuse entièrement (supprimée, mal copiée, ou désactivée après 60 jours sans usage) n’est pas enregistrée. Une fois la clé gardée, l’étape dit laquelle : « Analytics utilise une copie de ta clé Roblox. » ou « Analytics utilise une clé dédiée. »
    
3.  **Branche le jeu.** Clique Brancher le jeu. VibeStarter crée la clé d’envoi du jeu et la range dans ses secrets Roblox. **Rien à installer** : le module Analytics est déjà dans ton projet (voir [Le module dans ton projet](/services/analytics/brancher/#le-module-dans-ton-projet)).
    

## Deux gestes dans Studio, une seule fois

Une fois le jeu branché, l’étape dessine les deux gestes que seul Roblox Studio peut faire :

1.  **Autorise les requêtes HTTP.** Paramètres du jeu → Sécurité → « Allow HTTP Requests ». Sans elle, le module n’envoie rien.
2.  **Publie ton jeu.** Fichier → Publier sur Roblox : le module part avec la version jouée.

L’app ne peut pas cocher cette case pour toi ni la voir d’ici : c’est le premier joueur mesuré qui confirme que tout est en place. La ligne d’état passe alors à « Premier joueur mesuré le … ».

## Demander tes funnels à ton agent

L’étape propose aussi de demander à ton agent de suivre les étapes clés de ton jeu : arrivée, tutoriel terminé, première victoire, premier achat… Clique Copier la demande pour mon agent, puis colle-la dans la conversation de ton agent : il repère ces étapes dans le code, en fait le plan d’événements avec toi, ajoute les événements qui les marquent et définit les funnels. Analytics te montre ensuite où les joueurs décrochent, étape par étape, et le plan dit si chaque événement arrive comme prévu : voir [Le plan d’événements](/services/analytics/plan-evenements/). L’app ne tape rien à ta place.

## Quand le test ou le branchement refuse

-   **Une permission est « manquante »** : ouvre ta clé dans le Creator Hub, ajoute la permission, enregistre, puis clique Tester à nouveau. La clé ne change pas, rien à recoller ni à renvoyer.
-   **« Refusée sur ce jeu »** : Roblox ne dit pas pourquoi. Le plus probable : ton compte n’a pas les droits sur ce jeu (ou sur son groupe), ou la clé est limitée à d’autres expériences. Sinon, il lui manque les droits du système `secret-store`.
-   **« Roblox ne trouve pas ce jeu »** : vérifie que le projet est bien associé à ton jeu publié.
-   **« Ta clé Roblox n’est plus sur ce PC, ou n’est pas liée à ton compte. »** : ajoute-la dans les Paramètres, ou utilise une clé dédiée.

Pour passer de ta clé Roblox à une clé dédiée, ou l’inverse, clique Changer de clé : l’étape repropose les deux choix.

## Supprimer la clé d’Analytics

La clé d’Analytics se retire à deux endroits : dans l’étape « Brancher ton jeu », et dans Paramètres → Roblox, ligne « Analytics » de Qui publie quoi. Cette ligne est toujours affichée, **avec ou sans abonnement Analytics en cours**, et même sans projet ouvert : tu peux toujours voir quelle clé Analytics utilise et l’effacer. Elle donne la date d’enregistrement et les jeux branchés avec cette clé. Le bouton dépend de la clé :

-   **Une copie de ta clé Roblox** : Retirer la copie (dans l’étape, Retirer la copie aussi). L’app demande « Retirer la copie de ta clé pour tous tes jeux ? » et précise : « Ta clé reste sur ce PC pour tes autres services. » Retirer la copie pour tous mes jeux confirme, puis « Copie retirée pour tous tes jeux. Ta clé Roblox reste sur ce PC. » Rien à révoquer chez Roblox : ta clé y sert encore à tes autres services. Si ta clé n’est plus sur ce PC, l’app le dit : « Ta clé n’est plus sur ce PC : après ce retrait, VibeStarter n’en garde plus rien. », puis « Copie retirée pour tous tes jeux. Ta clé n’est plus ni sur ce PC ni sur nos serveurs. », et conseille de la révoquer chez Roblox. Supprimer ta clé Roblox des Paramètres propose aussi de retirer la copie en même temps : voir [Remplacer ou supprimer ta clé](/application/studio/compte-roblox/#remplacer-ou-supprimer-ta-cl%C3%A9).
-   **Une clé dédiée** : Supprimer la clé dédiée dans les Paramètres, Supprimer la clé dans l’étape. L’app demande « Supprimer la clé Analytics pour tous tes jeux ? » et rappelle : « Roblox garde la clé active : révoque-la ensuite sur create.roblox.com. VibeStarter ne peut pas le faire pour toi. » Supprimer pour tous mes jeux confirme.

Dans les deux cas, la clé vaut pour tous tes jeux, sa suppression aussi : la confirmation donne la liste des jeux concernés et prévient : « Dans un jeu où Analytics est encore actif, la mesure continue, mais VibeStarter ne pourra plus retirer sa clé d’envoi à la fin d’Analytics. » La clé est alors effacée de nos serveurs, et l’app dit ce qui reste à faire :

| Message | Ce qu’il veut dire |
| --- | --- |
| « Révoque aussi la clé chez Roblox : elle y reste active. » | Pour une clé dédiée, ou quand ta clé Roblox part de l’ordinateur avec sa copie : VibeStarter ne révoque rien chez Roblox. Fais-le dans le Creator Hub (Ouvrir le Creator Hub). |
| « La mesure continue pour … : Analytics y est actif et la clé d’envoi reste dans le jeu. » | Le module de ce jeu continue d’envoyer ses mesures. Les chiffres que Roblox tient (revenus, rétention, joueurs) ne sont plus relevés, et VibeStarter ne pourra pas retirer la clé d’envoi à la fin d’Analytics. Enregistre une nouvelle clé pour retrouver les deux. |
| « La clé d’envoi est restée dans les secrets Roblox de … » | Pour un jeu dont Analytics est fini, VibeStarter retire la clé d’envoi avant d’oublier ta clé ; quand elle est restée, supprime le secret « vibestarter\_analytics » dans le Creator Hub (ton jeu → Secrets), ou enregistre une nouvelle clé Analytics et VibeStarter le retirera. |

## « Clé refusée par Roblox »

Si Roblox refuse ta clé pendant la lecture quotidienne de ses chiffres, l’étape l’affiche en haut : la clé a été supprimée, a expiré ou a été désactivée (crée-en une nouvelle et remplace-la), ou elle n’a plus accès à ce jeu (vérifie ses permissions, puis teste à nouveau). Au test suivant, quand Roblox dit que la clé n’a servi à rien pendant 60 jours, le verdict le nomme : « Roblox a désactivé cette clé : elle n’a servi à rien pendant 60 jours. Réactive-la dans le Creator Hub, ou crée-en une autre. » Les mesures du module ne sont pas touchées. L’avertissement disparaît dès que la lecture suivante passe. Si Analytics utilise une copie de ta clé Roblox, remplace ta clé dans les Paramètres : la copie suit.

## Le module dans ton projet

Chaque projet ouvert avec l’app 4.0.0 contient le module Analytics. **Tant que le jeu n’a pas Analytics, il n’envoie rien** : aucun appel réseau, aucune ligne dans la sortie de Studio ; il vérifie seulement, à l’intérieur du serveur, si une clé d’envoi existe. Il démarre quand le jeu est branché. Il rejoint ton jeu en ligne à ta prochaine publication depuis Studio, avec l’app ouverte sur le projet ; chaque place du jeu doit être publiée.

Le réglage « Module Analytics dans ce jeu », sur l’Aperçu et sur la page Analytics de Mon jeu, retire le module du projet. L’app ne le remet pas ensuite : « Retiré de ce projet : l’app ne le remet pas. » Sur un jeu qui a Analytics, l’app prévient d’abord : « Ce jeu a Analytics : sans le module, plus aucune donnée n’arrivera après ta prochaine publication. »

## Si aucun chiffre n’arrive

Quand la ligne d’état reste sur « Branché · dans Studio, autorise HTTP puis publie ton jeu, et attends ton premier joueur », vérifie dans l’ordre :

1.  « Allow HTTP Requests » est coché dans les paramètres du jeu, dans Studio.
2.  Le jeu a été publié depuis Studio **avec l’app ouverte sur le projet**, et chaque place du jeu l’a été.
3.  Le réglage « Module Analytics dans ce jeu » n’a pas retiré le module.
4.  Un joueur a rejoint le jeu en ligne : un essai dans Studio ne compte pas.

## Pour aller plus loin

-   [Analytics de jeu](/services/analytics/)
-   [Les paliers d’Analytics](/services/analytics/paliers/)
-   [Lier ton compte Roblox et ta clé Open Cloud](/application/studio/compte-roblox/)
-   [Publier ton jeu et suivre tes versions](/application/studio/publier/)