Настройка интеграции с App Store

В этом разделе описывается, как настроить соединение между App Store и Adapty для вашего iOS-приложения. Это необходимо для отображения аналитики подписок и валидации покупок. Настройку можно выполнить во время первоначального онбординга или позже в разделе App Settings дашборда Adapty.

Хотя вы могли настроить интеграцию мобильного приложения с Adapty во время онбординга, эти настройки можно изменить позже в разделе App settings.

Изменения конфигурации можно безопасно вносить во время фазы песочницы, пока ваше мобильное приложение не вышло в релиз с установленным Adapty SDK. Изменения после релиза могут нарушить флоу покупок в приложении.

Шаг 1. Укажите Bundle ID и Apple app ID

Bundle ID — уникальный идентификатор вашего приложения в App Store. Он необходим для базовой функциональности Adapty, например для обработки подписок.

  1. Откройте App Store Connect. Выберите своё приложение и перейдите в раздел General → App Information.

  2. Скопируйте Bundle ID в подразделе General Information.

  1. Откройте вкладку App settings -> iOS SDK в верхнем меню Adapty и вставьте скопированное значение в поле Bundle ID.
  1. Вернитесь на страницу App information в App Store Connect и скопируйте Apple ID.
  2. На странице App settings -> iOS SDK в дашборде Adapty вставьте этот ID в поле Apple app ID.

Шаг 2. Укажите Issuer ID и Key ID

In-app purchase Issuer ID, называемый Issuer ID в App Store Connect, — это специальный идентификатор, определяющий эмитента, который создал токен аутентификации. In-App Purchase Key ID, называемый Key ID в App Store Connect, — это уникальный идентификатор, связанный с криптографическим ключом, сгенерированным в разделе Generate In-App Purchase Key in App Store Connect.

  1. Откройте App Store Connect. Перейдите в раздел Users and Access → Integrations → In-App Purchase.
  2. В списке Active найдите ключ, созданный в разделе Создание ключа In-App Purchase в App Store Connect.
19a2868-issuer_apple.webp
  1. Скопируйте Issuer ID и вставьте его в поле In-app purchase Issuer ID в дашборде Adapty.
c2b42e7-issuer_id.webp
  1. Скопируйте Key ID и вставьте его в поле In-app purchase Key ID в дашборде Adapty.

Шаг 3. Загрузите файл In-App Purchase Key

Загрузите файл In-App Purchase Key, скачанный в разделе Создание In-App Purchase Key в App Store Connect,

88cdfff-download_inapp_file.webp

в поле Private key (.p8 file) в дашборде Adapty.

253b840-in-app_file_upload.webp

Шаг 4. Для пробных периодов и специальных предложений — настройте promotional offers

Этот шаг обязателен, если в вашем приложении есть пробные периоды или другие promotional offers.

  1. Скопируйте тот же Key ID, который вы использовали на Шаге 2, в поле Subscription key ID в разделе App Store promotional offers.
  2. Загрузите тот же файл In-App Purchase Key, который вы использовали на Шаге 3, в область Subscription key (.p8 file) в разделе App Store promotional offers.
promo-key.webp

Шаг 5. Введите общий секрет App Store

App Store shared secret, также известный как App Store Connect Shared Secret, — это 32-символьная шестнадцатеричная строка, используемая для встроенных покупок и валидации чеков подписки.

  1. Откройте App Store Connect. Выберите своё приложение и перейдите в раздел General → App Information.

  2. Прокрутите вниз до подраздела App-Specific Shared Secret.

2bd112a-shared_secret_apple.webp

Если подраздел App-Specific Shared Secret отсутствует, убедитесь, что у вас есть роль Account Holder или Admin. Если у вас роль Admin, но подраздел всё равно не отображается, попросите Account Holder приложения (того, кто создал приложение в App Store Connect) сгенерировать App Store Shared Secret для приложения. После этого подраздел станет видим и для Admins.

  1. Нажмите кнопку Manage.
2d8b4c0-shared_secret_apple_copy.webp
  1. В открывшемся окне App-Specific Shared Secret скопируйте Shared Secret. Если общий секрет не отображается, сначала нажмите кнопку Manage или Generate (в зависимости от того, какая доступна), а затем скопируйте Shared Secret.
  2. Вставьте скопированный Shared Secret в поле App Store shared secret в дашборде Adapty.
4f9624d-shared_secret.webp
  1. Нажмите кнопку Save в дашборде Adapty, чтобы сохранить изменения.

Шаг 6. Добавьте ключ App Store Connect API

Создайте ключ App Store Connect API и добавьте его в Adapty, чтобы управлять продуктами в App Store прямо из дашборда Adapty:

  1. В App Store Connect перейдите в Users and Access > Integrations > Team keys и нажмите +.
app-store-connect-api.webp
  1. В окне Generate API key window введите имя ключа и предоставьте ему доступ уровня Admin.
generate-api-key.webp
  1. Нажмите Download рядом с ключом. Обратите внимание, что скачать его можно только один раз.
download-api-key.webp
  1. В дашборде Adapty перейдите в App settings > iOS SDK и нажмите Connect API key.
connect-api-key.webp
  1. Заполните поля в открывшемся окне:
issuer-id.webp
key-id.webp
  • API key: Загрузите файл API-ключа, скачанный из App Store Connect.
app-store-connect-key.webp
  1. Нажмите Connect.

Что дальше