In questa guida· 5 capitoli
Una chiave che crei tu, con il solo permesso di lettura
PostHog ha i numeri. Stai per renderli interrogabili in una frase.
La connessione gira su una chiave che crei nel tuo PostHog e che puoi revocare lì in qualsiasi momento. Ne scegli tu i permessi, e quelli che servono qui sono tutti di lettura — quindi è la chiave stessa il motivo per cui niente qui può cambiare i tuoi dati.
- 1
Crea una chiave API personale in PostHog
In PostHog, vai nelle impostazioni e crea una chiave API personale. Dalle i permessi di lettura che il pannello di connessione elenca — progetto, query, insight, coorte, dashboard, le definizioni di eventi e proprietà, e i dati web. Non concederle nient’altro: una chiave senza permessi di scrittura non può scrivere, qualunque cosa le venga chiesto.
- 2
Scegli la regione e incollala
Apri Connettori in 1Presence, scegli PostHog e seleziona dove vive il tuo account — US Cloud, EU Cloud, oppure il tuo indirizzo se ospiti PostHog da te. Incolla la chiave e viene verificata sul tuo account lì per lì, così sai subito se ha funzionato.
- 3
Lascia spenti i dati a livello di persona
C’è una casella apposta, e spenta è la risposta giusta per quasi tutti. Lasciandola spenta ottieni comunque conteggi, andamenti, funnel, retention, scomposizioni e i tuoi insight salvati: tutto quello che c’è qui sotto funziona. Quello che non ottieni sono le identità delle singole persone dietro ai numeri, che sono dati dei tuoi clienti più che tuoi.
Hai incollato una chiave che comincia per phc_? Quella è la chiave pubblica di progetto con cui il tuo sito manda gli eventi, e non può leggere niente. Quella che ti serve comincia per phx_ e arriva dalla pagina delle chiavi API personali — il pannello te lo dice se ne incolli una sbagliata.
Quattro forme di domanda
Non devi sapere quale tipo di grafico vuoi. Fai la domanda che hai davvero e 1Presence sceglie la forma — ma vale la pena conoscere le quattro, perché sono quelle a cui di solito si riduce una domanda di prodotto.
Comincia da queste e variale:
Quante persone si sono iscritte ogni settimana negli ultimi tre mesi?
Un andamento. Qualsiasi evento registri, su qualsiasi periodo, contato come totali o come persone uniche. Aggiungi “scomposto per campagna” e lo ottieni suddiviso.
Dove abbandonano le persone tra l’atterraggio e il primo messaggio inviato?
Un funnel. Nomina i passaggi in ordine e ti torna quante persone hanno raggiunto ciascuno, e la conversione rispetto al passaggio precedente e al primo.
Delle persone iscritte ad agosto, quante erano ancora attive alla quarta settimana?
Retention. Coorte per coorte, per settimana o per mese — la domanda a cui un conteggio di iscrizioni non può rispondere.
Come si chiamano i nostri insight salvati?
Elenca quelli che il tuo team ha già costruito e nominato, così puoi eseguire la definizione condivisa invece di una derivazione nuova che le somiglia soltanto.
Se non sei sicuro che un evento esista, chiedi quali eventi ci sono. Il nome di un evento scritto male restituisce un grafico vuoto invece di un errore, ed è l’unico modo in cui una risposta sbagliata può sembrare vera — quindi 1Presence verifica i nomi quando non è certo, e puoi farlo anche tu.
Fai arrivare il lunedì da solo
Il senso di chiedere di solito è accorgersi che qualcosa è cambiato. E questo funziona meglio a una cadenza fissa che a capriccio, quindi il passo naturale successivo è una routine: un’istruzione fissa che gira una mattina che scegli tu, fa le domande che ti stanno a cuore e ti dice che cosa si è mosso.
- 1
Descrivi la revisione che vuoi
Chiedi una routine con parole tue — “ogni lunedì alle otto, tira su le iscrizioni della settimana scorsa, il funnel di attivazione e la retention alla quarta settimana, e dimmi che cosa è cambiato”. Le domande le scegli tu; la forma è la stessa che stavi già facendo a mano.
- 2
Falle archiviare i numeri
Chiedi che le cifre atterrino in un dataset e le letture settimanali della routine diventano righe che puoi mettere in grafico. Una dashboard disegnata da quel dataset è poi la cosa che guardi a colpo d’occhio, ed è fatta dei tuoi numeri invece che di una copia di quelli di PostHog.
- 3
Leggila come un racconto, non come una tabella
La parte utile di una revisione settimanale è la frase, non il numero. Chiedi alla routine di dire che cosa si è mosso e che cosa no, e di segnalare tutto quello che ha rotto il suo andamento — è proprio il pezzo che altrimenti dovresti ricavare tu.
Una connessione per tutto un team
Un progetto PostHog appartiene all’azienda. Quindi in uno spazio di team viene collegato una volta sola, da un amministratore, nelle impostazioni dell’organizzazione — e da lì in poi tutti possono fare domande sui numeri del prodotto senza configurare niente. Nessuno lo collega due volte, e non smette di funzionare quando la persona che l’ha impostato se ne va.
L’impostazione sui dati a livello di persona è dell’organizzazione allo stesso modo: decisa una volta da un amministratore invece che persona per persona, perché la credenziale attraverso cui tutti leggono è una sola. Il tuo PostHog personale, se ne hai uno, resta completamente separato: chiedere nello spazio del team legge il progetto del team, chiedere nel tuo legge il tuo.
Che cosa non farà
- Non può cambiare niente. Né un flag, né un insight, né una persona, né una coorte. La chiave non ha permessi di scrittura e qui non esiste nessuno strumento che potrebbe usarli. Se gli chiedi di cambiare qualcosa in PostHog, ti dirà chiaramente che non può.
- Non ti consegnerà un elenco di persone. A meno che tu non abbia acceso i dati a livello di persona — cosa che richiede la casella qui e il permesso corrispondente sulla chiave — una domanda che restituirebbe singole persone viene rifiutata con una spiegazione. Questo vale anche per il tentativo di raggiungerle di lato con una query scritta a mano.
- Non legge in sottofondo. Una query gira perché l’hai chiesta, o perché una routine che hai impostato l’ha chiesta a una certa ora. Le query sono delimitate a un intervallo di date e usano i risultati già memorizzati da PostHog quando sono freschi.
- Legge i risultati come informazione. Il nome di un evento o il valore di una proprietà che sembra un’istruzione è una riga in una tabella, non un comando che seguirà.
Il cambio di passo
La revisione settimanale, senza aprire niente.
Collegalo una volta, chiedi in una frase, e lascia che una routine te la porti il lunedì. Sola lettura dappertutto, aggregati per impostazione predefinita, e condiviso con tutto il team da una sola connessione.