Настройка верификации покупки для вашего приложения

Чтобы начать использовать решение для верификации покупки, вам нужно убедиться в том, что вы правильно настроили Adjust SDK в своем приложении и предоставили Adjust необходимые учетные данные для авторизации покупок в соответствующем магазине.

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

Требования

• Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust.
• Для создания учетных данных магазина приложений и управления ими:
  • Google Cloud: роль Service Account Key Admin в проекте или сервисном аккаунте;
  • App Store Connect: права Admin.

Что нужно знать

• Решение для верификации покупок предназначено только для проверки покупок в приложениях, сделанных через Google Play или Apple App Store. Оно не предназначено для проверки покупок физических предметов.
• Доступно для приложений iOS, Android и Unity.

1. Настройте Adjust SDK

Чтобы интегрировать Adjust Purchase Verification в свое приложение, убедитесь, что у вас установлена минимально необходимая версия SDK и что вы выполнили все требуемые шаги для отправки событий покупки, приносящих доход.

• Android 4.34.0 или более поздней версии
• iOS 4.34.0 или более поздней версии
• Unity 4.34.0 или более поздней версии

2. Найдите свои учетные данные для магазина приложений

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

Android:

iOS:

Чтобы найти необходимые учетные данные, следуйте инструкциям для вашей платформы магазина.

Для Android

Чтобы создать ключ аккаунта службы для проекта или аккаунта службы, ваш аккаунт пользователя должен иметь роль Администратор ключа сервисного аккаунта .

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

1. В Google Play Console перейдите к разделу API и сервисы .
2. Выберите + Включить API и сервисы .
3. В разделе Mobile выберите Google Play Android Developer API .
4. Выберите Включить .
5. Задайте необходимые учетные данные API:
   1. В разделе Включенные API и сервисы выберите Google Play Android Developer API .
   2. Выберите Создать учетные данные .
   3. В разделе Select an API выберите Google Play Android Developer API .
   4. В разделе What data will you be accessing? выберите Данные приложения .
   5. Нажмите «Далее».

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

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

2. Выберите проект Google Cloud.

3. Введите название сервисного аккаунта.

   • ID сервисного аккаунта будет сгенерирован автоматически.

4. Необязательно: добавьте описание сервисного аккаунта.

5. Выберите Создать и продолжить .

6. Предоставьте сервисному аккаунту доступ к проекту:

   1. Назначьте сервисному аккаунту роль Администратор службы Pub/Sub .
   2. Выберите + Добавить другую роль .
   3. Назначьте сервисному аккаунту роль Просмотр и мониторинг .
   4. Выберите Продолжить .
   5. Необязательно: предоставьте пользователям доступ к сервисному аккаунту
   6. Нажмите ГОТОВО .

Создание нового ключа API

1. В Google Cloud перейдите в раздел IAM и администратор .
2. Выберите Сервисные аккаунты , чтобы увидеть сервисные аккаунты для вашего проекта.
3. Для сервисного аккаунта, который вы создали, выберите Действия (значок в виде трех точек).
4. Выберите Управление ключами .
5. Выберите Добавить ключ > Создать новый ключ .
6. В качестве типа ключа выберите JSON .
7. Закрытый ключ скачивается автоматически.

Для iOS

Чтобы создавать ключи API и управлять ими, вам нужны права администратора в App Store Connect.

Найдите свой идентификатор эмитента

1. В App Store Connect нажмите на значок Пользователи и доступ .
2. Перейдите на вкладку Интеграции .
3. В меню «Тип ключа» слева выберите Покупка в приложении .
4. Вверху страницы рядом с идентификатором эмитента выберите «Копировать».

Сгенерируйте новый ключ API

Рекомендуем сгенерировать ключ API, предназначенный специально для верификации дохода от приложения в Adjust.

Выберите «+ Сгенерировать ключ API»

Дайте название новому ключу, а затем выберите «Сгенерировать».

Ваш новый ключ появится в списке активных ключей. Нажмите **Скачать** .

Подтвердите свое намерение скачать новый ключ API.

1/4

(1/4)

(2/4)

(3/4)

(4/4)

1. Нажмите Сгенерировать ключ API или значок + , чтобы создать ключ.

   • Если вы ещё не запросили доступ API в вашей учетной записи App Store Connect, сделайте это.

2. В поле Название введите название для ключа.

3. Нажмите Сгенерировать .

4. Ваш новый ключ API появится в списке активных ключей со своим идентификатором ключа.

5. В ключе, который вы сгенерировали, наведите курсор на значение в столбце «Идентификатор ключа». Нажмите на ссылку Копировать идентификатор ключа .

6. Выберите Скачать ключ покупки в приложении .

7. Нажмите Скачать , чтобы продолжить.

8. Скопируйте весь ключ API из скачанного файла.

3. Для iOS: подключите Adjust к App Store Connect

Чтобы добавить учетные данные App Store Connect в панель управления Adjust, выполните следующие действия:

1. В Adjust выберите DataWorks > Подключения .
2. Выберите + Новое подключение .
3. В списке выберите App Store Connect (покупка в приложении) .
4. В разделе «Сервисы» выберите Верификация покупки .
5. Укажите идентификатор эмитента .
6. Введите идентификатор ключа .
7. Откройте файл .p8 в текстовом редакторе и скопируйте весь закрытый ключ. Вставьте его в поле «Закрытый ключ».

4. Добавьте функцию верификации покупки в свое приложение

Теперь примените верификацию покупки для своего приложения:

1. В Adjust перейдите к разделу AppView и выберите свое приложение.

2. Перейдите на вкладку Защита .

3. В разделе Верификация покупки выберите Изменить ().

4. Переведите переключатель для верификации покупки в положение ВКЛ .

5. Предоставьте информацию, которая относится к платформе:

   • для приложений iOS: если у вас приложение iOS, вам нужно выбрать, какой аккаунт App Store Connect использовать;
   • для приложений Android: загрузите файл ключа JSON, который вы скачали ранее.

6. Нажмите Сохранить .

Вот и все, настройка завершена!

Делитесь верифицированными данными о доходах с партнерами

Решение Adjust для верификации покупок гарантирует, что только верифицированные данные о доходах будут переданы вашим партнерам. Таким образом, вы можете быть уверены в передаваемых данных и их использовании для оптимизации кампаний.

Если вы уже настроили распределение доходов с партнерами в приложении на панели управления Adjust, вам не нужно вносить никаких изменений. Adjust автоматически пересылает только те данные о доходах, для которых установлен статус verified passed.

Чтобы создать нового партнера и включить верифицированное распределение доходов в приложении, следуйте инструкциям по настройке рекламной сети в Campaign Lab. Когда вы перейдете к шагу выбора вариантов передачи данных, обязательно выберите Доходы в приложении .