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

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

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

Изменения конфигурации безопасно вносить только на этапе Sandbox, пока приложение не вышло в продакшн с установленным 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 (в App Store Connect называется Issuer ID) — специальный идентификатор эмитента, создавшего токен аутентификации. In-App Purchase Key ID (в App Store Connect называется Key ID) — уникальный идентификатор криптографического ключа, созданного в разделе Генерация ключа для встроенных покупок в App Store Connect.

  1. Откройте App Store Connect и перейдите в раздел Users and Access → Integrations → In-App Purchase.
  2. В списке Active найдите ключ, созданный в разделе Генерация ключа для встроенных покупок в 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, скачанный в разделе Генерация ключа для встроенных покупок в 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 shared secret

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. После этого подраздел станет виден и Adminам.

  1. Нажмите кнопку Manage.
2d8b4c0-shared_secret_apple_copy.webp

  1. В открывшемся окне App-Specific Shared Secret скопируйте Shared Secret. Если shared secret не отображается, сначала нажмите кнопку Manage или Generate (в зависимости от того, какая доступна), а затем скопируйте Shared Secret.

  2. Вставьте скопированный Shared Secret в поле App Store shared secret в дашборде Adapty.

4f9624d-shared_secret.webp
  1. Нажмите кнопку Save в дашборде Adapty, чтобы подтвердить изменения.

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

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

  1. В App Store Connect перейдите в Users and Access > Integrations > Team keys и нажмите +.
app-store-connect-api.webp
  1. В окне Generate API key введите название ключа и предоставьте ему доступ 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.

Что дальше