Análises

A bancada: uma pergunta escrita como frase e feita de três maneiras, como tendência, funil ou retenção. O resultado desenha-se no lugar, e um que valha a pena guardar afixa-se num painel.

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 escolhe o que é um passo. Por evento, a caminhada são os nomes de evento mais frequentes depois da âncora. Por página, ela considera apenas visualizações de página e a chave de cada passo é o host com o caminho, de modo que a caminhada se lê preços, cadastro, checkout em vez de visualização de página, visualização de página, visualização de página. A âncora muda junto: o campo de evento vira um seletor sobre as páginas que os visitantes realmente alcançaram no período, as cem primeiras por usuários, porque uma âncora de página digitada à mão teria de casar exatamente com um host e um caminho para responder qualquer coisa. No sankey e na árvore, um passo de página desenha o caminho com o seu host como prefixo discreto, de modo que dois hosts que compartilham um caminho continuam distinguíveis.

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.

Medidas, eventos e exclusões

Cada métrica conta os seus eventos no total ou como utilizadores únicos, ou lê um número que eles traziam: o seletor de medida agrupa Count, Sum of e Average of, e os dois últimos listam cada propriedade que os eventos da métrica enviaram como número, pelo que a linha se lê the sum of amount. O campo de evento de uma métrica aceita até 8 eventos, contados em conjunto como uma só série sob a letra da métrica e identificados com cada evento que conta. Numa tendência, Exclude depois da coorte deixa de fora People who did an event, isto é, quem fez qualquer um de até 8 eventos dentro do intervalo, A cohort diferente daquela a que a pergunta está limitada, ou ambos; cada desagregação aceita também valores a deixar de fora. O intervalo é o seletor de datas: Today, Yesterday, Last 7 days, Last 30 days, Last 3 months, Last 6 months e Last 12 months, ou qualquer sequência de dias escolhida no seu calendário de dois meses. Os dias são dias UTC, tal como o armazém de dados os conta, e um intervalo relativo é guardado pelo nome, pelo que um relatório guardado sobre Last 30 days lê sempre os últimos 30 dias. Na rede, uma métrica leva os seus eventos adicionais em orEvents, a consulta leva excludeDid e excludeCohort, e a lista de propriedades é numericProperties em 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.

Definições do gráfico

O botão de definições ao lado do tipo de gráfico abre as definições do próprio gráfico, como popover, painel ao lado do gráfico ou caixa de diálogo, conforme o seletor de layout da página indica. Os separadores Left axis e Right axis definem se cada eixo aparece, o seu título, a sua unidade (contagem, moeda, percentagem ou personalizada), um prefixo e um sufixo, se os números grandes são abreviados, quantas casas decimais com uma pré-visualização do resultado, limites mínimo e máximo fixos com os valores que os ultrapassam cortados na margem ou omitidos, e uma escala linear ou logarítmica. O separador Time axis mostra ou oculta o eixo do tempo, dá-lhe um título e sombreia os fins de semana num gráfico diário ou horário. O separador Series move cada métrica ou fórmula para o eixo esquerdo ou direito, o que a linha própria de cada métrica na pergunta também faz, e escolhe a paleta Standard ou uma segura para daltónicos. Cada alteração redesenha o gráfico de imediato; um relatório ou insight guardado mantém as suas definições, o histórico de versões nomeia a alteração delas e um mosaico afixado desenha-se com elas, também no telemóvel. Na rede, viajam como o campo chart ao lado de viz em relatórios, insights e mosaicos.

A tabela de resultados

