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

Para que o Adobe Experience Platform processe seus dados de consentimento/preferência do cliente, esses dados devem ser enviados para um conjunto de dados cujo esquema contenha 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 no Platform, consulte a visão geral do processamento de consentimento.

IMPORTANTE

Os exemplos neste guia usam um conjunto padronizado de campos para representar valores de consentimento do cliente, conforme definido pelo grupo de campos Consent and Preference Details do consentimento. 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, também é possível 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 de 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 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:

  • Modelo de dados de experiência (XDM): A estrutura padronizada pela qual Experience Platform organiza os dados de experiência do cliente.
  • Perfil do cliente em tempo real: Consolida dados de clientes de fontes diferentes em uma visualização completa e unificada, oferecendo uma conta acionável e com carimbos de data e hora de cada interação com o cliente.
IMPORTANTE

Este tutorial pressupõe que você saiba o schema Profile na Plataforma que deseja usar para capturar informações de atributos do cliente. Independentemente do método usado para coletar dados de consentimento, esse schema deve estar ativado para o Perfil do cliente em tempo real. Além disso, a identidade primária do esquema não pode ser um campo diretamente identificável que é proibido de usar em publicidade com base em interesses, como um endereço de email. Consulte seu consultor jurídico se não tiver certeza de quais campos são restritos.

Estrutura do grupo de detalhes de campo de consentimento e preferência

O grupo de campos Consentimento e Detalhes de Preferência fornece campos de consentimento padronizados para um esquema. No momento, esse grupo de campos é compatível apenas com schemas com base na classe XDM Individual Profile.

O grupo de campos fornece um único campo do 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 ao assimilar 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"
  }
}
OBSERVAÇÃO

Para obter mais informações sobre a estrutura e o significado das subpropriedades em consents, consulte a visão geral no grupo de campos Consentimento e Detalhes de preferência.

Adicionar grupos de campos obrigatórios ao esquema Profile

Para coletar dados de consentimento usando o padrão do Adobe, você deve ter um schema ativado para perfil que contenha os dois grupos de campos a seguir:

  • Detalhes de consentimento e preferência
  • IdentityMap (obrigatório se estiver usando a Web da plataforma ou o SDK móvel para enviar sinais de consentimento)

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

DICA

Você pode usar os recursos de pesquisa e filtragem do espaço de trabalho para ajudar a encontrar o esquema mais fácil. Consulte o guia sobre exploração de recursos XDM para obter mais informações.

O Schema Editor é exibido, mostrando a estrutura do schema na tela. No lado esquerdo da tela, selecione Add na seção Field groups.

A caixa de diálogo Adicionar grupo de campos é exibida. Aqui, selecione Consentimento e Detalhes de Preferência na lista. Como opção, você pode usar a barra de pesquisa para restringir os resultados para localizar o grupo de campos mais facilmente.

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

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

IMPORTANTE

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

Se o esquema editado for usado pelo Conjunto de dados de perfil especificado no conjunto de dados do SDK da Web da plataforma, esse conjunto de dados agora 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 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 esquema de consentimento

Depois de criar um schema com campos de consentimento, você deve criar um conjunto de dados que, em última análise, assimilará os dados de consentimento dos clientes. Este conjunto de dados deve ser ativado para Real-time Customer Profile.

Para começar, selecione Datasets 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 schema.

O workflow Criar conjunto de dados a partir do schema é exibido, começando na etapa Selecionar schema. Na lista fornecida, localize um dos esquemas de consentimento criados anteriormente. Como opção, você pode usar a barra de pesquisa para restringir os resultados e localizar o esquema mais fácil. Selecione o botão de opção ao lado do schema desejado e selecione Next para continuar.

A etapa Configurar conjunto de dados é exibida. Forneça um nome e uma descrição exclusivos e facilmente identificáveis para o conjunto de dados antes de selecionar Finish.

A página de detalhes do conjunto de dados recém-criado é exibida. Se o conjunto de dados se basear no esquema da série de tempo, o processo será concluído. Se o conjunto de dados se baseia no esquema de registro, a etapa final no processo é habilitar o conjunto de dados para uso em Real-time Customer Profile.

No painel direito, selecione a opção Profile.

Finalmente, selecione Enable no provedor de confirmação para habilitar o schema para Profile.

O conjunto de dados agora é salvo e ativado para uso em Profile. Se você estiver planejando usar o SDK da Web da plataforma para enviar dados de consentimento ao Perfil, deverá selecionar esse conjunto de dados como o Conjunto de dados do perfil ao configurar seu datastream.

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 a assimilação direta do XDM.

Agora você pode retornar para a 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 como criar um conjunto de dados para assimilar dados de consentimento e preferência do cliente.

Se você precisar capturar sinais de consentimento adicionais fora daqueles representados pelo grupo de campos padrão Consent and Preference Details, poderá usar componentes XDM personalizados para aprimorar seu esquema de consentimento para atender às necessidades específicas de negócios. Esta seção descreve os princípios básicos de como personalizar o esquema de consentimento para assimilar esses sinais no Perfil.

IMPORTANTE

Os SDKs da Web da plataforma e móvel não oferecem suporte a 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 conexão de origem.

É altamente recomendável usar o grupo de campos Consentimento e Detalhes de Preferência como uma linha de base para a estrutura de seus dados de consentimento e adicionar campos adicionais 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 Consentimento e Detalhes de Preferência ao schema, selecione o ícone mais (+) 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 é exibido novamente com o novo grupo de campos personalizados selecionado no painel à esquerda. Na tela, são exibidos controles que permitem adicionar campos personalizados à estrutura do esquema. Para adicionar um novo consentimento ou campo de preferência, selecione o ícone de adição (+)ao lado do objeto consents.

Um novo campo é exibido 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 namespaco para a ID do locatário.

No painel direito em Field properties, 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 schema. 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 Save para confirmar as alterações.

Se você não tiver criado um conjunto de dados para esse esquema, continue para a seção em criar um conjunto de dados.

Nesta página