Помощник по Google Play Играм

Play Games Sidekick – это оверлей, который помогает удерживать пользователей в игре, показывая им подходящий контент и предложения.

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

Функции

Доступные функции Sidekick зависят от игры, статуса интеграции с сервисами Google Play Игр и участия в программе Play Points. Вот что ждет игроков:

  • Игровые утилиты. Скриншот, запись видео с экрана, трансляция на YouTube и режим "Не беспокоить".
  • Достижения. Требуется реализация достижений.
  • Игровые серии. Игровые серии.
  • Обмен баллов Play Points на баланс Google Play.
  • Бустеры Play Points и купоны. Доступны разработчикам, зарегистрированным в программе Play Points.
  • Преимущества и предложения Play Pass.
  • Квесты. Квесты доступны зарегистрированным разработчикам.
  • Официальные видео и видео авторов. Sidekick показывает видео, которые вы добавляете. Подробнее о том, как добавлять видео в Google Play и Sidekick…

Требования к программному и аппаратному обеспечению

Чтобы использовать помощника, игрокам нужно:

  • Мобильный телефон с Android 13 или более поздней версии.
  • У игрока должен быть один игровой профиль.
  • Игра должна быть установлена из Google Play.

Попробовать Sidekick

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

Включите Sidekick по умолчанию для своей игры

Создайте в Play Console выпуск для внутреннего или закрытого тестирования, чтобы проверить предварительные версии игры с Sidekick и собрать отзывы. Обратите внимание, что тестирование в закрытой бета-версии не позволяет напрямую сравнивать показатели эффективности, но остается допустимым методом базового функционального тестирования интеграции Sidekick.

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

  1. В Play Console настройте внутреннее или закрытое тестирование.
  2. Чтобы добавить Play Games Sidekick в набор App Bundle, выберите Sidekick включен по умолчанию.
  3. Проведите тестирование.
  4. Когда все будет готово, опубликуйте рабочую версию. Подробнее о том, как подготовить выпуск в несколько этапов…

Игроки смогут в любое время управлять видимостью Sidekick в настройках Google Play.

Sidekick включен по умолчанию
Добавьте Play Games Sidekick в свою игру.

Безопасное тестирование Sidekick

При интеграции Sidekick убедитесь, что оверлей работает без сбоев, не мешает игрокам и не влияет негативно на ключевые показатели, такие как стабильность игры (сбои и ошибки ANR), вовлеченность и доход. Чтобы оценить производительность перед полным запуском, используйте поэтапное внедрение на 5 % устройств.

Это руководство по тестированию позволит вам провести параллельное сравнение в рабочей среде, минимизируя риски и проверяя успешность интеграции.

Руководство по поэтапному внедрению с 5 % пользователей

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

  • Подготовьте выпуск. Интегрируйте Sidekick SDK в игру и подготовьте новую конечную сборку.
  • Начните поэтапное внедрение. Опубликуйте новую сборку в рабочей версии, используя поэтапное внедрение на 5 % в Google Play Console. Это позволит в реальном времени протестировать интеграцию Sidekick на небольшой части игроков.
  • Изолируйте данные по версии приложения. Убедитесь, что инструменты аналитики настроены на фильтрацию данных именно для той версии приложения, в которую интегрирован Sidekick.

Отслеживание эффективности и показателей

Во время поэтапного внедрения на 5 % пользователей отслеживайте производительность игры и следите за тем, чтобы основные показатели оставались стабильными. Для этого используйте Google Play Console и собственные инструменты аналитики. При отслеживании поэтапного внедрения обращайте внимание на следующее:

  • Отслеживайте вовлеченность и стабильность игры. С помощью Google Play Console убедитесь, что показатели Android Vitals (например, доля сбоев и ошибок ANR) и показатели взаимодействия с игроками остаются стабильными для новой версии приложения.
  • Отслеживайте стабильность дохода. Внимательно следите за доходом и показателями покупок в приложении, используя существующую инфраструктуру аналитики, например Google Аналитику или внутренние инструменты бизнес-аналитики (BI). Сравните когорту из 5 % пользователей, у которых есть доступ к Sidekick, с остальным трафиком, чтобы убедиться, что основная монетизация остается стабильной.

