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

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

Вот несколько примеров использования пользовательских тегов:

Отображать имя или email пользователя на пейволе.
Показывать текущий день недели для повышения продаж (например, «С четвергом!»).
Добавлять персонализированные детали о продаваемых продуктах (например, название фитнес-программы или номер телефона в VoIP-приложении). Пользовательские теги помогают создавать гибкие пейволы, которые адаптируются к различным ситуациям, делая интерфейс приложения более персонализированным и привлекательным.

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

Не забывайте добавлять фолбэки для каждой строки с пользовательскими тегами.

В некоторых случаях приложение может не знать, чем заменить пользовательский тег — особенно если пользователи работают со старой версией AdaptyUI SDK. Чтобы избежать этого, всегда добавляйте текст фолбэка, который будет подставляться вместо строк с неизвестными пользовательскими тегами. Без этого пользователи могут видеть теги в виде кода (<USERNAME/>).

Как добавить пользовательский тег к пейволу

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

Чтобы добавить пользовательский тег:

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

Несколько важных моментов:

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

После добавления пользовательского тега обязательно укажите резервную строку. Этот резервный текст будет отображаться в приложении, если оно не распознает конкретный пользовательский тег — так пользователи не увидят тег в виде кода. Резервный текст заменяет всю строку, содержащую пользовательский тег.

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

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

let tagResolver = [
    "USERNAME": "John",
] 
  
let paywallConfiguration = try await AdaptyUI.getPaywallConfiguration(
    forPaywall: paywall,
    tagResolver: tagResolver // or any other AdaptyTagResolver protocol implementation
)

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;

val customTags = mapOf(
    "USERNAME" to "John",
    "CUSTOM_TAG_NAME" to "Walter White",
    "CUSTOM_TAG_PHONE" to "+1 234 567890"
)

val view = AdaptyUI.createPaywallView(
    paywall = paywall,
    customTags = customTags
)

final customTags = {
  'USERNAME': 'John',
};

try {
final view = await AdaptyUI().createPaywallView(
    paywall: paywall,
    customTags: customTags,
);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

var parameters = new AdaptyUICreateViewParameters()
  .SetCustomTags(
    new Dictionary<string, string> {
      { "CUSTOM_TAG_NAME", "John Appleseed" }
    }
  )

AdaptyUI.CreateView(paywall, parameters, (view, error) => {
  // handle the result
});

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.