API Reference
Log In

Scripts de apoio a análise de fraude

Sobre

Para um bom funcionamento e assertividade das análises de prevenção a fraude nas transações online, recomedamos muito que sejam seguidas as três etapas descritas abaixo, que visam monitorar a ação do usuário em pagina assim como identificá-lo junto ao motor de decisão utilizado pela Justa.

Instalação das meta tags em seu site

A marcação de páginas no seu site pode ser feita usando meta tags.

O procedimento é simples, bastando adicionar tags no seu header (cabeçalho). Através delas, o sistema de antifraude terá um conhecimento mais abrangente das páginas servidas e também do produto ou categoria mostrado, assim como o produto ou categoria visualizada no momento.

Para iniciar essa marcação, adicione nossas <meta> tags no seu header.
Essas tags nos dirão que tipo de página você está servindo e, opcionalmente, qual produto ou categoria de produto estão sendo mostrados.
Para utilizar Meta tags, você pode utilizar o exemplo abaixo na sua página, atendendo a estrutura do seu site.
As meta tags listadas em nossa orientação, ilustram o cenário mais comum de estrutura para um site de viagens, contendo páginas de "Esqueci minha senha", "Checkout", "Detalhes do Produto" e "Busca de passagens".

Você deve nomear suas tags, de acordo com as páginas disponíveis no seu ambiente.

<!-- Página de 'Esqueci minha senha' --> 
<meta name="kdt:page" content="password-reset">  

<!-- Processo de checkout --> 
<meta name="kdt:page" content="checkout">  

<!-- Detalhe de produto --> 
<meta name="kdt:page" content="product"> 
<meta name="kdt:product" content="sku=123, name=Camiseta Verde">  

<!-- Busca de passagens (voo, ônibus) --> 
<meta name="kdt:page" content="search"> 
<meta name="kdt:departure" content="GRU-SFO"> 
<meta name="kdt:departure-date" content="2020-12-25"> 
<meta name="kdt:return" content="SFO-GRU"> 
<meta name="kdt:return-date" content="2021-01-25">

Coletando Eventos

Para que possamos coletar os eventos em sua página, é necessário que implemente em seu site um código JavaScript.

Esse código será responsável por enviar as informações da decisão de compra do seu cliente, e é de suma importância sua implementação, uma vez que o processo de análise de comportamento agrega um peso considerável às análises e conseguimos com a ajuda desse recurso, monitorar as páginas acessadas, o tempo de acesso em cada sessão ou produto, todo o processo de compra do seu cliente, dentre outros dados.

Como funciona?

O código funciona de forma assíncrona em seu site. Isso quer dizer que ele será o último elemento a ser carregado em seu site.

Por este motivo, garantimos que ele não afeta a performance do seu site e é invisível ao seu visitante, funcionando de forma semelhante a um Analytics.

Nosso JavaScript foi testado em diferentes cenários para garantir os resultados descritos acima, sendo assim desnecessária qualquer alteração em seu corpo, exceto a chave do exemplo pela sua chave.

Sua chave será encaminhada pela equipe de suporte da Justa, assim que todo trâmite estiver finalizado.

Você pode adicioná-lo em qualquer lugar antes do fechamento no seu site.

Após inclui-lo entre em contato com nosso Suporte para auxiliá-lo nos próximos passos ou em casos de dúvidas.

<script type="text/javascript">   
	var __kdt = __kdt || [];
__kdt.push({"public_key": "CHAVE_PUBLICA_AQUI"}); // A chave pública identifica a sua loja  
	(function() {   
		var kdt = document.createElement('script');   
		kdt.id = 'kdtjs'; kdt.type = 'text/javascript';   
		kdt.async = true;    kdt.src = 'https://i.k-analytix.com/k.js';   
		var s = document.getElementsByTagName('body')[0];   
		s.parentNode.insertBefore(kdt, s);
  	 })(); 
</script>

Identificando o Visitante

Você precisa recuperar o ID de visitante chamando o método getVisitorID() do nosso JavaScript.
Esse método devolverá um ID que representará a ligação entre os dados de navegação recebidos durante o processo e o "autor" da compra, a "amarração" que comentamos no início desse artigo.
Este identificador deve ser passado para a nossa API através do campo sessionId.

Para implementar essa identificação, utilize o modelo do código abaixo em seu site sem alterações:

var visitorID; 
(function() {     
	var period = 300;     
	var limit = 20 * 1e3;     
	var nTry = 0;     
	var intervalID = setInterval(function() {         
	var clear = limit/period <= ++nTry;         
	if ((typeof(Konduto) !== "undefined") &&
            (typeof(Konduto.getVisitorID) !== "undefined")) {             
		visitorID = window.Konduto.getVisitorID();             
		clear = true;         
	}         
	if (clear) {
 clearInterval(intervalID); 
}     
}, period);
})(visitorID);

Problemas comuns

Estou vendo o erro 'Uncaught ReferenceError: Konduto is not defined' ao chamar o JavaScript

Este erro acontece quando o método chamado ainda não está carregado na memória do navegador. O nosso JavaScript é inserido de forma assíncrona, depois que todo o site está carregado e pronto. Ele é geralmente um dos últimos scripts a rodar, propositalmente, para não influenciar a velocidade do site.

Por esta razão, é possível que você esteja chamando um dos métodos antes que o nosso JavaScript tenha sido totalmente carregado, gerando este erro. Recomendamos colocar um setInterval em seu script para testar a presença do objeto Konduto.