Теговые переменные для информации о продукте в устаревшем Paywall Builder
Paywall Builder Adapty позволяет настраивать все тексты, связанные с вашими продуктами и их предложениями. Но если у вас несколько локалей — мы настоятельно рекомендуем использовать переменные.
Как это работает
Когда тексты для ваших продуктов содержат теговую переменную из нашего списка, SDK берёт предварительно загруженные локализованные данные из сторов и подставляет их вместо тега. Таким образом текст на вашем пейволе всегда адаптирован под нужную локаль.
Пример: допустим, у вас есть «Premium Subscription», и ваше приложение доступно как в США, так и в Испании. Значит, вы продаёте «Premium Subscription for $4.99/month» в США и «Suscripción Premium por €4.99/mes» в Испании.
Теговые переменные позволяют опираться на данные, полученные напрямую из стора, для локализации таких строк — так что заголовки и цены всегда будут правильными.
Этот раздел описывает устаревший Paywall Builder, совместимый с Adapty SDK v2.x и более ранними версиями. Информацию о новом Paywall Builder, совместимом с Adapty SDK v3.0 и выше, см. в разделе Теговые переменные для информации о продукте в новом Paywall Builder.
Как использовать теговые переменные
Теговые переменные можно использовать только при описании продуктов и предложений на вкладке «Products» в Paywall Builder
- Выберите вкладку «Products» в Builder
- Выберите продукт, который хотите настроить:
- Используйте переменные из таблицы ниже в любом текстовом поле для описания продукта и его предложений:
- Проверьте Preview в правой части экрана, чтобы убедиться, что всё отображается корректно.
Примечание: Preview не использует реальные значения вместо переменных, так как они загружаются только на устройстве через SDK. По умолчанию в Preview отображаются шаблонные данные в том же формате, что и реальный результат.
Вы можете отключить это поведение, нажав значок «глаза» в правом верхнем углу Preview и отключив переключатель «Tags preview values». После этого Preview будет показывать фактические значения переменных:
Полный список переменных
| Теговая переменная | Описание | Пример |
|---|---|---|
<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/> для пробных и единовременных предложений. Применимо только к автовозобновляемым подпискам; возвращает пустую строку, если пользователь не имеет права ни на одно предложение. | 1 week |
<OFFER_FULL_DURATION/> | Локализованная полная длительность предложения (introductory offer или promotional offer). Применимо только к автовозобновляемым подпискам; возвращает пустую строку, если пользователь не имеет права ни на одно предложение. | 1 month |
Теги предложений для разных типов предложений
Подробнее об офферах и их настройке в Adapty можно узнать здесь
Теги предложений для разных типов могут сбивать с толку, поэтому рассмотрим пример. Допустим, у нас есть недельная подписка «Premium Subscription» стоимостью $5. Для неё доступны 3 возможных предложения:
- 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/> будут одинаковыми.