Aprenda como recuperar dados estatísticos da sua conta Snov.io usando solicitações de API.
Este guia explica duas solicitações:
Vamos revisar seus casos de uso e principais parâmetros.
Obtenha análises de campanha
Antes de fazer qualquer solicitação de API, obtenha “access_token” usando a solicitação de autenticação: https://api.snov.io/v1/oauth/access_token.
Tipo de solicitação: GET
URL da solicitação: https://api.snov.io/v2/statistics/campaign-analytics
Link para documentação da API.
Esta solicitação fornece análises detalhadas para suas campanhas Snov.io. Use-a para recuperar dados sobre o sucesso geral da campanha ou filtrar resultados por campanhas, remetentes, membros da equipe ou períodos de tempo.
Ele também pode ajudar você a gerar relatórios automaticamente com dados da sua conta e integrar seus KPIs da Snov.io ao seu processo de relatórios.
Parâmetros da solicitação
Todos os parâmetros nesta solicitação são opcionais. Se nenhum parâmetro for fornecido, a solicitação retornará estatísticas de todos os tempos para todas as campanhas e contas.
Para filtrar dados em resposta, aplique filtros relevantes nos parâmetros da solicitação. Veja a lista completa de parâmetros na documentação da API.
Por exemplo, use o campo “campaign_id” nos parâmetros de solicitação para especificar os IDs das campanhas para as quais você deseja recuperar estatísticas. Adicione IDs para campanhas específicas ou múltiplas (separadas por vírgula).
Para encontrar um ID de campanha, abra a campanha relevante na sua lista de campanhas. O ID da campanha é o número no final da URL na barra de endereços do seu navegador. (Exemplo: na URL da campanha: https://app.snov.io/campaigns/2402609 , o ID é “2402609”).
Para recuperar dados de membros específicos da equipe, use o campo “campaign_owner”. Insira os endereços de e-mail que os membros da equipe usam para entrar na equipe na Snov.io.
Resultado da solicitação
A resposta inclui todas as métricas padrão do seu alcance na Snov.io, abrangendo estatísticas de automação de e-mail e LinkedIn.
Campos de dados gerais: Total de clientes potenciais contatados (por e-mail ou LinkedIn).
Campos de dados de e-mail: Contatados por e-mail, e-mails enviados, primeiros e-mails, acompanhamentos, entregues, devolvidos, e-mails abertos, cliques em links, respostas de e-mail, assinaturas canceladas e respostas automáticas.
Campos de dados do LinkedIn: contatados pelo LinkedIn, respostas do LinkedIn (para todos os tipos de mensagens), solicitações de conexão, solicitações de conexão com falha, solicitações aceitas, mensagens enviadas; visualizações, seguidores e curtidas do LinkedIn.
Veja a lista completa de campos fornecidos na resposta da API. A representação visual desses dados pode ser encontrada no painel Reports no aplicativo Snov.io.
Ver o progresso da campanha
Antes de fazer qualquer solicitação de API, obtenha “access_token” usando a solicitação de autenticação: https://api.snov.io/v1/oauth/access_token.
Tipo de solicitação: GET
URL da solicitação: https://api.snov.io/v2/campaigns/[campaign_id]/progress
Link para documentação da API.
Use esta solicitação para obter dados sobre quantos destinatários concluíram a campanha, quantos ainda estão em andamento e quantos pararam devido a razões específicas. Isso ajuda você a rastrear o progresso da campanha e fazer ajustes conforme necessário.
Parâmetros da solicitação
Esta solicitação requer um parâmetro: o ID da campanha, um identificador exclusivo para a campanha na sua conta Snov.io.
Para encontrar um ID de campanha, abra a campanha relevante na sua lista de campanhas. O ID da campanha é o número no final da URL na barra de endereços do seu navegador. (Exemplo: na URL da campanha: https://app.snov.io/campaigns/2402609 , o ID é “2402609”).
Use o campo “campaign_id” nos parâmetros de solicitação para especificar a campanha cujo progresso você deseja ver. Uma solicitação pode fornecer dados para uma campanha. Faça solicitações adicionais para obter o progresso de mais campanhas.
Resultado da solicitação
O campo “Progresso” na resposta é mostrado como a porcentagem de clientes potenciais para os quais a sequência da campanha especificada foi concluída ou para os quais a sequência foi interrompida. Os motivos para interromper a sequência incluem: o e-mail foi devolvido, os clientes potenciais responderam, responderam automaticamente ou cancelaram a assinatura, foram excluídos da campanha ou movidos para outra lista de clientes potenciais.
Veja a lista completa de campos fornecidos na resposta da API.
O campo “Unfinished” na resposta mostra o número de destinatários para os quais a sequência ainda está em andamento. Esses destinatários ainda não chegaram ao fim da sequência, e ela não foi interrompida para eles (devido aos motivos listados no campo “Progress”.)
O resultado também fornece o “Status” atual da campanha no momento da solicitação. Saiba mais sobre possíveis status de campanha no artigo da base de conhecimento.