Если вы убедитесь, что помощник положительно влияет на доход, вовлеченность и стабильность, то можете смело увеличивать охват до 100 % игроков.

Управляйте видимостью Sidekick на устройстве для тестирования

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

  1. Откройте приложение "Google Play Маркет".
  2. Нажмите на значок профиля и выберите Настройки.
  3. Нажмите на меню О приложении.
  4. Нажмите на пункт Версия Google Play семь раз, пока не появится сообщение "You are now a developer!". Это включит режим «Для разработчиков» на вашем устройстве.
  5. Нажмите Общие, а затем – Для разработчиков.
  6. Включите Play Games Sidekick.
  7. Перейдите в игру, чтобы увидеть Sidekick.
Переключатель, позволяющий включить Play Games Sidekick в приложении Google Play.
Переключатель для активации Play Games Sidekick в приложении Google Play (нажмите, чтобы увеличить).

Настроить точку входа в Sidekick по умолчанию

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

Вы можете переопределить позицию точки входа по умолчанию, указав предпочтительную позицию в XML-файле ресурсов, на который ссылается файл AndroidManifest.xml, используя следующие параметры:

  • Точная позиция. Укажите точную позицию точки входа в процентах в XML-файле ресурсов.
  • Положение по краю. Укажите положение точки входа по краю в XML-файле ресурсов.

Если игрок вручную перетащит точку входа в другое место, она останется там и в следующих сеансах. Это действие имеет приоритет над настройками XML-файла.

Настройте точное положение точки входа.

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

  1. В файле AndroidManifest.xml добавьте элемент <meta-data> в элемент <application>:

    <manifest>
  <application>
   <meta-data
   android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
   android:resource="@xml/XML_RESOURCE_FILE"/>
  </application>
