Etiquetas personalizadas

Una etiqueta personalizada es una variable personalizada cuyo valor proviene de tu app. Cuando seleccionas Value comes from outside the app en la configuración de una variable, tu app puede establecer su valor a través del SDK de Adapty. Por ejemplo, un elemento de texto contiene “Coins:” y una etiqueta personalizada. Si tu app pasa “120” para la etiqueta, los usuarios verán “Coins: 120”.

Usa etiquetas personalizadas para mostrar:

• Quién es el usuario: Un nombre de usuario en un saludo, como “¡Bienvenido de nuevo, DragonSlayer42!”
• Qué tiene el usuario: El número de días en una racha, o el nivel de un jugador.
• Qué calcula tu app: Un descuento para un pack más grande, o un IMC basado en las respuestas del usuario en un flow anterior.

Valores y valores de respaldo

Tu app identifica cada valor por el nombre de su etiqueta personalizada. El valor siempre es una cadena de texto. Adapty no formatea ni traduce la cadena, así que tu app debe convertir cada valor en legible antes de que aparezca en el flow. Por ejemplo, pasa “1,250” en lugar de “1250.0”.

Los usuarios ven el Valor inicial de una etiqueta personalizada como valor de respaldo en los siguientes casos:

• Tu app no pasa ningún valor para la etiqueta.
• El usuario no ha actualizado tu app a una versión que envíe el valor.
• El nombre en el código de tu app no coincide con el nombre completo de la etiqueta, incluidas las mayúsculas y minúsculas.
• Otra etiqueta personalizada en el mismo elemento de texto no tiene valor. En ese caso, todas las etiquetas personalizadas de ese elemento de texto muestran su valor inicial.

Para no mostrar nada en lugar de una etiqueta, pasa una cadena vacía. Adapty trata una cadena vacía como un valor, por lo que el valor de respaldo no aparece.

1. Crea una etiqueta personalizada

1. Abre el panel Variables en el flow builder.

2. Añade una nueva variable haciendo clic en .

3. Configura el Name de la variable. El código de tu app debe referenciarlo exactamente, incluyendo mayúsculas y minúsculas.

   • Characters: Usa letras latinas (A–Z y a–z), dígitos, _ y -. Para colocar la etiqueta en un grupo, empieza su nombre con el grupo y un punto, por ejemplo user.streak.
   • Reserved names: En cualquier combinación de mayúsculas y minúsculas, no uses un nombre reservado como PRICE, TITLE, VALUE, ni uno que empiece por TIMER_.
   • Uniqueness: Usa un nombre único dentro del flow.

4. (Opcional) Para distinguir entre distintas variables, rellena el campo Description. Al pasar el cursor sobre el nombre de la variable en el builder, verás la descripción.

5. En el campo Initial value, introduce el valor de respaldo que verán los usuarios cuando tu app no pase ningún valor:

   • Una palabra que encaje con todos los usuarios: Para la etiqueta username en un saludo, introduce friend. Los usuarios no autenticados verán “Welcome back, friend!”. Ten en cuenta que el valor inicial no puede localizarse.
   • Un guion para un saldo o un contador: Para evitar mostrar un valor de saldo incorrecto a los usuarios no autenticados, introduce un guion (—).

6. (Solo variables de tipo String) Selecciona la casilla Value comes from outside the app. Esta acción es irreversible y bloquea el Value Type.

7. Haz clic en Create variable.

Las variables son específicas de cada flow. Para usar una etiqueta personalizada en otro flow, créala allí con el mismo nombre.

Reemplazar una variable con una etiqueta personalizada

Solo puedes marcar la casilla Value comes from outside the app al crear una variable. Para mostrar el valor de tu app en lugar de una variable personalizada normal, como la de un paywall convertido, reemplaza la variable con una etiqueta personalizada:

1. Elimina la variable y todas sus referencias en el flow.
2. Crea una etiqueta personalizada con el mismo nombre.
3. Inserta la etiqueta personalizada en cada elemento de texto que usaba la variable.

2. Añade una etiqueta personalizada a un elemento de texto

Selecciona el elemento de texto. En la sección Content, haz clic en Add variable y selecciona la etiqueta en la pestaña Custom.

Puedes insertar etiquetas personalizadas en cada rama del texto condicional, pero no puedes seleccionarlas en sus condiciones if.

3. Pasa los valores desde tu app

El código de tu app debe usar el nombre exacto de cada etiqueta personalizada, incluido su grupo. Por ejemplo, si el grupo user contiene una etiqueta streak, el nombre exacto de la etiqueta es user.streak.

El código de configuración depende de tu plataforma:

• iOS
• Android
• React Native
• Flutter
• Unity
• Kotlin Multiplatform
• Capacitor

Para probar tus etiquetas personalizadas, abre el flow en tu app después de añadir el código que establece sus valores. El canvas del builder y la vista previa en dispositivos solo muestran los valores iniciales: la app móvil de Adapty no establece los valores de las etiquetas personalizadas.

Limitaciones

• Solo en elementos de texto: Solo puedes insertar tags personalizados en elementos de texto. No puedes insertarlos en:
  • Acciones de Set variable
  • Acciones de Show alert
  • Acciones de Open URL
  • Marcadores de posición de inputs
• Sin condiciones en tags personalizados: No puedes seleccionar un tag personalizado en una condición ni en visibilidad condicional. Para decidir qué frases, elementos y pantallas ven los usuarios según un valor de tu app:
  • Frase: Construye la frase en el código de tu app y pásala como valor del tag. Por ejemplo, para un tag coins_message, pasa “You have 120 coins” a los jugadores con monedas y “Get your first coins” al resto.
  • Elementos y pantallas: Establece el valor como atributo personalizado. Luego muestra un flow independiente a una audiencia creada a partir de ese atributo.
• No hay método SDK para actualizar los valores en un flow abierto: Para mostrar un resultado basado en lo que los usuarios introducen en un flow, pasa el resultado al siguiente flow, como en el ejemplo de IMC.