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.
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
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.
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 |
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.
O SDK da ClearSale coleta as seguintes informações do dispositivo :
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.