DocumentaçãoExperience PlatformDados de modelo em esquemas

Dados de modelo em esquemas

Last update: Thu May 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Beginner
  • Intermediate
  • Developer

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):

https://video.tv.adobe.com/v/38512?learn=on&captions=por_br

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 no painel de navegação esquerdo.

  3. Selecione o Criar esquema no canto superior direito.
    Esquema com grupo de campos OOTB

  4. No workflow Criar esquema, selecione Perfil individual como a classe base do esquema, já que modelaremos atributos de um cliente individual (pontos, status e assim por diante).

  5. Selecionar Próxima.
    Selecionar classe base

  6. Enter Luma Loyalty Schema no Nome de exibição do esquema campo de texto. Na tela abaixo, você também pode revisar e verificar a estrutura do esquema base fornecida pela classe escolhida.

  7. Selecionar Concluir para criar seu esquema.
    Concluir a criação do esquema de fidelidade

Adicionar grupos de campos padrão

Depois que o esquema for criado, você será redirecionado para o Editor de esquema, onde poderá adicionar campos ao esquema. Você pode adicionar campos individuais diretamente ao esquema ou usar grupos de campos. É importante observar que todos os campos individuais ainda estão associados a uma classe ou grupo de campos. 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, uma etapa significativa será determinar quais dos 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 guiá-lo pela implementação de alguns esquemas predeterminados.

Para adicionar grupos de campos:

  1. Selecionar Adicionar no Grupos de campos cabeçalho.
    Adicionar um novo grupo de campos

  2. 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

  3. 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

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

  5. Selecionar Detalhes de fidelidade para adicionar os campos do programa de fidelidade.

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

Agora dedique 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 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, selecione Salvar.
Salvar 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. Também é possível remover o campo do esquema.

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. Você pode:

  • Primeiro adicione um novo campo personalizado ao esquema e depois crie um grupo de campos personalizado, ou
  • Primeiro crie um grupo de campos personalizado e depois adicione os campos a ele.

Neste tutorial, começamos com a criação de um grupo de campos personalizado.

Para criar o grupo de campos:

  1. Selecionar Adicionar no Grupos de campos de esquema cabeçalho
    Adicionar um novo grupo de campos
  2. Selecionar 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. Selecionar 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. Selecionar + ao lado do nome do schema. 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. No Grupo de campos selecione o Grupo de campos do perfil de identidade da Luma que criamos.

      Adicionar um novo grupo de campos

    5. Selecionar Aplicar

      Aplicar novas propriedades de campo

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 classe
  2. Nomear 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. Abertura 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. Selecionar 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 Evento de experiência 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 Evento de experiência classe.
  2. Nomeie seu esquema Luma Offline Purchase Events Schema.
  3. Adicionar o grupo de campos padrão Detalhes do Commerce para capturar detalhes comuns da ordem. Passe alguns minutos explorando os objetos internos.
  4. 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!
  5. Selecione o Criar novo grupo de campos botão de opção
  6. Insira o Nome de exibição as Luma Identity ExperienceEvent field group e selecione o Adicionar grupos de campos botão
  7. Selecione + ao lado do nome 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. Como a variável Grupo de campos selecionar Grupo de campos Luma Identity ExperienceEvent.
  12. Selecione o Aplicar botão.
  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, 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
Evento de experiência
Nome do esquema
Esquema de eventos da Web da Luma
Grupo de campos
ExperienceEvent do SDK da Web da AEP
Grupo de campos
Evento de experiência do consumidor

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 Commerce. 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. 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 Commerce 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 botão.

  2. No workflow Criar esquema, selecione Outro opção.
    Criar novo esquema

  3. Selecione o Criar classe botão

  4. Nomear como Luma Product Catalog Class

  5. Deixe a Comportamento as Gravar

  6. Selecione o Criar botão.
    Criar nova classe

  7. A variável Classe do catálogo de produtos Luma criada aparece na tabela Classes abaixo. Verifique se a classe está selecionada e selecione Próxima.
    Nova classe adicionada

  8. Nomeie o esquema Luma Product Catalog Schema.

  9. 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

  10. 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