Cómo obtener análisis de campañas a través de API

Esta guía explica cómo recuperar análisis de campañas y datos de interacción de los destinatarios mediante la API de Snov.io.

La API de Analítica e Informes de Snov.io proporciona acceso a los datos de rendimiento de tus campañas de prospección. Recupera el progreso de las campañas, las métricas de interacción y la actividad de los destinatarios en campañas de correo electrónico y LinkedIn mediante solicitudes a la API.

Qué puedes hacer con esta API:

1) Supervisar los resultados de las campañas de correo electrónico y LinkedIn.

2. Sincronizar la interacción de los destinatarios con tu CRM.

3. Crear paneles e informes internos.

4. Coordinar flujos de trabajo según las respuestas, aperturas o clics.

Utiliza el método de autenticación para obtener un access_token. Inclúyelo como un token Bearer en todas las solicitudes. El token es válido durante 1 hora (3600 segundos).

Consultar campañas y progreso

Ver todas las campañas

Recupera una lista de todas las campañas de tu cuenta de Snov.io, incluidos sus ID y detalles básicos.

Utiliza este método para obtener los ID de las campañas necesarios para solicitar datos mediante otros métodos.

Datos que proporciona:

• ID de la campaña
• Nombre de la campaña
• Estado de la campaña
• Fecha de creación

Ver el progreso de una campaña

Consulta el estado actual y el progreso de una campaña específica.

Utiliza este método para supervisar si una campaña está en ejecución, se ha completado, está en pausa o requiere atención.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• status: Estado actual de la campaña (activa, en pausa, completada o archivada).
• progress: Muestra el porcentaje de prospectos que llegaron al último paso de la secuencia y el porcentaje de aquellos para los que la campaña finalizó antes de tiempo debido a un rebote, una respuesta, una respuesta automática, una cancelación de suscripción, una eliminación o una eliminación manual.
• unfinished: Número de destinatarios programados para recibir los próximos pasos de la secuencia.

Estadísticas e informes de campañas

Utiliza los siguientes métodos para obtener métricas de interacción y rendimiento de las campañas.

Obtener análisis de campañas

Recupera estadísticas agregadas del rendimiento de tus campañas.

Utiliza este método para crear informes, supervisar los KPI de prospección y sincronizar las estadísticas de las campañas con paneles o herramientas de analítica externas.

Parámetros obligatorios:

Especifica el intervalo de fechas del que deseas obtener las estadísticas.

• date_from — fecha de inicio del período del informe (AAAA-MM-DD).
• date_to — fecha de finalización del período del informe (AAAA-MM-DD).

Los parámetros opcionales funcionan como filtros para limitar el alcance de los datos devueltos.

• campaign_id — obtener estadísticas de una campaña específica.
• campaign_owner — obtener estadísticas de un miembro específico del equipo.
• sender_email — obtener estadísticas de una cuenta de correo electrónico remitente específica.
• sender_linkedin — obtener estadísticas de un perfil específico de LinkedIn.

Datos que proporciona:

La respuesta contiene datos agregados del rendimiento en los canales de correo electrónico y LinkedIn:

• Métricas generales de prospección: total de prospectos contactados, correos electrónicos programados, correos electrónicos enviados y total de rebotes detectados.
• Métricas de interacción por correo electrónico: aperturas, clics, respuestas, cancelaciones de suscripción, tasa de apertura, tasa de clics y tasa de respuesta.
• Métricas de actividad en LinkedIn: solicitudes de conexión enviadas, conexiones aceptadas, mensajes enviados y respuestas recibidas.

Obtener la actividad de los destinatarios de una campaña

Recupera datos detallados de interacción de todos los destinatarios de una campaña, incluidas las interacciones por correo electrónico y LinkedIn.

Utiliza este método para sincronizar los datos de interacción con tu CRM, plataforma de analítica o herramientas de informes.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• Actividad por correo electrónico de cada destinatario: correos electrónicos enviados, abiertos, clics, respuestas y rebotes.
• Actividad en LinkedIn de cada destinatario: solicitudes de conexión enviadas y aceptadas, mensajes enviados y respuestas recibidas.
• Marcas de tiempo de cada evento de interacción.

Obtener las respuestas de una campaña

Recupera las respuestas por correo electrónico recibidas en una campaña específica.

Utiliza este método para enviar los datos de las respuestas a tu CRM o a tus flujos de automatización cuando solo necesites las respuestas por correo electrónico, sin incluir las respuestas de LinkedIn. Para obtener las respuestas de LinkedIn (solicitudes de conexión, mensajes directos o InMail), utiliza el método Obtener todas las respuestas de una campaña.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• Asunto y cuerpo del correo electrónico.
• Paso de la secuencia que generó la respuesta (step_number).
• Sentimiento de la respuesta detectado por IA (mood).
• Marca de tiempo de la respuesta.

Obtener todas las respuestas de una campaña

Recupera todas las respuestas recibidas en una campaña específica, tanto de correo electrónico como de LinkedIn.

Utiliza este método para supervisar las respuestas de los prospectos y enviar esos datos a tu CRM o a tus flujos de automatización.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• Tipo de respuesta: respuesta por correo electrónico o respuesta de LinkedIn.
• Asunto y cuerpo del correo electrónico.
• Contenido de la respuesta en LinkedIn.
• Paso de la secuencia que generó la respuesta (step_number).
• Sentimiento de la respuesta detectado por IA (mood).
• Marca de tiempo de la respuesta.

Obtener las aperturas de correos electrónicos

Recupera datos sobre los destinatarios que abrieron los correos electrónicos de una campaña.

Utiliza este método para supervisar la interacción por correo electrónico y medir las tasas de apertura.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• Número de veces que se abrió el correo electrónico.
• Marca de tiempo de la primera apertura y de la apertura más reciente.

Obtener los clics en los enlaces

Recupera datos sobre los destinatarios que hicieron clic en los enlaces incluidos en los correos electrónicos de una campaña.

Utiliza este método para realizar un seguimiento de la interacción mediante clics y del rendimiento del contenido.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• URL en la que se hizo clic.
• Número de clics por destinatario.
• Marca de tiempo del clic.

Obtener los correos electrónicos enviados

Recupera una lista de los correos electrónicos enviados dentro de una campaña.

Utiliza este método para validar los registros de entrega y realizar un seguimiento de la actividad de envío.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• Cuenta de remitente utilizada.
• Asunto del correo electrónico.
• Número del paso de la secuencia.
• Marca de tiempo del envío.

Obtener los prospectos que completaron la campaña

Recupera los prospectos que completaron todos los pasos de la secuencia de una campaña.

Utiliza estos datos para identificar a los destinatarios que finalizaron la secuencia y que podrían necesitar un seguimiento o ser inscritos en otra campaña.

Parámetro obligatorio:

• campaign_id — el ID de la campaña.

Datos que proporciona:

• Datos del prospecto: nombre y dirección de correo electrónico.
• Fecha en que el prospecto completó la secuencia.
• Último paso de la secuencia alcanzado.