Начальная интеграция с Google Play
Подключите аккаунт Google Play к Adapty, чтобы наши серверы могли читать продукты из Play Store, валидировать покупки и получать события подписок Android.
Каждый стор подключается отдельно, и эти подключения независимы друг от друга. Если ваше приложение также доступно в App Store, настройте интеграцию App Store Connect.
Настройка занимает около часа. Встроенный онбординг в дашборде Adapty охватывает те же шаги, если вы предпочитаете работать в одном окне.
Прежде чем начать
В отличие от Apple, Google разделяет свою экосистему для разработчиков на два отдельных продукта — Google Play Console и Google Cloud Console — и данная настройка затрагивает оба из них.
Что в этом участвует
- Сервисный аккаунт: аккаунт Google для машин, а не людей. Вам нужно создать новый сервисный аккаунт, чтобы предоставить Adapty доступ к вашим консолям Google Cloud и Google Play.
- Google Cloud Console: универсальная инфраструктурная платформа Google. У Play Store нет собственных учётных данных API, поэтому они создаются здесь. Используйте Cloud Console, чтобы включить Developer APIs, создать сервисный аккаунт и назначить ему часть необходимых разрешений. Они нужны Adapty для получения данных о продлениях, отменах и возвратах. Здесь же можно скачать файл ключа сервисного аккаунта, который позволяет Adapty пройти аутентификацию в Google.
- Google Play Console: место, где вы публикуете приложение и продаёте подписки. Используйте Play Console, чтобы назначить сервисному аккаунту оставшиеся необходимые разрешения. Они нужны Adapty для чтения ваших продуктов и валидации покупок. Кроме того, здесь включаются уведомления разработчика в реальном времени (RTDN) — это канал связи между Play Store и Adapty.
Необходимые права доступа
| Консоль | Что нужно |
|---|---|
| Google Cloud Console | Project Creator (roles/resourcemanager.projectCreator) для создания проекта, если у вас его нет. Service Account Creator (roles/iam.serviceAccountCreator) для создания сервисного аккаунта и Project IAM Admin (roles/resourcemanager.projectIamAdmin) для выдачи ему прав на уровне проекта. Owners могут делать всё это без дополнительных настроек. |
| Google Play Console | Admin (all permissions) — включает право приглашать пользователей, которое необходимо для приглашения сервисного аккаунта. |
Google по умолчанию выдаёт роль Project Creator всем участникам новой организации, так что она у вас, скорее всего, уже есть. В организациях с жёсткими ограничениями её могут отозвать.
Необходимые ресурсы
Проект Google Cloud. Создайте его, если у вас его ещё нет, или используйте уже существующий проект. Проект нужен для того, чтобы включить Developer API и создать сервисный аккаунт для Adapty.
Проект не зависит от вашего приложения в Play Console. Один проект может управлять коммуникациями нескольких приложений. Каждое приложение получает собственный топик — очередь сообщений — внутри проекта.
При подключении сервисов Google к Adapty важно использовать один и тот же проект на всех этапах. Выбирайте проект, принадлежащий команде, а не личный — ключ и топик хранятся там на весь срок жизни приложения.
Чеклист первоначальной интеграции
- Включите Developer APIs в Google Cloud Console.
- Создайте сервисный аккаунт в Google Cloud Console.
- Выдайте сервисному аккаунту необходимые разрешения в Google Play Console.
- Сгенерируйте файл ключа сервисного аккаунта в Google Cloud Console.
- Загрузите файл ключа и имя пакета в Adapty через дашборд Adapty. Новый сервисный аккаунт активируется минимум через 24 часа, и до этого момента Adapty не сможет читать ваши продукты — чтобы не ждать, отредактируйте и сохраните описание любого продукта в Google Play Console.
- Включите Real-time developer notifications (RTDN) в Google Play Console, используя имя топика, которое генерирует Adapty.
- Установите SDK Adapty для каждого фреймворка, который использует ваше приложение:
- Протестируйте встроенные покупки на реальном устройстве перед релизом.
Следующие шаги
После настройки интеграции вы можете начать использовать возможности Adapty.
Для показа пейволов потребуется дополнительный код в приложении: как минимум отобразите пейволы и обработайте процесс покупки, если вы рендерите пейволы самостоятельно.
Перед релизом приложения пройдитесь по чеклисту перед релизом.