Справочник событий

Всё, что Qubix видит о посетителе, ложится в один поток событий: заход с объявления, показанная страница, установка, пуш-уведомление, конверсия, присланная партнёрской сетью. Этот поток читают скрипты, а также воронка и отчёты.

Здесь перечислены виды событий, что несёт каждое и какие ловушки стоит знать, прежде чем что-то считать.

Сначала посмотрите свои события

Имена ниже — те, что пишет продукт, но какие из них появятся у вас, зависит от того, что вы запускаете. Спросите свои данные:

JavaScript

function main() {
  const kinds = sql`
    SELECT event, count() AS n, max(event_time) AS last_seen
      FROM qubix_events
     WHERE event_time > now() - INTERVAL 30 DAY
     GROUP BY event
     ORDER BY n DESC`
  for (const k of kinds) console.log(k.event, k.n, k.last_seen)
}

Вам могут встретиться имена, которых нет в таблицах ниже: пробный трафик, сканеры, щупающие ваши домены, или события версии новее этой страницы. Незнакомое имя так и считайте незнакомым — не додумывайте его в воронку.

Трафик

Событие	Что означает	Что несёт
campaign_visit	Посетитель пришёл с объявления — вершина воронки, по одному на клик.	Полный адрес захода со всеми метками, которые поставил источник; кампанию; гео; объявление, если ссылка его несла.
render	Посетителю показана страница.	Адрес, витрину PWA, гео.
white_page	Клоака отдала безопасную страницу вместо оффера.	Адрес, кампанию, гео.
campaign_visit_sdk	Тот же приход, о котором сообщил SDK с чужого сайта, а не наше перенаправление.	Кампанию; метки в том виде, в каком прислал SDK.

Не складывайте это между собой

campaign_visit — вершина воронки. render и white_page описывают, что было показано, и один посетитель даёт их несколько. Считать клики — значит считать campaign_visit.

Установки и запуски

Событие	Что означает	Что несёт
installed	Витрина PWA установлена.	Витрину, кампанию, оффер, объявление, гео, адрес.
install_accepted	Установка принята — пишется рядом с installed.	Тот же набор.
install_blocked	Установка не состоялась: условия её не пропустили.	Тот же набор.
install_rejected	Посетитель отказался от предложения установить.	Тот же набор.
install_ios	Путь установки для iPhone, он отличается от остальных.	Тот же набор.
install_fallback_redirect	Установка была невозможна, и посетителя отправили дальше на оффер.	Тот же набор.
install_fallback_stay	Установка была невозможна, и посетитель остался на странице.	Витрину, оффер.
launch_pwa	Установленное приложение открыли.	Витрину, кампанию, оффер, гео.
render_pwa_launch	Отрисован экран запуска установленного приложения.	Витрину, гео, адрес.

installed и install_accepted идут парой

Они пишутся об одной и той же установке, поэтому подсчёт обоих удваивает ваши установки. Возьмите одно — installed — и пользуйтесь им везде. Это самый частый способ испортить воронку, собранную по событиям.

Пуш-уведомления

Приставку push_ делят два разных семейства, и путать их нельзя.

Подписка — что произошло на витрине. Эти несут кампанию, оффер и объявление, потому что относятся к трафику, который привёл посетителя:

Событие	Что означает
push_prompt_shown	У посетителя спросили разрешение присылать уведомления.
push_allow	Разрешение дано.
push_deny	В разрешении отказано.
push_ignored	Предложение не приняли и не отклонили.
push_subscribe	Подписка зарегистрирована, теперь ей можно слать.

Доставка — что случилось с отправленной рассылкой. Эти несут вместо этого пуш-кампанию:

Событие	Что означает
push_sent	Уведомление передано к доставке.
push_shown	Показано на устройстве.
push_click	Посетитель нажал на него и вернулся.
push_dismiss	Посетитель его смахнул.
push_expired	Не доставлено, пока не вышел срок жизни.
push_failed	Доставка не удалась.

Поэтому окупаемость пуш-рассылки — это push_click к push_sent, а качество вашей витрины — push_allow к push_prompt_shown. Ни одно из этих отношений не имеет смысла между семействами.

Конверсии

Событие	Что означает	Что несёт
reg	Регистрация, о которой сообщила партнёрская сеть.	Статус в том виде, как прислала сеть, валюту, оффер, объявление, гео и исходный запрос сети.
dep	Депозит.	То же плюс сумму и её валюту.

Оба приходят снаружи — из постбэка сети, — поэтому знают посетителя (piuid), но не несут метку, которую положил в ссылку ваш источник трафика. Та метка приехала раньше, на campaign_visit. Как их связать, показано в статье Отправка событий в источник.

Разбор постбэков

Это не конверсии. Это записи о постбэках, которые не удалось превратить в конверсию, — они хранятся, чтобы пропавшую конверсию можно было разобрать по экрану, а не по журналу:

Событие	Что означает
postback_no_subid	В запросе не было опознавателя, поэтому его не к кому привязать.
postback_unmatched_status	Статус не распознан.
postback_duplicate_suppressed	Повтор уже засчитанной конверсии.
postback_stale_hash	Запрос пришёл на адрес, который с тех пор сменился.

Внимание

Никогда не считайте их конверсиями — отбирайте в запросах по имени события явно, а не берите всё, что пришло от сети.

Поведение на странице

Событие	Что означает
exit_intent	Посетитель собрался уходить со страницы.
idle_redirect	Посетителя отправили дальше после бездействия.
open	Приложение или страницу открыли.
offer_refresh_denied	Запрос на перевыпуск ссылки оффера отклонён.

Поля события

Не всякое поле заполнено у всякого вида: у установки нет статуса, у доставки пуша нет оффера. Что стоит знать:

Поле	Что это
event_time	Когда произошло.
event	Вид, из таблиц выше.
piuid	Опознаватель посетителя. Есть у всего и связывает весь его путь.
url	Полный сырой адрес запроса со всеми параметрами, которые прислал источник.
params['имя']	Любой параметр этого адреса, уже разобранный.
sub_id_1 … sub_id_16, click_id, external_id	Распространённые метки, вынесенные в отдельные колонки.
status, revenue, currency	Заполняются у конверсий.
country, city, language, device, ua, ip	Кто и откуда.
campaign_id, offer_id, ad_id, pwa_id, domain	К чему относится трафик.
push_campaign_id	Какая пуш-рассылка — только у семейства доставки.
extra	Всё прочее, что счёл нужным записать источник события.

Что дальше

Отправка событий в источник

Отдавайте эти события обратно партнёру.

Примеры скриптов

Готовые скрипты, читающие этот поток.

Таблицы для запросов

Другие таблицы, доступные скрипту.