ym88659208ym87991671
Заполняем информацию о проекте | Документация для разработчиков

Заполняем информацию о проекте

Обновлено 3 мая 2024

Для дальнейшей публикации приложения в каталоге нужно заполнить дополнительную информацию. Это можно сделать в Studio в настройках проекта:

  1. Перейдите в Studio.
  2. Откройте созданный проект.
  3. Перейдите на вкладку Параметры в панели управления слева.
Параметры приложения

Основные настройки

На этой вкладке вы можете указать базовую информацию о смартапе.

Обязательные для заполнения поля: Название смартапа, Сценарий смартапа и Хостинг фронтенда. Об остальных полях читайте в разделе Основные настройки.

Название смартапа

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

Название должно соответствовать требованиям. Оно может состоять из нескольких слов. Максимальная длина — 50 символов. Вы можете указать название бренда, если вы представляете бренд и можете это подтвердить.

Сценарий смартапа

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

В раскрывающемся списке Тип сценария нужно выбрать инструмент, с помощью которого создан сценарий: Graph, Code или SmartApp API. Для смартапов типа Canvas App также доступен пункт Готовый сценарий, который позволяет подключить базовый сценарий обработки голоса.

Если сценарий разрабатывается в Graph или Code, в списке Сценарий выберите или создайте проект. Затем выберите версию проекта.

При выборе инструмента SmartApp API в поле Внешняя ссылка укажите адрес сервера, который будет обрабатывать HTTP-запросы. Для заполнения поля используйте:

  • только доменное имя;
  • протокол https;
  • доменные зоны на кириллице или латинице (ru, com, рф и т. д.).

Вы можете разместить вебхук на собственном сервере или на нашем. Ваш сервер должен быть настроен на прием POST-запросов. Для отладки вы также можете разместить вебхук локально на компьютере.

Хостинг фронтенда

В поле Хостинг фронтенда вы можете добавить веб-приложение со статичным контентом. Загрузите в поле архив или укажите cсылку на веб-приложение. Настройка доступна только для смартапа типа Canvas App.

При загрузке архива убедитесь, что:

  • размер архива — до 50 Мб,
  • расширение — zip.

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

Приложение должно использовать действительный SSL-сертификат, подписанный доверенным центром сертификации. Для локального тестирования и отладки веб-приложений используйте Assistant Client.

Настройки каталога

На этой вкладке вы можете указать информацию о Canvas App для каталога приложений.

Подробное описание полей, в том числе необязательных, читайте в разделе Каталог.

Короткое описание смартапа

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

Длина описания — от 20 до 84 символов.

Описание смартапа

В поле Описание смартапа расскажите подробнее о своем приложении: какие задачи оно решает и чем будет полезно. Это описание должно расширять суть из поля Короткое описание смартапа.

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

Категории

Выберите до двух категорий, к которым относится приложение. Например, если у вас детская игра, ее можно добавить в категории «Для детей» и в «Игры».

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

Примеры запуска смартапа

В блоке Примеры запуска смартапа укажите примеры фраз, которые будут отображаться пользователям в каталоге приложений. Этими фразами пользователи могут запустить приложение. Настроить команды запуска можно в поле Активационные имена.

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

Иконка смартапа

Иконка — это визуальное представление вашего продукта или бренда. Иконка отображается в каталоге приложений. Требования к иконке:

  • Размер файла — не более 250 Кб.
  • Размер изображения — 240 × 240 px.
  • Формат файла — jpg, bmp, png.

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

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

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

Превью

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

Общие требования к загружаемым файлам:

  • Допустимое количество файлов — от 2 до 5.
  • Формат файла jpg, png.
  • Размер файла до 2 Мб.

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

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

Модерация и поддержка

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

Инструкция для тестирования

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

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

Частые вопросы и возможные ошибки

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

  • ошибки в сценариях;
  • недоработанные или отсутствующие функции;
  • отсутствие некоторых сценариев или разделов;
  • ограничения в работе;
  • особенности по произношению фраз и т. д.

Продвижение

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

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