Добавление игры

Добавить игру можно в разделе «Игры» Студии. Клик по кнопке «Добавить игру» откроет форму для создания карточки игры. Заполните все обязательные поля во вкладке "Информация" и сохраните карточку. Теперь можно перейти к дальнейшей настройке.

Основная информация

Обязательные поля:

1. Название игры. Максимальная длина 50 символов.
2. Ссылка на игру. Ссылка на билд игры, расположенный на вашем собственном сервере. Студия временно не поддерживает загрузку билдов на серверы Пикабу Игры. Если вам не подходит такой формат размещения, можно опубликовать игру через сервис GamePush с использованием их SDK и серверов для хостинга билда.
3. Поддерживаемые устройства. Выбирайте только те типы, для которых у вас адаптирован интерфейс игры.
4. Ориентация экрана. Важно для игроков на мобильных устройствах.
5. Возрастной рейтинг. Помочь определиться помогут рекомендации по выбору возрастного рейтинга
6. Основной жанр. Можно выбрать только один жанр, который точнее всего характеризует вашу игру. Если вы не согласны со списком жанров, напишите нам на games@pikabu.ru.
7. Краткое описание. Максимальная длина 250 символов.
8. Иконки игры. Загрузите квадратную и горизонтальную иконки:
   • квадратная — от 1024 на 1024 пикселей;
   • горизонтальная — от 1920 на 1080 пикселей, соотношение сторон 16x9;
   • форматы — jpg, png, webp;
   • максимальный размер 10 Мб на каждую.

Дополнительные поля:

1. Жанры. Здесь можно указать все жанры, поджанры и теги, к которым относится ваша игра. Не выбирайте всё подряд.
2. Об игре. Максимальная длина 10 000 символов. Расскажите подробно, чем хороша ваша игра.
3. Как играть. Максимальная длина 10 000 символов. Опишите особенности управления и геймплея. Дайте игрокам чёткую инструкцию.
4. SEO-описание. Максимальная длина 250 символов. Используется для оптимизации страницы игры в поисковых системах.
5. Скриншоты. Максимум 10, но оптимально загрузить до 5 изображений.
   • от 1280x720 пикселей для горизонтальных и от 720x1280 для вертикальных;
   • соотношение сторон 16:9 или 9:16;
   • форматы jpg, png, webp;
   • максимальный размер 10 Мб на каждое изображение.

Внутриигровые товары

Словарь товаров, доступных для покупки игроками.

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

Товары можно загрузить из CSV-файла или добавить вручную.

Добавление товаров

Массовая загрузка

Основной способ добавления товаров — загрузка CSV-файла, подготовленного по шаблону. Так можно добавить сразу много товаров.

Во вкладке «Внутриигровые товары» карточки игры нажмите «Загрузить». В открывшемся окне можно загрузить файл с товарами и скачать шаблон с демонстрационными данными.

Столбцы CSV-файла:

• id — уникальный идентификатор товара. Задайте его самостоятельно в удобном формате: по нему SDK определяет, какой товар начислить или списать игроку. Максимальная длина — 250 символов;
• name — название товара. Максимальная длина — 50 символов;
• type — тип товара. Допустимые значения: consumable и non_consumable. Максимальная длина — 250 символов;
  • Расходуемый (consumable) — игрок может купить такой товар несколько раз и потратить. Например, кристаллы или сундуки;
  • Постоянный (non_consumable) — игрок может купить такой товар один раз и не может потратить. Например, отключение рекламы;
• description — краткое описание. Максимальная длина — 250 символов. Необязательное поле;
• price — цена товара в рублях. Для разделения рублей и копеек используйте точку. Рекомендуем указывать копейки как 00. Стоимость после загрузки округляется до целого числа.

Максимальный размер файла — 10 МБ. Поддерживается только формат CSV.

ℹ️

Товары импортируются построчно, сверху вниз. Если у нескольких строк одинаковый id, в каталоге останется товар с данными из последней такой строки. Проверьте файл на дубликаты перед загрузкой.

Если в каталоге уже есть товар с id из файла, все его поля заменяются значениями из файла.

Загруженный файл не заменяет каталог. Уже добавленные товары в каталоге сохраняются. Например, если в каталоге есть товар с id A, а в файле — товары с id B и C, после загрузки в каталоге будут все три товара: A, B и C.

Добавление вручную

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

Чтобы открыть форму создания товара, нажмите стрелку вниз справа от кнопки загрузки товаров и выберите «Добавить вручную»:

• ID. Задайте идентификатор товара самостоятельно в удобном формате: по нему SDK определяет, какой товар начислить или списать игроку. Максимальная длина — 250 символов;
• Название. Максимальная длина — 50 символов;
• Тип:
  • Расходуемый (consumable) — игрок может купить такой товар несколько раз и потратить. Например, кристаллы или сундуки;
  • Постоянный (non_consumable) — игрок может купить такой товар один раз и не может потратить. Например, отключение рекламы;
• Краткое описание. Максимальная длина — 250 символов. Необязательное поле;
• Цена. Стоимость товара для игрока в рублях.

Покупки игроков

В эту вкладку попадают все игроки, которые совершили хотя бы одну покупку в игре. Здесь можно посмотреть историю покупок игрока: какие товары покупал и когда, статусы покупок.

Раздел доступен только в режиме просмотра. Отменить покупку или доначислить товар, к сожалению, не выйдет.

Тестирование

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

По тестовой ссылке SDK будет работать в режиме разработчика с заглушками вместо рекламных баннеров и формы приёма платежей и расширенным логом сообщений в консоли браузера.

Тестовая страница представляет из себя демо-страницу игры с информацией об игре и основным функционалом страницы. Это позволит лучше понять опыт игрока и протестировать разные сценарии взаимодействия игры с площадкой.

ℹ️

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

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

Секретный ключ

Именно в этой вкладке карточки игры Студии можно сгенерировать ключ для валидации данных покупок и игроков.

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

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

ℹ️

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