Variables de etiqueta para información de productos en el 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 precargados de los stores de aplicaciones para sustituir las etiquetas. Esto garantiza que el texto de tu paywall esté siempre perfectamente adaptado al idioma correcto.
Ejemplo: Imagina 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 a partir de los datos directamente del store, asegurando que los títulos y precios sean siempre correctos.
Cómo usar las variables de etiqueta
Solo puedes usar variables de etiqueta 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 siguiente en cualquier campo de texto para describir el producto y sus ofertas.
- Revisa la vista previa en el lado derecho de la pantalla para asegurarte de que todo se muestra como esperabas.
La vista previa no usa valores reales para reemplazar las variables; estos solo los obtiene nuestro SDK en el dispositivo. Sin embargo, muestra datos de plantilla con el mismo formato que el resultado real. Puedes desactivar este comportamiento haciendo clic en el ícono 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, 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 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 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 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 mensual se multiplicaría por 12, mientras que el precio anual se mantiene igual. Devuelve una cadena vacía para productos que no son suscripciones. | $119.88 |
<OFFER_PRICE/> | Precio localizado de una oferta (introductoria o promocional). Solo aplica 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 por adelantado. Solo aplica 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). Solo aplica 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 según el tipo de oferta
Puedes aprender más sobre las ofertas y cómo configurarlas en Adapty aquí.
Entender las etiquetas de oferta puede resultar algo complejo, 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 (facturado semanalmente), después $5/semana.
- Pay Up Front. Las primeras 3 semanas por $8 (facturado de inmediato), después $5/semana.
- Free Trial. La primera semana gratis, después $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, según la oferta para la que el usuario sea elegible, 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 las ofertas que no son de tipo “Pay As You Go”, <OFFER_BILLING_PERIOD/> y <OFFER_FULL_DURATION/> tendrán el mismo valor.