Тестовые награды

Play Billing Lab – это сопутствующее приложение, которое помогает тестировать интеграцию с платежной системой Google Play. Вы можете использовать предварительное тестирование покупок вне приложения в Play Billing Lab, чтобы убедиться, что ваш сервер правильно настроен для обработки товаров, приобретенных вне приложения, включая награды Play Игр.

Предварительная версия функции позволяет выбрать товар или специальное предложение, которые будут показываться за пределами приложения, например на странице сведений о нем в Google Play, и проверить весь процесс получения и предоставления права на контент.

Требования

Прежде чем тестировать в Play Billing Lab процессы покупок вне приложения, чтобы проверить настройки для наград Play Games, убедитесь, что выполняются следующие требования:

1. Зарегистрируйтесь в программе раннего доступа к наградам Play Games.

2. Статус лицензированного тестировщика. Ваш тестовый аккаунт должен быть зарегистрирован как лицензированный тестировщик игры. Подробную информацию можно найти в документации для лицензированных тестировщиков Google Play.

   Примечание. Приложение Play Billing Lab доступно всем пользователям, но настраивать и активировать переопределения OOAP могут только лицензированные тестировщики разработчиков, участвующих в программе раннего доступа и добавленных в белый список.

3. Один и тот же аккаунт на разных платформах. Вы должны войти в Play Billing Lab и Google Play, используя один и тот же лицензированный аккаунт тестировщика. Если аккаунты не совпадают, Google Play может не показать переопределенный тестовый товар или специальное предложение или не завершить тестовую покупку.

Скачать и установить

Скачать и установить Play Billing Lab можно из Google Play:

• Google Play (Android): приложение Play Billing Lab
• Тестовый тип версии для веб-версии: Согласие на участие в Play Billing Lab (веб-версия)

Пошаговое руководство по интеграции и тестированию в рамках программы раннего доступа

Ниже описано, как интегрировать и протестировать награды Play Games с помощью Play Billing Lab.

Шаг 1. Запустите Play Billing Lab и войдите в аккаунт

Когда вы впервые откроете Play Billing Lab после установки:

• Нажмите Войти с аккаунтом Google.
• Выберите аккаунт Google, зарегистрированный в качестве лицензированного тестировщика вашего приложения.
• После входа вы увидите главную панель управления.

Панель управления Play Billing Lab.

Шаг 2. Перейдите к тестированию покупок вне приложения

• На панели управления найдите карточку Покупки вне приложения.
• Нажмите Тестировать, чтобы открыть экран настройки конфигурации OOAP.

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

Шаг 3. Укажите название пакета приложения и идентификатор товара

На экране настройки OOAP введите необходимые идентификаторы приложения:

1. Название пакета. Точное название пакета Android вашего приложения (например, com.example.app).
2. Тип товара. В раскрывающемся меню выберите Контент для однократных покупок (контент в приложении) или Подписка.
3. Идентификатор товара (SKU). Идентификатор контента или подписки, которые вы хотите протестировать.

Укажите название пакета приложения и идентификатор товара.

Шаг 4. Выберите подходящее предложение

После того как вы введете название пакета, идентификатор товара и тип товара, Play Billing Lab отправит запрос на бэкенд и покажет список доступных предложений для этого товара.

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

• Для контента, оплачиваемого однократно: выберите подходящий способ покупки или предложение.

  

  Выберите подходящее предложение.

Шаг 5. Запустите тестирование OOAP

Выбрав предложение, нажмите Начать тестирование. Конфигурация сохраняется и синхронизируется с бэкенд-серверами Google Play.

После активации на карточке Покупки вне приложения на панели управления появится значок Активно, а также название пакета, идентификатор товара (код SKU) и оставшийся срок действия.

• Период тестирования. Активные конфигурации тестирования OOAP по умолчанию остаются активными в течение двух часов, а затем автоматически отключаются.

• Переопределение на сервере. Пока конфигурация активна, она показывается как имеющая наивысший приоритет на различных страницах OOAP (например, на странице сведений о приложении в Google Play).

  

  Запустите проверку.

Шаг 6. Протестируйте весь процесс покупки внешних предложений

Пока тест OOAP активен в Play Billing Lab, откройте приложение Google Play, войдя в тот же лицензированный аккаунт тестировщика.

1. Очистите кеш Google Play:
   1. Откройте приложение Настройки.
   2. Нажмите Приложения > Google Play.
   3. Нажмите Хранилище и кеш, а затем – Очистить кеш и Очистить хранилище.
2. Откройте приложение Google Play.
3. Перейдите на страницу сведений о приложении.

4. Завершите тестовую покупку (оверлей Play Express). Нажмите на карточку товара. В Google Play появляется наложенное окно быстрого оформления покупки.

   • Проверьте цену, способ оплаты (тестовый способ оплаты для лицензированных тестировщиков) и сведения о специальном предложении.
   • Нажмите Купить в 1 клик.

   

   Протестируйте весь процесс привлечения пользователей.

