Interações e análises
Quando um destinatário vota em uma enquete, envia um formulário ou toca em uma avaliação, essa interação é registrada pelos endpoints hospedados do MailInApp e atribuída ao seu projeto — em tempo real.
Como as interações trafegam
Blocos interativos alcançam os endpoints de registro de duas formas, seguindo a mesma filosofia de fallback:
- Links (universal). Cada opção em uma enquete, avaliação ou RSVP é um link simples, em todo app de e-mail. Tocar nele abre uma página hospedada leve que confirma a ação e a registra. Links simples funcionam em todos os apps de e-mail testados.
- Envios de formulário dentro do e-mail (aprimoramento). Formulários e quizzes mantêm o formulário no e-mail, e ele é enviado diretamente do e-mail usando a codificação padrão de formulários HTML nos apps que conseguem enviar um formulário: Gmail na web e apps do Outlook para iOS e Android. Após o envio, os destinatários são redirecionados para a página que você escolher. Todo formulário também mostra abaixo um link Responder na web, que o abre na visualização ao vivo para leitores de outros apps. Enquetes, avaliações e RSVPs nunca enviam um formulário a partir do e-mail: são sempre links para uma página curta de confirmação.
Ambos os caminhos aceitam os mesmos dados, então os resultados acabam em um único lugar, independentemente do cliente que o destinatário usou.
O clique em Comprar agora de um bloco de produto é a única exceção: ele não consegue ser registrado por esse endpoint de forma alguma, porque uma compra só pode ser concluída na própria página de checkout hospedada pela Stripe. Ainda assim, ele chega aqui como um evento purchase — com valor, moeda e quantidade — mas somente depois que o webhook da Stripe confirmar que o pagamento realmente foi aprovado, nunca apenas pelo clique do comprador.
Protegido contra bots e scanners
Ferramentas corporativas de segurança pré-buscam todo link em todo e-mail que analisam. Se um simples clique em link já bastasse para registrar um voto, os resultados da sua enquete estariam cheios de robôs. O MailInApp não registra nada em um GET simples: ações baseadas em link exigem uma ação de confirmação explícita do destinatário, e as interações na visualização ao vivo são registradas por meio de envios de formulário. Veja Links de visualização ao vivo.
Como os endpoints são públicos por necessidade (uma caixa de entrada não tem como se autenticar), todo payload é validado no servidor, e os envios personalizados são atribuídos por meio dos mesmos tokens assinados que protegem os links de visualização ao vivo — um token forjado ou incompatível é rejeitado.
Mais duas camadas mantêm os resultados honestos:
- Deduplicação por destinatário. O voto, avaliação, revelação ou envio de formulário de um destinatário conta apenas uma vez — clicar de novo no próprio link (um duplo toque impaciente, um recarregamento repetido da página) não tem efeito, em vez de gerar uma segunda linha. Visualizações repetidas de slides de carrossel deliberadamente não são deduplicadas, já que repetições ali são um sinal de engajamento significativo, e não uma contagem duplicada.
- Limitação de inundação anônima. O
campaignIdde uma campanha fica plenamente visível no próprio código HTML do e-mail, então nada impede que um script envie votos arbitrários sem token de destinatário algum. Envios não atribuídos são limitados por endereço IP, por campanha, por minuto. Essa é uma rede de melhor esforço, não uma identidade precisa — redes corporativas ou de webmail compartilhadas podem colocar muitos destinatários reais atrás de um único IP — então o limite permanece generoso o suficiente para não bloquear uma explosão legítima de aberturas.
O que é registrado
Cada evento de interação captura:
- o projeto (campanha) ao qual pertence,
- o bloco que a produziu (qual enquete, qual formulário),
- o valor (a opção escolhida, os campos enviados, a quantidade de estrelas),
- a linha do destinatário, quando o e-mail foi personalizado com uma fonte de dados — para que você veja quem respondeu, não apenas quantos,
- um registro de data/hora.
Ciclo de vida da pesquisa
Um projeto pode receber uma data de encerramento e/ou um limite de respostas (definidos junto com as configurações de envio). Assim que qualquer um dos dois é atingido, os endpoints de registro deixam de aceitar novos eventos para esse projeto — a visualização ao vivo troca os blocos interativos por um aviso de encerramento em vez de gerar erro — enquanto tudo o que foi coletado antes do encerramento permanece exatamente como foi registrado. Veja Respostas e webhooks.
Rastreamento de cliques
Links simples (um botão, uma imagem com link, um ícone social, um slide de carrossel com link, um link de prêmio de raspadinha ou roleta premiada) não são uma enquete nem uma avaliação. Mesmo assim, vale a pena acompanhá-los. Quando um e-mail foi enviado com um link personalizado por destinatário, o MailInApp roteia esses cliques simples por um redirecionamento rastreado antes do destino real. O clique é registrado, e então o destinatário chega à URL que você definiu, sem etapa extra e sem atraso. E-mails sem contexto de destinatário (por exemplo, um envio livre por meio da API transacional) apontam direto para o destino, já que não há nada a que atribuir o clique.
Cada um deles é rastreado como um link próprio. Os slides de um carrossel são contados um a um, então você vê em qual produto as pessoas clicaram, não só que clicaram no carrossel. O botão da loja de uma raspadinha conta do mesmo jeito, esteja ele dentro do prêmio revelado ou abaixo do cartão. Em um experimento, são esses cliques que a taxa de cliques únicos conta.
Diferente de votos e avaliações, cliques nunca são deduplicados — um destinatário que clica no mesmo botão cinco vezes conta como cinco cliques, já que cliques repetidos são um sinal de engajamento significativo aqui, não uma contagem duplicada. Os resultados se resumem em um mapa de calor de cliques por bloco — veja Respostas e webhooks.
Revelações e visualizações de slides
Raspar uma raspadinha, girar uma roleta premiada e passar para outro slide de um carrossel acontecem dentro do app de e-mail do destinatário. Cada um desses blocos carrega uma imagem minúscula que só carrega no momento da revelação ou da troca de slide. O MailInApp registra a revelação ou a visualização do slide quando essa imagem carrega, e só alguns apps de e-mail fazem isso.
Medimos os apps de e-mail mais comuns com caixas de teste em outubro de 2026:
| App de e-mail | Revelações e visualizações de slides |
|---|---|
| Mail no iPhone, com a Proteção de Privacidade do Mail | Registradas |
| Thunderbird | Registradas |
| Gmail | Não registradas: o Gmail mostra o fallback (o prêmio da raspadinha, o botão do prêmio da roleta, o primeiro slide), sem raspar, girar nem deslizar |
| Outlook.com, Outlook para iOS e Android | Não registradas: mostra o mesmo fallback |
| Yahoo Mail | Não registradas: o Yahoo executa a raspadinha e a roleta premiada, mas o proxy de imagens dele busca a imagem da revelação de um jeito que o MailInApp não consegue distinguir de um pré-carregamento, então ela não é contada. O carrossel mostra o fallback ali |
| Apple Mail no Mac, Mail no iPhone sem a Proteção de Privacidade do Mail, Outlook para Windows, Samsung Email | Ainda não medidos |
Algumas regras mantêm esses números honestos:
- Nenhuma revelação registrada não quer dizer «não revelou». Um destinatário cujo app não consegue informá-la pode muito bem ter visto o prêmio, já que o fallback o mostra. O MailInApp nunca o conta como quem não revelou.
- O pré-carregamento é descartado. Uma imagem carregada na mesma rajada que as outras imagens do e-mail, ou pelo proxy de imagens do Gmail ou do Yahoo, não conta como revelação.
- Só contam links pessoais. Revelações e visualizações de slides são registradas em e-mails em que cada destinatário tem o próprio link, como um envio para uma lista de contatos. O HTML exportado não registra nenhuma. A visualização ao vivo hospedada as registra sempre.
- Uma vez por destinatário. Uma revelação conta uma vez por pessoa e por cartão. Uma visualização de slide conta uma vez por pessoa e por slide.
Em Insights › Blocos, cada raspadinha e cada roleta premiada ganha um cartão Revelar. Cada carrossel conta as pessoas que passaram do primeiro slide. Os dois são parcelas de todas as pessoas que abriram ou interagiram, inclusive aquelas cujo app não consegue informar uma revelação nem um deslize, então leia-os como um piso. Um experimento é mais rigoroso. A Taxa de revelação observada dele conta só os e-mails em apps que conseguem informar uma revelação, e os resultados mostram essa parcela como Cobertura de revelações.
Profundidade de rolagem
A página de visualização ao vivo hospedada também informa até onde um destinatário rolou a página (25%, 50%, 75%, 100%) enquanto lia. Esse é o único lugar no MailInApp que executa um pequeno script. O e-mail enviado em si permanece 100% livre de script, como precisa ser, mas a visualização ao vivo já é uma página web hospedada normal, então um listener de rolagem ali não compromete nada. Os marcos se resumem em um funil de profundidade de rolagem; veja Respostas e webhooks.
Rastreamento de aberturas
Todo e-mail enviado a partir do painel também carrega um pequeno pixel invisível de rastreamento de aberturas, para que você tenha um sinal de "abriu mas não interagiu" versus "nunca abriu", ao lado das interações explícitas. Isso é exibido na visualização de Respostas como um indicador distinto de Aberto (data/hora da primeira abertura) por destinatário, em vez de misturado à lista de interações.
Isso é um mínimo de melhor esforço, não uma medição precisa: tanto a Proteção de Privacidade de E-mail da Apple quanto o proxy de imagens do Gmail pré-buscam ou armazenam em cache as imagens independentemente de o destinatário realmente ter aberto a mensagem, então as aberturas podem ser subcontadas ou gerar falsos positivos. Trate isso como um sinal direcional, não como uma fonte da verdade.
Respostas concluídas
Cada resposta é registrada sozinha, no momento em que é dada. Quando um e-mail pede respostas em dois ou mais blocos, o MailInApp também registra quando um destinatário respondeu a todos: é uma resposta concluída. O Insights a mostra como uma etapa Concluíram e uma taxa de conclusão, e o webhook recebe uma entrega response.completed. Veja Taxa de conclusão.
Onde os resultados ficam
Os dados de interação são coletados por projeto e retornam para você de três formas:
- Respostas por destinatário — a visualização de Respostas do painel agrupa cada interação por destinatário, unida à sua fonte de dados para que você veja quem respondeu, não apenas quantos. Veja Respostas e webhooks.
- Webhooks — cada interação pode ser enviada ao seu próprio endpoint no instante em que chega, assinada para que você possa verificar que veio do MailInApp. Também abordado em Respostas e webhooks.
- Resultados ao vivo para destinatários — blocos de enquete podem exibir resultados em tempo real aos destinatários em sua página de resultados hospedada.
Nota de privacidade: o MailInApp registra as interações que os destinatários fazem deliberadamente — votos, envios, avaliações, revelações e visualizações de slides — além do pixel de rastreamento de aberturas descrito acima. Os endpoints são projetados para não registrar nenhum outro rastreamento incidental em buscas simples de link.