Variables de etiqueta para información de productos en Paywall Builder
El Paywall Builder de Adapty te permite personalizar todo el texto de tus productos y sus ofertas. Si trabajas con varios idiomas, te recomendamos encarecidamente usar variables.
Cómo funciona
Cuando añades variables de etiqueta de nuestra lista a los textos de tus productos, el SDK obtiene los datos localizados ya precargados de los stores para reemplazar las etiquetas. Esto garantiza que el texto de tu paywall siempre esté perfectamente adaptado al idioma correcto.
Ejemplo: Supongamos que tienes una “Suscripción Premium” disponible tanto en EE. UU. como en España. En EE. UU. podría mostrarse como “Premium Subscription for $4.99/month”, mientras que en España aparecería como “Suscripción Premium por €4,99/mes”.
Las variables de etiqueta te permiten localizar automáticamente estas cadenas de texto a partir de los datos del store, garantizando que los títulos y precios sean siempre correctos.
Esta sección describe el nuevo Paywall Builder, que funciona con los SDKs de iOS, Android y React Native en la versión 3.0 o superior, y con los SDKs de Flutter y Unity en la versión 3.3.0 o superior. Para información sobre el Paywall Builder legacy compatible con el SDK de Adapty v2.x o anterior, consulta Variables de etiqueta en el Paywall Builder legacy.
Cómo usar las variables de etiqueta
Las variables de etiqueta solo se pueden usar al describir productos y ofertas en el componente Product del Paywall Builder.
- En el panel izquierdo del Paywall Builder, selecciona el producto que quieres personalizar.
- Usa las variables de la tabla a continuación en cualquier campo de texto para describir el producto y sus ofertas.
- Comprueba la vista previa en el lado derecho de la pantalla para asegurarte de que todo se muestra correctamente.
La vista previa no usa valores reales para reemplazar las variables; estos solo los recupera el SDK en el dispositivo. Sin embargo, sí muestra datos de plantilla en el mismo formato que el resultado real. Puedes desactivar este comportamiento haciendo clic en el icono del ojo en la esquina inferior derecha de la vista previa y desactivando el toggle Tags preview values. La vista previa mostrará entonces los valores reales de las variables:
Lista completa de variables
| Variable de etiqueta | Descripción | Ejemplo |
|---|---|---|
<PROD_TITLE/> | Título localizado del producto | Premium Subscription |
<PROD_PRICE/> | Precio localizado del producto. En suscripciones, este es el precio por un período de facturación. | $9.99 |
<PROD_PRICE_PER_DAY/> | Precio de la suscripción dividido entre el número de días del período de facturación. Devuelve una cadena vacía para los productos que no son suscripciones. | $0.33 |
<PROD_PRICE_PER_WEEK/> | Precio de la suscripción dividido entre el número de semanas del período de facturación. Devuelve una cadena vacía para los productos que no son suscripciones. | $2.33 |
<PROD_PRICE_PER_MONTH/> | Precio de la suscripción dividido entre el número de meses del período de facturación. Si el período de facturación es inferior a un mes, se ajusta para representar un mes completo. Devuelve una cadena vacía para los productos que no son suscripciones. | $9.99 |
<PROD_PRICE_PER_YEAR/> | Precio de la suscripción ajustado para representar un año completo de uso. Por ejemplo, el precio de una suscripción mensual se multiplicaría por 12, mientras que el precio anual permanece igual. Devuelve una cadena vacía para los productos que no son suscripciones. | $119.88 |
<OFFER_PRICE/> | Precio localizado de una oferta (introductoria o promocional). Aplicable solo a suscripciones de renovación automática; devuelve una cadena vacía si el usuario no es elegible para ninguna oferta. | $0.99 |
<OFFER_BILLING_PERIOD/> | Período de facturación localizado de una oferta (introductoria o promocional). Igual que <OFFER_FULL_DURATION/> para ofertas de prueba gratuita y pago anticipado. Aplicable solo a suscripciones de renovación automática; devuelve una cadena vacía si el usuario no es elegible para ninguna oferta. | 1 week |
<OFFER_FULL_DURATION/> | Duración total localizada de una oferta (introductoria o promocional). Aplicable solo a suscripciones de renovación automática; devuelve una cadena vacía si el usuario no es elegible para ninguna oferta. | 1 month |
Etiquetas de oferta para distintos tipos de oferta
Puedes aprender más sobre las ofertas y cómo configurarlas en Adapty aquí
Entender las etiquetas de oferta puede resultar algo confuso, así que veámoslo con un ejemplo. Supongamos que tienes una suscripción semanal llamada “Premium Subscription” por $5, con tres posibles ofertas:
- Pay As You Go. Las primeras 3 semanas por $3 (facturadas semanalmente), y luego $5/semana.
- Pay Up Front. Las primeras 3 semanas por $8 (facturadas inmediatamente), y luego $5/semana.
- Free Trial. La primera semana gratis, y luego $5/semana.
Para este producto, <PROD_TITLE/> sería “Premium Subscription” y <PROD_PRICE/> sería $5. Sin embargo, los valores de las etiquetas de oferta —dependiendo de cuál sea elegible para el usuario— serían:
| Variable de etiqueta | Pay As You Go | Pay Upfront | Free Trial |
|---|---|---|---|
<OFFER_PRICE/> | $3 | $8 | $0 |
<OFFER_BILLING_PERIOD/> | 1 week | 3 weeks | 1 week |
<OFFER_FULL_DURATION/> | 3 weeks | 3 weeks | 1 week |
Así que para los tipos de oferta distintos de “Pay As You Go”, <OFFER_BILLING_PERIOD/> y <OFFER_FULL_DURATION/> serán iguales.