Аналитика
Рабочий стол: один вопрос, записанный предложением и заданный тремя способами, как тренд, воронка или удержание. Результат рисуется на месте, а достойный сохранения закрепляется на дашборде.
Six modes, one question
A trend counts one event over a range, as totals or unique people, at a granularity the range makes sensible. A funnel orders two or more steps and reports who made it through each. Retention asks who came back: an entry event, a return event and a matrix of periods. Paths asks what happened next, stickiness how many days a period's users came back on, and lifecycle who was new, returning, resurrecting or dormant in each period. Switching modes keeps everything the modes share, so a trend refined into a funnel does not start over.
Metrics and formulas
A trend is not one measure: Add a metric appends a letter, B onward, each its own event and its own total or unique users measure, the scope event staying letter A. Add a formula turns a row into an expression combining those letters with decimal numbers and + - * /, grouped with parentheses, up to 200 characters and never another formula's own letter. A point the formula cannot compute, a division by zero among them, draws as a gap rather than a zero.
The compared period
Compare asks the same question again over the window right before this one: Previous Period, Previous Day, Previous Week, Previous Month, Previous Quarter or Previous Year. Every series in the result gets a past twin, drawn apart from the current one rather than as a plain extra line, and the scope note names which one is picked. The compared period draws on Line, Stacked Line, Column, Stacked Column, Bar, Stacked Bar, Table and Metric; Pie draws the current period only.
Breakdowns
Breakdowns split a trend by up to three fields at once, an event property or one of the columns the DSL allow-lists: every series in the result carries the tuple of values it is one combination of, in the breakdowns' own order. The table reads every combination as its own row; the other chart types read the first breakdown as the series and fold the rest into its key.
Paths: what happened next
Paths start from an anchor event and walk one to five steps forward, or backward, within the anchor's session or a window of minutes or hours. Each step reports its top three, five or ten events with the share of that step's users, the events past the top folded into one row, and the users who took no further step. The default reading is one column per step; the same result reads as a sankey, with a block per event and a ribbon into each block of the next step, or as a tree that nests the next step's events under each event until its caret opens it.
Step by выбирает, что считается шагом. По событию прогулка складывается из самых частых имён событий после якоря. По странице она смотрит только просмотры страниц, а ключом каждого шага становится хост вместе с путём, так что прогулка читается как цены, регистрация, оплата, а не просмотр страницы, просмотр страницы, просмотр страницы. Якорь меняется вместе с ней: поле события превращается в выбор среди страниц, до которых посетители в этом периоде действительно дошли, первая сотня по числу пользователей, потому что якорь страницы, набранный руками, должен был бы точно совпасть с хостом и путём, чтобы вообще что-то ответить. На диаграмме санкей и в дереве шаг страницы рисует путь, а хост ставит приглушённым префиксом, так что два хоста с одинаковым путём остаются различимыми.
Stickiness: how many days
Stickiness counts, for each week or month, how many of the event's users were active on one, two, three and more of its days. The result row steps between periods; the column chart reads one period at a time, and the table reads all of them.
Lifecycle: new, returning, resurrecting, dormant
Lifecycle sorts each period's users into four states: new were first seen in the period, returning were active in it and the period before, resurrecting came back after a period away, and dormant were active the period before and not in this one. First-seen reads the whole retained history, so a user is new once; activity is read one period before the range, so the first period's returning and dormant counts are real rather than zero by construction. The stacked column draws dormant below the zero line; the table adds a net column.
The sentence and its clauses
The question reads as a sentence: measure, event, range and any clauses, each word an editable control with the project's own event names suggested as you type. Property clauses narrow by what an event carried; a cohort clause scopes the whole question to a saved cohort. Whether the question composes as one sentence or as labelled groups is a stored preference, as is the split or stacked layout; nothing runs until Run, so a half-edited question never fires.
Меры, события и исключения
Каждая метрика считает свои события всего или по уникальным пользователям либо читает число, которое они несли: выбор меры группирует Count, Sum of и Average of, причём два последних перечисляют каждое свойство, которое события метрики отправили как число, и строка тогда читается the sum of amount. Поле события метрики принимает до 8 событий, которые считаются вместе как одна серия под буквой метрики и подписаны каждым учтённым событием. В тренде Exclude после когорты исключает People who did an event, то есть совершивших любое из не более чем 8 событий за период, A cohort, отличную от той, которой ограничен вопрос, или и то и другое; каждая разбивка также принимает значения, которые из неё исключаются. Период задаётся выбором дат: Today, Yesterday, Last 7 days, Last 30 days, Last 3 months, Last 6 months и Last 12 months или любой промежуток дней, выбранный в его календаре на два месяца. Дни считаются днями UTC, как их считает хранилище, а относительный период сохраняется по имени, поэтому отчёт, сохранённый на Last 30 days, всегда читает последние 30 дней. В сети метрика передаёт дополнительные события в orEvents, запрос передаёт excludeDid и excludeCohort, а список свойств берётся из numericProperties в eventCatalog.
Reading a result as another chart
Every result row ends with the chart type it is read in. The menu lists Line, Stacked Line, Column, Stacked Column, Bar, Stacked Bar, Pie, Table, Metric, Funnel Steps, Retention Curve, Ranked Columns, Sankey and Tree, in that order, with the ones the result cannot take greyed rather than hidden. A trend, a stickiness period and a lifecycle take any of the series types; funnel steps take a funnel; the retention curve draws one line per cohort over its matrix; ranked columns, the sankey and the tree read paths; the table reads everything. Each mode remembers the type you chose, the URL carries it as ?chart=, and a pinned tile keeps it.
Настройки графика
Кнопка настроек рядом с типом графика открывает собственные настройки графика: во всплывающем окне, на панели рядом с графиком или в диалоге, как указывает выбор макета страницы. Вкладки Left axis и Right axis задают, показывается ли каждая ось, её заголовок, единицу (количество, валюта, проценты или своя), префикс и суффикс, сокращаются ли большие числа, число знаков после запятой с предпросмотром результата, фиксированные минимальную и максимальную границы, за которыми значения обрезаются по краю или пропускаются, и линейную или логарифмическую шкалу. Вкладка Time axis показывает или скрывает ось времени, даёт ей заголовок и затеняет выходные на дневном или почасовом графике. Вкладка Series переносит каждую метрику или формулу на левую или правую ось, что делает и собственная строка каждой метрики в вопросе, и выбирает палитру Standard или безопасную для дальтоников. Каждое изменение сразу перерисовывает график; сохранённый отчёт или инсайт хранит свои настройки, история версий называет их изменение, а закреплённая плитка рисуется с ними, и на телефоне тоже. В передаче они идут полем chart рядом с viz у отчётов, инсайтов и плиток.
Таблица результатов
Под графиком таблица результатов тренда показывает по строке на каждую серию: цветовую метку её линии, значения разбивки (или её метрику, если в вопросе несколько букв или нет разбивки), столбец Сумма и столбец на каждый период, а рядом с каждым периодом его прошлого двойника, когда тренд сравнивается. Если снять флажок строки или нажать на её метку, линия уходит с графика; строка остаётся в таблице приглушённой, с полой меткой, легенда тоже оставляет её полой, а флажок в заголовке возвращает все строки или убирает все. Поле поиска над таблицей сужает строки до тех, в значениях которых есть набранный текст, и никогда не убирает линию с графика. Группа вида в строке результата переключает График, Таблица и График и таблица, и результат открывается в виде График и таблица; если тип графика Таблица, таблица и есть график, поэтому группа исчезает. Вид и убранные строки сохраняются вместе с отчётом в настройках графика, как view и hidden в поле chart, поэтому сохранённый отчёт, инсайт и закреплённая плитка рисуют одни и те же линии, на телефоне тоже. Остальные режимы показывают под графиком свою таблицу, с поиском и без выбора строк.
Строка над графиком показывает, как давно был получен результат, а кнопка Обновить рядом с настройками графика задаёт тот же вопрос заново. Изменения в предложении, сделанные после этого, ждут нажатия Выполнить.
Действия с точкой
Щелчок по точке графика открывает меню, заголовок которого называет саму точку: её ряд, интервал и значение; на телефоне то же меню открывает долгое нажатие. Этот отчёт меняет вопрос и запускает его снова. Приблизить сужает тренд или жизненный цикл до выбранного интервала на шаг мельче: месяц до недель, неделю до дней, а день тренда до часов. На точке разбивки строка фильтра добавляет фильтр по каждому её значению, а строка исключения убирает одно значение из её разбивки, по строке на значение; на точке без разбивки обе остаются серыми как Отфильтровать по этому и Исключить это. Подробнее перечисляет, кто и что составили точку, в любом режиме: интервал тренда или жизненного цикла, шаг воронки, ячейка удержания, событие на пути и столбец липкости называют каждый своих. Показать пользователей, Показать события и Показать повторы открывают их по умолчанию в диалоге, либо на боковой панели или на самой странице, как задаёт переключатель на странице аналитики. Открыть в разделе «Люди», или «События», или «Повтор», переносит точку на эту страницу, где чип называет её и снимает; когда переключатель отправляет точку сразу на страницу, Назад к отчёту возвращает к вопросу. Объяснить содержит Анализ первопричины: на точке тренда, перед которой есть интервал и которая считает итоги или уникальных пользователей, он составляет в Ask вопрос о том, почему линия выросла или упала между ними. В API точка передаётся аргументом point запросов projectPeople и replaySessions и в фильтре events: вид и запрос отчёта, а также интервал, шаг, событие, когорта, период, активные дни или состояние, которые её задают.
Аннотации
Добавить аннотацию в меню точки отмечает этот день или выбранный в календаре период заметкой и тегами, не более десяти. В отчёте Где показывать оставляет аннотацию только в отчёте или показывает её на каждом графике проекта, чьи даты её охватывают; вопрос, не сохранённый как отчёт, показывает её на графиках проекта. На оси дат стоит маркер: при наведении появляются его линия и карточка с заметкой, тегами, днями и автором, а щелчок оставляет карточку открытой с кнопками Редактировать и Удалить для автора и для всех, кому разрешено писать аннотации. Вкладка Аннотации в настройках графика перечисляет их и скрывает отключённые теги, сохраняясь вместе с отчётом, а плитки доски рисуют те же маркеры. В API это annotations, createAnnotation, updateAnnotation, deleteAnnotation, подписка annotationChanges и /v1/projects/{projectId}/annotations; агенты читают и добавляют их через prodantix.annotations.list и prodantix.annotations.create.
Results, and keeping them
A trend draws as a series, a funnel as its steps with the drop between them, retention as a matrix whose rows are entry periods, paths as ranked columns per step, stickiness as columns over days active and lifecycle as a stacked column. Once a result exists, Pin saves the question to a board on Saved, where its tile re-runs the query on every open and draws it as the chart type it was pinned in.
Рядом с Pin стоит Save. Его первая строка называется As an insight: вопрос сохраняется целиком, с редактором и графиком, под именем, которое спрашивается в диалоге, и шапка карточки затем называет открытый инсайт на чипе; адрес несёт ?insight=, так что ссылка открывает его заново. Измените вопрос, и чип читает changed после имени, пока первая строка Save, теперь Update, не запишет правку поверх сохранённого, или её вторая строка, Save as a new insight, не сохранит правку как другой инсайт. Следующая строка называется Users as a cohort: она называет людей, которых посчитал результат, и сохраняет их как статическую когорту. Список материализуется на сервере из запроса в том виде, в каком он выполнялся, поэтому он держит всех, кого посчитал результат, а не тех, кого нарисовал график, до 100,000, а результат, который никого не посчитал, отклоняется. Когорта хранит фразу, под которой её читали, и, будучи фиксированным списком, никогда не пересчитывается: тот же вопрос на следующей неделе отвечает о следующей неделе, а когорта по-прежнему держит тех, кого посчитала сегодня. Сохранённые инсайты перечислены на вкладке Insights страницы Saved. Под разделителем находится Экспорт в CSV: сервер записывает результат как таблицу из запроса в том виде, в каком он выполнялся, по строке на период и разбивку со столбцом на каждую букву метрики, все сочетания вплоть до тысячи движка, а не несколько верхних из диаграммы, и называет файл по инструменту и диапазону. Последним идёт Отслеживать порог, работающий только для результата тренда: он сохраняет результат как инсайт, если тот ещё не является им, затем задаёт одну границу на его первую метрику, выше, ниже или изменение на значение, проверяемую раз в день за последний полный период инсайта; пока граница нарушена, инсайт перечислен в Требует внимания, а заново открытый инсайт рисует границу как полосу на своём графике, и оповещение снимается само, когда значение возвращается.
Save as report сохраняет вопрос как отчёт на доске, в два шага: сначала имя и описание, затем доска, выбранная из списка с поиском высотой в три строки, с New board под ним. Затем адрес несёт ?report=, шапка страницы читается как проект › доска › отчёт, где доска является ссылкой, а шапка карточки называет открытый отчёт на чипе, который читается как changed после имени, как только редактор отличается от сохранённого, пока Save report не запишет правку следующей версией или Save as new report не сохранит её как другой отчёт. При открытом отчёте меню Save также переименовывает его, перемещает на другую доску или дублирует; перемещение вступает в силу сразу, и снэкбар сообщает об этом с Undo. Под карточкой полоса версий называет текущую версию, кто и когда её сохранил; Show history раскрывает каждую версию, что изменилось, кем и когда, по три записи в поле зрения, с Restore рядом с каждой, кроме текущей, а восстановление пишет новую версию, копирующую выбранную, вместо того чтобы переписывать историю. Отчёты перечислены на вкладке Reports в Saved.
Как поделиться отчётом
Когда открыт сохранённый отчёт, в строке запуска есть Copy link и Share. Copy link копирует адрес отчёта вместе с периодом, когортой и фильтрами, и он открывается у любого в компании, кому можно открыть этот отчёт. Share открывает две вкладки, сначала Teammates. Teammates отправляет отчёт не более чем 20 людям в компании, с заметкой, если вы её добавите: каждый получает его в уведомлениях консоли, пушем там, где пуши включены, и по электронной почте. Диалог остаётся открытым и сообщает, кому отчёт отправлен.
Public link создаёт страницу только для чтения, которую любой, у кого есть ссылка, может открыть без входа: отчёт на момент последнего запуска, с графиком и числами, но без фильтров, когорты и людей его вопроса, и каждый запуск отчёта в сохранённом виде её обновляет. Ссылка перестаёт работать в конце выбранного дня, от завтра до 90 дней, сначала In 30 days; выбор другого дня, пока она включена, продлевает её, а выключение сразу её останавливает. Для создания публичной ссылки нужно отдельное право, которого у агентов никогда нет, а роль без него видит переключатель отключённым и строку, которая это объясняет.
Where this meets the API
The concept is the Analytics pillar. On the wire, the six modes are six queries: runQuery, runFunnel, runRetention, runPaths, runStickiness and runLifecycle, with event names suggested from eventCatalog and, for a path stepping by page, the anchors from pathsPages (GraphQL reference). Pinning writes the question into a board through updateDashboard, with the report's kind and the chart type beside its query; saving an insight is createInsight, Update is updateInsight, and Saved's Insights tab reads insights. Save as report is createReport, Save report is updateReport, the strip's Restore is restoreReportVersion, and Saved's Reports tab reads reports. Sharing reads the public link with reportPublicLink, turns it on or renews it with setReportPublicLink, turns it off with turnOffReportPublicLink and sends to teammates with shareReport, while reportShareChanges streams every change; a visitor's page reads /v1/shared-reports/{token} (API reference).