DocumentaçãoExperience PlatformGuia do Experience Data Model (XDM)

Tipo de dados Consentimentos e Preferências

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor

O tipo de dados Consentimento para Privacidade, Personalization e Preferências de Marketing (a seguir denominado o tipo de dados "Consentimentos e Preferências") é um tipo de dados Experience Data Model (XDM) destinado a oferecer suporte à coleta de permissões e preferências do cliente geradas pelas Plataformas de Gerenciamento de Consentimento (CMPs) e outras fontes das suas operações de dados.

Este documento abrange a estrutura e o uso pretendido dos campos fornecidos pelo tipo de dados Consentimentos e Preferências.

Pré-requisitos prerequisites

Este documento requer uma compreensão funcional do XDM e o uso dos esquemas em Experience Platform. Revise a documentação a seguir antes de continuar:

Estrutura do tipo de dados structure

IMPORTANT
O tipo de dados Consentimentos e Preferências foi projetado para abranger uma variedade de casos de uso de gerenciamento de preferências e consentimento. Como resultado, este documento descreve o uso dos campos do tipo de dados em termos gerais e faz sugestões apenas sobre como você deve interpretar o uso desses campos. Consulte sua equipe jurídica de privacidade para alinhar a estrutura do tipo de dados com a forma como sua organização interpreta e apresenta essas opções de consentimento e preferência aos clientes.

O tipo de dados Consentimentos e Preferências fornece vários campos usados para capturar informações de consentimento e preferência.

Um consentimento é uma opção que permite que um cliente especifique como seus dados podem ser usados. A maioria dos consentimentos tem um aspecto legal, já que algumas jurisdições exigem a obtenção de permissão antes que os dados possam ser usados de uma determinada maneira, ou exigem que o cliente tenha uma opção para interromper esse uso (opt out) se o consentimento positivo não for necessário.

Uma preferência é uma opção que permite ao cliente especificar como diferentes aspectos de sua experiência com uma marca devem ser tratados. Eles se encaixam em duas categorias:

  • Preferências do Personalization: preferências relacionadas a como a marca deve personalizar experiências entregues a um cliente.
  • Preferências de marketing: preferências que especificam se uma marca pode contatar um cliente por meio de vários canais.

A captura de tela a seguir mostra como a estrutura do tipo de dados é representada na interface do usuário da plataforma:

TIP
Consulte o guia em explorando recursos XDM para obter etapas sobre como pesquisar qualquer recurso XDM e inspecionar sua estrutura na interface do usuário da plataforma.

O JSON a seguir mostra um exemplo do tipo de dados que o tipo de dados Consentimentos e Preferências pode processar. As informações sobre o uso específico de cada um desses campos são fornecidas nas seções a seguir.

