Nombra los IDs que ve tu analítica

El SDK de Adapty reporta cada visualización de pantalla y cada respuesta a tu app. Cada evento incluye el ID de la pantalla o elemento del que proviene, y esos IDs son los que muestra tu propio sistema de analíticas. Por defecto, el ID de una pantalla tiene un aspecto como scr_oAPBHPa7, así que un funnel en Amplitude o Mixpanel aparece como una columna de códigos, y alguien tiene que mantener a mano un mapeo de código a nombre.

Puedes nombrar estos IDs tú mismo. Los inputs y grupos seleccionables se nombran en el Flow Builder. Los IDs de pantalla se configuran mediante la skill flow-generator, que renombra una pantalla en todos los lugares del flow donde se hace referencia a ella.

Important

Renombrar pantallas forma parte de la skill del generador de flows, por lo que no necesitas instalar nada extra: sigue los pasos de instalación del generador de flows y ya lo tendrás. Guarda los cambios en los flows de tu dashboard, así que ejecútalo primero sobre un borrador y revisa el resultado en el Flow Builder antes de publicarlo.

Para qué sirve

Un funnel que tu equipo entiende: La secuencia welcome → signup → paywall cuenta lo que ocurrió. Tres códigos generados, no.
Un vocabulario común en todas tus herramientas: Cada evento que tu app reenvía nombra la pantalla de la misma forma, así un funnel, una cohorte y un filtro del dashboard coinciden sin necesidad de una tabla de referencia.
Respuestas que puedes consultar: Una opción de quiz llamada beginner es un valor que un analista puede filtrar directamente. Un ID generado hay que decodificarlo primero.

Qué IDs ve tu sistema de análisis

Dos eventos llevan IDs. flow_screen_showed se dispara cuando un usuario abre una pantalla, y flow_user_input se dispara cuando un usuario rellena un campo, elige una respuesta en un cuestionario o activa un interruptor. Cada guía documenta todos los parámetros de su evento. Esta tabla cubre únicamente los parámetros que identifican una pantalla o un elemento.

Parámetro del evento	Qué contiene	Dónde se configura
`instanceId`	El ID de la pantalla	La skill del generador de flows
`element_id`	El Element ID de un campo de entrada, o el Group ID de un grupo seleccionable	Flow Builder
`item_ids`	Los Element IDs de las opciones seleccionadas	Flow Builder

Nombres para inputs y opciones de quiz

Los inputs y los grupos seleccionables tienen campos de ID en el builder. El Element ID de un input está en Input settings, y es el mismo ID que usas para referenciar su valor en otras partes del flow — consulta Inputs y formularios. El Group ID de un grupo está en Screen settings > Selectable groups, y cada opción dentro de él tiene su propio Element ID.

Dale a cada uno un nombre que tenga sentido por sí solo, porque esa es la cadena que verás en tus analytics. birthday y beginner no necesitan explicación. el_024F sí.

Establece el ID cuando añades el elemento, no después. Las condiciones y variables de texto apuntan a un ID de elemento, y cambiar ese ID no las actualiza — dejan de resolverse, sin ningún error. Para renombrarlo en un flow que ya funciona, actualiza cada condición y variable que lo utilice. Consulta Las condiciones y variables se rompen tras cambiar el ID de un elemento.

La skill de generación de flows los nombra automáticamente en cualquier flow que construye. La skill de auditoría de flows reporta los que faltan.

Cambiar nombre a las pantallas

El Flow Builder no tiene ningún campo para el ID de una pantalla, así que pídele a la skill:

Give the screens in my onboarding flow readable IDs.

La skill propone un nombre para cada pantalla y luego lo renombra en todos los lugares donde el flow hace referencia a ella: la propia pantalla, cada acción de navegación que lleva a ella y los productos vinculados a ella. Los renombra todos a la vez, porque una pantalla renombrada en un sitio pero no en otro es un flow que no se podrá publicar.

Te indica qué nombres cambió y cuántas referencias se movieron, y no ejecutará un cambio de nombre que colisione con una pantalla que ya existe. Renombrar un ID de pantalla es seguro en un flow que ya funciona, algo que no ocurre con un ID de elemento: la herramienta mueve todas las referencias junto con él.

Qué verificar

Renombrar antes de publicar el flow: Los eventos ya recopilados conservan el ID anterior. Un embudo que abarque el cambio mostrará dos pantallas a medio llenar, y revertir el nombre no las fusiona. Las métricas de flow de Adapty se dividen de la misma forma, porque agrupa las filas de pantalla por ID: la pantalla renombrada obtiene una segunda fila con la misma etiqueta que la primera.
Cada opción de un grupo necesita su propio Element ID: Si a una opción le falta uno, si dos opciones comparten uno, o si el Group ID se reutiliza en otra pantalla, todo el grupo deja de reportar datos, no solo esa opción. El builder no señala este problema, así que revisa el grupo cada vez que añadas una opción.
Los IDs llegan a tus herramientas de análisis exactamente como los escribiste: Elige un estilo, como plan_selection o planSelection, y úsalo en todo el flow. Los estilos mezclados son más difíciles de consultar que los códigos generados.

Limitaciones

Los IDs de pantalla solo se renombran mediante el skill: No hay ningún campo para ellos en el Flow Builder.
Las métricas de flow de Adapty no mostrarán estos nombres: Las métricas de flow etiquetan una pantalla como <position>. <caption> a partir de la versión publicada del flow, por lo que aparece como 9. Paywall A independientemente del ID de la pantalla. Los IDs aquí solo llegan a tus propias analíticas.
Renombrar no migra el historial: Los eventos anteriores conservan el ID antiguo.
Algunos elementos no envían eventos de entrada: Los campos de contraseña, las selecciones de producto y los cambios de pestaña nunca se reportan. Nombrar uno afecta al flow, no a tus analíticas.