setConsent

Objeto do Adobe 2.0 standard consent

Se enviar dados para a Adobe Experience Platform, você deverá incluir um grupo de campos de esquema de privacidade no esquema do seu 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 Consents and Preferences.

• 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.

// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});

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 Profile habilitado para XDM ExperienceEvent. 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.

// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});

A API da TCF do IAB 2.0 fornece um evento para quando o consentimento é atualizado pelo cliente. Isso ocorre quando o cliente define inicialmente suas preferências e quando o cliente atualiza suas preferências. Você pode adicionar um ouvinte de eventos para executar o comando setConsent:

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

O bloco de código acima escuta o evento useractioncomplete e define o consentimento, transmitindo a cadeia de consentimento e o sinalizador gdprApplies. Se você tiver identidades personalizadas para seus clientes, preencha a variável identityMap.

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.

// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});