Добавление игры в Яндекс.Игры

[ru1000]

 

Итак, Вы уже научились добавлять свои игры в ВК (соцсеть Вконтакте) и теперь нацелились на Яндекс.Игры.

Чтобы игра могла взаимодействовать с сервисами Яндекса, необходимо добавить в неё соответствующий плагин: Yandex SDK.

В соответствующей статье, посвящённой ему можно найти перечисление всех функций этого плагина и готовый пример с их использованием.

Также, не забудьте заглянуть в список ценных советов по публикации игры в Яндекс.Игры.

Здесь же мы "пробежимся по верхам". Итак, приступим.

 

Спойлер

Для начала, добавим в игру сам плагин.

Для этого нужно скачать его на странице плагина: https://www.construct.net/en/make-games/addons/398/yandex-sdk

Сохраняем плагин в удобную нам временную папку и затем устанавливаем в редакторе Construct 3.

Установке плагинов посвящена отдельная статья: https://prodevs.ru/forum/topic/151-ustanovka-dopolnenij-v-construct-3/

По окончании установки плагин будет доступен в списке объектов, которые мы можем добавить в игру.

Добавляем его в игру, он должен появиться в нашем проекте.

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

Здесь:

• Fullscreen on start - включает полноэкранный режим. Также, будет показывать полноэкранный баннер при старте игры. В Яндекс.Играх это обычное дело, так что, галочку можно оставить, если у Вас нет каких-то особых предубеждений против такого размещения рекламы.
• Orientation — ориентация экрана в игре (Any - любая. Portaint - портретная, Landscape - альбомная).
• Lock orientation - заблокирует выбранную ориентацию.
• Metrika ID - сюда нужно будет вставить номер счётчика, который мы раздобудем чуть позже в сервисе Яндекс.Метрика.
• RTB Banners - указывает на то, что в игре будут использоваться RTB-баннеры Яндекса. Их мы тоже рассмотрим позже.

 

Спойлер

Дисклеймер: С этими моментами я пока только разбираюсь, поэтому этот раздел пока - просто набор заметок, которые я надеюсь в конце концов организовать в статью.

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

Для начала, нужно зарегистрироваться в этом сервисе: https://partner2.yandex.ru

Выбираем вкладку Для сайтов и нажимаем кнопку Присоединиться.

Сервис предложит войти в свой Яндекс-аккаунт.

Если у Вас пока нет своего аккаунта на Яндексе - то самое время его завести.

Дальше, нужно будет заполнить данные профиля своими реальными данными (они могут понадобиться для вывода заработанных средств).

 

 

Спойлер

Счётчики Метрики можно завести вот на этом сервисе: https://metrika.yandex.ru/

Регистрируемся в нём используя наш Яндекс ID (если не регистрировались ранее).

Нажимаем жёлтую кнопку Добавить счётчик.

Открывается страница, на которой нужно заполнить 3 поля:

• Имя счётчика - можете назвать его как удобно, к примеру, Игра Супер-пупер (по названию Вашей игры). Главное - чтобы потом можно было легко отличить  его от остальных счётчиков.
• Адрес сайта - адрес страницы, на которой будет расположена Ваша игра. Здесь немного сложнее, поскольку мы ещё не знаем, куда Яндекс запулит нашу игру. Но это не страшно. Можно пока задать любой в формате yandex.ru/games/play/181198 (цифры условные), а когда Яндекс присвоит адрес - поменять его на правильный.
• Часовой пояс - выбираете какой Вам ближе.

Кнопкой Дополнительные адреса можно добавить другие сайты, с которых Вы хотели бы собирать статистику в этот счётчик. Но пожалуй логичнее для этого сделать отдельные счётчики, чтобы не мешать всё в одну кучу.

Переключатель  Автоматические цели - уже включен по умолчанию. Можно его не трогать.

Переключатель Вебвизор, карта скроллинга, аналитика форм позволяет собирать подробные данные о действиях игроков в игре:

• куда они нажимали,
• как двигали мышкой,
• куда скроллили экран и т.д.

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

Затем ставим галочку Я принимаю условия Пользовательского соглашения.

И нажимаем кнопку Создать счётчик.

Нас перебросит на следующую страницу Установите код счетчика на сайт.

В разделе Выберите способ установки кода счетчика Метрики можно оставить ваниант HTML, поскольку именно в этом формате игра отправляется в Яндекс Игры.

