Реализация Introductory Offers (скидка на первый период) в мобильном приложении
Introductory Offers — мощный инструмент в StoreKit для привлечения новых подписчиков. Apple App Store Review Guidelines (Section 4.2 и 5.1) регулируют их применение. Без корректной реализации пользователь не увидит оффер, а значит — снижается конверсия. При грамотной настройке вводное предложение увеличивает конверсию в подписку на 30–50%. Мы гарантируем, что ваш paywall покажет оффер только тем, кому он действительно доступен. В этой статье разберём, как настроить и проверить eligibility, интегрировать с paywall и избежать типовых ошибок.
Типы Introductory Offers и их настройка
Apple предлагает три типа: freeTrial (бесплатно), payAsYouGo (скидка на каждый период) и payUpFront (единоразовая плата за несколько периодов). Выбор зависит от бизнес-модели: для теста продукта — freeTrial, для привлечения долгосрочных клиентов — payAsYouGo или payUpFront.
| Тип | Описание | Пример |
|---|---|---|
| freeTrial | Бесплатный период | 7 дней бесплатно |
| payAsYouGo | Скидка на каждый период в течение N периодов | Первые 3 месяца со скидкой |
| payUpFront | Единоразовая оплата за N периодов | 12 месяцев по сниженной цене |
Introductory Offer создаётся на уровне подписки: App Store Connect → Subscriptions → [Subscription] → Introductory Offers. Укажите тип, длительность и цену. Важно: оффер применяется только к пользователям, которые никогда не были подписчиками этой subscription group. Apple проверяет это на сервере. Частая ошибка — неправильно указать период: например, для freeTrial нельзя ставить продолжительность 0 дней. Длительность freeTrial обычно составляет 3, 7 или 30 дней.
Как прочитать оффер через StoreKit 2?
Сначала загружаем продукт и проверяем наличие introductory offer:
import StoreKit
// Загружаем продукт
let product = try? await Product.products(for: ["premium_monthly"]).first
// Проверяем наличие introductory offer
if let intro = product?.subscription?.introductoryOffer {
switch intro.paymentMode {
case .freeTrial:
let days = intro.period.value
let unit = intro.period.unit
showFreeTrialBanner(days: days)
case .payAsYouGo:
showDiscountedPriceBanner(price: intro.displayPrice, period: intro.period)
case .payUpFront:
showUpFrontBanner(price: intro.displayPrice, duration: intro.subscriptionPeriod)
@unknown default: break
}
}
Почему проверка eligibility критична?
Apple проверяет право на оффер на стороне сервера — Apple Developer Documentation.
product.subscription?.introductoryOfferприсутствует у каждого продукта, независимо от того, имеет ли пользователь право. Поэтому нужна дополнительная проверка. 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. Сервер возвращает isInBillingRetryPeriod и полную историю. Это надёжнее, но сложнее. Наше золотое правило: UI-решение на клиенте, валидация права — на сервере. Такой подход исключает злоупотребления и ошибки.
Как реализовать introductory offer: пошаговая инструкция
- Создайте оффер в App Store Connect. Укажите тип, срок и цену. Проверьте duration — для freeTrial он не может быть 0.
- Загрузите продукт и прочитайте offer в коде. Используйте
Product.products(for:)и проверьтеintroductoryOffer. - Проверьте eligibility. Через
Transaction.currentEntitlementsили серверный API. Для iOS 15+ используйтеeligibleForIntroOffer. - Создайте UI paywall. Отобразите баннер с условиями оффера, если пользователь eligible.
- Протестируйте. Используйте StoreKit Configuration File в Xcode для симуляции сценариев без ожидания 24 часов.
- Задокументируйте и передайте в поддержку. Укажите, какие офферы активны и как они отображаются.
Использование RevenueCat
RevenueCat берёт на себя проверку eligibility. Код становится проще:
Purchases.shared.getOfferings { offerings, error in
if let intro = offerings?.current?.monthly?.product.introductoryDiscount {
Purchases.shared.checkTrialOrIntroductoryPriceEligibility(
productIdentifiers: ["premium_monthly"]
) { eligibilityDict in
let eligible = eligibilityDict["premium_monthly"]?.status == .eligible
}
}
}
По нашим данным, переход на RevenueCat сокращает время разработки подписочной логики в 2–3 раза, а ошибки снижаются на 70%. Также RevenueCat автоматически обрабатывает восстановление покупок и уведомления.
Отображение в paywall UI
Типичный paywall условно показывает оффер:
struct PaywallView: View {
let product: Product
@State private var isEligibleForIntro = false
var body: some View {
VStack {
if let intro = product.subscription?.introductoryOffer,
isEligibleForIntro {
IntroOfferBanner(offer: intro)
.transition(.opacity)
}
SubscriptionButton(product: product)
}
.task {
await checkEligibility()
}
}
func checkEligibility() async {
isEligibleForIntro = await checkIntroEligibility()
}
}
Сравнение методов проверки eligibility
| Метод | Сложность | Надёжность | Рекомендация |
|---|---|---|---|
| StoreKit 2 (Transaction.currentEntitlements) | Средняя | Высокая (только iOS) | Для простых приложений |
| App Store Server API | Высокая | Максимальная | Для комплексных проектов |
| RevenueCat | Низкая | Высокая | Универсальное решение |
Типичные ошибки при настройке Introductory Offers
- Неверно указанная длительность freeTrial (например, 0 дней) — оффер не будет применён.
- Игнорирование eligibility — оффер показывается всем, что приводит к ошибкам при покупке.
- Отсутствие тестирования через StoreKit Configuration File — приходится ждать 24 часа для повторной проверки.
- Не учтена версия iOS:
Transaction.currentEntitlementsдоступен только с iOS 15. Для более старых версий используйте серверный API или библиотеку типа RevenueCat. - Забыли обновить paywall при изменении статуса подписки (например, после восстановления).
Что входит в работу
- Чтение и отображение introductory offer из объекта
Product(StoreKit 2) - Проверка eligibility через
Transaction.currentEntitlementsили серверную валидацию - UI-компонент paywall с условным отображением оффера
- Тестирование через StoreKit Configuration File в Xcode (sandbox без ожидания 24 ч.)
- Логирование в аналитику: показ оффера, конверсия, тип оффера
- Документация и передача знаний вашей команде
Сроки и стоимость
От 3 до 5 дней в зависимости от сложности paywall UI и наличия серверной валидации. Стоимость рассчитывается индивидуально после анализа требований. Свяжитесь с нами для получения точной оценки. Получите консультацию по реализации подписок в вашем проекте.
Мы имеем более 5 лет опыта в разработке подписочных решений для iOS и Android. Наши сертифицированные разработчики гарантируют соблюдение App Store Review Guidelines.