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.
- 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:
- Experience Data Model (XDM): a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM.
- Perfil do cliente em tempo real: consolida os dados do cliente de diferentes fontes em uma exibição completa e unificada, enquanto oferece uma conta acionável com carimbo de data e hora de cada interação com o cliente.
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"
}
}
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:
- Detalhes sobre consentimento e preferência
- IdentityMap (necessário se estiver usando o SDK móvel ou da Web da plataforma para enviar sinais de consentimento)
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.
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.
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.
Adicionar campos personalizados de consentimento e preferência ao esquema custom-consent
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.
É 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.