5. Проверьте интеграцию с серверной частью:

   • Убедитесь, что после успешной покупки Google Play отправляет на ваш сервер уведомление для разработчиков в режиме реального времени (RTDN).
     • Примечание. При получении бонусов также отправляется RTDN.
   • Убедитесь, что ваш сервер вызывает Google Play Developer API, чтобы подтвердить покупку и предоставить пользователю доступ к контенту.
   • Проверьте историю покупок пользователя в приложении Google Play, чтобы убедиться, что тестовый заказ записан.

Примечание. Этот шаг необходим, чтобы ваш сервер мог обрабатывать вознаграждения. награды Play Games отправляют похожее RTDN, требуют тот же Google Play Developer API для подтверждения и предоставления разрешения, а также записывают транзакцию на сумму 0 долларов США в историю покупок пользователя в приложении Google Play.

Шаг 7. Остановите тестирование OOAP и удалите его данные

После завершения тестирования:

1. Перейдите на страницу Покупки вне приложения.
2. Нажмите Очистить тест, чтобы остановить тестирование и удалить его настройки.

Очистите тест OOAP.

Изменение тестовых конфигураций

Пока активно предварительное тестирование, вы не можете изменить название пакета, идентификатор товара, выбор специальных предложений или переопределение страны в Google Play.

Для этого нужно остановить и очистить текущее тестирование покупок вне приложения.

Как изменить товар или предложение

Если вы уже проводите тестирование OOAP и хотите протестировать другой продукт или предложение:

1. Откройте Play Billing Lab и нажмите Посмотреть на активной карточке Покупки вне приложения.
2. Нажмите Изменить, чтобы изменить название пакета, идентификатор товара или специальное предложение для тестирования.
3. Подтвердите действие, нажав Остановить тестирование. Тестирование будет остановлено, а все связанные с ним входные данные – удалены.
4. Укажите новый товар или выберите новое предложение и перезапустите тестирование.

Изменить товар или предложение.

Как протестировать локализованные цены с переопределением для стран

В Play Billing Lab можно изменить страну в Google Play, чтобы протестировать региональные цены и форматы валют. Однако изменения стран должны быть синхронизированы с тестированием OOAP:

1. Остановите активный тест OOAP. Если вы попытаетесь изменить переопределение страны, пока тест OOAP активен, в Play Billing Lab появится предупреждение о том, что сначала нужно остановить тест. Если вы нажмете Остановить тестирование, текущее тестирование покупок вне приложения будет остановлено, а входные данные удалены.

2. Задайте переопределение страны. После остановки тестирования OOAP вы можете изменить настройки страны на странице Настройки конфигурации. Выберите целевую страну (например, Японию или Великобританию) и нажмите Применить.

3. Перезапустите тестирование. Когда переопределение страны станет активным, вернитесь к карточке Покупки вне приложения, выберите товар и специальное предложение и нажмите Начать тестирование.

   На панели управления будут показаны активные переопределения для стран и активный тест OOAP.

4. Проверьте локализованную цену в Google Play. Откройте Google Play и перейдите на страницу приложения. В карточке интерфейса и на нижнем экране Play Express цена товара будет указана в местной валюте выбранной страны.

Тестируйте локализованные цены с переопределением для отдельных стран.

Устранение неполадок и часто задаваемые вопросы

Почему настроенное тестовое специальное предложение не появляется на странице сведений о приложении в Google Play?

• Проверьте аккаунт. Убедитесь, что вы вошли в один и тот же аккаунт в Google Play и Play Billing Lab.
• Белый список программы раннего доступа и статус лицензированного тестировщика. Убедитесь, что ваш аккаунт разработчика добавлен в белый список программы раннего доступа к предварительной версии Play Billing Lab OOAP и указан как активный лицензированный тестировщик в Play Console.
• Срок действия. Активные тесты OOAP действуют в течение двух часов. Откройте Play Billing Lab и проверьте, изменился ли тег на Срок действия истек. Если да, начните новый тест.

Почему при настройке товара в Play Billing Lab я не вижу специальных предложений или не могу их выбрать?

• Доступность специальных предложений. В Play Billing Lab показываются только те специальные предложения, которые доступны для покупки в вашем аккаунте тестировщика.

Почему тестовая покупка в оверлее Play Express не удалась?

• Убедитесь, что на тестовом устройстве установлена ОС Android 12 (уровень API 31) или более поздней версии и последняя версия Google Play.
• Проверьте вебхук RTDN и интеграцию API в серверной части приложения. При тестировании через Google Play покупки совершаются за пределами стандартного интерфейса приложения. Ваш бэкенд-сервер должен надежно получать RTDN-сообщения от Google Play и асинхронно подтверждать покупки.

Как остановить или очистить активный тест до истечения двух часов?

• Откройте Play Billing Lab, найдите активную карточку (Покупки вне приложения или Настройки конфигурации) и нажмите Остановить или Удалить. Подтвердите выбор. Переопределение сразу удаляется с серверов Google Play.