Переключатели Электронная коммерция и Контентная аналитика для нас не совсем в тему - можно оставить выключенными.

Если открыть Дополнительные настройки, то можно увидеть ещё несколько опций.

Их тоже можно оставить как есть.

В самом конце экрана нам открыт Код счётчика. Если бы мы планировали разместить его на сайте, то скопировали бы целиком.

В нашем же случае, достаточно взять из него только номер из вот этой строчки:

<noscript><div><img src="https://mc.yandex.ru/watch/86885223"

Это число мы копируем в буфер обмена и вставляем в C3 в настройки плагина Yandex SDK в поле Metrica ID:

Возвращаемся в окно Метрики.

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

Если вдруг нам понадобится что-то изменить в настройках счётчика - нажимаем шестерёнку справа от него.

И снова попадаем на страницу настройки, где уже будет показан его номер.

А если вместо шестерёнки нажать на название счётчика

То можно посмотреть саму статистику.

 

 

Спойлер

Следующий шаг - добавление в игру событий, запускающих рекламу Яндекса.

Для этого имеет смысл завести отдельный лист событий, в котором будут храниться все функции, вызываемые из других листов событий игры.

Не мудрствуя лукаво, назовём его yandex.

Для больше универсальности нашей игры (чтобы проще было переключать её между нужными платформами) заведём переменную platform.

С её помощью мы будем указывать игре, для какой платформы она скомпилирована и соответственно, какую именно рекламу ей запускать. 

Поскольку сейчас мы делаем игру для Яндекса, то переменной задали состояние yandex. Чуть ниже нам это пригодится.

Теперь в листе событий yandex создадим главную группу и подгруппы, посвящённые действиям с Yandex SDK, которые мы планируем использовать.

Группа верхнего уровня --- --- ЯНДЕКС --- --- (назовите её как Вам удобнее) нужна для того, чтобы можно было с помощью одного условия выключить все функции Яндекса, если мы соберёмся адаптировать игру к какому-то другому сервису (например к Вконтакте).

Группа --- ПОДКЛЮЧЕНИЕ ЯНДЕКСА --- будет содержать события, связанные с подключением, авторизацией пользователя, выбором языка игры и т.д. Она нам пока не интересна, в следующих главах мы рассмотрим её подробнее

Сейчас мы сосредоточимся на группе --- РЕКЛАМА ЯНДЕКСА ---. Она у нас наполнена вот такими подгруппами:.

Рассмотрим их по очереди.

Здесь у нас работает таймер, отсчитывающий время между показами межстраничного баннера. 

Вот в этом источнике https://html5play.ru/blog/construct-3-yandex-sdk-как-пользоваться/
 утверждается, что нельзя показывать межстраничный баннер чаще 1 раза в 3 минуты.

Кто мы такие, чтобы с этим спорить?

Поэтому в данном событии у нас будет таймер, которые будет отслеживать, прошло ли N секунд с момента показа предыдущего баннера. И если ещё не прошло - то такой баннер показываться не будет.

Также заведём этому таймеру подружку - переменную, которая будет хранить предельное значение для нашего таймера:

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

Следующая группа содержит функцию запуска межстраничного баннера.

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

Далее проверяем таймер. Если он достиг предельного значения - то показываем межстраничный баннер и сбрасываем таймер перед следующим показом.

 

Далее идёт функция запуска награждаемой рекламы.

Здесь всё просто:

• Если реклама включена - показываем награждаемую рекламу.
• Если выключена - сразу даём игроку награду (завершаем уровень). Или вообще ничего не даём - на Ваш выбор.

Следующие 2 группы посвящены результату просмотра награждаемой рекламы.

• Если просмотр был успешным - выдаём награду.
• Если игрок прервал рекламу или она не загрузилась - ничего не делаем или выдаём какое-нибудь уведомление об этом.

Для вызова награждаемой рекламы запускаем вышеописанные функции в подходящем месте. Например по кнопке Пропустить (уровень):

Как видим, здесь нам пригодилась переменная platform. С её помощью мы запускаем рекламу для выбранной платформы.

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

Здесь мы запускаем межстраничный баннер и сразу же делаем переход на следующий уровень.

Таким образом, после закрытия рекламы игрок будет уже на следующем уровне.

 

Спойлер

