Neste guia· 5 capítulos
Uma chave que você cria, só com permissão de leitura
O PostHog guarda os números. Você está prestes a torná-los respondíveis numa frase.
A conexão roda numa chave que você cria no seu próprio PostHog e pode revogar lá a qualquer momento. Você escolhe as permissões dela, e as de que isto precisa são todas de leitura — então a própria chave é o motivo pelo qual nada aqui consegue mudar a sua análise.
- 1
Crie uma chave de API pessoal no PostHog
No PostHog, vá em Settings e crie uma personal API key. Dê a ela as permissões de leitura que o painel de conexão lista — projeto, consulta, insight, coorte, painel, as definições de evento e de propriedade, e a análise da web. Não conceda mais nada: uma chave sem permissão de escrita não consegue escrever, seja qual for o pedido.
- 2
Escolha a sua região e cole
Abra os Conectores no 1Presence, escolha o PostHog e selecione onde a sua conta vive — US Cloud, EU Cloud, ou o seu próprio endereço, se você hospeda o PostHog. Cole a chave e ela é conferida contra a sua conta ali mesmo, então você sabe na hora se funcionou.
- 3
Deixe os dados no nível de pessoa desligados
Há uma caixa de marcar para isso, e desligado é a resposta certa para quase todo mundo. Deixando desligado, você ainda tem contagens, tendências, funis, retenção, quebras e os seus insights salvos — tudo o que vem abaixo funciona. O que você não tem são as identidades das pessoas individuais por trás dos números, que são dados dos seus clientes, e não seus.
Colou uma chave que começa com phc_? Essa é a chave pública de projeto com a qual o seu site manda os eventos, e ela não consegue ler nada. A que você quer começa com phx_ e vem da página de personal API keys — o painel vai te avisar se você colar a errada.
Quatro formatos de pergunta
Você não precisa saber que tipo de gráfico quer. Faça a pergunta que você de fato tem e o 1Presence escolhe o formato — mas vale conhecer os quatro, porque é neles que uma pergunta de produto costuma se reduzir.
Comece por estas e vá variando:
Quantas pessoas se cadastraram por semana nos últimos três meses?
Uma tendência. Qualquer evento que você registre, em qualquer período, contado como total ou como pessoas únicas. Acrescente “separado por campanha” e você recebe a quebra.
Onde as pessoas desistem entre chegar ao site e mandar a primeira mensagem?
Um funil. Diga os passos em ordem e receba de volta quantos chegaram a cada um, e a conversão a partir do passo anterior e a partir do topo.
Das pessoas que se cadastraram em agosto, quantas ainda estavam ativas na quarta semana?
Retenção. Coorte por coorte, por semana ou por mês — a pergunta que uma contagem de cadastros não responde.
Como se chamam os nossos insights salvos?
Lista o que a sua equipe já construiu e nomeou, para você rodar a definição combinada em vez de uma derivação nova que é quase a mesma.
Se você não tem certeza de que um evento existe, pergunte quais eventos há. Um nome de evento digitado errado devolve um gráfico vazio em vez de um erro, que é o único jeito de uma resposta errada parecer real — então o 1Presence confere os nomes quando não tem certeza, e você também pode.
Faça a segunda-feira chegar sozinha
O sentido de perguntar costuma ser notar que alguma coisa mudou. Isso funciona melhor num horário do que por impulso, então o passo natural seguinte é uma rotina: uma instrução permanente que roda numa manhã que você escolhe, faz as perguntas que te importam e te conta o que se mexeu.
- 1
Descreva a revisão que você quer
Peça uma rotina com as suas palavras — “toda segunda às oito, puxe os cadastros da semana passada, o funil de ativação e a retenção da quarta semana, e me conte o que mudou”. As perguntas são suas para nomear; o formato é o mesmo que você vinha pedindo na mão.
- 2
Faça ela arquivar os números
Peça para os números caírem num conjunto de dados e as leituras semanais da rotina viram linhas que você pode transformar em gráfico. Um painel desenhado a partir daquele conjunto passa a ser a coisa que você olha de relance, e ele é feito dos seus próprios números, e não de uma cópia dos do PostHog.
- 3
Leia como história, não como tabela
A parte útil de uma revisão semanal é a frase, e não o número. Peça à rotina que diga o que se mexeu e o que não se mexeu, e que sinalize qualquer coisa que tenha quebrado a tendência — essa é a parte que você teria de descobrir sozinho.
Uma conexão para uma equipe inteira
Um projeto do PostHog pertence à empresa. Então, num espaço de equipe, ele é conectado uma vez, por um administrador, em Organisation settings — e daí em diante todo mundo pode perguntar sobre os números do produto sem montar nada. Ninguém conecta duas vezes, e aquilo não para de funcionar quando quem montou vai embora.
O ajuste de dados no nível de pessoa é da organização do mesmo jeito: feito uma vez por um administrador, e não pessoa por pessoa, porque a credencial pela qual todo mundo lê é uma só. O seu PostHog pessoal, se você tiver um, continua inteiramente separado — perguntar no espaço da equipe lê o projeto da equipe, perguntar no seu lê o seu.
O que ele não vai fazer
- Ele não consegue mudar nada. Nem uma flag, nem um insight, nem uma pessoa, nem uma coorte. A chave não tem permissão de escrita e não existe aqui nenhuma ferramenta que pudesse usar uma. Se você pedir para ele mudar alguma coisa no PostHog, ele vai dizer com clareza que não consegue.
- Ele não vai te entregar uma lista de pessoas. A menos que você tenha ligado os dados no nível de pessoa — o que exige a caixa de marcar aqui e a permissão correspondente na chave —, uma pergunta que devolveria pessoas individuais é recusada com uma explicação. Isso inclui alcançá-las de lado por uma consulta escrita à mão.
- Ele não lê em segundo plano. Uma consulta roda porque você pediu, ou porque uma rotina que você montou pediu num horário. As consultas são limitadas a um intervalo de datas e usam os resultados em cache do PostHog onde eles estiverem frescos.
- Ele lê os resultados como informação. Um nome de evento ou um valor de propriedade que se leia como instrução é uma linha numa tabela, e não um comando que ele vá seguir.
A virada
A revisão semanal, sem abrir nada.
Conecte uma vez, pergunte numa frase e deixe uma rotina trazer aquilo até você na segunda. Somente leitura do começo ao fim, agregado por padrão, e compartilhado pela sua equipe a partir de uma conexão só.