Если сервис отправки ответил 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_eventservice workerданные дошли до веб-приложения
notification_shownкод после showNotificationзапрос на системный показ выполнен
notification_clickednotificationclickпользователь совершил действие
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_attemptedidempotency по message ID
404/410 endpointвечный failed каждый деньдеактивировать подписку
несколько подписок пользователяклик одного сравнили с тремя отправкамиуровень subscription и user отдельно

Протокольный receipt не равен клику

RFC 8030 описывает запрос receipt через `Prefer: respond-async`: подтверждение появляется после получения и acknowledgement сообщения user agent. Но конкретный браузерный push-сервис или библиотека может не предоставлять этот механизм вашему приложению в удобном виде. Даже доступный receipt подтверждает протокольную доставку, а не показ и не чтение — продуктовые события всё равно собираются отдельно.

Контрольная рассылка идёт на известные устройства

  1. Создать пять тестовых подписок на поддерживаемых браузерах и сохранить их внутренние ID.
  2. Отправить разные message ID с коротким, но достаточным TTL.
  3. Одно устройство оставить онлайн, второе вывести офлайн до истечения TTL, третье вернуть до истечения.
  4. На четвёртом запретить уведомления после подписки, пятую подписку удалить.
  5. Сверить каждую строку по событиям, а не сравнивать только итоги двух панелей.
  6. Повторить одно логическое сообщение с тем же ID и убедиться, что отчёт не удвоился.

Дашборд показывает неизвестные исходы честно

Не превращайте отсутствие receipt в `failed`: оно может означать офлайн, истёкшее окно наблюдения, потерянный клиентский ack или ограничение платформы. Полезные категории — accepted, client-confirmed, expired, endpoint-gone и unknown. Отдельно показывайте возраст когорты и версию service worker.

Для разбора подготовьте message ID тестовой рассылки, статусы HTTP без endpoint и ключей, TTL, версию браузера/service worker, время событий в UTC и формулы метрик. Полные push endpoints и payload с персональными данными в отчёт не добавляйте.

Проверенные источники