Exporte seus dados de mensagens como um arquivo CSV para analisar o desempenho das suas mensagens. Com esses dados, você pode:
Combine dados de mensagens do Intercom com seus dados de users para entender melhor o impacto das suas mensagens.
Entenda como suas mensagens e series performam ao longo do tempo.
Existem três maneiras de exportar dados de mensagens no Intercom.
Exporte todos os dados de mensagens para um intervalo de datas específico
Para exportar todos os dados das suas mensagens outbound para um intervalo de datas específico, vá para Todos os relatórios > Relatórios do Intercom > Visão geral do engajamento do cliente.
Nota: Este é um relatório legado e não é personalizável.
No topo do relatório, clique em Exportar CSV.
Você pode escolher entre dois relatórios e definir um intervalo de datas:
Estatísticas detalhadas - Faça uma análise profunda de como os users individuais estão respondendo às suas mensagens com este relatório CSV, que fornece uma divisão detalhada de todos os users que receberam suas mensagens.
Estatísticas gerais - Veja uma visão geral de como todas as mensagens estão performando com este relatório CSV, que fornece uma visão agregada geral das suas mensagens outbound junto com dados de auditoria.
Importante:
Você só pode exportar dados de mensagens que sua equipe enviou. Se quiser exportar conversas iniciadas por clientes, leia este artigo sobre exportação de dados de conversas.
O intervalo de datas selecionado aqui filtrará o relatório para mostrar mensagens enviadas nesse período, mas as estatísticas individuais dessas mensagens (como taxa de cliques etc) mostrarão os resultados para todo o período.
O link enviado para baixar o CSV é válido por apenas 2 dias e depois expira.
Nota: Se você escolher um intervalo de datas que possa conter um grande volume de dados, é melhor abrir o arquivo CSV usando um editor de texto.
Por fim, clique em Exportar Dados e você receberá o arquivo CSV no seu endereço de email.
Exportar seus dados de mensagens pode levar algumas horas. Você receberá um arquivo ZIP contendo vários CSVs para diferentes interações, como ‘recebimento’ de uma mensagem, ‘conclusão’ de uma Series, ‘visualizações de tela’ de um mobile carousel etc.
Os arquivos são exportados separadamente porque, para uma única entrega de um conteúdo, um user pode ter várias ocorrências da mesma estatística.
Por exemplo, se você receber um email e clicar em vários links, ou receber um tour e visualizar vários passos – registraríamos uma nova estatística de "clique" ou "passo visualizado" a cada vez.
Com isso em mente, não é possível colocar tudo em uma única linha.
Exportação de estatísticas detalhadas
Aqui está uma lista de estatísticas exportáveis e os diferentes tipos de conteúdo aos quais elas se relacionam. Cada evento é exportado em seu próprio arquivo, onde você pode ver os detalhes de quando ocorreu. Clique em um evento para saber mais sobre ele.
Evento | Tipo(s) de conteúdo |
Series | |
Mobile Carousel | |
Post, Banner, Chat, Email | |
Chat | |
Custom Bot, Product Tour, Mobile Carousel | |
Mobile Carousel | |
Post, Banner, Product Tour, Push, Control Group, Mobile Carousel, Chat, Email, Series, Custom Bot, Series Edge Split, SMS | |
SMS | |
Post, Push, Chat, Email, | |
Mobile Carousel | |
Publicação, Banner | |
TODOS | |
Publicação, Chat, Email, Custom Bot | |
Carrossel Móvel | |
Série | |
Série | |
Série | |
SMS | |
Tour do Produto | |
Tour do Produto | |
Email, SMS |
Cada estatística é exportada em seu próprio arquivo. Abaixo está a lista completa das diferentes estatísticas, os atributos fornecidos na exportação e suas descrições.
Dica: Use o arquivo CSV 'receipt' para análises básicas, como agregar e calcular taxas de clique para mensagens entre datas específicas sem precisar agregar vários arquivos manualmente. Use os outros arquivos detalhados de eventos como 'click_TIMESTAMP.csv' quando precisar de maior granularidade, por exemplo, quantas vezes um cliente clicou em uma mensagem específica ou quais links clicou com mais frequência.
Ponto de Verificação
Um Ponto de Verificação é criado para cada bloco em uma Série quando visitado por um agrupamento usuário-empresa. Eles nos dizem o que deve ser processado e quando/onde esse processamento deve acontecer.
Atributo | Descrição |
user_id | ID Intercom para o user, lead ou visitante. |
company_id | ID Intercom para a company. |
ruleset_id | O ID da mensagem dentro do sistema Intercom. Este é o mesmo ID visto na URL para o conteúdo, por exemplo. |
status_code |
|
status_name | Descrição para o status_code. Valores possíveis:
|
created_at | Timestamp de quando o checkpoint foi criado. |
last_processed_at | A última vez que verificamos se o usuário correspondia às regras do nó, ou se deveria receber o conteúdo do nó. |
expires_at | O momento em que enviaremos o usuário por qualquer caminho "did not match" do nó, ou o removeremos do caminho completamente se não houver caminhos alternativos. |
times_processed | O número de vezes que verificamos se o usuário corresponde ao nó |
*O que são Primary, Alternate e Split edges?
Primary edge — O cliente correspondeu às regras, recebeu a mensagem (ou tag), ou passou por um bloco de espera.
Alternate edge — O cliente não correspondeu às regras, ou não ficou online para receber uma mensagem.
Split edge — O cliente seguiu um caminho de um teste dividido.
Toque no botão
Um toque no botão é registrado quando um usuário toca em um botão em um Mobile Carousel.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
button_action_tapped_at | Timestamp de quando o botão foi tocado. |
Clique
Um clique é registrado sempre que um usuário, lead ou visitante clica em um link em um conteúdo. Aqui, um link pode ser um link de texto comum, um botão ou uma imagem que leva a algum lugar.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
clicked_at | Timestamp de quando o link, imagem ou botão foi clicado. |
Email coletado
Uma estatística de email coletado é registrada sempre que um visitante recebe um Chat pedindo seu endereço de email e o envia.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
email_collected_at | Timestamp de quando o email foi coletado. |
O endereço de email que foi coletado. |
Conclusão
Uma conclusão é registrada sempre que um user, lead ou visitante completa um Mobile Carousel ou Product Tour. Há uma estatística separada de "Série de Conclusão" para Séries.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
completed_at | Carimbo de data/hora de quando o carousel ou tour foi concluído. |
Dispensa
Uma dispensa é registrada sempre que um user dispensa um Mobile Carousel.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
dismissed_at | Carimbo de data/hora de quando o Mobile Carousel foi dispensado. |
Sucesso de meta
Um sucesso de meta é registrado sempre que um user, lead ou visitante atinge a meta para uma mensagem.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
goal_hit_at | Carimbo de data/hora de quando a meta foi atingida. |
Rejeição permanente
Uma rejeição permanente é registrada sempre que um email é permanentemente rejeitado pelo cliente de email do destinatário. Por exemplo, quando:
O endereço de email não existe em um servidor.
O domain não existe.
Ou o destinatário bloqueou a entrega.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
hard_bounced_at | Carimbo de data/hora de quando a mensagem teve rejeição permanente. |
Resposta por palavra-chave
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
replied_at | Carimbo de data/hora de quando a resposta foi enviada. |
Resposta | Post, Chat, Email, Custom Bot |
keyword_type | DEFAULT (ex: resposta não reconhecida) |
Aberto
Um aberto é registrado na primeira vez que alguém abre uma mensagem Push, Post, Chat ou Email.
Atributo | Descrição |
receipt_id | ID do recibo vinculado a esta estatística. |
opened_at | Carimbo de data/hora de quando a mensagem foi aberta. |
Concessão de permissão
Uma concessão de permissão é registrada sempre que você solicita uma permissão com um Mobile Carousel, e o usuário a concede no momento. Não é registrada se a permissão já foi concedida ou é concedida posteriormente nas configurações.
Atributo | Descrição |
receipt_id | ID do recibo vinculado a esta estatística. |
granted_at | Carimbo de data/hora de quando a permissão foi concedida. |
permission_type | O tipo de permissão que o usuário concedeu. Por exemplo:
|
Reação
Uma reação é registrada sempre que um usuário, lead ou visitante reage com um emoji a uma mensagem Post ou Banner.
Atributo | Descrição |
receipt_id | ID do recibo vinculado a esta estatística. |
reacted_at | Carimbo de data/hora de quando a reação aconteceu. |
reaction | A reação que o usuário, lead ou visitante escolheu. |
Recibo
Um recibo é registrado sempre que um usuário, lead ou visitante recebe uma de suas mensagens. É registrado mesmo que a mensagem não possa ser recebida com sucesso, como em um bounce. O receipt_id pode ser usado para vincular outros eventos relacionados a esta mensagem.
Atributo | Descrição |
user_id | ID Intercom para o usuário, lead ou visitante. |
user_external_id | Seu ID para o usuário, lead ou visitante. |
company_id | O ID da empresa à qual o usuário pertence |
O endereço de email do usuário | |
name | O nome completo do usuário |
ruleset_id | O ID da mensagem que foi entregue ao usuário |
content_id | O ID da variante da mensagem que foi entregue ao usuário (Testes A/B terão o mesmo ruleset_id, mas diferentes content_id’s). |
content_type | O tipo de mensagem que foi entregue, por exemplo, ‘email’, ‘tour’ |
content_title | O título da mensagem |
criado_via | Por que a mensagem foi entregue |
ruleset_version_id | À medida que você edita o conteúdo, registramos novas versões. Este ID pode ajudar a determinar qual versão de um conteúdo foi recebida. |
receipt_id | ID para este recibo. Será incluído com quaisquer estatísticas relacionadas. |
received_at | Carimbo de data/hora de quando o recibo foi registrado. |
series_id | O id da série da qual este conteúdo faz parte. |
series_title | O título da série da qual este conteúdo faz parte. |
node_id | O id do nó da série com o qual este ruleset está associado. Cada bloco em uma série tem um node_id correspondente. |
first_people_reached_receipt | O carimbo de data/hora do nome do atributo. |
first_checklist_step_receipt | O carimbo de data/hora do nome do atributo. |
first_checklist_step_open | O carimbo de data/hora do nome do atributo. |
first_checklist_step_click | O carimbo de data/hora do nome do atributo. |
first_checklist_step_completion | O carimbo de data/hora do nome do atributo. |
first_reply | O carimbo de data/hora da primeira vez que o usuário responde ao recebimento desta mensagem.
(Só mostrará um valor para tipos de conteúdo que suportam respostas, ficará em branco se o usuário não respondeu ao recibo) |
first_completion | O carimbo de data/hora da primeira vez que o usuário completa este recibo (por exemplo, para mensagens de tours, quando o usuário completa pela primeira vez esse tour do produto).
(Só mostrará um valor para tipos de conteúdo que suportam conclusões, ficará em branco se o usuário não completou a mensagem). |
first_series_completion | O carimbo de data/hora da primeira vez que o usuário completa esta série.
(Só mostrará um valor para tipos de conteúdo de recibo que suportam conclusões de séries, ficará em branco se o usuário não completou a série). |
first_series_disengagement | “ |
first_series_exit | “ |
first_goal_success | “ |
first_tour_step_failure | “ |
first_tour_step_view | “ |
first_reaction | “ |
first_open | “ |
first_click | “ |
first_dismissal | “ |
first_collected_email | “ |
first_unsubscribe | “ |
first_hard_bounce | “ |
first_soft_bounce | “ |
first_spam_complaint | “ |
first_permission_grant | “ |
first_button_tap | “ |
first_screen_view | “ |
first_webhook_failure | “ |
first_sms_failure | “ |
first_push_failure | “ |
first_answer | “ |
Responder
Uma resposta é registrada sempre que uma pessoa responde a um Post, Chat, Custom Bot ou Email.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
replied_at | Carimbo de data/hora de quando a resposta foi enviada. |
Visualização de tela
Uma visualização de tela é registrada para cada tela em um Mobile Carousel que um usuário visualiza.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
viewed_at | Carimbo de data/hora de quando a tela foi visualizada. |
Conclusão da série
Uma conclusão de série é registrada quando um usuário ou lead termina uma série.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
completed_at | Carimbo de data/hora de quando a série foi concluída. |
completion_node_ruleset_id | O ID do Ruleset onde o user ou lead completou a Série. |
Desengajamento da Série
Um desengajamento da série é registrado quando um user ou lead se desengaja de uma série. Isso ocorre quando eles alcançam o fim do período de espera especificado em uma mensagem ou bloco de regras. Se não receberam a mensagem ou não corresponderam às regras, serão marcados como desengajados.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
desengajado_em | Carimbo de data/hora de quando o user ou lead se desengajou da série. |
desengajado_node_ruleset_id | O ID do Ruleset onde o user ou lead se desengajou da série. |
Saída da Série
Uma saída da série é registrada sempre que um user ou lead corresponde às regras de saída para uma série.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
saído_em | Carimbo de data/hora de quando o user ou lead saiu da série. |
Falha no SMS
Atributo | Descrição |
receipt_ID | ID do receipt vinculado a esta estatística. |
falhou_em | Carimbo de data/hora de quando a etapa do tour falhou. |
status_da_mensagem | Falhou ou Não Entregue |
código_de_erro |
Rejeição suave
Uma rejeição suave é registrada quando um email não pode ser entregue a um user ou lead por um motivo temporário, como caixa de entrada cheia.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
rejeição_suave_em | Carimbo de data/hora de quando a mensagem teve rejeição suave. |
Reclamação de spam
Uma reclamação de spam é registrada se um user ou lead marcar uma de suas mensagens como spam no cliente de email.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
reclamou_em | Carimbo de data/hora de quando a reclamação de spam ocorreu. |
Falha na etapa do tour
Uma falha na etapa do tour é registrada sempre que uma etapa do Product tour falha ao ser exibida para um user, lead ou visitante.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
step_id | ID da etapa do tour que falhou. |
failed_selector | O seletor CSS que falhou. |
failure_url | A URL em que o usuário, lead ou visitante estava quando a falha ocorreu. |
failed_at | Carimbo de data/hora de quando a etapa do tour falhou. |
Visualização da etapa do tour
Uma visualização da etapa do tour é registrada sempre que uma etapa do Product tour é apresentada a um usuário, lead ou visitante.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
step_id | ID da etapa do tour que foi visualizada. |
viewed_at | Carimbo de data/hora de quando a etapa do tour foi visualizada. |
Cancelar inscrição
Um cancelamento de inscrição é registrado se alguém cancelar a inscrição de uma de suas mensagens de email.
Atributo | Descrição |
receipt_id | ID do receipt vinculado a esta estatística. |
unsubscribed_at | Carimbo de data/hora de quando o usuário ou lead cancelou a inscrição. |
Exportação de estatísticas gerais
Overview stats é um relatório CSV que fornece estatísticas detalhadas das mensagens de um workspace agregadas no nível da mensagem, não no nível do receipt do usuário.
Nota: A funcionalidade do filtro de data funciona de forma diferente do relatório de Estatísticas Detalhadas. Para o relatório Overview Stats, todas as mensagens que estiveram ativas em qualquer momento durante o intervalo de datas filtrado serão exportadas.
Quando você exportar esses dados, receberá por email um único arquivo CSV contendo a visão geral de suas mensagens.
Junto com os detalhes da mensagem e colunas relacionadas à auditoria, como ‘last edited by’, há colunas para cada estatística no sistema de estatísticas de mensagens. Cada uma dessas estatísticas mostrará valores apenas para tipos de mensagem/conteúdo que suportam essas estatísticas.
Cada estatística é dividida em 3 valores:
A contagem total dessa estatística - por exemplo, ‘open_total’ - mostrará o número total de vezes que a mensagem foi aberta, independentemente dos users.
A contagem única dessa estatística - por exemplo, ‘click_unique’ - mostrará a contagem de users únicos que clicaram pelo menos uma vez naquela mensagem.
A taxa dessa estatística baseada no total de receipts - por exemplo, ‘reply_rate’ - mostrará a porcentagem do total de envios que responderam a essa mensagem.
Todas as colunas explicadas
Nome da Coluna | Descrição |
ruleset_id | O ID da mensagem |
created_at | Quando a mensagem foi criada |
content_title | O título do conteúdo que você vê no seu workspace Intercom. |
content_id | O ID do conteúdo/variante específico da mensagem - Em um teste A/B, cada versão tem seu próprio Content ID. |
content_type | O tipo da mensagem, por exemplo, Email, Chat, Post |
series_id | O id da série da qual este conteúdo faz parte. |
series_title | O título da série da qual este conteúdo faz parte. |
estado | O estado atual da mensagem, por exemplo, Ao Vivo, Pausada, Rascunho |
last_state_change_by | O endereço de email do colega que atualizou o estado da mensagem. |
last_state_change_at | O carimbo de data/hora de quando ocorreu a última mudança de estado. |
last_edited_by | O endereço de email do último colega que editou a mensagem. |
last_edited_at | O carimbo de data/hora de quando ocorreu a última edição da mensagem. |
url | A URL para visualizar/editar a mensagem dentro do Intercom. |
receipt_total | Explicado acima |
receipt_unique | Explicado acima |
reply_total | Explicado acima |
reply_unique | Explicado acima |
reply_rate | Explicado acima |
completion_total | Explicado acima |
completion_unique | Explicado acima |
completion_rate | Explicado acima |
goal_success_total | Explicado acima |
goal_success_unique | Explicado acima |
goal_success_rate | Explicado acima |
tour_step_failure_total | Explicado acima |
tour_step_failure_unique | Explicado acima |
tour_step_failure_rate | Explicado acima |
tour_step_view_total | Explicado acima |
tour_step_view_unique | Explicado acima |
reaction_total | Explicado acima |
reação_única | Explicado acima |
taxa_de_reação | Explicado acima |
total_aberto | Explicado acima |
único_aberto | Explicado acima |
taxa_de_abertura | Explicado acima |
total_de_cliques | Explicado acima |
clique_único | Explicado acima |
taxa_de_clique | Explicado acima |
total_de_dispensa | Explicado acima |
dispensa_única | Explicado acima |
taxa_de_dispensa | Explicado acima |
total_de_emails_coletados | Explicado acima |
email_coletado_único | Explicado acima |
taxa_de_email_coletado | Explicado acima |
total_de_cancelamentos | Explicado acima |
cancelamento_único | Explicado acima |
taxa_de_cancelamento | Explicado acima |
total_de_hard_bounce | Explicado acima |
hard_bounce_único | Explicado acima |
taxa_de_hard_bounce | Explicado acima |
total_de_soft_bounce | Explicado acima |
soft_bounce_único | Explicado acima |
taxa_de_soft_bounce | Explicado acima |
total_de_reclamações_de_spam | Explicado acima |
reclamação_de_spam_única | Explicado acima |
taxa_de_reclamação_de_spam | Explicado acima |
total_de_concessão_de_permissão | Explicado acima |
concessão_de_permissão_única | Explicado acima |
taxa_de_concessão_de_permissão | Explicado acima |
total_de_toques_no_botão | Explicado acima |
toque_único_no_botão | Explicado acima |
taxa_de_toque_no_botão | Explicado acima |
total_de_visualizações_de_tela | Explicado acima |
visualização_única_de_tela | Explicado acima |
taxa_de_visualização_de_tela | Explicado acima |
total_de_falhas_no_webhook | Explicado acima |
falha_única_no_webhook | Explicado acima |
taxa_de_falha_no_webhook | Explicado acima |
total_de_falhas_no_sms | Explicado acima |
falha_única_no_sms | Explicado acima |
taxa_de_falha_no_sms | Explicado acima |
total_de_falhas_no_push | Explicado acima |
falha_única_no_push | Explicado acima |
taxa_de_falha_no_push | Explicado acima |
total_de_respostas | Explicado acima |
resposta_única | Explicado acima |
total_de_falhas_no_email | Explicado acima |
falha_única_no_email | Explicado acima |
taxa_de_falha_no_email | Explicado acima |
Exportar dados de uma mensagem outbound específica
Se você quiser analisar o desempenho de uma mensagem outbound específica com mais detalhes, vá para Outbound e selecione a mensagem que deseja exportar, depois clique no menu suspenso Mais e selecione Exportar CSV.
Nota: Os dados exportados de mensagens Mobile Push e Product Tours estarão em vários arquivos, baseados em eventos de mensagem separados como "Receipt", "Open" ou "Completion (for tours only)".