English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Настройка Retention Messaging

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

Перед началом работы

  • Добавьте ключ API App Store Connect в Adapty. Adapty использует его для регистрации URL реального времени и взаимодействия с Apple.
  • Запросите доступ у Apple и дождитесь одобрения. Без него Apple отклонит подключение.
  • Создайте хотя бы один продукт, который будут охватывать ваши сообщения.

Запросите доступ у Apple

Apple предоставляет доступ к Retention Messaging API для каждого приложения отдельно и запрашивает URL эндпоинта, который будет отвечать на запросы Apple. Adapty запускает этот эндпоинт за вас — ничего строить или хостить не нужно. Вы просто отправляете URL, который предоставляет Adapty.

  1. В дашборде Adapty перейдите в App settings > iOS SDK. Скопируйте URL из раздела Apple Retention Messaging API. Этот URL подходит как для песочницы, так и для продакшена.
  2. Откройте форму запроса Apple и отправьте её со скопированным URL.
  3. Дождитесь решения Apple. Apple проводит проверку, которая занимает до месяца. Adapty уведомит вас, когда ваше приложение будет одобрено.

До получения одобрения от Apple на странице Retention Messaging отображаются те же шаги и тот же URL.

Настройка песочницы

Apple требует сначала протестировать подключение в среде песочницы, чтобы убедиться в его надёжности перед отправкой продакшн-сообщений.

Настройка Sandbox URL

Нажмите Configure Sandbox URL, чтобы начать настройку.

Sandbox setup card with the Point your Sandbox URL to Adapty step and the Configure URL button

Adapty подключает ваш аккаунт App Store Connect к собственному эндпоинту в реальном времени. Если в App Store Connect уже задан другой URL, кнопка отображается как Replace URL.

После успешного подключения Adapty выводит подтверждение: «Sandbox URL has been configured.»

Пройдите проверку производительности

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

Important

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

  1. Купите продукт с наибольшей длительностью — годовой план, если он у вас есть — с помощью аккаунта песочницы или через TestFlight. Используйте обычный продукт из App Store Connect: создавать отдельный продукт только для песочницы не нужно.
  2. Нажмите Start Test сразу после покупки. Тест может занять до часа, и подписка должна оставаться активной до его завершения.
  3. Если тест не прошёл, совершите новую покупку и нажмите Try Again. Если тест продолжает завершаться с ошибкой, обратитесь в support@adapty.io.
Тест производительности Sandbox URL, запущенный в дашборде

Переход в продакшн

После настройки sandbox URL и успешного прохождения теста производительности Adapty позволяет отключить переключатель Sandbox mode и перейти в рабочий режим.

The Sandbox mode toggle above the messages table

Нажмите Configure Production URL. Adapty зарегистрирует свой эндпоинт в Apple для продакшна и подтвердит это сообщением «Production URL has been configured.» Если в App Store Connect уже задан другой продакшн URL, нажмите Replace URL.

Следующие шаги