Реализация веб-пейволов в Unity SDK

Прежде чем начать, убедитесь, что вы настроили веб-пейвол в дашборде и установили Adapty SDK версии 3.14 или выше.

Открытие веб-пейволов

Если вы работаете с пейволом, разработанным самостоятельно, для работы с веб-пейволами необходимо использовать метод SDK. Метод Adapty.OpenWebPaywall:

Генерирует уникальный URL, позволяющий Adapty связать конкретный показанный пейвол с конкретным пользователем и веб-страницей, на которую он перенаправляется.
Отслеживает возвращение пользователя в приложение, а затем с короткими интервалами вызывает Adapty.GetProfile, чтобы определить, обновились ли права доступа профиля. Таким образом, если платёж прошёл успешно и права доступа обновились, подписка активируется в приложении почти мгновенно.

Adapty.OpenWebPaywall(
    product,
    (error) =>
    {
        if (error != null)
        {
            Debug.LogError($"Failed to open web paywall: {error.Message}");
        }
        else
        {
            Debug.Log("Web paywall opened successfully");
        }
    }
);

Существует две версии метода OpenWebPaywall:

OpenWebPaywall(product) — генерирует URL по пейволу и добавляет данные о продукте к URL.
OpenWebPaywall(paywall) — генерирует URL по пейволу без добавления данных о продукте к URL. Используйте её, когда продукты в пейволе Adapty отличаются от продуктов в веб-пейволе.

Обработка ошибок

Код ошибки	Описание	Рекомендуемые действия
`AdaptyErrorCode.WrongParam`	У пейвола или продукта не настроен URL для веб-покупки, либо не удалось открыть URL в браузере	Проверьте сообщение об ошибке для получения подробностей. Убедитесь в правильности настройки пейвола/продукта в дашборде Adapty или проверьте настройки устройства.
`AdaptyErrorCode.DecodingFailed`	Не удалось корректно закодировать параметры в URL	Убедитесь, что параметры URL корректны и правильно отформатированы

Проверьте свойство Message ошибки, чтобы узнать подробности о причине сбоя: WrongParam может указывать на несколько разных проблем (отсутствующий URL покупки, ошибка открытия браузера и т. д.).

Открытие веб-пейволов во встроенном браузере

Открытие веб-пейволов во встроенном браузере поддерживается начиная с Adapty SDK v3.15.

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

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

Чтобы включить эту возможность, передайте AdaptyWebPresentation.InAppBrowser в метод OpenWebPaywall:

Adapty.OpenWebPaywall(
    product,
    AdaptyWebPresentation.InAppBrowser, // default — ExternalBrowser
    (error) =>
    {
        if (error != null)
        {
            Debug.LogError($"Failed to open web paywall: {error.Message}");
        }
        else
        {
            Debug.Log("Web paywall opened successfully");
        }
    }
);