Sob o gráfico, a tabela de resultados de uma tendência lista uma linha por série: a amostra de cor em que a sua linha é desenhada, os seus valores de desagregação (ou a sua métrica quando a pergunta tem várias letras ou nenhuma desagregação), uma coluna Soma e uma coluna por período, com o gémeo passado de cada período ao lado quando a tendência é comparada. Desmarcar a caixa de uma linha, ou clicar na sua amostra, tira a sua linha do gráfico; a linha fica na tabela esbatida e com amostra oca, a legenda mantém-na oca, e a caixa do cabeçalho repõe todas as linhas ou tira-as todas. O campo de pesquisa acima da tabela restringe as linhas às que têm valores que contêm o texto escrito, e nunca tira uma linha do gráfico. O grupo de vista na linha de resultado alterna entre Gráfico, Tabela e Gráfico e tabela, a vista em que um resultado abre; com o tipo de gráfico Tabela, a tabela é o gráfico e o grupo desaparece. A vista e as linhas tiradas são guardadas com o relatório como parte das definições do gráfico, como view e hidden no campo chart, pelo que um relatório guardado, um insight e um mosaico fixado desenham as mesmas linhas, também no telemóvel. Os outros modos mostram a sua própria tabela sob o gráfico, com pesquisa e sem escolha de linhas.

A linha acima do gráfico diz há quanto tempo o resultado foi executado, e Atualizar, ao lado das configurações do gráfico, faz a mesma pergunta novamente. As alterações feitas na frase desde então aguardam Executar.

Agir sobre um ponto

Clicar num ponto de um gráfico abre um menu intitulado com o próprio ponto: a sua série, o seu intervalo e o seu valor; no telemóvel, um toque longo abre o mesmo menu. Este relatório altera a pergunta e volta a executá-la. Ampliar restringe uma tendência ou um ciclo de vida ao intervalo clicado, um passo mais fino: um mês em semanas, uma semana em dias e o dia de uma tendência em horas. Num ponto de uma divisão, a linha de filtro acrescenta um filtro por cada um dos seus valores e a de exclusão deixa um valor fora da sua divisão, uma linha por valor; num ponto sem divisão, ambas ficam a cinzento como Filtrar por isto e Excluir isto. Ver de perto lista quem e o que formou o ponto, em todos os modos: um intervalo de tendência ou de ciclo de vida, um passo de funil, uma célula de retenção, um evento de um percurso e uma coluna de aderência nomeiam cada um os seus. Ver utilizadores, Ver eventos e Ver repetições abrem-nos numa caixa de diálogo por predefinição, ou num painel lateral ou na própria página, conforme o seletor da página de análise. Abrir em Pessoas, ou Eventos, ou Replay, leva o ponto a essa página, onde uma etiqueta o nomeia e o limpa; quando o seletor envia o ponto diretamente para a página, Voltar ao relatório regressa à pergunta. Explicar contém Análise da causa raiz: num ponto de tendência com um intervalo anterior, que conta totais ou utilizadores únicos, redige no Ask a pergunta de porque é que a linha subiu ou desceu entre os dois. Na API, o ponto viaja como o argumento point de projectPeople e replaySessions e no filtro de events: o tipo e a consulta do relatório, mais o intervalo, o passo, o evento, a coorte, o período, os dias ativos ou o estado que o designam.

Anotações

Adicionar uma anotação, no menu de um ponto, marca esse dia, ou um período escolhido no calendário, com uma nota e até dez etiquetas. Num relatório, Aparece em mantém a anotação no relatório ou mostra-a em todos os gráficos do projeto cujas datas a abrangem; uma pergunta que não foi guardada como relatório mostra-a nos gráficos do projeto. Um marcador fica no eixo das datas: passar o ponteiro sobre ele desenha a sua linha e um cartão com a nota, as etiquetas, os dias e quem a adicionou, e clicar mantém o cartão aberto com Editar e Excluir para o autor e para quem pode escrever anotações. O separador Anotações das configurações do gráfico lista-as e oculta as etiquetas que desativar, guardadas com o relatório, e os mosaicos de um painel desenham os mesmos marcadores. Na API são annotations, createAnnotation, updateAnnotation, deleteAnnotation, a subscrição annotationChanges e /v1/projects/{projectId}/annotations; os agentes leem-nas e adicionam-nas com prodantix.annotations.list e 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.

