Configurar um conjunto de dados para capturar dados de consentimento e preferência

Para que o Adobe Experience Platform processe os dados de consentimento/preferência do cliente, esses dados devem ser enviados para um conjunto de dados cujo esquema contém campos relacionados a consentimentos e outras permissões. Especificamente, esse conjunto de dados deve ser baseado na classe XDM Individual Profile e habilitado para uso em Real-Time Customer Profile.

Este documento fornece etapas para configurar um conjunto de dados para processar dados de consentimento no Experience Platform. Para obter uma visão geral do fluxo de trabalho completo para processar dados de consentimento/preferência na Platform, consulte a visão geral do processamento de consentimento.

IMPORTANT
Os exemplos neste guia usam um conjunto padronizado de campos para representar os valores de consentimento do cliente, conforme definido pelo Grupo de campos de esquema de Detalhes de Consentimento e Preferência. A estrutura desses campos tem como objetivo fornecer um modelo de dados eficiente para abranger muitos casos de uso comuns de coleta de consentimento.
No entanto, você também pode definir seus próprios grupos de campos para representar o consentimento de acordo com seus próprios modelos de dados. Consulte sua equipe jurídica para obter aprovação para um modelo de dados de consentimento que atenda às suas necessidades comerciais, com base nas seguintes opções:
  • O grupo de campos de consentimento padronizado
  • Um grupo de campos de consentimento personalizado criado pela sua organização
  • Uma combinação do grupo de campos de consentimento padronizado e campos adicionais fornecidos por um grupo de campos de consentimento personalizado

Pré-requisitos

Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:

IMPORTANT
Este tutorial presume que você conhece o esquema Profile na Platform que deseja usar para capturar informações de atributos do cliente. Independentemente do método usado para coletar dados de consentimento, esse esquema deve ser habilitado para o Perfil de Cliente em Tempo Real. Além disso, a identidade primária do schema não pode ser um campo diretamente identificável que esteja proibido de usar em anúncios baseados em interesses, como um endereço de email. Consulte seu advogado se não tiver certeza de quais campos são restritos.

Estrutura do grupo de campos Detalhes sobre consentimento e preferência structure

O grupo de campos Detalhes sobre Consentimento e Preferência fornece campos de consentimento padronizados para um esquema. Atualmente, este grupo de campos é compatível apenas com esquemas baseados na classe XDM Individual Profile.

O grupo de campos fornece um único campo de tipo de objeto, consents, cujas subpropriedades capturam um conjunto de campos de consentimento padronizados. O JSON a seguir é um exemplo do tipo de dados que consents espera na assimilação de dados:

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  },
  "metadata": {
    "time": "2019-01-01T15:52:25+00:00"
  }
}
NOTE
Para obter mais informações sobre a estrutura e o significado das subpropriedades em consents, consulte a visão geral no grupo de campos Detalhes sobre consentimento e preferência.

Adicionar grupos de campos obrigatórios ao esquema Profile add-field-group

Para coletar dados de consentimento usando o padrão Adobe, é necessário ter um esquema habilitado para Perfil que contenha os dois grupos de campos a seguir:

Na interface do usuário da Platform, selecione Esquemas na navegação à esquerda e selecione a guia Procurar para exibir uma lista de esquemas existentes. Aqui, selecione o nome do esquema habilitado para Profile ao qual você deseja adicionar campos de consentimento. As capturas de tela nesta seção usam o esquema "Membros de Fidelidade" criado no tutorial de criação de esquema, como exemplo.

TIP
Você pode usar os recursos de pesquisa e filtragem do espaço de trabalho para ajudar a encontrar seu esquema com mais facilidade. Consulte o guia em explorando recursos XDM para obter mais informações.

A Schema Editor é exibida, mostrando a estrutura do esquema na tela. No lado esquerdo da tela, selecione Adicionar na seção Grupos de campos.

A caixa de diálogo Adicionar grupo de campos é exibida. Aqui, selecione Detalhes de consentimento e preferência na lista. Opcionalmente, é possível usar a barra de pesquisa para restringir os resultados e localizar o grupo de campos com mais facilidade.

Em seguida, localize o grupo de campos IdentityMap na lista e selecione-o também. Depois que ambos os grupos de campos forem listados no painel direito, selecione Adicionar grupos de campos.

A tela será exibida novamente, mostrando que os campos consents e identityMap foram adicionados à estrutura do esquema. Se você precisar de campos de consentimento e preferência adicionais não capturados pelo grupo de campos padrão, consulte a seção do apêndice sobre adição de campos de consentimento e preferência personalizados ao esquema. Caso contrário, selecione Salvar para finalizar as alterações no esquema.

IMPORTANT
Se você estiver criando um novo esquema ou editando um esquema existente que não foi habilitado para o Perfil, deverá habilitar o esquema para o Perfil antes de salvar.

