Кастомные теги в legacy Paywall Builder

Кастомные теги доступны начиная с AdaptyUI SDK v.2.1.0 и выше

Кастомные теги позволяют не создавать отдельные пейволы для разных ситуаций. Представьте единый пейвол, который адаптируется под конкретный контекст, подставляя данные пользователя. Например, обычное «Привет!» превращается в персональное «Привет, Иван!» или «Привет, Анна!»

Варианты использования:

Email или имя пользователя на пейволе
Текущий день недели для повышения продаж (например, «Счастливый четверг»)
Кастомные свойства продаваемых продуктов (название персональной фитнес-программы, номер телефона в VoIP-приложении и т. д.)

Кастомные теги позволяют создать единый пейвол для разных ситуаций — интерфейс приложения будет динамически подставлять нужную информацию. Это удобное решение для персонализации дизайна пейвола под каждого конкретного пользователя.

Обязательно добавляйте фолбэки для всех строк с кастомными тегами

В некоторых случаях приложение может не знать, чем заменить кастомный тег — например, если пейвол доставляется пользователям со старыми версиями AdaptyUI SDK.

Поэтому при использовании кастомных тегов обязательно добавляйте фолбэк-строки — они будут отображаться вместо строк с неизвестными кастомными тегами. Иначе пользователь увидит тег как код (<USERNAME/>).

Как добавить кастомный тег в пейвол

В любую текстовую строку Paywall Builder можно добавить один или несколько кастомных тегов.

Чтобы добавить кастомный тег в строку:

Введите кастомный тег в формате <CUSTOM_TAG/> или просто напечатайте открывающую угловую скобку (<) в текстовой строке — система предложит тег в правильном формате.

Обратите внимание:
- В Adapty Paywall Builder кастомные теги заключаются в угловые скобки (<CUSTOM_TAG/>), а в коде мобильного приложения на них ссылаются напрямую (CUSTOM_TAG).
- Кастомные теги чувствительны к регистру.
- Кастомные теги не должны совпадать ни с одной из Tag Variables, зарезервированных для информации о продуктах в Adapty.

После ввода кастомного тега обязательно укажите фолбэк-строку. Фолбэк — это текст, который отображается в приложении, если оно не распознаёт конкретный кастомный тег. Это гарантирует, что пользователь не увидит тег в виде кода, а увидит заданный фолбэк-текст. Обратите внимание: фолбэк заменяет всю строку целиком, а не только сам тег.

Как использовать кастомные теги в мобильном приложении

Чтобы использовать кастомные теги в мобильном приложении, нужно создать объект tagResolver — словарь/карту, содержащую кастомные теги и строковые значения, которые будут подставляться при отображении пейвола. Пример:

let tagResolver = [
    "USERNAME": "John",
]

val customTags = mapOf("USERNAME" to "John")
val tagResolver = AdaptyUiTagResolver { tag -> customTags[tag] }

Map<String, String> customTags = new HashMap<>();
customTags.put("USERNAME", "John");
AdaptyUiTagResolver tagResolver = customTags::get;

let customTags: Record<string, string> = { "USERNAME": "John" }
//and then you can pass it to createPaywallView as follows:
view = await createPaywallView(paywall, { customTags })

В этом примере USERNAME — кастомный тег, который вы добавили в дашборде Adapty при создании пейвола в формате <USERNAME/>. tagResolver гарантирует, что при встрече с этим тегом приложение динамически заменит его указанным значением — в данном случае John.

Рекомендуем создавать и заполнять tagResolver непосредственно перед показом пейвола. После создания передайте его в метод AdaptyUI, отвечающий за отображение. Подробнее о показе пейволов читайте для iOS, Android, React Native, Flutter или Unity.