Ao lado de Pin está Save. A sua primeira linha é As an insight: a pergunta é guardada inteira, editor e gráfico, sob um nome pedido num diálogo, e o cabeçalho do cartão nomeia então o insight aberto num chip; o endereço leva ?insight=, por isso a ligação reabre-o. Edite a pergunta e o chip lê changed depois do nome até que a primeira linha de Save, agora Update, escreva a edição sobre o que foi guardado, ou a sua segunda linha, Save as a new insight, guarde a edição como outro. A linha seguinte é Users as a cohort: nomeia as pessoas que um resultado contou e guarda-as como coorte estática. A lista é materializada no servidor a partir da consulta tal como correu, por isso guarda todos os que o resultado contou e não os que o gráfico desenhou, até 100,000, e um resultado que não contou ninguém é recusado. A coorte guarda a frase sob a qual foi lida e, sendo uma lista fixa, nunca é reavaliada: a mesma pergunta feita na próxima semana responde sobre a próxima semana, enquanto a coorte continua a ter quem contou hoje. Os insights guardados são listados no separador Insights de Saved. Abaixo de um separador está Exportar CSV: o servidor escreve o resultado como folha de cálculo a partir da consulta tal como correu, uma linha por período e desagregação com uma coluna por letra de métrica, todas as combinações até ao milhar do motor em vez das poucas do topo do gráfico, e dá ao ficheiro o nome da ferramenta e do intervalo. Por último vem Monitorar um limite, que só funciona sobre um resultado de tendência: guarda o resultado como insight se ainda não for um, depois declara um limite na sua primeira métrica, acima, abaixo ou a variar por um valor, verificado uma vez por dia ao longo do último intervalo completo do insight; enquanto o limite estiver ultrapassado o insight é listado em Precisa de si e o insight reaberto desenha o limite como uma faixa no seu gráfico, e o alerta desaparece sozinho quando o valor regressa.

Save as report guarda a pergunta como relatório num painel, em dois passos: primeiro o nome e uma descrição, depois o painel, escolhido numa lista pesquisável com três linhas de altura e New board por baixo. O endereço passa a levar ?report=, o cabeçalho da página lê projeto › painel › relatório com o painel como ligação, e o cabeçalho do cartão nomeia o relatório aberto num chip, que lê changed a seguir ao nome assim que o editor difere do guardado, até Save report escrever a edição como a versão seguinte ou Save as new report a guardar como outro relatório. Com um relatório aberto, o menu Save também lhe muda o nome, move-o para outro painel ou duplica-o; mover acontece de imediato e a snackbar di-lo com Undo. Sob o cartão, a faixa de versões nomeia a versão atual, quem a guardou e quando; Show history desdobra cada versão, o que mudou, por quem e quando, três entradas à vista, com Restore ao lado de cada uma exceto a atual, e um restauro escreve uma nova versão que copia a escolhida em vez de reescrever o histórico. Os relatórios estão listados no separador Reports de Saved.

Compartilhar um relatório

Com um relatório salvo aberto, a linha de execução oferece Copy link e Share. Copy link copia o endereço do relatório com seu período, coorte e filtros, e ele abre para qualquer pessoa da empresa que possa abrir o relatório. Share abre duas abas, Teammates primeiro. Teammates envia o relatório para até 20 pessoas da empresa, com uma nota se você adicionar uma: cada uma o recebe nas notificações do console, como push onde ativou os pushes, e por e-mail. A caixa de diálogo continua aberta e diz para quem foi enviado.

Public link cria uma página somente leitura que qualquer pessoa com o link pode abrir sem entrar: o relatório como estava na última execução, com o gráfico e os números, mas sem os filtros, a coorte ou as pessoas da pergunta, e cada execução do relatório como foi salvo a atualiza. O link deixa de funcionar no fim do dia escolhido, de amanhã até 90 dias, começando em In 30 days; escolher outro dia enquanto está ativo o renova, e desativá-lo o interrompe na hora. Criar um link público exige uma permissão própria, que agentes nunca têm, e uma função sem ela vê o interruptor desativado, com uma linha dizendo isso.

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).