Aprende cómo recuperar datos estadísticos de tu cuenta de Snov.io utilizando solicitudes API.
Esta guía explica dos solicitudes:
Revisemos sus casos de uso y parámetros principales.
Obtener análisis de campaña
Antes de realizar cualquier solicitud API, obtén el «access_token» utilizando la solicitud de autenticación: https://api.snov.io/v1/oauth/access_token.
Tipo de solicitud: GET
URL de solicitud: https://api.snov.io/v2/statistics/campaign-analytics
Enlace a la documentación de la API.
Esta solicitud proporciona análisis detallados de tus campañas en Snov.io. Utilízala para recuperar datos sobre el éxito general de la campaña o filtrar resultados por campañas, remitentes, miembros del equipo o períodos de tiempo.
También puede ayudarte a generar informes automáticamente con los datos de tu cuenta e integrar tus KPIs de Snov.io en tu proceso de informes.
Parámetros de la solicitud
Todos los parámetros en esta solicitud son opcionales. Si no se proporcionan parámetros, la solicitud devolverá las estadísticas generales de todas las campañas y cuentas.
Para filtrar los datos en la respuesta, aplica los filtros relevantes en los parámetros de la solicitud. Consulta la lista completa de parámetros en la documentación de la API.
Por ejemplo, usa el campo «campaign_id» en los parámetros de la solicitud para especificar los ID de las campañas para las que deseas recuperar estadísticas. Agrega los ID de campañas específicas o múltiples (separados por comas).
Para encontrar el ID de una campaña, abre la campaña relevante en tu lista de campañas. El ID de campaña es el número al final de la URL en la barra de direcciones de tu navegador. (Ejemplo: en la URL de la campaña: https://app.snov.io/campaigns/2402609, the ID is «2402609»).
Para recuperar datos de miembros específicos del equipo, usa el campo «campaign_owner». Ingresa las direcciones de correo electrónico que los miembros del equipo usan para unirse al equipo en Snov.io.
Encuentra los correos electrónicos de los miembros del equipo en la página «Mi equipo«. El filtro «Campaign owner» está disponible si eres líder del equipo en Snov.io o tienes habilitada la opción «Ver registros del equipo».
Resultado de la solicitud
La respuesta incluye todas las métricas predeterminadas de tu alcance en Snov.io, cubriendo estadísticas de automatización de correo electrónico y LinkedIn.
Los datos de cada métrica devueltos en los resultados dependen de los filtros aplicados. Si contiene valores cero (0), significa que no hay datos disponibles según los parámetros de la solicitud. Ajusta tu solicitud para acceder a más datos de campaña.
Campos de datos generales: Total de prospectos contactados (por correo electrónico o LinkedIn).
Campos de datos de correo electrónico: Contactados por correo electrónico, correos enviados, primeros correos, seguimientos, entregados, rebotados, aperturas de correo, clics en enlaces, respuestas de correo, desuscripciones y respuestas automáticas.
Campos de datos de LinkedIn: Contactados por LinkedIn, respuestas de LinkedIn (para todos los tipos de mensajes), solicitudes de conexión, solicitudes de conexión fallidas, solicitudes aceptadas, mensajes enviados; vistas de LinkedIn, seguidores, me gusta.
Consulta la lista completa de campos proporcionados en la respuesta de la API. La representación visual de estos datos se puede encontrar en el panel de informes de la aplicación Snov.io.
Ver progreso de campaña
Antes de realizar cualquier solicitud API, obtén el «access_token» utilizando la solicitud de autenticación: https://api.snov.io/v1/oauth/access_token.
Tipo de solicitud: GET
URL de solicitud: https://api.snov.io/v2/campaigns/[campaign_id]/progress
Enlace a la documentación de la API.
Usa esta solicitud para obtener datos sobre cuántos destinatarios han completado la campaña, cuántos están aún en progreso y cuántos se han detenido debido a razones específicas. Esto te ayuda a seguir el progreso de la campaña y hacer ajustes según sea necesario.
Parámetros de la solicitud
Esta solicitud requiere un parámetro: el ID de campaña, un identificador único para la campaña en tu cuenta de Snov.io.
Para encontrar el ID de una campaña, abre la campaña relevante en tu lista de campañas. El ID de campaña es el número al final de la URL en la barra de direcciones de tu navegador. (Ejemplo: en la URL de la campaña: https://app.snov.io/campaigns/2402609, el ID es «2402609»)
Usa el campo «campaign_id» en los parámetros de la solicitud para especificar la campaña de la que deseas ver el progreso. Una solicitud puede proporcionar datos de una sola campaña. Realiza solicitudes adicionales para obtener el progreso de más campañas.
Resultado de la solicitud
El campo «Progreso» en la respuesta se muestra como el porcentaje de prospectos para los cuales la secuencia de la campaña especificada se completó, o para los cuales la secuencia fue detenida.
Las razones para detener la secuencia incluyen: el correo rebotó, los prospectos respondieron, respondieron automáticamente, se dieron de baja, fueron eliminados de la campaña o movidos a otra lista de prospectos.
Consulta la lista completa de campos proporcionados en la respuesta de la API.
El campo «No terminado» en la respuesta muestra el número de destinatarios para los cuales la secuencia sigue en progreso. Estos destinatarios aún no han alcanzado el final de la secuencia y no se ha detenido para ellos (por las razones listadas en el campo «Progreso»).
El resultado también proporciona el «Estado» actual de la campaña en el momento de la solicitud. Aprende más sobre los posibles estados de campaña en este artículo de la base de conocimientos.