Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Настройка подписки для приложений Android

Чтобы Adjust мог взаимодействовать с Google, вам необходимо предоставить набор учетных данных сервиса. В этой статье вы узнаете, как связать проект Google Cloud с консолью Play Console и авторизовать его с помощью сервисного аккаунта.

  1. Настройте уведомления разработчиков в режиме реального времени для Android в своем аккаунте Google Play. Если вы настроите уведомления сервера, Google Play Store будет уведомлять Adjust об обновлениях подписок в приложении. Таким образом Adjust сможет вовремя инициировать события подписки.
  2. Создайте открытый ключ JSON для аккаунта Google Service. JSON-ключ нужен для подключения сервисного аккаунта Google к Adjust.
  3. Предоставьте финансовый доступ к сервисному аккаунту.
  4. Подключите сервисный аккаунт Google в Adjust.

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

Что нужно знать, чтобы начать работу.

Решение для роста:

Подписки входят в пакет решений Adjust Growth. Чтобы добавить их в ваш пакет, обратитесь к своему представителю Adjust или отправьте электронное письмо по адресу sales@adjust.com.

Требования

  • Разрешения Account owner в Google Play Console.
  • Разрешения на создание тем, подписок и назначение ролей в Google Cloud Console.
  • Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust для подключения учетных данных сервисного аккаунта Google к Adjust.

Настройка уведомлений разработчиков в режиме реального времени

Создание принудительной подписки

  1. Откройте «Темы» в консоли Google Cloud.

  2. Выберите свой проект.

  3. Нажмите Создать тему .

  4. Укажите Идентификатор темы и нажмите Создать .

  5. Теперь в левой панели навигации в разделе «Pub/Sub» нажмите Подписки .

  6. Нажмите Создать подписку .

  7. Укажите Идентификатор подписки .

  8. В списке Выбрать тему Cloud Pub/Sub выберите тему, созданную на этапе 4.

  9. В разделе Тип доставки выберите Push .

  10. В поле URL конечной точки введите https://subscription.adjust.com/v3/playstore.

  11. В разделе Политика повторных попыток нажмите Повторная попытка после экспоненциальной задержки на время откладывания и введите следующие данные:

    • минимальное время задержки — 10;
    • максимальное время задержки — 600.

  12. Нажмите Создать .

Добавление участника к подписке

  1. Выберите созданную подписку и нажмите Добавить участника .
  2. В поле Новые участники введите google-play-developer-notifications@system.gserviceaccount.com.
  3. В списке Назначить роли выберите Издатель Pub/Sub .
  4. Нажмите Сохранить .

Копирование значения имени темы

  1. Откройте «Темы» в консоли Google Cloud.
  2. Выберите тему, которую вы добавили при создании принудительной подписки, и скопируйте значение имени темы.
    • Возможно, вам придется выбрать (значок стрелки вниз), чтобы просмотреть полное название темы. Затем нажмите (значок копирования), чтобы скопировать значение имени темы.

Это значение понадобится на следующем этапе.

Включение уведомлений разработчиков для приложений в режиме реального времени

  1. Откройте консоль Google Play.
  2. Выберите свое приложение.
  3. В разделе Монетизация нажмите Настройка монетизации .
  4. Прокрутите страницу вниз до раздела Счета Google Play .
  5. В разделе Управление уведомлениями нажмите Включить уведомления в реальном времени .
  6. В поле Название темы вставьте название темы, скопированное на предыдущем этапе.
  7. Нажмите Сохранить изменения .

Повторите действия 2–7 для каждого приложения, для которого необходимо настроить подписки.

Создание открытого ключа в формате JSON

Включение API Google Play Android Developer

  1. Откройте Google Play Console.
  2. Выберите существующий проект или создайте новый.
  3. Откройте API и службы > Включенные API и службы .
  4. Нажмите + Включить API и сервисы .
  5. Найдите и выберите Google Play Android Developer API , а затем нажмите Включить .
  6. Нажмите Создать учетные данные .
  7. В разделе Какой API вы используете? выберите Google Play Android Developer API .
  8. В разделе К каким данным вы будете получать доступ? выберите Данные приложения и нажмите Далее .
