Se o senhor estiver mudando de outra solução de gerenciamento de cookies para a nossa, talvez queira migrar os consentimentos que já coletou. Isso é útil para garantir que os usuários que já deram seu consentimento na solução anterior não recebam novamente o banner de cookies e a respectiva solicitação de consentimento.
Há duas maneiras de fazer isso, dependendo do fato de a plataforma “antiga” fornecer um cookie(método síncrono) ou exigir uma chamada para sua API(método assíncrono).
Método síncrono
Antes de incorporar o Privacy Controls and Cookie Solution, o senhor precisará definir uma função síncrona (por exemplo, isConsentGivenByOtherPlatform
) para obter o consentimento da outra plataforma:
<script type="text/javascript"> function readLocalCookie(cookieName) { var cookies = document.cookie.split(';'); for (var i = 0; i < cookies.length; i++) { var e=cookies[i].split('='); if (e[0] === cookieName) { return e[1]; } } return null; } function isConsentGivenByOtherPlatform() { var otherPlatformCookieName = 'cookie_from_other_platform'; // use the actual cookie name saved by the other platform var prevConsent = readLocalCookie(otherPlatformCookieName); if (prevConsent) { return true; } else { return false; } } </script>
Importante
Não copie e cole o código mostrado acima – é apenas um exemplo de código que fornecemos para ajudá-lo a entender a abordagem.
Em seguida, adicione o snippet Privacy Controls and Cookie Solution, invocando o retorno de chamada onReady
:
<script type="text/javascript"> var _iub = _iub || []; _iub.csConfiguration = { "lang": "en", "siteId": XXXXXX, // use your siteId "cookiePolicyId": YYYYYY, // use your cookiePolicyId "banner": { "acceptButtonDisplay": true, "customizeButtonDisplay": true, "position": "float-top-center" }, "callback": { "onReady": function() { if (typeof window.isConsentGivenByOtherPlatform === 'function' && isConsentGivenByOtherPlatform()) { _iub.cs.api.setPreferences({ consent: true, ccpa: true, uspr: { 'all': true, 'sd8': true, 'sd9': true, }, purposes: { '1': true, '2': true, '3': true, '4': true, '5': true, }, tcfv2: { 'all': true, }, gac: { 'all': true, }, }, true); } } } }; </script> <script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>
O retorno de chamada onReady
verifica se o consentimento já foi dado em outra plataforma e, em caso afirmativo, armazena-o chamando o método _iub.cs.api.setPreferences()
.
Consentimento por categoria
_iub.cs.api.storeConsent()
permite personalizar as finalidades também no argumento, que pode ser {consent: true}
, {consent: false}
ou {purposes: {1: true, 2: false, …}}
.
Método assíncrono
Antes de incorporar o código do Privacy Controls and Cookie Solution, o senhor precisará definir uma função que:
- aceita um retorno de chamada;
- detecta o consentimento;
- salva o consentimento em uma variável global; e
- invoca o retorno de chamada posteriormente.
Aqui está um exemplo:
<script type="text/javascript"> // fetch consent asynchronously from 3rd party function getConsentByOtherPlatform(cb) { $.getJSON('http://otherplatform.com/api/get-consent', function(result) { if (result.given) { window.consentByOtherPlatform = true; } else { window.consentByOtherPlatform = false; } cb(); }); } function isConsentGivenByOtherPlatform() { return !!window.consentByOtherPlatform; } </script>
Importante
Não copie e cole o código mostrado acima – é apenas um exemplo de código que fornecemos para ajudá-lo a entender a abordagem.
Em seguida, adicione o snippet Privacy Controls and Cookie Solution, invocando o callback on
Ready:
<script type="text/javascript"> var _iub = _iub || []; _iub.csConfiguration = { "lang": "en", "siteId": XXXXXX, // use your siteId "cookiePolicyId": YYYYYY, // use your cookiePolicyId "banner": { "acceptButtonDisplay": true, "customizeButtonDisplay": true, "position": "float-top-center" }, "callback": { "onReady": function() { if (typeof window.isConsentGivenByOtherPlatform === 'function' && isConsentGivenByOtherPlatform()) { _iub.cs.api.setPreferences({ consent: true, ccpa: true, uspr: { 'all': true, 'sd8': true, 'sd9': true, }, purposes: { '1': true, '2': true, '3': true, '4': true, '5': true, }, tcfv2: { 'all': true, }, gac: { 'all': true, }, }, true); } } } } }; </script> <script type="text/javascript"> // ask for 3rd party consent before including the CS getConsentByOtherPlatform(function() { var s = document.createElement('script'); s.src = '//cdn.iubenda.com/cs/iubenda_cs.js'; document.head.appendChild(s); }); </script>
O retorno de chamada onReady
verificará se o consentimento já foi dado em outra plataforma e, em caso afirmativo, o armazenará chamando o método _iub.cs.api.setPreferences()
.
Consentimento por categoria
_iub.cs.api.storeConsent()
permite personalizar as finalidades também no argumento, que pode ser {consent: true}
, {consent: false}
ou {purposes: {1: true, 2: false, …}}
.
_iub.cs.api.setPreferences(consentObj, hideBanner)
O método _iub.cs.api.setPreferences
espera dois argumentos: consentObj (obrigatório) e hideBanner (opcional)
consentObj
É um objeto com itens de preferências de acompanhamento:
- consentimento – necessário – aceita
true
oufalse
– Refere-se ao consentimento geral - ccpa – obrigatório se a CCPA estiver ativada – aceita
true
oufalse
– refere-se à privacidade dos EUA e será aplicada somente se a CCPA estiver ativada na Cookie Solution - uspr – obrigatório se a USPR estiver ativada – aceita um objeto com as seguintes opções – refere-se ao consentimento da USPR e será aplicado somente se a USPR estiver ativada na Cookie Solution
- all – aceita
true
oufalse
– essa opção define o mesmo valor para todos os fins
- all – aceita
uspr: { all: true // or false }
- [purposeId] – aceita
true
oufalse
– essa opção define o valor para fins de ID específicos
uspr: { 's': true, // or false 'sh': false, // or true 'adv': false // or true }
- purposes – obrigatório se
perPurposeConsent
estiver ativado – aceita um objeto com as seguintes opções – refere-se ao consentimento para fins e será aplicado somente seperPurposeConsent
estiver ativado na Cookie Solution- all – aceita
true
oufalse
– essa opção define o mesmo valor para todos os fins
- all – aceita
purposes: { all: true // or false }
- [purposeId] – aceita
true
oufalse
– essa opção define o valor para fins de ID específicos
purposes: { '1': true, // or false '2': false, // or true '4': false // or true }
- tcfv2 – obrigatório se o TCF estiver ativado – aceita um objeto com as seguintes opções – refere-se ao consentimento do TCF e será aplicado somente se o TCF estiver ativado na Cookie Solution
- all – aceita
true
oufalse
– essa opção define o mesmo valor para todas as finalidades do TCF
- all – aceita
tcfv2: { all: true // or false }
- [string] – aceita uma string TCF
tcfv2: 'CP9rVEAP9rVEAB7FGCENAyEgAAAAAAAAAAAAAAAUHgJAA4AM-AjwBKoDfAHbAO5AgoBIgCSgEowJaATHAmSBNICfYFBAKDgAAAAA'
- gac – obrigatório se o Google Aditional Consent estiver ativado – aceita um objeto com as seguintes opções – refere-se ao consentimento do GAC e será aplicado somente se o GAC estiver ativado na Cookie Solution
- all – aceita
true
oufalse
– essa opção define o mesmo valor para todos os fornecedores de GAC
- all – aceita
gac: { all: true // or false }
- [string] – aceita uma string GAC
gac: '1~1584.2292.2392'
hideBanner
É um booleano para ocultar ou não o banner após o armazenamento de preferências; nesse caso, ele deve ser sempre true
_iub.cs.api.setPreferences({ ... }, true); // hide the banner after the preference storage _iub.cs.api.setPreferences({ ... }, false); // keep the banner after the preference storage