Документация Игровые сообщения

Игровые сообщения

Подключение игровых сообщений через Construct 3 addon API 1.1.0.0.

Настройте Android-окно

В Android-проекте откройте «Игровые сообщения», создайте объявление, предложение магазина или оценку и заполните заголовок, текст и подпись кнопки. Выберите аудиторию, момент показа, лимит, паузу и даты. Задайте светлую, тёмную или игровую тему и цвет акцента; проверьте предпросмотр, сохраните и включите окно.

Для «После уровня» выберите любой уровень или точные ID через запятую, например 5, 10, tutorial_1. Они должны совпадать со значением из игры. Выберите «Закрыть сообщение», «Открыть магазин игры» или «Открыть ссылку»; для ссылки нужен URL.

SDK DK Builder

Использование в Construct 3

Запустите DK Push через Auto initialize или Initialize. Установите Use worker: No. Дополнительный интеграционный скрипт не нужен. Request notification permission используется для push-уведомлений; игровые сообщения не требуют push-разрешения.

DK Push → Show message
Trigger: Level complete
Level ID: Level
Delay: 500

Manual запрашивает сообщение в выбранный игрой момент. Session start вызывается при готовности игры. Level complete — после завершения уровня. Trigger должен совпадать с настройкой в DK Push.

Level ID необязателен. Передайте числовую или строковую переменную уровня, а не её имя в кавычках. Идентификаторы выбранных уровней в DK Push должны совпадать с переданным значением.

Вызывайте Show message после окончания рекламы и перехода между уровнями. Delay задаётся в миллисекундах; аддон ждёт непрерывной активности, видимости документа, регистрации устройства и отсутствия другого окна DK Push. Ваш рекламный SDK ему неизвестен.

Кампания DK Push определяет тип: объявление, предложение магазина или оценка. Одно действие Show message запрашивает подходящий тип; опрос оно не запрашивает.

Предложение магазина

On in-app action: проверьте DKPush.InAppAction = "open_store" и перейдите на layout магазина. Игра открывает свой магазин; Open link открывает настроенную внешнюю ссылку.

Оценить уровень

Игрок выбирает 1–5 звёзд и нажимает настроенную кнопку. DK Push записывает rated перед открытием заданного внешнего URL. Оценка не превращается в обычный клик; события действий игры остаются доступными.

On rating submitted: DKPush.InAppRating возвращает оценку от 1 до 5. Закрытие окна не считается оценкой.

Используйте On in-app shown и On in-app closed для управления вводом при показе окна. Игра сама решает, приостанавливать ли таймеры или музыку.

Опросы

Опросы вызываются через Show survey с теми же параметрами Trigger, Level ID и Delay. Подробнее — в отдельной документации опросов.

DK Push → Show survey
Trigger: Level complete
Level ID: Level
Delay: 500
Опросы