Passo 1 - Adicione o script e folha de estilo abaixo na tag 'head' do seu portal.
<script type="text/javascript" src="https://cdn.privacytools.com.br/sdkconsent/dist/sdkconsent.min.js"></script> <link rel="stylesheet" href="https://cdn.privacytools.com.br/sdkconsent/dist/sdkconsent.css" type="text/css" />
Passo 2 - Na inicialização do seu código configure o SDK.
<script type="text/javascript">
var sdk = sdkConsent("$base","$publicKey");
</script>
Registrando um consentimento
Para registrar um consentimento você precisa gerar um identificador único do seu usuário conforme orientação da variável hashUser. Envie também o parâmetro 'consent' (booleano) com o aceite (true) ou rejeição(false) do usuário.
O retorno caso bem sucedido será um text/plain com o protocolo de registro. Como o registro é assíncrono e entra em uma fila de consumidor/processador pode levar entre 30 segundos a 70 segundos para o consentimento poder ser consultado.
Se o ocorrer um erro a mensagem será exibida em um application/json.
Array de consentimentos: Caso você precise enviar um array com vários consentimentos ao mesmo tempo, basta enviar um objeto do tipo Array nos parâmetros $hashTemplate e $consent - Garanta que ambos possuem a mesma quantidade de dados ou serão rejeitados.
sdk.registerConsentForUser($hashTemplate,$hashUser,$consent,function(response){
console.log('success = '+response);
},function(response){
console.log('error = '+JSON.stringify(response));
});
Obtendo todos os consentimentos de um usuário
sdk.getConsentsUser($hashUser,function(response){
if(response && response.length>0){
for(var i=0;i<response.length;i++){
console.log(response[i].hashTemplate+'='+response[i].consent);
}
}else{
console.log('no data')
}
},function(response){
console.log('error = '+JSON.stringify(response));
});
Verificando um consentimento específico
sdk.verifyConsentUser($hashTemplate,$hashUser,function(response){
if(response && response.length>0){
for(var i=0;i<response.length;i++){
console.log(response[i].hashTemplate+'='+response[i].consent);
}
}else{
console.log('no data')
}
},function(response){
console.log('error = '+JSON.stringify(response));
});
Outras funções disponíveis
Função no SDK | Finalidade |
|---|---|
loadConsentCondition($hashTemplate) | Essa função retorna a estrutura JSON para você criar uma popup/dialog para coletar um determinado consentimento do seu usuário. Ela busca todas as informações registradas na plataforma para o hashTemplate informado. |
askForConsent($hashTemplate,$hashUser) | Essa função é semelhante à anterior mas aqui a popup/dialog é gerada pela API e ela cuida de toda a coleta do consentimento. |