Nommez les IDs vus par vos outils d'analyse

Le SDK Adapty signale chaque affichage d’écran et chaque réponse à votre application. Chaque événement inclut l’ID de l’écran ou de l’élément dont il provient, et ce sont ces IDs que votre propre outil d’analyse affiche. Par défaut, l’ID d’un écran ressemble à scr_oAPBHPa7, ce qui fait qu’un funnel dans Amplitude ou Mixpanel s’affiche comme une colonne de codes, et quelqu’un doit maintenir manuellement une correspondance code-nom.

Vous pouvez nommer ces IDs vous-même. Les inputs et les groupes sélectionnables sont nommés dans le Flow Builder. Les IDs d’écrans sont définis via le skill flow-generator, qui renomme un écran partout où le flow y fait référence.

À quoi ça sert

• Un tunnel que votre équipe comprend : La séquence welcome → signup → paywall dit ce qui s’est passé. Trois codes générés automatiquement, non.
• Un vocabulaire commun avec vos propres outils : Chaque événement transmis par votre app désigne l’écran de la même façon, ce qui permet à un tunnel, une cohorte et un filtre de tableau de bord de s’accorder sans table de correspondance.
• Des réponses que vous pouvez requêter : Une option de quiz nommée beginner est une valeur qu’un analyste peut filtrer directement. Un identifiant généré, lui, doit d’abord être décodé.

Quels identifiants votre analytics reçoit

Deux événements portent des identifiants. flow_screen_showed se déclenche quand un utilisateur ouvre un écran, et flow_user_input se déclenche quand un utilisateur remplit un champ, choisit une réponse à un quiz ou active un interrupteur. Chaque guide documente tous les paramètres de son événement. Ce tableau couvre uniquement les paramètres qui identifient un écran ou un élément.

Nommer les champs et les options de quiz

Les champs et les groupes sélectionnables possèdent des identifiants dans le builder. L’Element ID d’un champ se trouve dans Input settings ; c’est le même identifiant que vous utilisez pour référencer la valeur ailleurs dans le flow — voir Champs et formulaires. Le Group ID d’un groupe se trouve dans Screen settings > Selectable groups, et chaque option à l’intérieur possède son propre Element ID.

Donnez à chacun un nom qui parle de lui-même, car c’est la chaîne qui s’affiche dans vos analytics. birthday et beginner n’ont pas besoin d’explication. el_024F, lui, en a besoin.

Définissez l’ID au moment où vous ajoutez l’élément, pas après. Les conditions et les variables texte pointent vers un ID d’élément : le modifier ne met pas à jour les références — elles cessent de fonctionner, sans aucune erreur. Pour renommer un ID dans un flow déjà opérationnel, mettez à jour toutes les conditions et variables qui l’utilisent. Voir Les conditions et variables se cassent après un changement d’ID d’élément.

Le skill flow-generator nomme ces éléments automatiquement pour tout flow qu’elle génère. La skill flow-audit signale ceux qui sont manquants.

Renommer les écrans

Le Flow Builder ne dispose d’aucun champ pour l’identifiant d’un écran, alors demandez au skill :

Give the screens in my onboarding flow readable IDs.

Le skill propose un nom pour chaque écran, puis le renomme partout où le flow y fait référence — l’écran lui-même, chaque action de navigation qui y mène, et les produits qui y sont attachés. Elle les renomme tous ensemble, car un écran renommé à un endroit mais pas à un autre est un flow qui ne pourra pas être publié.

Cela vous indique quels noms ont été modifiés et combien de références ont été déplacées. La commande n’exécutera pas un renommage qui entrerait en collision avec un écran déjà existant. L’identifiant d’un écran peut être renommé en toute sécurité dans un flow déjà fonctionnel, contrairement à un identifiant d’élément : le skill déplace toutes les références en même temps.

Quoi vérifier

• Renommez avant la mise en ligne du flow : les événements déjà collectés conservent l’ancien ID. Un funnel qui couvre le changement affiche deux écrans à moitié remplis, et rebaptiser l’écran ne les fusionne pas. Les métriques de flow d’Adapty se divisent de la même façon, car elles regroupent les lignes d’écran par ID — l’écran renommé obtient une deuxième ligne, sous le même libellé que la première.
• Chaque option d’un groupe doit avoir son propre Element ID : si une option n’en a pas, si deux options partagent le même, ou si le Group ID est réutilisé sur un autre écran, tout le groupe ne remonte rien — pas seulement cette option. Le builder ne le signale pas, vérifiez donc le groupe après y avoir ajouté une option.
• Les ID arrivent dans votre outil d’analyse exactement tels que saisis : choisissez un style, par exemple plan_selection ou planSelection, et utilisez-le dans tout le flow. Des styles mélangés sont plus difficiles à interroger que des codes générés.

Limitations

• Les IDs d’écran ne peuvent être renommés que via le skill : il n’existe pas de champ prévu à cet effet dans le Flow Builder.
• Les métriques de flow d’Adapty n’affichent pas ces noms : Les métriques de flow étiquettent un écran <position>. <caption> d’après la version publiée du flow, donc l’affichage sera 9. Paywall A quel que soit l’ID de l’écran. Ces IDs n’apparaissent que dans vos propres outils d’analyse.
• Un renommage ne migre pas l’historique : les anciens événements conservent l’ancien ID.
• Certains éléments n’envoient aucun événement de saisie : les champs de mot de passe, les sélections de produits et les changements d’onglets ne remontent jamais d’événement. Les nommer impacte le flow, pas vos données analytiques.