Промо-акции в играх

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

Как выглядит

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

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

Текущая витрина игр

В текущей версии витрине промо-акции выглядят вот так:

Новая витрина игр

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

Как это работает

В данный блок может попасть любая игра из каталога.

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

  • блок промо-акций игр из Топа - этот блок одинаков для всех пользователей, и в него попадают игры из Топа с активными акциями;
  • блок “моих” игр - контент этого блока персонализирован для каждого пользователя. В него попадают игры пользователя не из Топа.

Создание акций

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

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

В API реализовано три метода для управления акциями в игре:

Если акция создана успешно, то в момент старта (start_time) ваше приложение появится в блоке с промо-акциями.

При создании акции есть несколько нюансов, которые обязательно стоит учесть:

  • топик в официальной группе должен быть общедоступен. Таким образом, если ваша группа закрыта, либо имеет ограничение по возрасту, вам не удастся создать акцию;
  • топик в официальной группе должен заканчиваться блоком с вашим приложением. Сделать это можно, указав в конце топика ссылку на ваше приложение вида https://ok.ru/game/SHORT_NAME.
  • убедитесь, что ваша акция начинается позже текущего времени по Москве. В ином случае акция не создастся;
  • убедитесь, что акция длится не более 3х суток. В ином случае акция не создастся;
  • настоятельно рекомендуем следовать требованию по размеру изображения акции. В таком случае ваше приложение будет показываться в блоке наиболее привлекательно для пользователя.

Требования к акциям

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

Также заметим, что рекомендуется:

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

Ограничения и лимиты

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

Также в данный момент существуют ограничения на вызов API-метода создания акции:

  • метод apps.setAppPromoInfo можно вызвать не более 5 раз за 1 месяц;
  • ошибочные вызовы метода также учитываются;
  • тестовые вызовы методов не предусмотрены. В случае, если на этапе тестирования вы достигли лимита вызовов метода, обратитесь в api-support@ok.ru

Вопросы и помощь

В случае возникновения каких-либо вопросов по работе раздела промо-акций, либо методам API, которые с ними работают, задавать свои вопросы можно по почтовому адресу api-support@ok.ru