Переменные-теги для информации о продукте в Paywall Builder
Paywall Builder от Adapty позволяет настраивать все тексты для ваших продуктов и их офферов. Если вы поддерживаете несколько локалей, мы настоятельно рекомендуем использовать переменные.
Как это работает
Когда вы добавляете переменные-теги из нашего списка в тексты продуктов, SDK подставляет заранее загруженные локализованные данные из сторов на место тегов. Это гарантирует, что текст на вашем пейволе всегда точно соответствует нужной локали.
Пример: допустим, у вас есть «Premium Subscription», доступная как в США, так и в Испании. В США она может отображаться как «Premium Subscription for $4.99/month», а в Испании — «Suscripción Premium por €4.99/mes».
Переменные-теги позволяют автоматически локализовать эти строки на основе данных непосредственно из стора, гарантируя точность заголовков и цен.
Этот раздел описывает новый Paywall Builder, который работает с iOS, Android и React Native SDK версии 3.0 и выше, а также с Flutter и Unity SDK версии 3.3.0 и выше. Информацию о legacy Paywall Builder, совместимом с Adapty SDK v2.x и более ранними версиями, см. в разделе Переменные-теги в Legacy Paywall Builder.
Как использовать переменные-теги
Переменные-теги можно использовать только при описании продуктов и офферов в компоненте Product в Paywall Builder.
- В левой панели Paywall Builder выберите продукт, который хотите настроить.
- Используйте переменные из таблицы ниже в любых текстовых полях для описания продукта и его офферов.
- Проверьте превью в правой части экрана, чтобы убедиться, что всё отображается корректно.
В превью не используются реальные значения для замены переменных — их получает SDK уже на устройстве. Тем не менее превью отображает шаблонные данные в том же формате, что и итоговый результат. Отключить это поведение можно, нажав на иконку глаза в правом нижнем углу превью и выключив переключатель Tags preview values. Тогда превью будет показывать фактические значения переменных:
Полный список переменных
| Переменная-тег | Описание | Пример |
|---|---|---|
<PROD_TITLE/> | Локализованное название продукта | Premium Subscription |
<PROD_PRICE/> | Локализованная цена продукта. Для подписок — цена за один расчётный период. | $9.99 |
<PROD_PRICE_PER_DAY/> | Цена подписки, разделённая на количество дней в расчётном периоде. Возвращает пустую строку для продуктов, не являющихся подписками. | $0.33 |
<PROD_PRICE_PER_WEEK/> | Цена подписки, разделённая на количество недель в расчётном периоде. Возвращает пустую строку для продуктов, не являющихся подписками. | $2.33 |
<PROD_PRICE_PER_MONTH/> | Цена подписки, разделённая на количество месяцев в расчётном периоде. Если расчётный период меньше месяца, значение корректируется до полного месяца. Возвращает пустую строку для продуктов, не являющихся подписками. | $9.99 |
<PROD_PRICE_PER_YEAR/> | Цена подписки, пересчитанная на полный год использования. Например, цена месячной подписки умножается на 12, а годовая цена остаётся без изменений. Возвращает пустую строку для продуктов, не являющихся подписками. | $119.88 |
<OFFER_PRICE/> | Локализованная цена оффера (introductory offer или promotional offer). Применимо только к автовозобновляемым подпискам; возвращает пустую строку, если пользователь не имеет права ни на один оффер. | $0.99 |
<OFFER_BILLING_PERIOD/> | Локализованный расчётный период оффера (introductory offer или promotional offer). То же, что <OFFER_FULL_DURATION/>, для trial и pay-upfront офферов. Применимо только к автовозобновляемым подпискам; возвращает пустую строку, если пользователь не имеет права ни на один оффер. | 1 week |
<OFFER_FULL_DURATION/> | Локализованная полная длительность оффера (introductory offer или promotional offer). Применимо только к автовозобновляемым подпискам; возвращает пустую строку, если пользователь не имеет права ни на один оффер. | 1 month |
Теги офферов для разных типов офферов
Подробнее об офферах и их настройке в Adapty можно узнать здесь.
Разобраться с тегами офферов проще на конкретном примере. Допустим, у вас есть недельная подписка «Premium Subscription» за $5 с тремя возможными офферами:
- Pay As You Go. Первые 3 недели по $3 (списывается еженедельно), затем $5/неделю.
- Pay Up Front. Первые 3 недели за $8 (списывается сразу), затем $5/неделю.
- Free Trial. Первая неделя бесплатно, затем $5/неделю.
Для этого продукта <PROD_TITLE/> будет «Premium Subscription», а <PROD_PRICE/> — $5. Значения тегов офферов — в зависимости от того, на какой оффер имеет право пользователь — будут следующими:
| Переменная-тег | 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 |
Таким образом, для всех типов офферов, кроме «Pay As You Go», значения <OFFER_BILLING_PERIOD/> и <OFFER_FULL_DURATION/> совпадают.