Заходим в список приложений и добавляем наше приложение кнопкой в правом углу Добавить приложение.

Далее, заполняем все графы Черновика согласно подсказкам.

Подробности от Яндекса: https://yandex.ru/dev/games/doc/dg/console/enable-monetization.htm

Когда все пункты заполнены, нужно заглянуть во вкладку Реклама и нажать кнопку Подключить Rewarded Video.

Важно! Если не включить этот пункт, в игре не будет показываться награждаемая реклама.

Что об этом пишет Яндекс: https://yandex.ru/dev/games/doc/dg/console/add-video-block.html#add-video-block__creating

 

Спойлер

Прежде чем отправить игру на модерацию, имеет смысл протестировать, правильно ли всё работает.

Для этого воспользуемся советом из справки Яндекса вот по этому адресу:

https://yandex.ru/dev/games/doc/dg/q-and-a/moderation-and-testing.html#moderation-and-testing__testing

в раздел Как протестировать игру?

Для начала нам нужно запустить игру прямо на сайте Яндекс Игр (на других сайтах SDK работать не будет).

1. Заходим во вкладку Черновик.

2. Мотаем вниз примерно до середины экрана (раздел Исходники - Архив).

3. Загружаем архив с готовой игрой в сервис (кнопка Выбрать файл).

Примечание: Этот файл загружается один раз - для всех языков.

4. Когда файл загрузился - мотаем в конец экрана и нажимаем кнопку Сохранить.

5. После сохранения обновляем страницу, снова идём в её середину (раздел Исходники) и ждём, пока появится синяя ссылка Файл проверен.

Именно эта ссылка и открывает тестовый файл Вашего черновика на сайте Яндекс Игр.

Её адрес можно указать в настройках счётчика для Яндекс Метрики.

 

 

Спойлер

Если Ваша игра рассчитана не только на русскоязычную аудиторию (поддерживает 2 и более языков), то по правилам Яндекс Игр игра должна автоматически определять используемый язык игрока.

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

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

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

Самое важное здесь - это JS-код. Вот он отдельно (огромное спасибо @Reficul за его написание и тестирование).

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

YaGames
.init()
.then(ysdk => {
runtime.globalVars.language = ysdk.environment.i18n.lang;
});

Код возвращает в глобальную переменную language значение текущего языка в двухбуквенном формате, например, ru или en).

Дальше, проверяем, относится ли полученный язык к одному из языков стран СНГ. И если это так - задаём игре русский язык (ru), как самый распространённый в данном регионе.

Для всех остальных вариантов выводим английский (en).

Также, в руководстве Яндекса рекомендуют добавить поддержку турецкого языка (tr). Видимо, в Турции много поклонников Яндекс Игр.

Некоторые двухбуквенные коды языков можно посмотреть в Википедии: ISO 639-1

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

Ссылки на руководства по организации многоязычности в Яндексе:

Переменные окружения: https://yandex.ru/dev/games/doc/dg/sdk/sdk-environment.html

Поддержка языков и доменов: https://yandex.ru/dev/games/doc/dg/concepts/languages-and-domains.html

Чтобы протестировать результат этого условия можно использовать Яндекс Браузер.

Наверное, можно это сделать и в других браузерах, но раз уж у нас статья про SDK Яндекса, обратимся именно к нему.

Если браузер уже установлен, открываем его Настройки.

Переходим в раздел Системные.

И внизу страницы выбираем пункт: Настройки языка и региона.

Здесь мы увидим вот такое меню настроек:

Нам нужен пункт с жёлтыми плашками: Язык отображения страниц.

Эти плашки с названиями языков можно перетаскивать, меняя их очерёдность.

Если первым стоит Русский - браузер будет возвращать в игру значение ru.

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

Аналогично, можно первым поставить Английский.

Для английского языка заменяем домен yandex.ru на yandex.com в адресе страницы.
Пример: https://yandex.com/games/play/181194?draft=true
Если он был уже открыт - обновляем эту вкладку с игрой.

Тогда браузер вернёт en и игра, переключится на английский.

Если мы теперь обновим вкладку браузера с нашей игрой - она должна автоматически переключиться на английский язык:

Если Вам повезло и всё работает - Вы ещё на шаг приблизились к публикации своей игры в Яндекс Играх.

 

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

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