{
  "consents": {
    "collect": {
      "val": "VI",
    },
    "adID": {
      "idType": "IDFA",
      "val": "y"
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "u"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}
TIP
Você pode gerar dados JSON de amostra para qualquer esquema XDM definido no Experience Platform para ajudar a visualizar como os dados de consentimento e preferência do cliente devem ser mapeados. Consulte a documentação a seguir para obter mais informações:

consents choices

consents contém vários campos que descrevem os consentimentos e preferências de um cliente. Esses campos são descritos com mais detalhes nas subseções abaixo.

"consents": {
  "collect": {
    "val": "VI",
  },
  "adID": {
    "idType": "IDFA",
    "val": "y"
  },
  "share": {
    "val": "y",
  },
  "personalize": {
    "content": {
      "val": "y"
    }
  },
  "marketing": {
    "preferred": "email",
    "any": {
      "val": "u"
    },
    "email": {
      "val": "n",
      "reason": "Too Frequent",
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

collect

collect representa o consentimento do cliente para que seus dados sejam coletados.

"collect": {
  "val": "y"
}
Propriedade
Descrição
val
A opção de consentimento fornecida pelo cliente para este caso de uso. Consulte o apêndice para obter os valores e as definições aceitos.

adID

adID representa o consentimento do cliente para que uma ID de anunciante possa ser usada para vincular o cliente em aplicativos neste dispositivo.

"adID": {
  "idType": "IDFA",
  "val": "y"
}
Propriedade
Descrição
idType
O tipo de ID do anúncio, IDFA para a ID do Apple para anunciantes ou GAID para a ID do anunciante da Google, também conhecida como AAID (Android Advertiser ID).
val
A opção de consentimento fornecida pelo cliente para este caso de uso. Consulte o apêndice para obter os valores e as definições aceitos.

share

share representa o consentimento do cliente para que os dados sejam compartilhados com (ou vendidos a) segundos ou terceiros.

"share": {
  "val": "y"
}
Propriedade
Descrição
val
A opção de consentimento fornecida pelo cliente para este caso de uso. Consulte o apêndice para obter os valores e as definições aceitos.

personalize personalize

personalize captura as preferências do cliente com relação a quais maneiras seus dados podem ser usados para personalização. Os clientes podem recusar casos de uso de personalização específicos ou recusar totalmente a personalização.

IMPORTANT
personalize não abrange casos de uso de marketing. Por exemplo, se um cliente optar por não ser personalizado para todos os canais, ele não deverá parar de receber comunicações por meio desses canais. Em vez disso, as mensagens que recebem devem ser genéricas e não baseadas em seus perfis.
Pelo mesmo exemplo, se um cliente optar por não participar do marketing direto para todos os canais (por meio do marketing, explicado na próxima seção), ele não deverá receber nenhuma mensagem, mesmo que a personalização seja permitida.
"personalize": {
  "content": {
    "val": "y",
  }
}
Propriedade
Descrição
content
Representa as preferências do cliente para conteúdo personalizado no site ou aplicativo.
val
A preferência de personalização fornecida pelo cliente para o caso de uso especificado. Nos casos em que não é necessário solicitar o consentimento do cliente, o valor desse campo deve indicar a base sobre a qual a personalização deve ocorrer. Consulte o apêndice para obter os valores e as definições aceitos.

marketing marketing

marketing captura as preferências do cliente com relação às finalidades de marketing para as quais seus dados podem ser usados. Os clientes podem recusar casos de uso de marketing específicos ou recusar totalmente o marketing direto.

"marketing": {
  "preferred": "email",
  "any": {
    "val": "u"
  },
  "email": {
    "val": "n",
    "reason": "Too Frequent"
  },
  "push": {
    "val": "y"
  },
  "sms": {
    "val": "y"
  }
}
Propriedade
Descrição
preferred
Indica o canal preferido do cliente para receber comunicações. Consulte o apêndice para ver os valores aceitos.
any
Representa as preferências do cliente para marketing direto como um todo. A preferência de consentimento fornecida neste campo é considerada a preferência "padrão" para qualquer canal de marketing, a menos que seja substituída por subcampos adicionais fornecidos em marketing. Se você planeja usar opções de consentimento mais granulares, é recomendável excluir esse campo.

Se o valor for definido como n, todas as configurações de personalização mais específicas deverão ser ignoradas. Se o valor for definido como y, todas as opções de personalização mais refinadas também deverão ser tratadas como y, a menos que explicitamente definidas como n. Se o valor não for definido, os valores de cada opção de personalização deverão ser honrados conforme especificado.
email
Indica se o cliente concorda em receber mensagens de email.
push
Indica se o cliente permite receber notificações por push.
sms
Indica se o cliente concorda em receber mensagens de texto.
val
A preferência fornecida pelo cliente para o caso de uso especificado. Nos casos em que não é necessário solicitar o consentimento do cliente, o valor deste campo deve indicar a base em que o caso de uso de marketing deve ocorrer. Consulte o apêndice para obter os valores e as definições aceitos.
time
Um carimbo de data e hora ISO 8601 que indica quando a preferência de marketing foi alterada, se aplicável. Observe que se o carimbo de data e hora de qualquer preferência individual for igual ao fornecido em metadata, esse campo não deverá ser definido para essa preferência.
reason
Quando um cliente recusa um caso de uso de marketing, esse campo de string representa o motivo pelo qual o cliente recusou.

metadata

metadata captura metadados gerais sobre os consentimentos e preferências do cliente sempre que foram atualizados pela última vez.

"metadata": {
  "time": "2019-01-01T15:52:25+00:00",
}
Propriedade
Descrição
time
Um carimbo de data e hora ISO 8601 pela última vez que qualquer consentimento e preferência do cliente foi atualizado. Esse campo pode ser usado em vez de aplicar carimbos de data e hora a preferências individuais para reduzir a carga e a complexidade. Fornecer um valor time sob uma preferência individual substitui o carimbo de data/hora metadata dessa preferência específica.

Assimilar dados usando o tipo de dados ingest

Para usar o tipo de dados Consentimentos e Preferências para assimilar dados de consentimento de seus clientes, você deve criar um conjunto de dados com base em um esquema que contenha esse tipo de dados.

Consulte o tutorial sobre criação de um esquema na interface para ver etapas sobre como atribuir tipos de dados a campos. Depois de criar um esquema contendo um campo com o tipo de dados Consentimentos e Preferências, consulte a seção sobre criação de um conjunto de dados no guia do usuário do conjunto de dados, seguindo as etapas para criar um conjunto de dados com um esquema existente.

IMPORTANT
Para enviar dados de consentimento para Real-Time Customer Profile, é necessário criar um esquema habilitado para Profile com base na classe XDM Individual Profile que contenha o tipo de dados Consentimentos e Preferências. O conjunto de dados criado com base nesse esquema também deve ser habilitado para Profile. Consulte os tutoriais vinculados acima para obter etapas específicas relacionadas aos requisitos de Real-Time Customer Profile para esquemas e conjuntos de dados.
Além disso, você também deve garantir que suas políticas de mesclagem sejam configuradas para priorizar os conjuntos de dados que contêm os dados de consentimento e preferência mais recentes, para que os perfis do cliente sejam atualizados corretamente. Consulte a visão geral em políticas de mesclagem para obter mais informações.

Lidar com alterações de consentimento e preferência

Quando um cliente altera seus consentimentos ou preferências no site, essas alterações devem ser coletadas e imediatamente aplicadas usando o Adobe Experience Platform Web SDK. Se um cliente recusar a coleta de dados, toda a coleta de dados deverá ser interrompida imediatamente. Se um cliente optar por não ser personalizado, não deverá haver personalização na próxima página que visitar.

Apêndice appendix

As seções abaixo fornecem informações de referência adicionais sobre o tipo de dados Consentimentos e Preferências.

Valores aceitos para val choice-values

A tabela a seguir descreve os valores aceitos para val:

Valor
Título
Descrição
y
Sim (aceitação)
O cliente optou pelo consentimento ou preferência. Em outras palavras, eles consentem o uso de seus dados conforme indicado pelo consentimento ou preferência em questão.
n
Não (recusar)
O cliente recusou o consentimento ou a preferência. Em outras palavras, não consente com o uso de seus dados conforme indicado pelo consentimento ou preferência em questão.
p
Verificação pendente
O sistema ainda não recebeu um consentimento final ou valor de preferência. Isso é usado com mais frequência como parte de um consentimento que requer verificação em duas etapas. Por exemplo, se um cliente optar por receber emails, esse consentimento será definido como p até que ele selecione um link em um email para verificar se forneceu o endereço de email correto. Nesse momento, o consentimento será atualizado para y.

Se este consentimento ou preferência não utilizar um processo de verificação de dois conjuntos, a opção p poderá ser usada para indicar que o cliente ainda não respondeu ao prompt de consentimento. Por exemplo, você pode definir automaticamente o valor como p na primeira página de um site, antes que o cliente tenha respondido ao prompt de consentimento. Em jurisdições que não exigem consentimento explícito, você também pode usá-lo para indicar que o cliente não recusou explicitamente (em outras palavras, o consentimento é presumido).
u
Desconhecido
As informações de consentimento ou preferência do cliente são desconhecidas.
dy
Padrão de Sim (aceitação)
O cliente não forneceu um valor de consentimento e é tratado como uma aceitação ("Sim") por padrão. Em outras palavras, o consentimento é presumido até que o cliente indique o contrário.

Observe que, se leis ou alterações na política de privacidade da sua empresa resultarem em alterações nos padrões de alguns ou de todos os usuários, será necessário atualizar manualmente todos os perfis que contenham valores padrão.
dn
Padrão de Não (recusar)
O cliente não forneceu um valor de consentimento e é tratado como uma opção de não participação ("Não") por padrão. Em outras palavras, presume-se que o cliente tenha negado o consentimento até que indique o contrário.

Observe que, se leis ou alterações na política de privacidade da sua empresa resultarem em alterações nos padrões de alguns ou de todos os usuários, será necessário atualizar manualmente todos os perfis que contenham valores padrão.
LI
Interesse legítimo
O interesse comercial legítimo de coletar e processar esses dados para a finalidade especificada supera o dano potencial que eles representam para o indivíduo.
CT
Contrato
A coleta de dados para a finalidade especificada é necessária para cumprir obrigações contratuais com o indivíduo.
CP
Cumprimento de uma obrigação legal
A coleta de dados para a finalidade especificada é necessária para atender às obrigações legais da empresa.
VI
Interesse vital do indivíduo
A recolha de dados para os fins especificados é necessária para proteger os interesses vitais do indivíduo.
PI
Interesse público
A recolha de dados para os fins especificados é necessária para executar uma missão de interesse público ou para o exercício da autoridade pública.

Valores aceitos para preferred preferred-values

A tabela a seguir descreve os valores aceitos para preferred. Os valores de preferred indicam o canal de preferência do cliente para receber comunicações que informem sobre a coleta de dados, as políticas de privacidade e as opções de personalização.

Valor
Descrição
email
Esta preferência indica o consentimento do cliente para receber mensagens por email.
push
Esta preferência indica o consentimento do cliente para receber notificações por push. São mensagens ou alertas enviados diretamente ao dispositivo, geralmente um aplicativo móvel.
inApp
Esta preferência indica o consentimento do cliente para receber mensagens no aplicativo. Essas mensagens são entregues em um aplicativo móvel ou Web e fornecem informações enquanto o usuário está ativamente envolvido no aplicativo.
sms
Esta preferência indica o consentimento do cliente para receber mensagens via SMS (Short Message Service). São mensagens de texto enviadas para o celular deles.
phone
Esta preferência indica o consentimento do cliente para receber comunicações por meio de interações de chamada telefônica.
phyMail
Esta preferência indica o consentimento do cliente para receber material por correio físico.
inVehicle
Esta preferência indica o consentimento do cliente para receber notificações enquanto estiver em seu veículo. Estas mensagens podem ser entregues através de sistemas de informação do veículo ou outros canais de comunicação no veículo.
inHome
Esta preferência indica o consentimento do cliente para receber mensagens em casa. Essas mensagens podem ser entregues por meio de dispositivos residenciais inteligentes ou outros canais de comunicação baseados em residências.
iot
Esta preferência denota o consentimento do cliente para receber mensagens relacionadas à IoT (Internet das Coisas). Essas mensagens podem ser entregues por meio de dispositivos e sistemas conectados em seu ambiente.
social
Esta preferência indica o consentimento do cliente para receber comunicações por meio de plataformas de redes sociais.
other
Essa preferência engloba canais que não se encaixam em categorias padrão. Representa canais de comunicação alternativos ou especializados que podem ser específicos de uma determinada empresa ou indústria.
none
Essa preferência indica que o cliente não tem um canal de comunicação preferido.
unknown
Esta preferência significa que o canal de comunicação preferido do cliente não é conhecido ou não foi especificado. Isso pode ocorrer se o cliente não tiver fornecido consentimento explícito ou informações de preferência.

Esquema completo de Consentimentos e Preferências full-schema

Para exibir o esquema completo do tipo de dados Consentimentos e Preferências, consulte o repositório XDM oficial.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07