Se o esquema editado for usado pelo Conjunto de dados do perfil especificado na sequência de dados do SDK da Web da plataforma, esse conjunto de dados incluirá os novos campos de consentimento. Agora você pode retornar ao guia de processamento de consentimento para continuar o processo de configuração do Experience Platform para processar dados de consentimento. Se você não tiver criado um conjunto de dados para esse esquema, siga as etapas na próxima seção.

Criar um conjunto de dados com base no seu esquema de consentimento dataset

Depois de criar um esquema com campos de consentimento, você deve criar um conjunto de dados que assimilará os dados de consentimento dos clientes. Este conjunto de dados deve ser habilitado para Real-Time Customer Profile.

Para começar, selecione Conjuntos de dados na navegação à esquerda e selecione Criar conjunto de dados no canto superior direito.

Na próxima página, selecione Criar conjunto de dados do esquema.

O fluxo de trabalho Criar conjunto de dados a partir do esquema aparece, começando na etapa Selecionar esquema. Na lista fornecida, localize um dos esquemas de consentimento criados anteriormente. Opcionalmente, é possível usar a barra de pesquisa para restringir os resultados e localizar seu esquema com mais facilidade. Selecione o botão de opção ao lado do esquema desejado e selecione Avançar para continuar.

A etapa Configurar conjunto de dados é exibida. Forneça um nome e uma descrição exclusivos e de fácil identificação para o conjunto de dados antes de selecionar Concluir.

A página de detalhes do conjunto de dados recém-criado é exibida. Se o conjunto de dados for baseado no esquema de série temporal, o processo será concluído. Se o conjunto de dados for baseado no esquema do seu registro, a etapa final no processo será habilitar o conjunto de dados para uso no Real-Time Customer Profile.

No painel direito, selecione a opção de alternância Perfil.

Finalmente, selecione Habilitar no popover de confirmação para habilitar o esquema para Profile.

O conjunto de dados foi salvo e habilitado para uso em Profile. Se você estiver planejando usar o SDK da Web da Platform para enviar dados de consentimento para o Perfil, selecione esse conjunto de dados como o Conjunto de dados do perfil ao configurar sua sequência de dados.

Próximas etapas

Ao seguir este tutorial, você adicionou campos de consentimento a um esquema habilitado para Profile, cujo conjunto de dados será usado para assimilar dados de consentimento usando o SDK da Web da plataforma ou assimilação XDM direta.

Agora você pode retornar à visão geral do processamento de consentimento para continuar configurando o Experience Platform para processar dados de consentimento.

Apêndice

A seção a seguir contém informações adicionais sobre a criação de um conjunto de dados para assimilar dados de consentimento e preferência do cliente.

Se você precisar capturar sinais de consentimento adicionais além daqueles representados pelo grupo de campos Detalhes de consentimento e preferência padrão, poderá usar componentes XDM personalizados para aprimorar seu esquema de consentimento para atender às suas necessidades comerciais específicas. Esta seção descreve os princípios básicos de como personalizar o esquema de consentimento para assimilar esses sinais no Perfil.

IMPORTANT
Os SDKs da Web e móvel da Platform não são compatíveis com campos personalizados em seus comandos de alteração de consentimento. Atualmente, a única maneira de assimilar campos de consentimento personalizados no Perfil é por meio de assimilação em lote ou uma conexão de origem.

É altamente recomendável usar o grupo de campos Detalhes sobre consentimento e preferência como uma linha de base para a estrutura dos dados de consentimento e adicionar outros campos conforme necessário, em vez de tentar criar toda a estrutura do zero.

Para adicionar campos personalizados à estrutura de um grupo de campos padrão, primeiro crie um grupo de campos personalizado. Depois de adicionar o grupo de campos Detalhes de consentimento e preferência ao esquema, selecione o ícone de adição (+) na seção Grupos de campos e selecione Criar novo grupo de campos. Forneça um nome e uma descrição opcional para o grupo de campos e selecione Adicionar grupo de campos.

O Schema Editor reaparece com o novo grupo de campos personalizado selecionado no painel esquerdo. Na tela, são exibidos controles que permitem adicionar campos personalizados à estrutura do esquema. Para adicionar um novo campo de consentimento ou preferência, selecione o ícone de adição (+) ao lado do objeto consents.

Um novo campo aparece dentro do objeto consents. Como você está adicionando um campo personalizado a um objeto XDM padrão, o novo campo é criado em um objeto com namespace para sua ID de locatário.

No painel direito, em Propriedades do campo, forneça um nome e uma descrição para o campo. Ao selecionar o Tipo do campo, você deve usar o tipo de dados padrão apropriado para um consentimento personalizado ou campo de preferência:

Quando terminar, selecione Aplicar.

O campo de consentimento ou preferência é adicionado à estrutura do esquema. Observe que o Caminho exibido no painel direito contém o namespace _tenantId. Esse namespace deve ser incluído sempre que você fizer referência ao caminho para esse campo em suas operações de dados.

Siga as etapas acima para continuar adicionando os campos de consentimento e preferência necessários. Quando terminar, selecione Salvar para confirmar as alterações.

Se você não criou um conjunto de dados para este esquema, continue para a seção sobre criação de um conjunto de dados.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5