Важно:

Для корректной работы учетных данных в Google Play Developer API может потребоваться до 36 часов.

Создание сервисного аккаунта

Добавили свой продукт в Play Console до создания сервисного аккаунта?

Важно

Чтобы создать сервисный аккаунт, выполните следующие действия:

  1. Откройте Google Cloud Console.

  2. Выберите тот же проект, который был выбран на предыдущем этапе.

  3. Откройте раздел IAM и администратор > Сервисные аккаунты .

  4. Нажмите Создать сервисный аккаунт .

  5. В разделе Сведения о сервисном аккаунте укажите название сервисного аккаунта.

    • В результате автоматически заполняется поле идентификатора сервисного аккаунта . Это электронный адрес сервисного аккаунта.

  6. Нажмите Создать и продолжить .

  7. В разделе Предоставление этому сервисному аккаунту доступа к проекту (необязательно) выберите приведенные далее роли и выберите Продолжить .

    • Администратор ключа сервисного аккаунта : роль позволяет создавать ключи сервисных аккаунтов и управлять ими.
    • Администратор Pub/Sub : роль позволяет включить уведомления сервера платформы.
    • Просмотр и мониторинг : роль позволяет следить за очередью уведомлений.

  8. Выберите Готово , чтобы вернуться на страницу «Сервисные аккаунты».

В Google Cloud Console выберите Создать сервисный аккаунт.

1/2

Создание учетных данных открытого ключа

Чтобы создать учетные данные открытого ключа, выполните следующие действия:

  1. Откройте Google Cloud Console.
  2. Выберите тот же проект, который был выбран на предыдущем этапе.
  3. Откройте раздел IAM и администратор > Сервисные аккаунты .
  4. Для созданного сервисного аккаунта в разделе Действия выберите Управление ключами .
  5. Нажмите Добавить ключ > Создать новый ключ .
  6. Выберите JSON в разделе тип ключа , а затем Создать .

В настройках сервисного аккаунта выберите Управление ключами.

1/3

Предоставление финансового доступа

Чтобы дать финансовый доступ к вашему сервисному аккаунту, выполните приведенные ниже действия.

В консоли Google Cloud Console

  1. В консоли Google Cloud Console выберите тот же проект, который был выбран на предыдущем этапе.
  2. Откройте раздел IAM и администратор > Сервисные аккаунты .
  3. Для созданного сервисного аккаунта скопируйте значение Email .
    • Этот адрес электронной почты понадобится на следующем этапе.

В консоли Google Play Console

  1. Откройте Google Play Console.

  2. Выберите Пользователи и разрешения > Приглашать новых пользователей .

  3. Введите адрес электронной почты сервисного аккаунта, полученный на предыдущем этапе.

  4. В разделе Разрешения приложений добавьте свое приложение.

  5. В разделе Разрешения аккаунта выберите следующие разрешения:

    • Просмотр информации о приложении (только для чтения)
    • Просмотр финансовых данных
    • Управление заказами и подписками

  6. Нажмите Пригласить пользователя , а затем нажмите Отправить приглашение .

В Google Play Console в разделе Доступ к APIвыберите Предоставить доступ.

1/3

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

Подключение сервисного аккаунта Google в Adjust

Чтобы добавить учетные данные сервисного аккаунта Google в Adjust, выполните следующие действия.

  1. В разделе DataWorks выберите Подключения .
  2. Выберите + Новое подключение .
  3. В разделе Партнер выберите Сервисный аккаунт Google .
  4. В разделе Услуги нажмите Подписки .
  5. В поле Файл учетных данных загрузите файл JSON, полученный на этапе Генерация учетных данных открытого ключа.
  6. Нажмите Подключить .

➡️ Далее: включение подписок для приложения в Adjust.