Push-уведомления: легко переносите базу подписчиков и подключайте несколько провайдеров на одном домене

Мы обновили push-сервис Kadam и добавили поддержку пользовательских имен для файла Service Worker — это дает два сценария: перенос базы push-подписчиков из другой сети с сохранением аудитории и работу нескольких провайдеров на одном домене без перезаписи чужих файлов.

Почему раньше перенос был сложным

Для работы push-уведомлений рекламные сети используют Service Worker (SW) — скрипт на домене, к которому привязаны подписки. Раньше SW Kadam работал только по пути sw.js, поэтому мог перезаписать файл другого провайдера и сбросить его подписки раньше, чем пользователи успевали переподписаться.

Что изменилось в кабинете

В настройках push-блока появилось необязательное поле Custom sw.js file name, где можно задать имя Service Worker, например kadam-sw.js.

Допустимы буквы, цифры и дефисы с окончанием .js и нижнее подчеркивание. 

При некорректном значении появляется ошибка валидации с просьбой указать корректное имя. Выбранное имя сохраняется в настройках блока и подставляется при редактировании.

Не переименовывайте SW уже работающего блока: это сбросит текущие подписки. Перед сохранением кабинет покажет предупреждение.

Какой сценарий выбрать

Перенос базы из другой push-сети. Укажите в поле имя SW, которое использует текущий провайдер, и замените этот файл на SW Kadam по тому же пути. 

Несколько push-провайдеров на одном домене. Задайте для Kadam отдельное новое имя и оставьте файлы SW других провайдеров на прежних местах.

Пошаговая инструкция

1. Найдите имя файла SW текущего провайдера на домене, обычно это sw.js или service-worker.js.
2. В кабинете Kadam откройте настройки push-блока и впишите это имя в поле Custom sw.js file name.
3. Скачайте файл SW Kadam и сниппет из кабинета, разместите SW в корне домена под выбранным именем.
4. Проверьте, что файл отдаётся по адресу https://your-domain/filename.js с кодом HTTP 200 и content-type JavaScript, используйте встроенную проверку скрипта в кабинете.
5. При следующей проверке обновлений браузеры подхватят SW Kadam и автоматически переподпишут пользователей под VAPID-ключами Kadam.

Проверьте перед запуском

• ⚠️ Если Kadam подключается под новым именем, а старый sw.js все еще держит активную базу другого провайдера — оставьте оба файла в корне домена: ошибка 404 на старом SW сбросит его подписки.
• ⚠️ Пользовательские имена SW работают только при прямом встраивании сниппета — в режиме прокси-домена всегда используется стандартный sw.js.
• ✅ Файл отдается по адресу https://domain/filename.js (HTTP 200, content-type JS).
• ✅ Встроенная проверка скрипта в кабинете проходит успешно.
• ✅ При открытии https://domain/filename.js виден корректный код скрипта.

Обновление уже доступно в кабинете паблишера вместе с подробной инструкцией по настройке. 

Если вам потребуется помощь, обратитесь к своему менеджеру Kadam:

Telegram: @varvara_kadam
Email: v.dikareva@kadam.net

FAQ

Можно ли перенести в Kadam базу подписчиков из другой рекламной сети?
Да. Укажите в поле Custom sw.js file name имя SW прежнего провайдера и замените этот файл на SW Kadam по тому же пути.

Можно ли использовать Kadam вместе с другим push-провайдером?
Да. Задайте для Kadam отдельное имя SW и не удаляйте файлы, через которые работают другие провайдеры.

Можно ли изменить имя Service Worker после запуска?
Переименование работающего SW сбрасывает подписки, поэтому менять имя у действующего блока нельзя, кабинет предупредит при попытке.