Как выглядит

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

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

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

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

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

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

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

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

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

• • для создания и обновления акции;
• • для проверки текущей акции;
• • для удаления текущей акции.

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

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

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

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

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

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

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

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

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

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

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

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

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