Получение пейволов Paywall Builder и их конфигурации в iOS SDK

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

Обратите внимание, что этот раздел относится к пейволам, настроенным в Paywall Builder. Если вы реализуете пейволы вручную, обратитесь к разделу Получение пейволов и продуктов для Remote Config пейволов в мобильном приложении.

Получение пейвола, созданного в Paywall Builder

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

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

Для получения пейвола используйте метод getPaywall:

do {
    let paywall = try await Adapty.getPaywall("YOUR_PLACEMENT_ID")
    // the requested paywall
} catch {
    // handle the error
}

Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID", locale: "en") { result in
    switch result {
        case let .success(paywall):
            // the requested paywall
        case let .failure(error):
            // handle the error
    }
}

Параметры:

Параметры ответа:

Получение конфигурации отображения пейвола, созданного в Paywall Builder

После получения пейвола проверьте, содержит ли он конфигурацию отображения — это признак того, что он создан с помощью Paywall Builder. Это определит способ отображения пейвола. Если конфигурация отображения есть, обрабатывайте пейвол как созданный в Paywall Builder; если нет — обработайте его как Remote Config пейвол.

Для загрузки конфигурации отображения используйте метод getPaywallConfiguration.

guard paywall.hasViewConfiguration else {
    //  use your custom logic
    return
}

do {
    let paywallConfiguration = try await AdaptyUI.getPaywallConfiguration(
            forPaywall: paywall,
            products: products
    )
    // use loaded configuration
} catch {
    // handle the error
}

Параметры:

После загрузки покажите пейвол.

Получение пейвола для аудитории по умолчанию для ускоренной загрузки

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

Для этого можно использовать метод getPaywallForDefaultAudience, который загружает пейвол указанного плейсмента для аудитории All Users. Однако важно понимать, что рекомендуемый подход — использовать метод getPaywall, как описано в разделе Получение пейвола, созданного в Paywall Builder выше.

Adapty.getPaywallForDefaultAudience(placementId: "YOUR_PLACEMENT_ID", locale: "en") { result in
    switch result {
        case let .success(paywall):
            // the requested paywall
        case let .failure(error):
            // handle the error
    }
}

Настройка ресурсов

Для кастомизации изображений и видео в пейволе используйте пользовательские ресурсы.

Главные изображения и видео имеют предопределённые ID: hero_image и hero_video. В наборе пользовательских ресурсов вы обращаетесь к этим элементам по их ID и настраиваете их поведение.

Для других изображений и видео необходимо задать пользовательский ID в дашборде Adapty.

Например, вы можете:

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

Пример того, как передать пользовательские ресурсы через простой словарь:

let customAssets: [String: AdaptyCustomAsset] = [
    // Show a local image using a custom ID
    "custom_image": .image(
        .uiImage(value: UIImage(named: "image_name")!)
    ),

    // Show a local preview image while a remote main image is loading
    "hero_image": .image(
        .remote(
            url: URL(string: "https://example.com/image.jpg")!,
            preview: UIImage(named: "preview_image")
        )
    ),

    // Show a local video with a preview image
    "hero_video": .video(
        .file(
            url: Bundle.main.url(forResource: "custom_video", withExtension: "mp4")!,
            preview: .uiImage(value: UIImage(named: "video_preview")!)
        )
    ),
]

let paywallConfig = try await AdaptyUI.getPaywallConfiguration(
    forPaywall: paywall,
    assetsResolver: customAssets
)

Настройка таймеров, заданных разработчиком

Для использования пользовательских таймеров в мобильном приложении создайте объект, реализующий протокол AdaptyTimerResolver. Этот объект определяет, как должен отображаться каждый пользовательский таймер. При желании можно использовать словарь [String: Date] напрямую, поскольку он уже соответствует этому протоколу. Пример:

@MainActor
struct AdaptyTimerResolverImpl: AdaptyTimerResolver {
    func timerEndAtDate(for timerId: String) -> Date {
        switch timerId {
        case "CUSTOM_TIMER_6H":
            Date(timeIntervalSinceNow: 3600.0 * 6.0) // 6 hours
        case "CUSTOM_TIMER_NY":
            Calendar.current.date(from: DateComponents(year: 2025, month: 1, day: 1)) ?? Date(timeIntervalSinceNow: 3600.0)
        default:
            Date(timeIntervalSinceNow: 3600.0) // 1 hour
        }
    }
}

В этом примере CUSTOM_TIMER_NY и CUSTOM_TIMER_6H — это Timer ID пользовательских таймеров, заданных разработчиком в дашборде Adapty. timerResolver гарантирует, что приложение динамически обновляет каждый таймер с правильным значением. Например:

• CUSTOM_TIMER_NY: время, оставшееся до конца таймера, например до Нового года.
• CUSTOM_TIMER_6H: время, оставшееся в 6-часовом периоде, который начался с момента открытия пейвола пользователем.