setConsent
O comando setConsent informa ao Web SDK se ele deve enviar dados (aceitação), descartar dados (recusa) ou usar defaultConsent (consentimento desconhecido).
O Web SDK é compatível com os seguintes padrões:
-
Padrão do Adobe: os padrões 1.0 e 2.0 são compatíveis.
-
Estrutura de transparência e consentimento do IAB: se você usar esse padrão, o Perfil de cliente em tempo real do visitante será atualizado com as informações de consentimento se a implementação estiver configurada corretamente:
- O esquema de perfil individual XDM contém o Grupo de campos de Consentimento do TCF 2.0 do IAB.
- O esquema do Evento de experiência contém o Grupo de campos de Consentimento da TCF 2.0 do IAB.
- Você inclui as informações de consentimento do IAB no evento objeto XDM. O Web SDK não inclui automaticamente as informações de consentimento ao enviar dados do evento.
Após usar esse comando, o Web SDK grava as preferências do usuário em um cookie. Na próxima vez que o usuário carregar o site no navegador, o SDK recuperará essas preferências persistentes para determinar se os eventos podem ser enviados para o Adobe.
A Adobe recomenda que você armazene todas as preferências da caixa de diálogo de consentimento separadamente do consentimento do Web SDK. O Web SDK não oferece uma maneira de recuperar o consentimento. Para garantir que as preferências do usuário permaneçam sincronizadas com o SDK, você pode chamar o comando setConsent em cada carregamento de página. O Web SDK só faz uma chamada de servidor quando o consentimento é alterado.
Considerações sobre a sincronização de identidade identity-considerations
O comando setConsent usa somente ECID do mapa de identidade, pois o comando opera no nível do dispositivo. Outras identidades do mapa de identidades não são consideradas pelo comando setConsent.
Usando defaultConsent junto com setConsent using-consent
O Web SDK oferece dois comandos complementares de configuração de consentimento:
defaultConsent: este comando destina-se a capturar as preferências de consentimento dos clientes do Adobe que usam o Web SDK.setConsent: este comando tem como objetivo capturar as preferências de consentimento dos visitantes do site.
Quando usadas juntas, essas configurações podem levar a diferentes resultados de coleta de dados e configuração de cookie, dependendo de seus valores configurados.
Consulte a tabela abaixo para entender quando ocorre a coleta de dados e quando os cookies são definidos, com base nas configurações de consentimento.
inininoutinpendinginpendingoutpendingoutinoutoutoutOs seguintes cookies são definidos quando a configuração de consentimento permite:
idMigrationEnabled estiver habilitado. Ajuda na transição para o Web SDK enquanto algumas partes do site ainda usam o visitor.js.s_ecid=MCMID|<ECID>.Definir consentimento usando a extensão de tag do Web SDK
A configuração do consentimento é executada como uma ação em uma regra na interface das tags da Coleção de dados da Adobe Experience Platform.
- Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Coleção de dados > Marcas.
- Selecione a propriedade de tag desejada.
- Navegue até Regras e selecione a regra desejada.
- Em Ações, selecione uma ação existente ou crie uma ação.
- Defina o campo suspenso Extensão como Adobe Experience Platform Web SDK e defina o Tipo de Ação como Definir consentimento.
- Defina os campos desejados à direita, incluindo Padrão e Consentimento geral.
- Clique em Manter alterações e execute o fluxo de trabalho de publicação.
Você pode incluir vários objetos de consentimento nesta ação.
Definir consentimento usando a biblioteca JavaScript do Web SDK
Execute o comando setConsent ao chamar a instância configurada do Web SDK. Você pode incluir os seguintes objetos nesse comando:
consent[]: uma matriz deconsentobjetos. O objeto de consentimento é formatado de forma diferente dependendo do padrão e da versão escolhidos. Consulte as guias abaixo para obter exemplos de cada objeto de consentimento, dependendo do padrão de consentimento.identityMap: um objeto que controla como uma ECID é gerada e a quais IDs as informações de consentimento estão vinculadas. A Adobe recomenda incluir esse objeto quandosetConsentfor executado antes de outros comandos, comosendEvent.edgeConfigOverrides: Um objeto que contém substituições de configuração de sequência de dados.
Objeto do Adobe 2.0 standard consent
Se você estiver usando o Adobe Experience Platform, precisará incluir um grupo de campos de esquema de privacidade no esquema do perfil. Consulte Governança, privacidade e segurança no Adobe Experience Platform para obter mais informações sobre o padrão Adobe 2.0. Você pode adicionar dados dentro do objeto de valor abaixo correspondente ao esquema do campo consents do grupo de campos de perfil Consentimentos e Preferências.
-
standard: o padrão de consentimento escolhido. Defina esta propriedade como"Adobe"para o padrão Adobe 2.0. -
version: uma cadeia de caracteres que representa a versão do padrão de consentimento. Defina esta propriedade como"2.0"para o padrão Adobe 2.0. -
value: um objeto contendo valores de consentimento.value.collect.val: o valor de consentimento. Defina como"y"quando os usuários optarem por entrar e como"n"quando os usuários optarem por não participar.value.metadata.time: O carimbo de data/hora quando os usuários atualizaram suas configurações de consentimento pela última vez.
| code language-js |
|---|
|
Objeto consent padrão IAB TCF 2.0
Para registrar as preferências de consentimento do usuário fornecidas por meio do padrão Estrutura de transparência e consentimento (TCF) do Interative Advertising Bureau Europe (IAB), defina a string de consentimento como mostrado abaixo.
Quando o consentimento é definido dessa forma, o Perfil do cliente em tempo real é atualizado com as informações de consentimento. Para que isso funcione, o esquema XDM do perfil precisa conter o grupo de campos de esquema Privacidade do perfil. Ao enviar eventos, as informações de consentimento do IAB precisam ser adicionadas manualmente ao objeto XDM do evento. O Web SDK não inclui automaticamente as informações de consentimento nos eventos.
Para enviar as informações de consentimento nos eventos, você deve adicionar o grupo de campos Privacidade de eventos de experiência ao esquema XDM ExperienceEvent habilitado para Profile. Consulte a seção sobre atualização do esquema ExperienceEvent no guia de preparação do conjunto de dados para obter etapas sobre como configurar isso.
standard: o padrão de consentimento escolhido. Defina essa propriedade como"IAB TCF"para o padrão IAB TCF 2.0.version: uma cadeia de caracteres que representa a versão do padrão de consentimento. Defina essa propriedade como"2.0"para o padrão IAB TCF 2.0.value: uma cadeia de caracteres que contém o valor de consentimento.gdprApplies: um booleano que determina se o GDPR se aplica a este valor de consentimento. Seu valor padrão étrue.gdprContainsPersonalData: um booleano que determina se os dados do evento associados a este usuário contêm dados pessoais. Seu valor padrão éfalse.
| code language-js |
|---|
|
Objeto consent padrão do Adobe 1.0
standard: o padrão de consentimento escolhido. Defina esta propriedade como"Adobe"para o padrão Adobe 1.0.version: uma cadeia de caracteres que representa a versão do padrão de consentimento. Defina esta propriedade como"1.0"para o padrão Adobe 1.0.value.general: o valor de consentimento. Defina como"in"quando os usuários optarem por entrar e como"out"quando os usuários optarem por não participar.
| code language-js |
|---|
|
Envio de vários padrões em uma solicitação multiple-standards
O Web SDK também permite enviar mais de um objeto de consentimento em uma solicitação, conforme mostrado no exemplo abaixo.
alloy("setConsent", {
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: {
val: "y"
},
metadata: {
time: "2021-03-17T15:48:42-07:00"
}
}
}, {
standard: "IAB TCF",
version: "2.0",
value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
gdprApplies: true
}]
});
Persistência das preferências de consentimento persistence
Depois de comunicar as preferências do usuário ao Web SDK usando o comando setConsent, o SDK mantém as preferências do usuário para um cookie. Na próxima vez que o usuário carregar o site no navegador, o Web SDK recuperará e usará essas preferências persistentes para determinar se os eventos podem ou não ser enviados para o Adobe.
Você precisará armazenar as preferências do usuário independentemente para poder mostrar a caixa de diálogo de consentimento com as preferências atuais. Não há como recuperar as preferências do usuário no Web SDK. Para garantir que as preferências do usuário permaneçam sincronizadas com o SDK, você pode chamar o comando setConsent em cada carregamento de página. O Web SDK só fará uma chamada de servidor se as preferências tiverem sido alteradas.