Если сервис отправки ответил HTTP 201, называйте результат `accepted_by_push_service`, а не `delivered`. RFC 8030 прямо указывает: 201 означает принятие сообщения и создание ресурса, но не подтверждает доставку user agent. Уже эта переименованная колонка часто объясняет «завышенную доставляемость» без поиска ошибки в формулах.
Web Push проходит через несколько независимых участников: ваш сервер, push-сервис браузера, user agent, service worker и системный интерфейс уведомлений. Между каждой парой возможен отдельный исход. Один общий счётчик стирает место потери и заставляет сравнивать несопоставимые числа.
Сначала договоритесь о названиях событий
| Событие | Кто его фиксирует | Что оно доказывает |
|---|---|---|
| send_attempted | сервер приложения | задание дошло до отправителя |
| push_accepted | ответ push-сервиса | сообщение принято для доставки |
| push_event | service worker | данные дошли до веб-приложения |
| notification_shown | код после showNotification | запрос на системный показ выполнен |
| notification_clicked | notificationclick | пользователь совершил действие |
| endpoint_gone | ответ 404/410 | подписку надо деактивировать |
`notification_shown` не означает, что человек заметил уведомление, а `push_event` не гарантирует показ: обработчик мог решить обновить локальные данные, упасть на JSON или не выполнить `event.waitUntil()`. Названия метрик должны сохранять это различие.
Один message ID проходит всю цепочку
{
"message_id": "01J...",
"campaign_id": "renewal-2026-10",
"subscription_id": "sub_...",
"sent_at": "2026-10-06T19:35:00Z",
"ttl_seconds": 3600
}Не используйте endpoint как публичный идентификатор: это capability URL, знание которого даёт возможность отправки и который нельзя раскрывать. В аналитике храните внутренний subscription ID или необратимый технический ключ. Message ID не меняется при retry одной логической отправки.
Service worker отправляет собственный ack
self.addEventListener('push', event => {
const msg = event.data.json();
event.waitUntil((async () => {
await recordLocally({id: msg.message_id, stage: 'push_event'});
await self.registration.showNotification(msg.title, {
body: msg.body, data: {message_id: msg.message_id}
});
await flushReceiptsWhenOnline();
})());
});Код условный: `recordLocally` и повтор отправки receipt реализуются приложением. Сетевой fetch из service worker тоже может не состояться, поэтому receipt сначала полезно сделать идемпотентным и переживающим краткий офлайн. `event.waitUntil()` продлевает жизнь обработчика до завершения переданной операции.
Процент без знаменателя ничего не объясняет
- `push acceptance` = уникальные push_accepted / уникальные send_attempted.
- `client receipt` = уникальные push_event / push_accepted, дожившие до конца TTL и окна наблюдения.
- `show rate` = notification_shown / push_event для сообщений, где показ обязателен.
- `CTR sent` = уникальные клики / уникальные принятые сообщения.
- `CTR shown` = уникальные клики / notification_shown — отдельная продуктовая метрика.
Для последнего часа часть сообщений ещё находится в TTL или ждёт офлайн-устройство. Закрывайте когорту только после согласованного окна наблюдения. Иначе свежая рассылка всегда выглядит хуже старой.
TTL, collapse и повтор меняют арифметику
| Механика | Ошибка отчёта | Как считать |
|---|---|---|
| TTL истёк | принято при отправке, но уже недоставимо | отдельно expired |
| замена сообщения/topic | две отправки, один актуальный показ | разделить attempts и logical message |
| retry после timeout | двойной send_attempted | idempotency по message ID |
| 404/410 endpoint | вечный failed каждый день | деактивировать подписку |
| несколько подписок пользователя | клик одного сравнили с тремя отправками | уровень subscription и user отдельно |
Протокольный receipt не равен клику
RFC 8030 описывает запрос receipt через `Prefer: respond-async`: подтверждение появляется после получения и acknowledgement сообщения user agent. Но конкретный браузерный push-сервис или библиотека может не предоставлять этот механизм вашему приложению в удобном виде. Даже доступный receipt подтверждает протокольную доставку, а не показ и не чтение — продуктовые события всё равно собираются отдельно.
Контрольная рассылка идёт на известные устройства
- Создать пять тестовых подписок на поддерживаемых браузерах и сохранить их внутренние ID.
- Отправить разные message ID с коротким, но достаточным TTL.
- Одно устройство оставить онлайн, второе вывести офлайн до истечения TTL, третье вернуть до истечения.
- На четвёртом запретить уведомления после подписки, пятую подписку удалить.
- Сверить каждую строку по событиям, а не сравнивать только итоги двух панелей.
- Повторить одно логическое сообщение с тем же ID и убедиться, что отчёт не удвоился.
Дашборд показывает неизвестные исходы честно
Не превращайте отсутствие receipt в `failed`: оно может означать офлайн, истёкшее окно наблюдения, потерянный клиентский ack или ограничение платформы. Полезные категории — accepted, client-confirmed, expired, endpoint-gone и unknown. Отдельно показывайте возраст когорты и версию service worker.
Для разбора подготовьте message ID тестовой рассылки, статусы HTTP без endpoint и ключей, TTL, версию браузера/service worker, время событий в UTC и формулы метрик. Полные push endpoints и payload с персональными данными в отчёт не добавляйте.