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 ou avaliação é um link simples. Tocar nele abre uma página hospedada leve que confirma a ação e a registra. Esse caminho funciona em 100% dos clientes de e-mail.
• Envios de formulário dentro do e-mail (aprimoramento). Em clientes que suportam isso (Gmail web/Android, Yahoo), formulários e enquetes podem ser enviados diretamente do e-mail usando a codificação padrão de formulários HTML — sem saltar para outra página. Após o envio, os destinatários são redirecionados para a página que você escolher.

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 campaignId de 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) não são uma enquete nem uma avaliação, mas ainda 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.

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.

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.

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 — 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.