Monitoramento
Replay de sessão
O SDK do navegador pode gravar a página como o usuário a viu e enviar o minuto anterior a um erro ou a um relato de erro. A configuração Gravação de sessões de cada projeto no painel decide quando gravar, então funciona sem mudar código, também no Odoo. O gravador é um complemento separado de 61 KB baixado de blipit.io só quando a gravação está ligada, assim o script principal continua pequeno.
1Escolha quando grava
Abra o projeto em app.blipit.io e escolha uma configuração de Gravação de sessões. Em erros e relatos de erros, o padrão de todo projeto, guarda os últimos 60 a 120 segundos na memória do navegador e só os envia quando um erro é capturado ou alguém envia um relato, e depois continua gravando; visitas sem problema nunca são enviadas. Todas as visitas, por amostra grava desde o início a parte das visitas que você escolher (de 1 a 100%), quebrando algo ou não, e mantém o buffer de erros nas demais. Desligada não carrega nada. Proprietários, administradores e quem pode editar o projeto podem mudar, e os navegadores recebem a mudança em cerca de uma hora.
2O que fica visível e o que é mascarado
O mascaramento acontece no navegador antes de qualquer envio. Valores digitados, texto da página, células de tabelas e nomes de registros viram asteriscos, então um campo aparece como Cliente: ******. Rótulos e botões ficam legíveis para você acompanhar o que o visitante fez: rótulos de formulários, legendas, cabeçalhos de colunas de tabelas e listas, títulos de tabelas, botões, abas, itens de menu, links de navegação e, no Odoo, os rótulos dos campos, a barra de status, as abas do notebook, o menu de apps e os botões do painel de controle. Mesmo ali, dígitos, datas, e-mails, links e @nomes são mascarados, então um botão aparece como Pay $**.**, e os atributos title, alt, aria-label e placeholder também são mascarados. Tudo o que estiver num valor de campo, célula de tabela, cartão do kanban, atividade ou chat continua mascarado mesmo quando aparece como botão, e os títulos das colunas do kanban são mascarados porque podem ser valores agrupados. Sempre mascarados, mesmo dentro de um rótulo ou botão: campos de entrada, áreas de texto, seletores e suas opções, áreas editáveis, células de tabelas e valores de campos, títulos, breadcrumbs, o chatter, cartões do kanban, menus de conta, usuário e perfil e listas de busca e preenchimento automático. Imagens, vídeo, áudio, canvas, iframes e campos de senha viram caixas vazias do mesmo tamanho, tudo com data-blipit-block é bloqueado e valores parecidos com tokens na URL são ocultados. Para mascarar todas as palavras como antes, desligue Mostrar rótulos e botões nas gravações no painel Session replay do projeto. Coloque data-blipit-mask num elemento para sempre mascará-lo, ou data-blipit-unmask para mostrar o texto de um que você escolher; data-blipit-mask tem prioridade.
<div data-blipit-mask>Always masked</div>
<span data-blipit-unmask>Plan</span>3Assista a um replay
Replays lista as gravações por projeto, com ou sem erros, e por URL. O player tem reproduzir, 1x, 2x, 4x, pular inatividade e um marcador vermelho por erro que leva ao seu problema. Um problema cujo evento mais recente tem um replay mostra Assistir replay.
4Substitua no código
Uma opção replay em Blipit.init tem prioridade sobre a configuração do projeto naquele site: onErrorSampleRate (padrão 1) é a parte das visitas que mantém o buffer de erros, sessionSampleRate (padrão 0) a parte gravada desde o início, e labels: false mascara todo o texto naquele site. replay: false desliga a gravação naquele site, seja qual for a configuração do projeto.
Blipit.init({
key: "<public key>",
release: "2026.09.28",
replay: { sessionSampleRate: 0.05, onErrorSampleRate: 1 }
});5Apps móveis: Android
O replay de sessão móvel funciona em apps Android com blipit-android 0.3.0 ou mais recente, e também em dispositivos Huawei, porque o SDK não usa Google Play services nem Firebase. iOS, React Native e Flutter estão a caminho. Vale a mesma configuração do projeto: Em erros e relatórios de bug guarda os últimos 30 segundos na memória do dispositivo e só os envia quando acontece um erro ou alguém envia um relatório; Todas as visitas, por amostragem grava por inteiro a parte das sessões do app que você escolher. O replay precisa do Android 8.0 (API 26) ou mais recente; dispositivos mais antigos continuam enviando erros, sem replay.
implementation("com.github.blipit-io:blipit-android:v0.7.5")Blipit.init(this) {
key = "<public key>"
project = "<project id>"
}6Peça o consentimento primeiro
Nada é capturado até o seu app chamar Blipit.setReplayConsent(true); o padrão é false. Mostre o seu aviso (abaixo) e chame quando o usuário concordar. A escolha fica salva no dispositivo, então chame de novo só quando ela mudar. Blipit.setReplayConsent(false) para a gravação na hora e descarta o buffer, por isso ofereça essa opção nas configurações do app. Blipit.hasReplayConsent() retorna a escolha atual.
allowButton.setOnClickListener { Blipit.setReplayConsent(true) }
replaySwitch.isChecked = Blipit.hasReplayConsent()
replaySwitch.setOnCheckedChangeListener { _, on -> Blipit.setReplayConsent(on) }7O que um replay móvel captura
Cerca de um quadro por segundo das telas do seu próprio app, codificado no dispositivo como um vídeo H.264 pequeno, além de toques, mudanças de tela, breadcrumbs, o modelo do dispositivo, a versão do Android e a versão do app. Outros apps, a interface do sistema, as notificações e qualquer coisa enquanto o app está em segundo plano nunca são capturados: a gravação pausa assim que o app vai para segundo plano e para depois de 30 segundos lá. O Blipit nunca usa um AccessibilityService nem MediaProjection, então não há pedido de captura de tela nem serviço em primeiro plano. A qualidade do vídeo cai em redes tarifadas (dados móveis), e tudo é enviado por HTTPS só para o Blipit.
8O que é mascarado no dispositivo
O mascaramento acontece no dispositivo antes de um quadro ser guardado: todo o texto, todas as imagens, todos os campos de texto (EditText e campos de texto do Jetpack Compose), WebViews e players de vídeo são desenhados como blocos sólidos. Defina replayLabels = true no Blipit.init para manter legíveis os rótulos e o texto dos botões em telas baseadas em View; campos de texto e imagens continuam mascarados, e as telas do Jetpack Compose continuam totalmente mascaradas. Adicione android:tag="blipit-mask" a uma view para mascará-la sempre.
<TextView
android:id="@+id/balance"
android:tag="blipit-mask" />9Apps para crianças
Deixe o replay desligado em apps voltados para crianças (política Famílias do Google Play, COPPA, a categoria Crianças da App Store). Defina childDirected = true no Blipit.init ou chame Blipit.disableReplayForChildApp(); assim o replay nunca começa, nem com consentimento.
Blipit.init(this) {
key = "<public key>"
project = "<project id>"
childDirected = true
}10Checklist de conformidade para as lojas
- Peça o consentimento antes de qualquer captura: chame Blipit.setReplayConsent(true) só depois que o usuário concordar.
- Mostre um aviso em destaque no app antes de perguntar, com o texto abaixo.
- Cite o Blipit e o replay de sessão na sua política de privacidade; o parágrafo para a AppGallery abaixo serve para qualquer loja.
- Preencha o formulário Segurança dos dados do Google Play e os rótulos de privacidade da AppGallery com as respostas abaixo.
- Mantenha o replay desligado em apps voltados para crianças.
- Respeite a retirada: ofereça nas configurações do app um botão que chame Blipit.setReplayConsent(false).
11Respostas para Segurança dos dados do Google Play
Use estas respostas no Play Console, em Conteúdo do app > Segurança dos dados. Os nomes das categorias e finalidades estão como o console em inglês os mostra.
- App activity > App interactions: coletados, não compartilhados, opcionais. Finalidades: App functionality, Analytics.
- App info and performance > Crash logs: coletados, não compartilhados. Finalidades: App functionality, Analytics.
- App info and performance > Diagnostics: coletados, não compartilhados. Finalidades: App functionality, Analytics.
- Todos os dados do usuário coletados pelo app são criptografados em trânsito? Sim.
- Você oferece uma forma de os usuários pedirem a exclusão dos seus dados? Sim.
12Aviso no app, pronto para colar
Mostre antes de pedir o consentimento, numa tela própria ou num diálogo com os botões Permitir e Agora não, e ajuste o caminho das configurações ao seu app.
- Este app grava um vídeo mascarado da sua tela e dos seus toques por até 30 segundos antes de um erro ou relatório de bug e o envia ao nosso provedor de monitoramento de erros, o Blipit, para corrigir problemas. Texto, imagens e o que você digita ficam ocultos. Você pode desligar isso em Configurações.
13Declaração de privacidade para a Huawei AppGallery
Cole isto na sua declaração de privacidade e troque as partes entre colchetes; serve também para o Google Play e outras lojas. No AppGallery Connect, declare nos rótulos de privacidade do app que um SDK de terceiros coleta atividade no app (interações) e diagnósticos (registros de falhas), sem compartilhar e sem usar para publicidade.
- Monitoramento de erros e replay de sessão. Usamos o Blipit, um serviço de monitoramento de erros operado pela Louward Labs FZC LLC (Ajman, EAU), como operador de dados. Com o seu consentimento, o app guarda uma gravação curta e mascarada das telas do próprio app (texto, imagens e o que você digita são ocultados no seu dispositivo antes de qualquer armazenamento), dos seus toques e mudanças de tela, do modelo do dispositivo, do sistema operacional e da versão do app. Ela é enviada por uma conexão criptografada (HTTPS) apenas quando ocorre um erro, quando você envia um relatório de bug ou para uma pequena amostra de sessões, e é usada só para encontrar e corrigir problemas no app. Não é vendida nem usada para publicidade. As gravações são excluídas automaticamente após [7/14/30] dias. Você pode retirar o consentimento a qualquer momento em [Configurações > Privacidade] e pedir acesso aos seus dados ou a exclusão deles em [contato].
14Rótulo de privacidade da App Store (para a versão iOS)
Para o futuro SDK de iOS. No App Store Connect, em App Privacy, declare:
- Usage Data > Product Interaction: finalidades App Functionality e Analytics.
- Diagnostics > Crash Data e Other Diagnostic Data: App Functionality, Analytics.
- Não vinculado à identidade do usuário, a menos que você chame Blipit.setUser; nesse caso, marque como vinculado.
- Não usado para rastreamento (tracking).
Bom saber
- Gravações por mês: Free 25, Solo 500, Team 2.500, Scale 5.000, guardadas 7 dias no Free, 14 no Solo e 30 no Team e no Scale. Quando as gravações do mês acabam, a configuração do projeto responde Desligada até o mês seguinte e nada é cobrado.
- Uma gravação para após 60 minutos, 500 segmentos ou 20 MB. Os blocos saem a cada 10 segundos ou a 1 MB, com gzip, e o último quando a aba fecha.
- Em sites, o script de navegador do Blipit grava os replays; em apps Android, o SDK Android do Blipit os envia.
- Os replays móveis compartilham a franquia mensal e a retenção dos replays web, e os arquivos de vídeo são excluídos junto com o replay.
Travou? Envie um e-mail para support@blipit.io. As chaves e o id de cada projeto ficam em Chaves de API no app.blipit.io.