Пользовательские теги в Paywall Builder

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

Этот раздел описывает новый Paywall Builder, совместимый с iOS, Android и React Native SDK версии 3.0 и выше, а также Flutter и Unity SDK версии 3.3.0 и выше. Информацию о старом Paywall Builder, совместимом с Adapty SDK v2.x и более ранними версиями, см. в статье Пользовательские теги в старом Paywall Builder.

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

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

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

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

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

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

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

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

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

Несколько важных моментов:
- В Paywall Builder Adapty пользовательские теги заключены в угловые скобки (<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.