{"id":36144,"date":"2024-12-20T16:03:39","date_gmt":"2024-12-20T13:03:39","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=36144"},"modified":"2025-05-12T15:02:31","modified_gmt":"2025-05-12T12:02:31","slug":"como-obter-analises-de-campanha-via-api","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/br\/como-obter-analises-de-campanha-via-api\/","title":{"rendered":"Como obter an\u00e1lises de campanha via API"},"content":{"rendered":"<p>Aprenda como recuperar dados estat\u00edsticos da sua conta Snov.io usando solicita\u00e7\u00f5es de API.<\/p>\n<p>Este guia explica duas solicita\u00e7\u00f5es:<\/p>\n<p><a href=\"#obtenha\"><b>Obtenha an\u00e1lises de campanha<\/b><\/a><\/p>\n<p><a href=\"#progresso\"><b>Ver o progresso da campanha<\/b><\/a><\/p>\n<p>Vamos revisar seus casos de uso e principais par\u00e2metros.<\/p>\n<h2 id=\"get-campaign-analytics\"><strong><a id=\"obtenha\"><\/a>Obtenha an\u00e1lises de campanha<\/strong><\/h2>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Antes de fazer qualquer solicita\u00e7\u00e3o de API, obtenha \u201caccess_token\u201d usando a solicita\u00e7\u00e3o de autentica\u00e7\u00e3o:\u00a0<a href=\"https:\/\/api.snov.io\/v1\/oauth\/access_token\">https:\/\/api.snov.io\/v1\/oauth\/access_token<\/a>.<\/p>\n<\/div>\n<\/div>\n<p><b>Tipo de solicita\u00e7\u00e3o:\u00a0<\/b>GET<\/p>\n<p><b>URL da solicita\u00e7\u00e3o:\u00a0<\/b><a href=\"https:\/\/api.snov.io\/v2\/statistics\/campaign-analytics\">https:\/\/api.snov.io\/v2\/statistics\/campaign-analytics<\/a><\/p>\n<p><a href=\"https:\/\/snov.io\/api#GetcampaignAnalytics\" target=\"_blank\" rel=\"noopener\">Link para documenta\u00e7\u00e3o da API.<\/a><\/p>\n<p>Esta solicita\u00e7\u00e3o fornece an\u00e1lises 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\u00edodos de tempo.<\/p>\n<p>Ele tamb\u00e9m pode ajudar voc\u00ea a gerar relat\u00f3rios automaticamente com dados da sua conta e integrar seus KPIs da Snov.io ao seu processo de relat\u00f3rios.<\/p>\n<h3><b>Par\u00e2metros da solicita\u00e7\u00e3o<\/b><\/h3>\n<p>Todos os par\u00e2metros nesta solicita\u00e7\u00e3o s\u00e3o opcionais. Se nenhum par\u00e2metro for fornecido, a solicita\u00e7\u00e3o retornar\u00e1 estat\u00edsticas de todos os tempos para todas as campanhas e contas.<\/p>\n<p>Para filtrar dados em resposta, aplique filtros relevantes nos par\u00e2metros da solicita\u00e7\u00e3o.\u00a0Veja a lista completa de par\u00e2metros\u00a0<a href=\"https:\/\/snov.io\/api#GetcampaignAnalytics\" target=\"_blank\" rel=\"noopener\">na documenta\u00e7\u00e3o da API<\/a>.<\/p>\n<p>Por exemplo, use o campo\u00a0<b>\u201ccampaign_id\u201d\u00a0<\/b>nos par\u00e2metros de solicita\u00e7\u00e3o para especificar os IDs das campanhas para as quais voc\u00ea deseja recuperar estat\u00edsticas. Adicione IDs para campanhas espec\u00edficas ou m\u00faltiplas (separadas por v\u00edrgula).<\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Para encontrar um ID de campanha, abra a campanha relevante na sua lista de campanhas. O ID da campanha \u00e9 o n\u00famero no final da URL na barra de endere\u00e7os do seu navegador. (Exemplo: na URL da campanha:\u00a0<a href=\"https:\/\/app.snov.io\/campaigns\/2402609\">https:\/\/app.snov.io\/campaigns\/2402609<\/a>\u00a0, o ID \u00e9 \u201c2402609\u201d).<\/p>\n<\/div>\n<\/div>\n<p>Para recuperar dados de membros espec\u00edficos da equipe, use o campo\u00a0<b>\u201ccampaign_owner\u201d<\/b>. Insira os endere\u00e7os de e-mail que os membros da equipe usam para entrar na equipe na Snov.io.<\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>Encontre os e-mails dos membros da equipe na p\u00e1gina\u00a0<a href=\"https:\/\/app.snov.io\/account\/team\" target=\"_blank\" rel=\"noopener\">Minha Equipe<\/a>. O filtro \u201cPropriet\u00e1rio da campanha\u201d est\u00e1 dispon\u00edvel se voc\u00ea for um l\u00edder de equipe na Snov.io ou tiver a permiss\u00e3o \u201cExibir registros da equipe\u201d habilitada.<\/p>\n<\/div>\n<\/div>\n<h3><b>Resultado da solicita\u00e7\u00e3o<\/b><\/h3>\n<p>A resposta inclui todas as m\u00e9tricas padr\u00e3o do seu alcance na Snov.io, abrangendo estat\u00edsticas <a href=\"https:\/\/snov.io\/linkedin-automation-tools\" target=\"_blank\" rel=\"noopener\">de automa\u00e7\u00e3o de e-mail e LinkedIn<\/a>.<\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>Os dados para cada m\u00e9trica retornada nos resultados dependem dos filtros aplicados. Se contiver zero (0) valores, significa que n\u00e3o h\u00e1 dados dispon\u00edveis com base nos par\u00e2metros da solicita\u00e7\u00e3o. Ajuste sua solicita\u00e7\u00e3o para acessar mais dados da campanha.<\/p>\n<\/div>\n<\/div>\n<p><strong>Campos de dados gerais:<\/strong>\u00a0Total de clientes potenciais contatados (por e-mail ou LinkedIn).<\/p>\n<p><strong>Campos de dados de e-mail:<\/strong>\u00a0Contatados 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\u00e1ticas.<\/p>\n<p><strong>Campos de dados do LinkedIn:<\/strong>\u00a0contatados pelo LinkedIn, respostas do LinkedIn (para todos os tipos de mensagens), solicita\u00e7\u00f5es de conex\u00e3o, solicita\u00e7\u00f5es de conex\u00e3o com falha, solicita\u00e7\u00f5es aceitas, mensagens enviadas; visualiza\u00e7\u00f5es, seguidores e curtidas do LinkedIn.<\/p>\n<p>Veja a lista completa de campos\u00a0<a href=\"https:\/\/snov.io\/api#GetcampaignAnalytics\" target=\"_blank\" rel=\"noopener\">fornecidos na resposta da API<\/a>.\u00a0\u00a0A representa\u00e7\u00e3o visual desses dados pode ser encontrada no\u00a0<a href=\"https:\/\/app.snov.io\/campaigns\/reports\" target=\"_blank\" rel=\"noopener\">painel Reports<\/a>\u00a0no aplicativo Snov.io.<\/p>\n<h2 id=\"view-campaign-progress\"><strong><a id=\"progresso\"><\/a>Ver o progresso da campanha<\/strong><\/h2>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Antes de fazer qualquer solicita\u00e7\u00e3o de API, obtenha \u201caccess_token\u201d usando a solicita\u00e7\u00e3o de autentica\u00e7\u00e3o:\u00a0<a href=\"https:\/\/api.snov.io\/v1\/oauth\/access_token\">https:\/\/api.snov.io\/v1\/oauth\/access_token<\/a>.<\/p>\n<\/div>\n<\/div>\n<p><b>Tipo de solicita\u00e7\u00e3o:\u00a0<\/b>GET<\/p>\n<p><b>URL da solicita\u00e7\u00e3o:\u00a0<\/b><a href=\"https:\/\/api.snov.io\/v2\/campaigns\/[campaign_id]\/progress\">https:\/\/api.snov.io\/v2\/campaigns\/[campaign_id]\/progress<\/a><\/p>\n<p><a href=\"https:\/\/snov.io\/api#ViewcampaignProgress\" target=\"_blank\" rel=\"noopener\">Link para documenta\u00e7\u00e3o da API.<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para obter dados sobre quantos destinat\u00e1rios conclu\u00edram a campanha, quantos ainda est\u00e3o em andamento e quantos pararam devido a raz\u00f5es espec\u00edficas. Isso ajuda voc\u00ea a rastrear o progresso da campanha e fazer ajustes conforme necess\u00e1rio.<\/p>\n<h3><b>Par\u00e2metros da solicita\u00e7\u00e3o<\/b><\/h3>\n<p>Esta solicita\u00e7\u00e3o requer um par\u00e2metro: o ID da campanha, um identificador exclusivo para a campanha na sua conta Snov.io.<\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Para encontrar um ID de campanha, abra a campanha relevante na sua lista de campanhas. O ID da campanha \u00e9 o n\u00famero no final da URL na barra de endere\u00e7os do seu navegador. (Exemplo: na URL da campanha:\u00a0<a href=\"https:\/\/app.snov.io\/campaigns\/2402609\">https:\/\/app.snov.io\/campaigns\/2402609<\/a>\u00a0, o ID \u00e9 \u201c2402609\u201d).<\/p>\n<\/div>\n<\/div>\n<p>Use o campo\u00a0<b>\u201ccampaign_id\u201d\u00a0<\/b>nos par\u00e2metros de solicita\u00e7\u00e3o para especificar a campanha cujo progresso voc\u00ea deseja ver. Uma solicita\u00e7\u00e3o pode fornecer dados para uma campanha. Fa\u00e7a solicita\u00e7\u00f5es adicionais para obter o progresso de mais campanhas.<\/p>\n<h3><strong>Resultado da solicita\u00e7\u00e3o<\/strong><\/h3>\n<p>O campo\u00a0<strong>\u201cProgresso\u201d<\/strong>\u00a0na resposta \u00e9 mostrado como a porcentagem de clientes potenciais para os quais a sequ\u00eancia da campanha especificada foi conclu\u00edda ou para os quais a sequ\u00eancia foi interrompida. Os motivos para interromper a sequ\u00eancia incluem: o e-mail foi devolvido, os clientes potenciais responderam, responderam automaticamente ou cancelaram a assinatura, foram exclu\u00eddos da campanha ou movidos para outra lista de clientes potenciais.<\/p>\n<p>Veja a lista completa de campos\u00a0<a href=\"https:\/\/snov.io\/api#ViewcampaignProgress\" target=\"_blank\" rel=\"noopener\">fornecidos na resposta da API<\/a>.<\/p>\n<p>O campo\u00a0<strong>\u201cUnfinished\u201d<\/strong>\u00a0na resposta mostra o n\u00famero de destinat\u00e1rios para os quais a sequ\u00eancia ainda est\u00e1 em andamento. Esses destinat\u00e1rios ainda n\u00e3o chegaram ao fim da sequ\u00eancia, e ela n\u00e3o foi interrompida para eles (devido aos motivos listados no campo \u201cProgress\u201d.)<\/p>\n<p>O resultado tamb\u00e9m fornece o\u00a0<strong>\u201cStatus\u201d<\/strong>\u00a0atual da campanha no momento da solicita\u00e7\u00e3o. Saiba mais sobre poss\u00edveis status de campanha no\u00a0<a href=\"https:\/\/snov.io\/knowledgebase\/br\/status-da-campanha\/\" target=\"_blank\" rel=\"noopener\">artigo da base de conhecimento<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Aprenda como recuperar dados estat\u00edsticos da sua conta Snov.io usando solicita\u00e7\u00f5es de API. Este guia explica duas solicita\u00e7\u00f5es: Obtenha an\u00e1lises de campanha Ver o progresso da campanha Vamos revisar seus casos de uso e principais par\u00e2metros. Obtenha an\u00e1lises de campanha Antes de fazer qualquer solicita\u00e7\u00e3o de API, obtenha \u201caccess_token\u201d usando a solicita\u00e7\u00e3o de autentica\u00e7\u00e3o:\u00a0https:\/\/api.snov.io\/v1\/oauth\/access_token. Tipo [&hellip;]<\/p>\n","protected":false},"author":17,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2312],"tags":[],"_links":{"self":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/36144"}],"collection":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/comments?post=36144"}],"version-history":[{"count":1,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/36144\/revisions"}],"predecessor-version":[{"id":39727,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/36144\/revisions\/39727"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=36144"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=36144"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=36144"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}