В противном случае, можно часами пытаться исправить то, что уже работает, просто из-за того, браузер просто показывает Вам старую версию игры, даже если Вы обновили страницу с зажатым Shift'ом.

 

 

Спойлер

Самая приятная часть работы (или нет) - просмотр дохода от созданных игр.

Для этого заходим в раздел Статистика.

Здесь нас интересуют параметры в правой колонке: "Группировки" и "Показатели".

В разделе Группировки отчёта выбираем галочками, к примеру, "Дата - По дням" и "Приложение или сайт - Название площадки / приложения".

Нажимаем кнопку "Применить".

В разделе "Показатели" можно выбрать к примеру, "Вознаграждение".

Снова жмём "Применить".

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

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

 

 

P.S. Почему не удаляются вот эти скриншоты - я без понятия:

Изменено 21 марта, 2022 пользователем ru1000

[Aventiy]

Так, я статью добавлю и уже будет три темы по Яндексу.

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

@ReviveR200 @Sailer

Изменено 7 декабря, 2021 пользователем Aventiy

[Homelander]

1 час назад, Aventiy сказал:

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

готово. под-разделы созданы. в точности, как было на c2community. соответственно там - разделы перемещены в архив, чтобы не дублировались

[Aventiy]

@Sailer ну это не то...площадки Яндекс так и нет....все также в кучу лепить...

Хоть и лучше, чем ничего...

Изменено 7 декабря, 2021 пользователем Aventiy

[Homelander]

28 минут назад, Aventiy сказал:

площадки Яндекс так и нет

задумайся, для чего вообще создаются разделы? чтобы структурировать более 10 тем! то есть, кода у тебя есть больше 10 тем, какого-то направления, то для удобства - эти темы лучше структурировать (отобрать) и перенести в под-раздел. а щас? всего 3 темы. если для каждой площадки создать свой под-раздел (ПО, консоли, ios и тд), то представь сколько будет пустых разделов

я просто не вижу в этом необходимости

напиши более 10 тем под yandex - отдельно для тебя сделаю под-раздел яндекс платформы, прямо внутри раздела Площадки

повторюсь: раздел имеет смысл создавать, когда скапливается большое количество тем с разными направлениями. сейчас этих тем - нет

Изменено 7 декабря, 2021 пользователем Sailer

[Aventiy]

В 07.12.2021 в 11:03, ru1000 сказал:

тобы заставить её автоматически определить язык браузера, в котором запущена игра, используем условие Browser.Language

это может работает на других площадках, но в ЯИ будут менять домен, а не язык браузера

я уже говорил про это

мультиязычность в ЯИ так не делается

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

Изменено 12 декабря, 2021 пользователем Aventiy

[ru1000]

22 минуты назад, Aventiy сказал:

это может работает на других площадках, но в ЯИ будут менять домен, а не язык браузера

Немного позже поправлю здесь этот момент. Вчера нашёлся работающий вариант - описал его в своём Вопросе - в UPD:

 

[Aventiy]

@ru1000 кстати, забыл про страны снг, которые на англе играть будут теперь

Изменено 12 декабря, 2021 пользователем Aventiy

[ru1000]

1 час назад, Aventiy сказал:

@ru1000 кстати, забыл про страны снг, которые на англе играть будут теперь

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

Изменено 12 декабря, 2021 пользователем ru1000

[Nagval333]

Думаю это подходит под тему, пример пока Демо работы без плагина. Вроде как работают все функции. Кто может протестируйте.

Желательно так же смотреть в консоле что происходит, я не все вывел в текст_окне, только важные фишки и то что не забыл Если все будет Ок я выложу исходник итд. Думаю это можно будет так же прикрутить к С2 через плагин JS. Так же там простенькая система Лидерборда (открывается в другом лайоте), но по факту все данные должны перейдти в массив в С3 и дальше уже каждый как хочет может выводить. Отправка очков - приниает только те что выше преждних (записанных) данные об этом в консоле, текст_окно показвает только команды. Ревардед видео там есть выход на 3 ответа: 1- просмотренна реклама 2- не просмотренна 3-ошибка. Но по факту НЕ ПРОСМОТРЕННА не получается так как в ревардед рекламах вобще нет крестика или функции закрытия (и так во всех играх что я видел)

ДЕМО ЯНДЕКС no plugin 

 

Изменено 16 декабря, 2021 пользователем Nagval333