DocumentaçãoExperience PlatformColeção de dados

defaultConsent

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

A propriedade defaultConsent determina como você lida com o consentimento da coleta de dados antes de chamar o comando setConsent. Essa propriedade é importante quando você não deseja coletar dados acidentalmente de indivíduos que residem em áreas onde o consentimento é necessário antes de coletar dados.

Se você tiver um visitante que não esteja na jurisdição do Regulamento Geral sobre a Proteção de Dados (GDPR), o consentimento padrão poderá ser definido como in. Os visitantes dentro da jurisdição do GDPR podem ter seu consentimento padrão definido como pending. Sua Plataforma de Gerenciamento de Consentimento (CMP) pode detectar a região do cliente e fornecer o sinalizador gdprApplies para a TCF 2.0 do IAB. Esse sinalizador pode ser usado para definir o consentimento padrão.

Defina a propriedade da cadeia de caracteres defaultConsent com o nível de consentimento desejado ao executar o comando configure. Esta propriedade diferencia maiúsculas e minúsculas e oferece suporte apenas aos três valores a seguir: "in", "out" e "pending". Se você tentar usar qualquer outro valor, a biblioteca emitirá um erro. Se não estiver definido no comando configure, o valor padrão será in.

IMPORTANT
O valor defaultConsent não persiste entre os carregamentos de página. Defina o consentimento padrão desejado sempre que chamar o comando configure.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  defaultConsent: "pending"
});
  • in: A coleta de dados opera normalmente até que o usuário opte por não participar.
  • out: os dados são descartados permanentemente até que o usuário opte por entrar.
  • pending: os dados são armazenados localmente até que o usuário opte por usar o comando setConsent.
NOTE
Embora a Adobe planeje criar um conjunto mais robusto de finalidades ou categorias que correspondam aos recursos e ofertas de produtos da Adobe, a implementação atual é uma abordagem do tipo "tudo ou nada" para a aceitação. Essa limitação se aplica somente ao Web SDK e não a outras bibliotecas JavaScript do Adobe.

O Web SDK oferece duas opções de consentimento complementares:

  • defaultConsent (esta página): determina as preferências de consentimento padrão.
  • setConsent: Capture as preferências de consentimento dos visitantes.

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.

defaultConsent
setConsent
Ocorre a coleta de dados
O Web SDK define cookies do navegador
in
in
Sim
Sim
in
out
Não
Sim
in
Não definido
Sim
Sim
pending
in
Sim
Sim
pending
out
Não
Sim
pending
Não definido
Não
Não
out
in
Sim
Sim
out
out
Não
Sim
out
Não definido
Não
Não

Consulte Cookies do Adobe Experience Platform Web SDK para obter uma lista de cookies que a biblioteca define.

NOTE
Os cookies de identidade e consentimento são definidos mesmo se um visitante optar por não ser rastreado. Esses cookies são necessários para honrar as preferências de coleção de dados.

Definindo consentimento padrão com base em gdprApplies

Algumas CMPs fornecem a capacidade de determinar se o Regulamento Geral sobre a Proteção de Dados (GDPR) se aplica ao cliente. Se você quiser assumir o consentimento para clientes aos quais o GDPR não se aplica, poderá usar o sinalizador gdprApplies em uma chamada de API TCF. Por exemplo:

var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
    window.alloy("configure", alloyConfiguration);
  }
});

No bloco de código acima, o comando configure é chamado depois que tcData é obtido da API TCF. Se gdprApplies for verdadeiro, o consentimento padrão será definido como pending. Se gdprApplies for falso, o consentimento padrão será definido como in. Preencha a variável alloyConfiguration com sua configuração.

Consentimento padrão usando a extensão de tag do Web SDK

Consulte Configurações de consentimento na documentação da extensão de tag do Web SDK para saber como executar essas ações usando tags.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1