Web Push без плагина
Подключите любой HTTPS-сайт через общий SDK сайта и браузерные уведомления.
1. Добавьте сайт
Создайте проект «Веб-сайт» и откройте «Настройки проекта → Сайты». Добавьте origin, например https://example.com. Не вводите почту или путь страницы. Протокол, домен и порт должны совпадать с адресом посетителей; варианты с www и без www — разные origin.
В production используйте HTTPS. Для локальной разработки можно использовать http://localhost:3000; этот origin тоже нужно добавить. Web Push не использует Firebase или аддон Construct.
2. Создайте ключ и настройте Web Push
В «Настройки проекта → Подключение DK Push» создайте SDK-ключ либо вставьте полный существующий ключ и проверьте его. Ключ должен принадлежать этому проекту и иметь devices:write и events:write. Копируйте готовый код только после проверки: сервер не может восстановить полный ключ из хеша.
В блоке Web Push укажите название настройки и контактную почту, затем создайте VAPID-ключи. Приватный ключ остаётся на сервере DK Push; браузер получает только публичную конфигурацию подписки.
3. Разместите service worker на своём домене
Скачайте dk-push-sw.js и загрузите в корень сайта. Откройте https://ваш-домен/dk-push-sw.js: должен отображаться JavaScript, а не главная страница, форма входа или перенаправление. SDK размещён у DK Push, но worker должен находиться на вашем origin.
Скачать dk-push-sw.jsЕсли у сайта уже есть PWA service worker с областью /, сначала проверьте существующее подключение. Не заменяйте worker PWA вслепую.
4. Установите SDK сайта один раз
Вставьте проверенный код из настроек проекта в общий HTML-шаблон перед </body>, чтобы он подключался один раз на каждой странице. Не подключайте дополнительно dk-web-push.js или dk-surveys.js вручную: dk-web.js загружает их и использует общую идентичность посетителя.
Пример ниже показывает только структуру. YOUR_PROJECT_ID и YOUR_FULL_SDK_KEY — заполнители, а не рабочие данные. Готовый код берите в настройках своего проекта.
<!-- Structure only: NOT ready to install. Replace both YOUR_* values. -->
<script src="https://push-dk.ru/sdk/dk-web.js"
data-api-url="https://api.push-dk.ru"
data-project-id="YOUR_PROJECT_ID"
data-sdk-key="YOUR_FULL_SDK_KEY"
async></script>5. Собирайте подписки
В «Настройки проекта → Web Push → Запрос подписки» включите предложение, задайте задержку 3–300 секунд и повтор через 1–30 дней после «Не сейчас». Обычный SDK показывает предложение; системный запрос браузера открывается только после нажатия основной кнопки.
Либо отключите автоматическое предложение и используйте свою кнопку. Разместите следующую кнопку и скрипт после кода SDK. Разрешение запрашивается только по нажатию; кнопка доступна после готовности SDK. Замените английские подписи и сообщения своими текстами.
<button type="button" id="dk-subscribe" disabled>Enable notifications</button>
<p id="dk-subscribe-result" role="status"></p>
<script>
const button = document.getElementById("dk-subscribe");
const result = document.getElementById("dk-subscribe-result");
function updateButton() {
const status = window.DKPush?.webPush?.status;
button.disabled = !["ready", "unsubscribed", "permission-default", "error"].includes(status);
if (status === "subscribed") result.textContent = "Subscribed";
if (status === "permission-denied") {
result.textContent = "Allow notifications in your browser's site settings.";
}
}
window.addEventListener("dk-web-push-status", updateButton);
updateButton();
button.addEventListener("click", async () => {
try {
const subscribed = await window.DKPush.webPush.subscribe();
result.textContent = subscribed ? "Subscribed" : "Permission not granted";
} catch (error) {
result.textContent = "Could not subscribe. Please try again.";
console.warn(error);
} finally { updateButton(); }
});
</script>Для отписки через свой элемент управления вызовите DKPush.webPush.unsubscribe() после готовности SDK. Если разрешение запрещено, посетитель должен изменить его в настройках сайта в браузере; SDK не может обойти отказ.
6. Отправьте тест и кампанию
- Откройте сайт в поддерживаемом браузере, нажмите кнопку подписки и разрешите уведомления. В DK Push → «Устройства» проверьте активную подписку WEB_PUSH. Посетителю без токена push не придёт.
- Откройте «Тестовый пуш», выберите это устройство и отправьте сообщение. Проверьте получение и переход по ссылке. Доставка зависит также от настроек браузера/ОС и сети.
- Откройте кампании Web Push, создайте кампанию, заполните заголовок и текст, при необходимости ссылку, выберите всех подписчиков или сегмент и отправьте сейчас либо настройте расписание. Проверьте результат и аналитику; принятие провайдером не подтверждает получение.
Если Web Push не работает
- HTTP 401: проверьте полный активный SDK-ключ проекта. HTTP 403: проверьте права ключа и точный origin сайта. HTTP 402: проверьте доступ DK Push в «Доступ и оплата».
- Нет системного окна: проверьте Notification.permission. denied требует изменения разрешения вручную; unsupported означает, что браузер/окружение не поддерживает Web Push. Одного HTTPS недостаточно для поддержки браузером.
- Ошибка worker: проверьте /dk-push-sw.js и DevTools → Application → Service Workers. Таймаут SDK: проверьте доступность push-dk.ru и api.push-dk.ru, а также разрешения CSP сайта для скрипта и запросов API.