Реализация Introductory Offers (скидка на первый период) в мобильном приложении

Реализация Introductory Offers (скидка на первый период) в мобильном приложении

Introductory Offers — механизм StoreKit, который позволяет предложить новому подписчику сниженную цену или бесплатный пробный период на первый платёжный цикл. Apple поддерживает три типа: freeTrial (бесплатно), payAsYouGo (платить за каждый период по сниженной цене) и payUpFront (заплатить один раз за несколько периодов по сниженной цене). Без правильной реализации на клиенте — пользователь вводный оффер не увидит.

Настройка в App Store Connect

Introductory Offer создаётся на уровне подписки в App Store Connect → Subscriptions → [Subscription] → Introductory Offers. Нужно указать тип, длительность и цену. Важно: оффер применяется только к пользователям, которые никогда не были подписчиками этой subscription group. Apple проверяет это на сервере.

Чтение оффера через StoreKit 2

import StoreKit

// Загружаем продукт
guard let product = try? await Product.products(for: ["premium_monthly"]).first else { return }

// Проверяем наличие introductory offer
if let intro = product.subscription?.introductoryOffer {
    switch intro.paymentMode {
    case .freeTrial:
        // Показываем: "Первые 7 дней бесплатно"
        let days = intro.period.value // например, 7
        let unit = intro.period.unit  // .day
        showFreeTrialBanner(days: days)

    case .payAsYouGo:
        // Показываем: "Первый месяц за 99 ₽"
        showDiscountedPriceBanner(price: intro.displayPrice, period: intro.period)

    case .payUpFront:
        showUpFrontBanner(price: intro.displayPrice, duration: intro.subscriptionPeriod)

    @unknown default: break
    }
}

Проверка eligibility — ключевой момент

Пользователь видит introductory offer только если он eligible. Но product.subscription?.introductoryOffer не сообщает об eligibility напрямую — оффер присутствует в объекте независимо от того, имеет ли право конкретный пользователь.

Проверка через StoreKit 2:

// Проверяем статус подписки через Transaction
for await result in Transaction.currentEntitlements {
    if case .verified(let transaction) = result {
        if transaction.productID == "premium_monthly" {
            // Пользователь уже был подписчиком — оффер не показываем
            userHasBeenSubscriber = true
        }
    }
}

Альтернатива — серверная проверка через App Store Server API (/inApps/v1/subscriptions/{originalTransactionId}): сервер возвращает isInBillingRetryPeriod и полную историю транзакций, по которой можно точно определить, использовал ли пользователь introductory offer.

Не стоит полагаться только на клиентскую проверку для бизнес-логики. Золотое правило: UI-решение о показе оффера на клиенте, валидация права на оффер — на сервере через App Store Server API или RevenueCat.

Отображение в paywall UI

Типичный сценарий: одна и та же paywall-страница показывает разные варианты в зависимости от eligibility:

struct PaywallView: View {
    let product: Product

    var body: some View {
        VStack {
            if let intro = product.subscription?.introductoryOffer,
               isEligibleForIntro {
                IntroOfferBanner(offer: intro)
                    .transition(.opacity)
            }
            SubscriptionButton(product: product)
        }
    }
}

isEligibleForIntro — @State или @Published свойство, которое выставляется после асинхронной проверки транзакций.

Использование RevenueCat

Если проект уже использует RevenueCat, проверка eligibility значительно проще:

Purchases.shared.getOfferings { offerings, error in
    if let intro = offerings?.current?.monthly?.product.introductoryDiscount {
        // RevenueCat сам проверяет eligibility через StoreKit
        Purchases.shared.checkTrialOrIntroductoryPriceEligibility(
            productIdentifiers: ["premium_monthly"]
        ) { eligibilityDict in
            let eligible = eligibilityDict["premium_monthly"]?.status == .eligible
        }
    }
}

Что входит в работу

• Чтение и отображение introductory offer из объекта Product (StoreKit 2)
• Проверка eligibility через Transaction.currentEntitlements или серверную валидацию
• UI-компонент paywall с условным отображением оффера
• Тестирование через StoreKit Configuration File в Xcode (sandbox без ожидания 24 ч.)
• Логирование в аналитику: показ оффера, конверсия, тип оффера

Сроки

От 3 до 5 дней в зависимости от сложности paywall UI и наличия серверной валидации. Стоимость рассчитывается индивидуально после анализа требований.