Dados de modelo em esquemas

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

A padronização e a interoperabilidade são os principais conceitos por trás da 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 documentada publicamente projetada para melhorar o potencial das experiências digitais. Ela fornece estruturas e definições comuns para qualquer aplicativo usar na comunicação com os serviços da plataforma. Seguindo 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 maneira mais rápida e integrada. Você pode obter insights valiosos 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, acionado pelo Experience Platform, enviar a mensagem certa à pessoa certa, no canal direito, no momento exato. A metodologia em que o Experience Platform é construído, Sistema XDM O, operacionaliza esquemas do Experience Data Model para uso pelos serviços da plataforma.

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

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

TIP
Para aprofundar a modelagem de dados no Experience Platform, recomendamos fazer 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 você configura todos os controles de acesso necessários para concluir esta lição.

Criar esquema de fidelidade por meio da interface

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

  1. Vá para a interface do usuário da Platform e verifique se sua sandbox está selecionada.
  2. Ir para Esquemas na navegação à esquerda
  3. Clique no botão Criar esquema no canto superior direito
  4. No menu suspenso, selecione Perfil individual XDM, já que modelaremos 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 que usam grupos. Você pode escolher entre um grande conjunto de grupos de campo padrão do setor fornecidos pelo Adobe ou criar os seus próprios. À medida que você começa a modelar seus próprios dados no Experience Platform, é bom se familiarizar com os grupos de campo padrão do setor fornecidos pelo Adobe. Sempre que possível, é uma prática recomendada usá-los, pois eles às vezes alimentam serviços downstream, como IA do cliente, Attribution AI e Adobe Analytics.

Ao trabalhar com seus próprios dados, um grande passo será determinar quais de seus próprios dados devem ser capturados na Platform e como eles devem ser modelados. Esse grande tópico é discutido com mais detalhes no curso Modelar seus dados de experiência do cliente com o XDM. Neste tutorial, eu vou apenas guiá-lo pela implementação de alguns esquemas predeterminados.

Para adicionar grupos de campos:

  1. No Adicionar grupos de campos , 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 obter detalhes básicos de contato, como endereço de email e número de telefone
  2. Você pode visualizar os campos de contribuição 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. Selecione Adicionar grupo de campos para adicionar todos os três grupos de campos ao esquema.
    Adicionar grupos de campos padrão ao esquema de fidelidade

Agora reserve um tempo para explorar o estado atual do esquema. Os grupos de campos adicionaram campos padrão relacionados a uma pessoa, seus detalhes de contato e status do programa de fidelidade. Esses dois grupos de campos podem ser úteis ao criar esquemas para os dados da 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 é alterada.

Para salvar o esquema:

  1. Selecione o nó superior do esquema.
  2. Enter Luma Loyalty Schema como o Nome de exibição.
  3. Selecione Salvar.
    Nomeie e salve o esquema
NOTE
Não há problema se um grupo de campos adicionar um campo para um ponto de dados que você não coleta. Por exemplo, "faxPhone" pode ser um campo para o qual a Luma não coleta dados. Tudo bem. O fato de um campo estar definido no esquema não significa que os dados dele deve ser assimilado posteriormente.

Adicionar um grupo de campos personalizado

Agora vamos criar um grupo de campos personalizado.

Embora o grupo de campos de fidelidade contivesse uma loyaltyID A Luma gostaria de gerenciar todos os identificadores do sistema em um único grupo para ajudar a garantir a consistência em seus esquemas.

Os grupos de campos devem ser criados no fluxo de trabalho de esquema. Para criar o grupo de campos:

  1. Selecionar Adicionar no Grupos de campos de esquema cabeçalho
    Adicionar um novo grupo de campos
  2. Selecione Criar novo grupo de campos
  3. Uso Luma Identity profile field group como o Nome de exibição
  4. Uso system identifiers for XDM Individual Profile class como o Descrição
  5. Selecione Adicionar grupos de campos
    Adicionar um novo grupo de campos

O novo grupo de campos vazio é adicionado ao esquema. A variável + 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. Selecione + ao lado do nome do esquema. Isso adiciona um novo campo no namespace de id do locatário para gerenciar conflitos entre os campos personalizados e quaisquer campos padrão.

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

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

    Adicionar um novo grupo de campos

Agora adicione dois campos sob 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

Seu novo grupo de campos deve ter esta aparência. Selecione o Salvar botão para salvar seu esquema, mas deixe o esquema 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 reutilizados em outros esquemas, permitindo que você aplique definições de dados padrão em vários sistemas. Mas elas 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 esquemas em várias classes. Vamos converter o nosso novo systemIdentifier em um tipo de dados:

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

Grupo de campos de fidelidade Concluído

Se você Cancelar fora do esquema e navegue até o 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 do CRM por meio da API

Agora criaremos um esquema usando a API.

TIP
Se preferir ignorar o exercício de API, você poderá criar o seguinte schema usando o método de interface do usuário:
  1. Use o Perfil individual XDM classe
  2. Nomeie-a como 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 da Luma

