setConsent

O comando setConsent informa ao SDK da Web se ele deve enviar dados (aceitação), descartar dados (recusa) ou usar defaultConsent (consentimento desconhecido).

O SDK da Web é compatível com os seguintes padrões:

Após usar esse comando, o SDK da Web 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 SDK da Web. O SDK da Web 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 SDK da Web só faz uma chamada de servidor quando o consentimento é alterado.

Usando defaultConsent junto com setConsent using-consent

O SDK da Web oferece dois comandos complementares de configuração de consentimento:

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.

Os seguintes cookies são definidos quando a configuração de consentimento permite:

Definir o consentimento usando a extensão de tag do SDK da Web

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.

Você pode incluir vários objetos de consentimento nesta ação.

Definir o consentimento usando a biblioteca JavaScript do SDK da Web

Execute o comando setConsent ao chamar a instância configurada do SDK da Web. Você pode incluir os seguintes objetos nesse comando:

// 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"
      }
    }
  }]
});

// 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
  }]
});

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

Envio de vários padrões em uma solicitação multiple-standards

O SDK da Web também permite enviar mais de um objeto de consentimento em uma solicitação, como 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 SDK da Web usando o comando setConsent, o SDK mantém as preferências do usuário em um cookie. Na próxima vez que o usuário carregar o site no navegador, o SDK da Web 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 SDK da Web. 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 SDK da Web só fará uma chamada de servidor se as preferências tiverem sido alteradas.

Sincronização de identidades ao definir o consentimento sync-identities

Quando o consentimento padrão (definido por meio do parâmetro defaultConsent) é definido como pending ou out, a configuração setConsent pode ser a primeira solicitação que sai e estabelece a identidade. Por isso, pode ser importante sincronizar identidades na primeira solicitação. Você pode adicionar o mapa de identidade ao comando setConsent da mesma forma que no comando sendEvent. Consulte usando identityMap para obter um exemplo de como incluir o mapa de identidade no comando.