Este arquivo mostra como confirmar, com um teste rápido, se a captura de clique do Push está funcionando quando a taxa de abertura ou clique aparece zerada ou próxima de zero no relatório.
Por que a taxa de abertura do Push cai a zero
No Push, a Context Cloud unifica abertura e clique: um Push visualizado é contado quando o cliente clicou nele. A captura desse clique é feita por uma função da SDK da Inngage embarcada no app.
Quando essa função não é acionada, os cliques deixam de ser computados. O efeito no relatório é uma taxa de abertura e de clique zerada ou próxima de zero, mesmo com a mensagem sendo entregue normalmente. Como abertura e clique são o mesmo evento no Push, os dois indicadores caem juntos.
Esse é um problema da integração da SDK no app, não da entrega da mensagem. Algumas versões do app podem continuar registrando o clique enquanto outras não — por isso o valor costuma ficar baixo, e não exatamente zero.
Antes de começar
- App na versão mais atualizada. O teste só é conclusivo na build mais recente. Versões antigas podem falhar na captura mesmo com o restante da integração correto.
- Login realizado no app. O login vincula o identificador de cliente ao device. Sem esse vínculo, o clique de teste não é associado ao seu envio no relatório unitário.
- Acesso ao relatório unitário da campanha de teste no painel da Context Cloud.
Os três cenários de teste
O teste envia três notificações, uma para cada estado em que o app pode estar quando o Push chega. Cada estado exercita a captura de clique de um jeito diferente, e falhas costumam aparecer em apenas um deles.
| Cenário | Estado do app | O que testa |
|---|---|---|
| App fechado | Aplicativo encerrado, sem execução em segundo plano | Captura do clique a partir de uma notificação recebida com o app desligado |
| App em segundo plano | Aplicativo aberto, mas minimizado (rodando em background) | Captura do clique com o app suspenso, mas ainda em memória |
| App aberto | Aplicativo em uso, em primeiro plano na tela | Captura do clique com o app ativo em foreground |
Passos
- Atualize o app para a versão mais recente e faça login, para vincular o identificador de cliente ao device.
- No painel da Context Cloud, prepare um envio de teste com três notificações de Push, uma para cada cenário da tabela acima.
- Dispare a primeira notificação, coloque o app no estado do cenário correspondente (fechado, segundo plano ou aberto) e clique na notificação nesse estado.
- Repita o clique para os outros dois cenários, sempre deixando o app no estado definido para aquela mensagem antes de clicar.
- Abra o relatório unitário da campanha de teste. Os cliques aparecem praticamente em tempo real.
Como validar
No relatório unitário, cada clique válido aparece quase em tempo real associado ao seu device.
- Se os três cenários registram o clique, a captura de clique da SDK está funcionando e a métrica de abertura do Push está correta.
- Se um ou mais cenários não registram o clique, a função de captura da SDK não está sendo acionada naquele estado do app. É essa a causa da taxa de abertura baixa.
Problemas comuns
- Nenhum cenário registra clique → a função de captura de clique da SDK não é acionada em nenhum estado → abra um chamado com o time técnico ou com a empresa responsável pelo app para analisar a integração da SDK.
- Só um cenário falha (ex.: funciona com app aberto, mas não com app fechado) → a captura não é acionada naquele estado específico → registre em qual cenário falhou ao abrir o chamado, para direcionar a análise.
- Cliques aparecem, mas a taxa continua baixa no relatório geral → parte da base está em versões antigas do app que ainda não capturam o clique → veja a seção sobre correção abaixo.
Depois de corrigir
A correção é feita na integração da SDK dentro do app, pelo time técnico ou pela empresa responsável pelo aplicativo. Depois de publicada:
- Usuários que atualizarem o app passam a ter os cliques capturados normalmente, e a taxa de abertura do Push volta ao esperado para esses devices.
- Usuários em versões antigas não recuperam a captura retroativamente. Não há como computar cliques que não foram registrados nem corrigir devices que não atualizaram. A recuperação acontece de forma gradual, conforme a base migra para a versão corrigida.