Primeiro, criamos o schema vazio:

  1. Abrir Postman

  2. Se você não tiver um token de acesso, abra a solicitação OAuth: Request Access Token e selecione Enviar para solicitar um novo token de acesso.

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

  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 código a seguir e selecione Enviar para fazer a chamada de API. Esta chamada cria um novo esquema usando a mesma XDM Individual Profile classe base:

    code language-json
    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    note note
    NOTE
    O namespace faz referência a esta e às amostras de código subsequentes (por exemplo, https://ns.adobe.com/xdm/context/profile), pode ser obtido usando chamadas de API de lista com o CONTAINER_ID e aceite o cabeçalho definido com os valores corretos. Alguns também são facilmente acessíveis na interface do usuário.
  7. Você deve obter um 201 Created resposta

  8. Copiar meta:altId do Corpo de resposta. Usaremos depois em outro exercício.
    Criar o esquema do CRM

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

NOTE
A variável meta:altId ou a id do esquema 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 definir como tenant e um cabeçalho accept application/vnd.adobe.xdm+json.
TIP
Problemas comuns com esta chamada e prováveis correções:
  • Sem token de autenticação: execute o OAuth: solicitar token de acesso solicitação para gerar um novo token
  • 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 suas permissões de usuário no Admin Console

Adicionar grupos de campos padrão

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

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

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

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

    code language-json
    [{
        "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

    Grupos de campos padrão adicionados

Adicionar grupo de campos personalizado

Agora, vamos adicionar nossa Luma Identity profile field group ao esquema. Primeiro, precisamos encontrar 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 valor de Luma Identity profile field group (o seu será diferente do valor nesta 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. novamente

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

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

    code language-json
    [{
      "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 esquema verificando a resposta da API e na interface.

Criar esquema de eventos de compra offline

Agora vamos criar um esquema com base na variável XDM ExperienceEvent classe para dados de compra offline do Luma. Como você agora está se familiarizando com a interface do usuário do editor de esquemas, reduzirei o número de capturas de tela nas instruções:

  1. Crie um esquema com o XDM ExperienceEvent classe
  2. Adicionar o grupo de campos padrão Detalhes do comércio para capturar detalhes comuns da ordem. Passe alguns minutos explorando os objetos internos.
  3. Pesquisar 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 este esquema, não podemos usá-lo. Precisamos adicionar um novo grupo de campos para a classe XDM ExperienceEvent que contém os campos de identidade. Nosso tipo de dados tornará isso realmente fácil!
  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. Verifique se + botões são exibidos em no Estrutura para adicionar novos campos
  7. Entrada Estrutura , selecione + no nível superior do esquema
  8. Como a variável Nome do campo, insira systemIdentifier
  9. Como a variável Nome de exibição, insira System Identifier
  10. Como a variável Tipo, selecione Identificador do sistema que é o tipo de dados personalizado que você criou anteriormente
  11. Selecione o Aplicar botão
  12. Dê um nome ao esquema Luma Offline Purchase Events Schema
  13. Selecione o botão Salvar

Observe como o tipo de dados adicionou todos os campos.

Adicionar o tipo de dados ao grupo de campos

Além disso, XDM ExperienceEvent no Classe e inspecione alguns dos campos contribuídos por essa classe. Observe que os campos _id e carimbo de data e hora são necessários ao usar a classe XDM ExperienceEvent — esses campos devem ser preenchidos para cada registro assimilado ao usar esse esquema:

Estrutura básica do evento de experiência

Criar esquema de eventos da Web

Agora vamos criar mais um schema para os dados do site do Luma. Até agora, você deve ser um especialista na criação de esquemas! Crie o seguinte esquema com essas propriedades

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

Selecione o Evento de experiência do consumidor grupo de campos. Este grupo de campos contém os objetos de comércio e productListItems que também estavam Detalhes do comércio. Realmente 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. Mixin ExperienceEvent do SDK da Web da AEP 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 o Luma Identity ExperienceEvent field group para este esquema. Isso ocorre porque o SDK da Web tem uma maneira diferente de coletar identidades. Se você selecionar a variável XDM ExperienceEvent na classe Composição do editor de esquemas, você observará que um dos campos que ele adiciona por padrão é chamado de IdentityMap. IdentityMap é usado por vários aplicativos Adobe para vincular à Platform. Você verá como as identidades são enviadas para a Platform via identityMap na lição de assimilação de streaming.

Criar esquema do catálogo de produtos

Ao usar o Detalhes do 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 padrão productListItems. Mas eles também têm campos adicionais de detalhes do produto que gostariam de 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 do sistema de catálogo de produtos. Uma "relação de esquema" permite definir uma relação entre dois esquemas para fins de classificação ou pesquisas. A Luma usará um relacionamento para classificar os detalhes do produto. Começaremos o processo agora e o concluiremos no final da próxima lição.

NOTE
Se você for um cliente existente do Analytics ou do Target, classificar entidades com relacionamentos de esquema é análogo às classificações de SAINT ou fazer upload do catálogo de produtos para o Recommendations

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

  1. Selecione o Criar esquema e selecione o botão Procurar opção na lista suspensa
    Criar novo esquema

  2. Selecione o Criar nova classe botão de opção

  3. Nomeie-a como Luma Product Catalog Class

  4. Deixe a Comportamento as Gravar

  5. Selecione o Atribuir classe botão
    Criar nova classe

  6. Criar 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: Cadeia de caracteres | Obrigatório
    5. productSize: Product Size: String
    6. productPrice: Preço do produto: Duplo
  7. Nomeie o esquema 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 esquema deve ter esta aparência. Observe como productSku está listado no campo 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 SchemaNo entanto, há alguns passos adicionais que devemos dar na próxima lição antes de podermos fazer isso.

Recursos adicionais

Agora que tem seus esquemas, você pode mapear identidades!

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad