Dados do modelo em schemas

Nesta lição, você modelará os dados do Luma em schemas. Esta é uma das lições mais longas do tutorial, então pegue um copo de água e balde!

A padronização e a interoperabilidade são conceitos-chave por trás do Adobe Experience Platform. O Experience Data Model (XDM) é um esforço para padronizar os dados de experiência do cliente e definir esquemas para o gerenciamento da experiência do cliente.

O XDM é uma especificação publicamente documentada projetada para melhorar o poder das experiências digitais. Ele fornece estruturas e definições comuns para qualquer aplicativo usar para se comunicar com os serviços da plataforma. Ao seguir os padrões XDM, todos os dados de experiência do cliente podem ser incorporados a uma representação comum que pode fornecer insights de uma maneira mais rápida e integrada. Você pode obter informações valiosas das ações do cliente, definir públicos-alvo do cliente por meio de segmentos e expressar atributos do cliente para fins de personalização.

O XDM é a estrutura fundamental que permite ao Adobe Experience Cloud, viabilizado por Experience Platform, enviar a mensagem certa para a pessoa certa, no canal certo, no momento certo. A metodologia na qual o Experience Platform é construído, Sistema XDM O , o operacionaliza esquemas do Experience Data Model para serem usados pelos serviços da plataforma.

Arquitetos de dados precisará criar schemas fora deste tutorial, mas Engenheiros de dados trabalhará em conjunto com os esquemas criados pelo Arquiteto de dados.

Antes de começar os exercícios, assista a este breve vídeo para saber mais sobre schemas e o Experience Data Model (XDM):

DICA

Para aprofundar a modelagem de dados no Experience Platform, recomendamos seguir o curso Modelar seus dados de experiência do cliente com o XDM, disponível gratuitamente no Experience League!

Permissões necessárias

No Configurar permissões lição, configure todos os controles de acesso necessários para concluir esta lição.

Criar esquema de fidelidade por meio da interface do usuário

Neste exercício, criaremos um schema para os dados de fidelidade do Luma.

  1. Vá para a interface do usuário da Platform e verifique se a sandbox está selecionada.
  2. Ir para Esquemas na navegação à esquerda
  3. Selecione o Criar esquema no canto superior direito
  4. No menu suspenso , selecione Perfil individual XDM, já que faremos a modelagem de atributos de um cliente individual (pontos, status e assim por diante).
    Esquema com grupo de campos OOTB

Adicionar grupos de campos padrão

Em seguida, será solicitado que você adicione grupos de campos ao esquema. Todos os campos devem ser adicionados a esquemas usando grupos. É possível escolher entre um grande conjunto de grupos de campos padrão do setor fornecido pelo Adobe ou criar os seus próprios. Ao começar a modelar seus próprios dados no Experience Platform, é bom conhecer os grupos de campos padrão do setor fornecidos pelo Adobe. Sempre que possível, é uma prática recomendada usá-los, pois, às vezes, alimentam serviços de downstream, como a API do cliente, o Attribution AI e a Adobe Analytics.

Ao trabalhar com seus próprios dados, um grande passo será determinar qual de seus próprios dados deve ser capturado na Plataforma e como deve ser modelado. Este grande tópico é discutido com mais profundidade no curso Modelar seus dados de experiência do cliente com o XDM. Neste tutorial, eu só guiarei você pela implementação de alguns schemas predeterminados.

Para adicionar grupos de campos:

  1. No Adicionar grupos de campos modal, selecione os seguintes grupos de campos:

    1. Detalhes demográficos para dados básicos do cliente como nome e data de nascimento
    2. Detalhes de contato pessoal para detalhes básicos de contato como endereço de email e número de telefone
  2. É possível visualizar os campos que contribuíram no grupo de campos selecionando o ícone no lado direito da linha.
    Selecionar grupos de campos padrão

  3. Verifique a Setor > Varejo para expor grupos de campos específicos do setor.

  4. Selecionar Fidelidade para adicionar os campos do programa de fidelidade.

  5. Selecionar Adicionar grupo de campos para adicionar todos os três grupos de campos ao schema.
    Adicionar grupos de campos padrão ao esquema de fidelidade

Agora, use algum tempo para explorar o estado atual do schema. Os grupos de campos adicionaram campos padrão relacionados a uma pessoa, seus detalhes de contato e o status do programa de fidelidade. Esses dois grupos de campos podem ser úteis quando você cria esquemas para os dados de sua própria empresa. Selecione uma linha de grupo de campos específica ou marque a caixa ao lado do nome do grupo de campos para ver como a visualização muda.

Para salvar o schema:

  1. Selecione o nó superior do schema.
  2. Enter Luma Loyalty Schema como Nome de exibição.
  3. Selecione Salvar.
    Nomear e salvar o esquema
OBSERVAÇÃO

Não há problema se um grupo de campos adicionar um campo para um ponto de dados que você não coletar. Por exemplo, "faxPhone" pode ser um campo para o qual o Luma não coleta dados. Isso é bom. Apenas porque um campo é definido no schema não significa que os dados para ele must ser assimilado posteriormente.

Adicionar um grupo de campos personalizado

Agora vamos criar um grupo de campos personalizado.

Enquanto o grupo de campos de fidelidade continha um loyaltyID , o Luma gostaria de gerenciar todos os identificadores de sistema em um único grupo para ajudar a garantir a consistência em seus esquemas.

Os grupos de campos devem ser criados no workflow do schema. Para criar o grupo de campos:

  1. Selecionar Adicionar nos termos do Grupos de campos de esquema título
    Adicionar um novo grupo de campos

  2. Selecionar Criar novo grupo de campos

  3. Use Luma Identity profile field group como Nome de exibição

  4. Use system identifiers for XDM Individual Profile class como Descrição

  5. Selecionar Adicionar grupos de campos

    Adicionar um novo grupo de campos

O novo grupo de campos vazio é adicionado ao esquema. O + botões podem ser usados para adicionar novos campos a qualquer local na hierarquia. Em nosso caso, queremos adicionar campos no nível raiz:

  1. Selecionar + ao lado do nome do schema. Isso adiciona um novo campo no namespace da id do locatário para gerenciar conflitos entre os campos personalizados e quaisquer campos padrão.

  2. No Propriedades do campo barra lateral adicione os detalhes do novo campo:

    1. Nome do campo: systemIdentifier
    2. Nome de exibição: System Identifier
    3. Tipo: Objeto
    4. Selecionar Aplicar

    Adicionar um novo grupo de campos

Agora, adicione dois campos sob a variável systemIdentifier objeto:

  1. Primeiro campo
    1. Nome do campo: loyaltyId
    2. Nome de exibição: Loyalty Id
    3. Tipo: String
  2. Segundo campo
    1. Nome do campo: crmId
    2. Nome de exibição: CRM Id
    3. Tipo: String

O novo grupo de campos deve ter esta aparência. Selecione o Salvar para salvar o schema, mas deixe o schema aberto para o próximo exercício.
Grupo de campos de fidelidade concluído

Criar um tipo de dados

Grupos de campos, como o novo Luma Identity profile field group, podem ser reutilizadas em outros esquemas, permitindo que você imponha definições de dados padrão em vários sistemas. Mas só podem ser reutilizadas em esquemas que compartilham uma classe, nesse caso, a classe Perfil individual XDM.

O tipo de dados é outra construção de vários campos que pode ser reutilizada em schemas em várias classes. Vamos converter nosso novo systemIdentifier em um tipo de dados:

Com o Luma Loyalty Schema ainda aberto, selecione a systemIdentifier e selecione Converter em novo tipo de dados

Grupo de campos de fidelidade concluído

Se você Cancelar do esquema e navegue até a variável Tipos de dados , você verá seu tipo de dados recém-criado. Usaremos esse tipo de dados posteriormente na lição.

Grupo de campos de fidelidade concluído

Criar esquema CRM por meio da API

Agora criaremos um schema usando a API .

DICA

Se preferir ignorar o exercício da API, é possível criar o seguinte schema usando o método da interface do usuário:

  1. Use o Perfil individual XDM classe
  2. Nomeie-o Luma CRM Schema
  3. Use os seguintes grupos de campos: Detalhes demográficos, Detalhes de contato pessoal e grupo de campos de perfil de identidade Luma

Primeiro criamos o schema vazio:

  1. Abrir Postman

  2. Se você não tiver feito uma solicitação nas últimas 24 horas, seus tokens de autorização provavelmente expiraram. Abrir a solicitação Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token e selecione Enviar para solicitar novos tokens de acesso e JWT.

  3. Abra as variáveis de ambiente e altere o valor de CONTAINER_ID from global para tenant. Lembre-se, você deve usar tenant sempre que quiser interagir com seus próprios elementos personalizados no Platform, como criar um schema.

  4. Selecione Salvar
    Alterar CONTAINER_ID para locatário

  5. Abrir a solicitação Schema Registry API > Schemas > Create a new custom schema.

  6. Abra o Corpo e cole o seguinte código e selecione Enviar para fazer a chamada da API . Essa chamada cria um novo schema usando o mesmo XDM Individual Profile classe base:

    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    OBSERVAÇÃO

    As referências de namespace neste e nas amostras de código subsequentes (por exemplo, https://ns.adobe.com/xdm/context/profile), pode ser obtida usando a opção listar chamadas de API com o CONTAINER_ID e aceitar o cabeçalho definido para os valores corretos. Alguns também são facilmente acessíveis na interface do usuário do .

  7. Você deveria pegar um 201 Created response

  8. Copiar meta:altId do corpo da Resposta. Usá-lo-emos mais tarde noutro exercício.
    Criar o esquema CRM

  9. O novo schema deve estar visível na interface do usuário, mas sem nenhum grupo de campos
    Criar o esquema CRM

OBSERVAÇÃO

O meta:altId ou a id do schema também pode ser obtida fazendo a solicitação da API Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. com o CONTAINER_ID defina como tenant e um cabeçalho accept application/vnd.adobe.xdm+json.

DICA

Problemas comuns com esta chamada e possíveis correções:

  • Nenhum token de autenticação: Execute o IMS: JWT Generate + Auth via Token de usuário chamada para gerar novos tokens
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Atualize o CONTAINER_ID variável de ambiente de global para tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control: Verifique as permissões do usuário no Admin Console

Adicionar grupos de campos padrão

Agora é hora de adicionar os grupos de campos ao schema:

  1. Em Postman, Abra a solicitação Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. No Params cole a guia meta:altId da resposta anterior como SCHEMA_ID

  3. Abra a guia Corpo , cole o seguinte código e selecione Enviar para fazer a chamada da API . Essa chamada adiciona os grupos de campos padrão ao seu Luma CRM Schema:

    [{
        "op": "add",
        "path": "/allOf/-",
        "value": {
          "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
        }
      },
      {
        "op": "add",
        "path": "/allOf/-",
        "value": {
          "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
        }
      }
    ]
    
  4. Você deve obter um status 200 OK para a resposta e os grupos de campos devem estar visíveis como parte do esquema na interface do usuário

    Adição de grupos de campos padrão

Adicionar grupo de campos personalizado

Agora vamos adicionar nosso Luma Identity profile field group ao schema. Primeiro, precisamos localizar a id do novo grupo de campos, usando uma API de lista:

  1. Abrir a solicitação Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Selecione o Enviar botão para recuperar uma lista de todos os grupos de campos personalizados em sua conta

  3. Pegue o $id do Luma Identity profile field group (o seu será diferente do valor desta captura de tela)
    Recuperar a lista de grupos de campos

  4. Abrir a solicitação Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. again

  5. O Params A guia ainda deve ter a variável $id do esquema

  6. Abra o Corpo e cole o seguinte código, substituindo o $ref com o valor $id do seu Luma Identity profile field group:

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
      }
    }]
    
  7. Selecionar Enviar

    Adicionar o grupo Campo de identidade

Verifique se o grupo de campos foi adicionado ao schema verificando a resposta da API e na interface.

Criar Esquema de Eventos de Compra Offline

Agora vamos criar um schema baseado no ExperiênciaEvento XDM classe para os dados de compra offline do Luma. Como você está se familiarizando com a interface do usuário do editor de esquema, reduzirei o número de capturas de tela nas instruções:

  1. Crie um esquema com a ExperiênciaEvento XDM classe
  2. Adicionar o grupo de campos padrão Detalhes de comércio para capturar detalhes comuns do pedido. Gaste alguns minutos explorando os objetos dentro.
  3. Procurar por Luma Identity profile field group. Não está disponível! Lembre-se de que os grupos de campos estão vinculados a uma classe e, como estamos usando uma classe diferente para esse schema, não podemos usá-lo. Precisamos adicionar um novo grupo de campos para a classe XDM ExperienceEvent contendo os campos de identidade. Nosso tipo de dados facilitará muito isso!
  4. Selecione o Criar novo grupo de campos botão de opção
  5. Insira o Nome de exibição as Luma Identity ExperienceEvent field group e selecione o Adicionar grupos de campos botão
  6. Certifique-se de que o + os botões aparecem no Estrutura para que você possa adicionar novos campos
  7. Em Estrutura seção , selecione + no nível superior do esquema
  8. Como Nome do campo, insira systemIdentifier
  9. Como Nome de exibição, insira System Identifier
  10. Como Tipo, selecione Identificador do sistema que é o tipo de dados personalizado criado anteriormente
  11. Selecione o Aplicar botão
  12. Dê um nome ao esquema Luma Offline Purchase Events Schema
  13. Selecione o Salvar botão

Observe como o tipo de dados adicionou todos os campos!

Adicionar o tipo de dados ao grupo de campos

Além disso, selecione ExperiênciaEvento XDM nos termos do Classe e inspecione alguns dos campos contribuídos por esta classe. Observe que os campos _id e timestamp são necessários ao usar a classe XDM ExperienceEvent — esses campos devem ser preenchidos para cada registro que você assimilar ao usar este esquema:

Estrutura base do evento de experiência

Criar esquema de eventos da Web

Agora vamos criar mais um schema para os dados do site do Luma. Por este ponto, você deve ser um especialista em criar schemas! Crie o seguinte schema com essas propriedades

Propriedade Valor
Classe ExperiênciaEvento XDM
Grupo de campos Mistura AEP Web SDK ExperienceEvent
Grupo de campos Evento de experiência do consumidor
Nome do esquema Esquema de eventos da Web Luma

Selecione o Evento de experiência do consumidor grupo de campos. Este grupo de campos contém os objetos commerce e productListItems que também estavam em Detalhes de comércio. De fato Evento de experiência do consumidor é uma combinação de vários outros grupos de campos padrão que também estão disponíveis separadamente. Mistura AEP Web SDK ExperienceEvent grupo de campos também contém outros grupos de campos, incluindo alguns dos mesmos em Evento de experiência do consumidor. Felizmente, eles se misturam perfeitamente.

Observe que não adicionamos a variável Luma Identity ExperienceEvent field group para este schema. Isso ocorre porque o SDK da Web tem uma maneira diferente de coletar identidades. Se você selecionar a variável ExperiênciaEvento XDM na Composição do editor de esquema, você observará que um dos campos adicionados por padrão é chamado IdentityMap. IdentityMap é usada por vários aplicativos Adobe para vincular à Platform. Você verá como as identidades são enviadas para a plataforma pelo identityMap na lição de assimilação de streaming.

Criar esquema de catálogo de produtos

Ao usar a variável Detalhes de comércio e Evento de experiência do consumidor grupos de campos, o Luma relata alguns detalhes de eventos relacionados ao produto por meio do tipo de dados productListItems padrão. Mas também têm campos de detalhes adicionais do produto que desejam enviar para a Platform. Em vez de capturar todos esses campos em seus sistemas de ponto de venda e comércio eletrônico, a Luma preferiria assimilar esses campos diretamente de seu sistema de catálogo de produtos. Uma "relação de schema" permite definir uma relação entre dois schemas para fins de classificação ou pesquisas. O Luma usará uma relação para classificar os detalhes do produto. Começaremos o processo agora e o concluiremos no final da próxima lição.

OBSERVAÇÃO

Se você for um cliente existente do Analytics ou do Target, a classificação de entidades com relações de esquema é semelhante às classificações de SAINT ou ao upload do catálogo de produtos para o Recommendations

Primeiro, devemos criar um schema para o catálogo de produtos do Luma usando uma classe personalizada:

  1. Selecione o Criar esquema e selecione o Procurar na lista suspensa
    Criar novo esquema
  2. Selecione o Criar nova classe botão de opção
  3. Nomeie-o Luma Product Catalog Class
  4. Deixe o Comportamento as Registro
  5. Selecione o Atribuir classe botão
    Criar nova classe
  6. Crie um novo grupo de campos chamado Luma Product Catalog field group com os seguintes campos:
    1. productName: Nome do produto: String
    2. productCategory: Categoria do produto: String
    3. productColor: Cor do produto: String
    4. productSku: SKU do produto: String | Obrigatório
    5. productSize: Tamanho do produto: String
    6. productPrice: Preço do produto: Duplo
  7. Nomeie o schema Luma Product Catalog Schema (certifique-se de atualizar o campo correto e não atualizar o nome da classe)
  8. Salvar o schema

O novo schema deve ser semelhante a este. Observe como a função productSku é listado na variável Campos obrigatórios seção:
Esquema do produto

A próxima etapa é definir a relação entre os dois esquemas ExperienceEvent e o Luma Product Catalog SchemaContudo, há alguns passos adicionais que temos de dar na próxima lição antes de o podermos fazer.

Recursos adicionais

Agora que você tem seus esquemas, é possível mapear identidades!

Nesta página