</manifest>

  2. Укажите местоположение точки входа в XML_RESOURCE_FILE.

    Пример файла (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
   <!-- Entrypoint default position overrides -->
   <!-- Anchored to RIGHT edge, 25% down from top -->
   <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />

   <!-- Anchored to LEFT edge, vertically centered at 50% -->
   <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />

   <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Тег <default-entrypoint-position> поддерживает следующие атрибуты:

  • orientation – ориентация экрана, которую нужно настроить. Допустимые значения:
    • landscape
    • portrait
  • horizontal-position – горизонтальный край экрана, к которому прикреплена точка входа. Допустимые значения:
    • LEFT
    • RIGHT

  • vertical-position-percent – числовое значение в диапазоне от 0 до 100 (например, "25" или "50"), которое определяет вертикальное размещение в процентах от высоты окна игры сверху. Например, "25" размещает точку входа на 25 % ниже верхнего края, а "50" центрирует ее по вертикали. Значения, не входящие в диапазон от 0 до 100, округляются до ближайшего предела.

    Значок всегда находится на небольшом расстоянии от верхнего и нижнего краев экрана и автоматически сдвигается, чтобы не перекрывать вырез для камеры или выемку на дисплее. В результате 0 помещает точку входа у верхнего края, а 100 – у нижнего.

Эти значения представляют собой физические позиции на экране. Например, LEFT закрепляет точку входа у левого края экрана, даже если на устройстве используется макет с направлением справа налево.

Правила замещения и приоритета

Чтобы задать точное положение, укажите атрибуты orientation, horizontal-position и vertical-position-percent в теге <default-entrypoint-position>:

  • Если оба атрибута (horizontal-position и vertical-position-percent) действительны, они имеют приоритет над атрибутом value в том же теге.
  • Если атрибуты horizontal-position или vertical-position-percent отсутствуют или недействительны, точка входа использует атрибут value, если он есть.
  • Если атрибут value также отсутствует или недействителен, точка входа возвращается в положение по умолчанию.

Как настроить положение точки входа, выровненной по краю

Чтобы настроить положение значка помощника, следуйте инструкциям ниже.

  1. В файле AndroidManifest.xml добавьте элемент <meta-data> в элемент <application>:

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. Укажите местоположение точки входа в XML_RESOURCE_FILE.

    Пример файла (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
  <!-- Entrypoint default position overrides -->
  <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
  <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />

  <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Допустимые значения для точки входа orientation:

  • Пейзаж
  • вертикальная ориентация

Атрибут value представляет физические позиции на экране. Например, MIDDLE_LEFT всегда закрепляет точку входа у левого края экрана, даже если на устройстве используется макет с направлением справа налево. Поддерживаются следующие допустимые значения для точек входа, выровненных по краю:

  • MIDDLE_LEFT
  • MIDDLE_RIGHT
  • TOP_LEFT
  • TOP_RIGHT
  • BOTTOM_LEFT
  • BOTTOM_RIGHT

Настройка длительности откладывания точки входа во время первого использования

По умолчанию точка входа в Play Games Sidekick показывается сразу. Вы можете отложить показ точки входа в игре на заданное время в XML_RESOURCE_FILE.

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

  1. В файле AndroidManifest.xml добавьте элемент <meta-data> в элемент <application>:

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. Укажите длительность откладывания в XML_RESOURCE_FILE.

    Пример файла (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
  <!-- Entrypoint default position overrides -->
  <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
  <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />

  <!-- Custom Snooze Period -->
  <snooze duration_seconds="300" />

  <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Максимальная продолжительность откладывания – 30 минут. Если вы укажете значение, превышающее этот порог, система автоматически установит ограничение в 30 минут.

Автоматически добавлять Sidekick ко всем загружаемым наборам App Bundle

Если вы включите Sidekick по умолчанию, он будет добавляться во все новые наборы App Bundle.

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

  1. Откройте Play Console.
  2. Выберите игру.
  3. Нажмите Тестирование > Расширенные настройки.
  4. На вкладке Play Games Sidekick выберите один из вариантов:
    • Автоматически включайте Sidekick по умолчанию в новых наборах App Bundle, которые вы загружаете.
    • Не включать Sidekick по умолчанию для новых наборов App Bundle
  5. Нажмите Сохранить изменения.

Если вы редко обновляете приложение, мы можем периодически обновлять Sidekick за вас. Вы можете в любой момент отказаться от использования Sidekick в расширенных настройках Google Play Console.

Как сделать Sidekick рабочей версией

Если вы добавите выпуск с Sidekick в рабочую версию, игроки увидят Sidekick. Игроки смогут в любое время включить или отключить Sidekick в настройках приложения Google Play.

Игры, в которых продвигается выпуск с Sidekick, соответствуют рекомендациям Level Up.

Часто задаваемые вопросы

Можно ли добавить Sidekick в игру с помощью Publishing API?

Вы можете добавить Sidekick в игру, даже если публикуете ее с помощью Google Play Developer Publishing API. Сначала настройте автоматическое добавление Sidekick ко всем загружаемым наборам App Bundle, а затем продолжайте обычный процесс выпуска. Sidekick будет добавлен в набор Android App Bundle.

В моей игре не используются наборы Android App Bundle (AAB). Что делать?

Sidekick добавляется в игры, когда вы загружаете новый набор Android App Bundle.

Если вы используете APK, добавьте Sidekick SDK в качестве зависимости.

В моей игре используется продукт для защиты от взлома. Совместим ли Sidekick с моим решением?

Мы сотрудничаем с ведущими компаниями, чтобы обеспечить совместимость Sidekick.

Если вы используете несовместимое решение для защиты от вмешательства, добавьте SDK Sidekick в качестве зависимости в APK. Если у вас есть другие вопросы, обратитесь в службу поддержки.

Почему достижения не появляются в Sidekick?

Если достижения не отображаются, проверьте следующее:

  • Черновик. Достижения в этом статусе не показываются в Sidekick.
  • Значок за достижения. Неразблокированные достижения видны всем игрокам, только если у игры есть значок за достижения. Для этого необходимо, чтобы за последние 30 дней не менее 100 уникальных игроков вызывали API достижений.
  • Разблокированные. Если у игры нет значка, игроки видят достижения, которые они уже разблокировали.