---
title: "Переменные-теги для информации о продукте в Paywall Builder"
description: "Используйте переменные-теги в Paywall Builder от Adapty для персонализации пользовательского опыта и роста продаж."
---

Paywall Builder от Adapty позволяет настраивать все тексты для ваших продуктов и их офферов. Если вы поддерживаете несколько локалей, мы настоятельно рекомендуем использовать переменные.

### Как это работает \{#how-it-works\}

Когда вы добавляете переменные-теги из нашего списка в тексты продуктов, SDK подставляет заранее загруженные локализованные данные из сторов на место тегов. Это гарантирует, что текст на вашем пейволе всегда точно соответствует нужной локали.

**Пример**: допустим, у вас есть «Premium Subscription», доступная как в США, так и в Испании. В США она может отображаться как «Premium Subscription for $4.99/month», а в Испании — «Suscripción Premium por €4.99/mes».

Переменные-теги позволяют автоматически локализовать эти строки на основе данных непосредственно из стора, гарантируя точность заголовков и цен.

:::warning

Этот раздел описывает новый 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](paywall-builder-tag-variables-legacy).

:::

### Как использовать переменные-теги \{#how-to-use-tag-variables\}

:::note
Переменные-теги можно использовать только при описании продуктов и офферов в компоненте Product в Paywall Builder.
:::

1. В левой панели Paywall Builder выберите продукт, который хотите настроить.
2. Используйте переменные из [таблицы ниже](paywall-builder-tag-variables#full-list-of-variables) в любых текстовых полях для описания продукта и его офферов.

  <img src="/assets/shared/img/0351661-tag_variables.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

4. Проверьте превью в правой части экрана, чтобы убедиться, что всё отображается корректно.

:::note
В превью не используются реальные значения для замены переменных — их получает SDK уже на устройстве. Тем не менее превью отображает шаблонные данные в том же формате, что и итоговый результат. Отключить это поведение можно, нажав на иконку глаза в правом нижнем углу превью и выключив переключатель **Tags preview values**. Тогда превью будет показывать фактические значения переменных:

  <img src="/assets/shared/img/da92d39-tags_preview_values.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

:::

### Полный список переменных \{#full-list-of-variables\}

| Переменная-тег            | Описание                                                                                                                                                                                                                                        | Пример               |
| :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |
| `<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              |

### Теги офферов для разных типов офферов \{#offer-tags-for-different-offer-types\}

:::note
Подробнее об офферах и их настройке в Adapty можно узнать [здесь](offers).
:::

Разобраться с тегами офферов проще на конкретном примере. Допустим, у вас есть недельная подписка «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/>` совпадают.