En esta guía· 5 capítulos
Una clave que creas tú, con permiso solo de lectura
PostHog guarda los números. Estás a punto de hacer que respondan a una frase.
La conexión funciona con una clave que creas en tu propio PostHog y que puedes revocar allí en cualquier momento. Tú eliges sus permisos, y los que esto necesita son todos de lectura, así que la clave misma es la razón por la que nada de aquí puede cambiar tus analíticas.
- 1
Crea una personal API key en PostHog
En PostHog, ve a Ajustes y crea una personal API key. Dale los permisos de lectura que enumera el panel de conexión: proyecto, consulta, insight, cohorte, panel, las definiciones de eventos y propiedades, y analítica web. No le des nada más: una clave sin permiso de escritura no puede escribir, le pidas lo que le pidas.
- 2
Elige tu región y pégala
Abre Conectores en 1Presence, elige PostHog y escoge dónde vive tu cuenta: la nube de EE. UU., la de la UE, o tu propia dirección si alojas PostHog tú mismo. Pega la clave y se comprueba contra tu cuenta en ese momento, así que sabes al instante si funcionó.
- 3
Deja apagados los datos de personas
Hay una casilla para ello, y apagada es la respuesta correcta para casi todo el mundo. Apagada sigues teniendo recuentos, tendencias, embudos, retención, desgloses y tus insights guardados: todo lo de abajo funciona. Lo que no obtienes son las identidades de las personas concretas detrás de los números, que son datos de tus clientes y no tuyos.
¿Pegaste una clave que empieza por phc_? Esa es la clave pública de proyecto con la que tu web envía eventos, y no puede leer nada. La que quieres empieza por phx_ y sale de la página de personal API keys; el panel te avisará si pegas la que no es.
Cuatro formas de pregunta
No hace falta que sepas qué tipo de gráfico quieres. Haz la pregunta que de verdad tienes y 1Presence elige la forma, pero conviene conocer las cuatro, porque es a lo que suele reducirse una pregunta sobre un producto.
Empieza por estas y ve variándolas:
¿Cuánta gente se registró cada semana en los últimos tres meses?
Una tendencia. Cualquier evento que registres, en cualquier periodo, contado como total o como personas únicas. Añade "divídelo por campaña" y lo recibes desglosado.
¿Dónde abandona la gente entre llegar y mandar un primer mensaje?
Un embudo. Nombra los pasos en orden y recibe cuántos llegaron a cada uno, y la conversión desde el paso anterior y desde el principio.
De los que se registraron en agosto, ¿cuántos seguían activos en la cuarta semana?
Retención. Cohorte a cohorte, por semana o por mes: la pregunta que un recuento de registros no puede responder.
¿Cómo se llaman nuestros insights guardados?
Enumera lo que tu equipo ya ha creado y nombrado, para que ejecutes la definición acordada en vez de una derivación nueva casi igual.
Si no estás seguro de que un evento exista, pregunta qué eventos hay. Un nombre de evento mal escrito devuelve un gráfico vacío en vez de un error, que es la única manera en que una respuesta equivocada puede parecer real, así que 1Presence comprueba los nombres cuando no está seguro, y tú también puedes.
Haz que el lunes llegue solo
El sentido de preguntar suele ser darse cuenta de que algo cambió. Eso funciona mejor con un horario que por impulso, así que el siguiente paso natural es una rutina: una instrucción permanente que se ejecuta la mañana que elijas, hace las preguntas que te importan y te cuenta qué se movió.
- 1
Describe la revisión que quieres
Pide una rutina con tus palabras: "cada lunes a las ocho, saca los registros de la semana pasada, el embudo de activación y la retención de la cuarta semana, y cuéntame qué cambió". Las preguntas son tuyas; la forma es la misma que venías haciendo a mano.
- 2
Haz que archive los números
Pide que las cifras aterricen en un conjunto de datos y las lecturas semanales de la rutina se convierten en filas que puedes graficar. Un panel dibujado a partir de ese conjunto es entonces lo que miras de un vistazo, y está hecho de tus propios números en vez de ser una copia de los de PostHog.
- 3
Léelo como un relato, no como una tabla
Lo útil de una revisión semanal es la frase, no la cifra. Pide a la rutina que diga qué se movió y qué no, y que señale lo que se haya salido de su tendencia: esa es la parte que si no tendrías que sacar tú.
Una conexión para todo un equipo
Un proyecto de PostHog es de la empresa. Así que en un espacio de equipo lo conecta una vez un administrador, en los ajustes de la organización, y a partir de ahí todo el mundo puede preguntar por los números del producto sin configurar nada. Nadie lo conecta dos veces, y no deja de funcionar cuando la persona que lo montó se va.
El ajuste de datos de personas es de la organización igual: lo toma una vez un administrador en vez de persona a persona, porque la credencial a través de la que todos leen es una sola. Tu PostHog personal, si tienes uno, sigue completamente aparte: preguntar en el espacio del equipo lee el proyecto del equipo, y preguntar en el tuyo lee el tuyo.
Lo que no va a hacer
- No puede cambiar nada. Ni un flag, ni un insight, ni una persona, ni una cohorte. La clave no tiene permiso de escritura y aquí no hay ninguna herramienta que pudiera usarlo. Si le pides que cambie algo en PostHog, te dirá claramente que no puede.
- No te entregará una lista de personas. Salvo que hayas encendido los datos de personas —lo que necesita la casilla de aquí y el permiso correspondiente en la clave—, una pregunta que devolvería personas concretas se rechaza con una explicación. Eso incluye llegar a ellas de lado con una consulta escrita a mano.
- No lee de fondo. Una consulta se ejecuta porque preguntaste, o porque una rutina que montaste preguntó según un horario. Las consultas van acotadas a un rango de fechas y usan los resultados en caché de PostHog cuando siguen frescos.
- Lee los resultados como información. Un nombre de evento o un valor de propiedad que suene a instrucción es una fila en una tabla, no una orden que vaya a seguir.
El cambio
La revisión semanal, sin abrir nada.
Conecta una vez, pregunta en una frase y deja que una rutina te lo traiga el lunes. Solo lectura de principio a fin, agregados por defecto, y compartido con todo tu equipo desde una sola conexión.