Лента активности друзей

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

Ленту можно увидеть:

  • •
    В разделе Игры мобильного приложения ВКонтакте для Android.
  • •
    В блоке Профиль → Уведомления раздела Игры в десктопной версии сайта.

Лента активности друзей в десктопной версииЛента активности друзей в десктопной версии

Лента помогает игре оставаться в информационном поле игрока и его друзей. Кроме того, сообщения о достигнутых уровнях и набранных очках помогают поддерживать дух соревнования и вызывают интерес других пользователей. Согласно нашей статистике, лента приносит до 20% от общего числа установок игры и до 15% от числа всех запусков. Эти числа примерно равны для каталогов игр на мобильных устройствах и для каталога игр в десктопной версии сайта.

Требования

Игра может отправлять сообщения в ленту активности только после публикации в каталоге.

Как реализовать

Чтобы отправить событие в ленту активности, выполните на стороне сервера игры API-запрос secure.addAppEvent. Параметры запроса указывают:

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

Текст сообщения формируется автоматически.

Очки

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

Параметры secure.addAppEvent для очков

  • •
    activity_id = 2
  • •
    value — набранное количество очков:
    • •
      Целое число от 1 до 10 000 000 включительно.
    • •
      Значение должно быть строго больше значения, установленного предыдущими вызовами для этого пользователя.

В случае успешного выполнения переданное значение сохраняется на стороне игровой платформы.

Уровни

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

Параметры secure.addAppEvent для уровней

  • •
    activity_id = 1
  • •
    value — достигнутый уровень:
    • •
      Целое число от 1 до 15 000 включительно.
    • •
      Значение должно быть строго больше номера уровня, установленного предыдущим вызовом для этого пользователя.

В случае успешного выполнения переданное значение сохраняется на стороне игровой платформы.

Миссии

Игра может отправлять в ленту событие о выполненной миссии. Для этого нужно вызвать secure.addAppEvent, передав activity_id, равный идентификатору миссии. Параметр value в этом случае не требуется.

Подробнее — в разделе Миссии.

Особенности использования

  • •
    Добавление событий в ленту активности не требует дополнительного подтверждения или согласования с пользователем, упоминаемым в сообщении.
  • •
    Игра должна отправлять события в ленту только в связи с непосредственными действиями и достижениями пользователя в игровом процессе, например прохождение этапа, улучшение персонажа.
  • •
    Запрещено отправлять достижения за пассивную активность: действия друзей, полученные подарки или бонусы без участия игрока.
  • •
    Платформа сохраняет информацию о достигнутом уровне или количестве очков.
    • •
      Для уровней и очков каждое следующее значение value должно быть строго больше предыдущего, иначе метод вернёт ошибку.
    • •
      Максимальное значение уровня в игре — 15 000, максимальное количество очков — 10 000 000.

Материалы по теме