Device Comportamental

Última atualização: 27 de Janeiro de 2025

Introdução

Este é o guia de integração da nossa ferramenta de monitoramento de Device Comportamental. Este documento é destinado aos desenolvedores responsáveis pela implementação desta funcionalidade.

Nossa tecnologia de device comportamental permite identificar padrões de uso suspeitos, detectar bots e outras atividades anômalas. Isso garante uma camada adicional de proteção para seus usuários. Coletamos informações públicas do dispositivo, como IP e sistema operacional, para criar perfis comportamentais detalhados e identificar dispositivos já conhecidos pelo sistema.

Comprometemo-nos a respeitar as políticas de privacidade e o nível de permissão concedido pelo usuário, em conformidade com a LGPD. Nosso objetivo é fornecer serviços de prevenção a fraudes de maneira ética e transparente.

Implementação do Script

Para utilizar a funcionalidade de monitoramento de comportamento de dispositivos, o script correspondente deve ser implementado em todas as páginas onde a validação do dispositivo será realizada.

O código deverá ser incluso na página antes da tag </body> conforme exemplo abaixo:

<script>
    (function (a, b, c, d, e, f, g) {
    a['CsbpObject'] = e; a[e] = a[e] || function () {
    (a[e].q = a[e].q || []).push(arguments)
    }, a[e].l = 1 * Date.now(); f = b.createElement(c),
    g = b.getElementsByTagName(c)[0]; f.async = 1; f.src = d; g.parentNode.insertBefore(f, g)
    })(window, document, 'script', '//bio.clearsale.com.br/p/bio.js', 'csbp');
    csbp('app', 'seu_app');
    csbp('navigationid', 'seu_id_de_sessao');
    csbp('send-to-analysis', true)//O valor true, deve ser utilizado nas telas onde você deseja obter a resposta de device comportamental da ClearSale, via endpoint.
</script>

A ClearSale deverá informar qual valor deve ser utilizado na palavra sinalizada em verde (seu_app). Este valor serve para identificar o seu website em nosso sistema.

O valor de navigationID deve ser um ID único por usuário. Este ID pode ser um identificador específico ou um número aleatório de até 128 caracteres e deve ser mantido durante toda a sessão de navegação do usuário.

Após a implementação, caso queira validar a execução do script, realize um fluxo teste garantindo que o Javascript foi executado corretamente. Em seguida, envie o navigationID e o nome de cadastro para suporte.behavior@clear.sale

Resposta

A funcionalidade de monitoramento de comportamento de dispositivos deve ser contratada juntamente com o Device Check. Dessa forma, a resposta sobre a análise comportamental do dispositivo será retornada na mesma resposta da API.


{
  "Biometrics": [
    {
      "Incognito": false,
      "Bot": false,
      "BrowserTampering": false,
      "Emulated": false,
      "AdBlock": false,
      "LocationSpoofing": false,
      "Anomaly": 9,
      "BioIdentity": "",
      "DeveloperTools": false,
      "ConnectionSignals": 0,
      "BehaviorType": 1,
      "Moviment": 1,
      "NavigationMethod": 1
    }
  ]
}
    

IMPORTANTE: Em alguns casos de uso, o modelo pode não identificar algumas variáveis. Recomendamos utilizar a variável “bot” como referência, pois ela representa a interpretação positiva da identificação de dispositivos maliciosos em relação a todas as outras variáveis.

Mapa de Resposta

Nome Descrição Tipo
Incognito Indica se o navegador está em modo de navegação anônima. boolean
Bot Indica se o usuário é identificado como um bot. boolean
BrowserTampering Indica se houve alguma adulteração no navegador. boolean
Emulated Indica se o ambiente está sendo emulado. boolean
AdBlock Indica se um bloqueador de anúncios está ativo. boolean
LocationSpoofing Indica se a localização do usuário está sendo falsificada. boolean
Anomaly Indica o nível de anomalias detectadas. int
BioIdentity Identificador biométrico único do usuário. string
DeveloperTools Indica se as ferramentas de desenvolvedor do navegador foram abertas durante a navegação. boolean
ConnectionSignals Indicador relacionado às características de conexão de rede do dispositivo. int
BehaviorType Classifica se o tipo de comportamento do usuário é humano ou robótico. int
Moviment Indica as características do movimento do usuário ao interagir com a página. int
NavigationMethod Indica o método de navegação principal utilizado pelo usuário (TAB, Mouse, Teclado). int

Detalhes de privacidade

Uso de dados

Todas as informações coletadas pelo SDK da ClearSale são com exclusiva finalidade de prevenção à fraude e proteção ao próprio usuário, aderente à política de segurança e privacidade das plataformas Google e Apple e à LGPD. Por isso, estas informações devem constar na política de privacidade do aplicativo.

Tipo de dados coletados

O SDK da ClearSale coleta as seguintes informações do dispositivo :

  • Localização precisa (quando habilitada permissão pelo usuário);
  • Identificadores de publicidade do dispositivo (quando habilitada permissão pelo usuário);
  • Características físicas do dispositivo/ hardware (Como tela, bateria, teclado, espaço livre em disco, modelo, nome do dispositivo);
  • Características de software (Como versão, idioma, build, controle parental);
  • Informações de rede (Como Conexões, IP);
  • Operadora do SimCard.

Política de privacidade da Google
Política de privacidade da Apple
Licença

Licença de Uso

Ao realizar o download e utilizar nosso SDK você estará concordando com a seguinte licença.

Copyright © 2025 ClearSale

Todos os direitos são reservados, sendo concedida a permissão para usar o software da maneira como está, não sendo permitido qualquer modificação ou cópia para qualquer fim. O Software é licenciado com suas atuais configurações “tal como está” e sem garantia de qualquer espécie, nem expressa e nem implícita, incluindo mas não se limitando, garantias de comercialização, adequação para fins particulares e não violação de direitos patenteados. Em nenhuma hipótese os titulares dos Direitos Autorais podem ser responsabilizados por danos, perdas, causas de ação, quer seja por contrato ou ato ilícito, ou outra ação tortuosa advinda do uso do Software ou outras ações relacionadas com este Software sem prévia autorização escrita do detentor dos direitos autorais.