Criar um esquema XDM para dados da Web

Saiba como criar um esquema XDM para dados da Web na interface da Coleção de dados da Adobe Experience Platform.

Os esquemas do Experience Data Model (XDM) são os blocos fundamentais, os princípios e as práticas recomendadas para coletar dados no Adobe Experience Platform.

O SDK da Web da Platform usa o esquema para padronizar os dados de eventos da Web, enviá-los para o Edge Network da Platform e, por fim, encaminhar os dados para qualquer aplicativo Experience Cloud configurado no fluxo de dados. Essa etapa é crítica, pois define um modelo de dados padrão necessário para assimilar dados de experiência do cliente no Experience Platform e habilita serviços e aplicativos downstream baseados nesses padrões.

Por que modelar os dados?

As empresas têm sua própria linguagem para se comunicar sobre seus domínios. As concessionárias de automóveis lidam com marcas, modelos e cilindros. As companhias aéreas lidam com números de voo, classe de serviço e atribuições de assentos. Alguns desses termos são exclusivos de uma empresa específica, alguns são compartilhados entre um setor vertical e alguns são compartilhados por quase todas as empresas. Para termos compartilhados entre um setor vertical ou até mais amplo, você pode começar a fazer coisas poderosas com seus dados ao nomear e estruturar esses termos de uma maneira comum.

Por exemplo, muitas empresas lidam com pedidos. E se, coletivamente, essas empresas decidissem modelar um pedido de maneira semelhante? Por exemplo, e se o modelo de dados consistisse em um objeto com uma priceTotal propriedade que representava o preço total do pedido? E se esse objeto também tiver propriedades chamadas? currencyCode e purchaseOrderNumber? Talvez o objeto da ordem contenha uma propriedade chamada payments que seria uma matriz de objetos de pagamento. Cada objeto representaria um pagamento para o pedido. Por exemplo, talvez um cliente tenha pago uma parte do pedido com um vale-presente e o restante com um cartão de crédito. Você pode começar a construir um modelo com esta aparência:

{
  "order": {
    "priceTotal": 89.50,
    "currencyCode": "EUR",
    "purchaseOrderNumber": "JWN20192388410012",
    "payments": [
      {
        "paymentType": "gift_card",
        "paymentAmount": 50
      },
      {
        "paymentType": "credit_card",
        "paymentAmount": 39.50
      }
    ]
  }
}

Se todas as empresas que lidam com pedidos decidissem modelar seus dados de pedidos de maneira consistente para termos comuns no setor, coisas mágicas poderiam começar a acontecer. As informações poderiam ser trocadas de forma mais fluida dentro e fora da organização, em vez de interpretar e traduzir constantemente os dados (props e evars, alguém?). O aprendizado de máquina poderia entender mais facilmente o que seus dados significa e fornecer insights acionáveis. As interfaces do usuário para encontrar dados relevantes podem se tornar mais intuitivas. Seus dados podem ser perfeitamente integrados a parceiros e fornecedores que estejam seguindo a mesma modelagem.

Esse é o objetivo do Adobe Experience Data Model. O XDM fornece modelagem prescritiva para dados comuns no setor, além de permitir estender o modelo para suas necessidades específicas. O Adobe Experience Platform é construído com base no XDM e, como tal, os dados enviados para o Experience Platform precisam estar no XDM. Em vez de pensar em onde e como você pode transformar seus modelos de dados atuais em XDM antes de enviar os dados para o Experience Platform, considere adotar o XDM de forma mais abrangente em toda a organização para que a tradução raramente precise ocorrer.

NOTE
Para fins de demonstração, os exercícios nesta lição criam um schema de exemplo para capturar o conteúdo visualizado e os produtos comprados pelos clientes no Site de demonstração da Luma. Embora você possa usar essas etapas para criar um esquema diferente para suas próprias finalidades, recomenda-se seguir primeiro juntamente com a criação do esquema de exemplo para saber mais sobre os recursos do editor de esquema.

Para saber mais sobre esquemas XDM, faça o curso Modelar seus dados de experiência do cliente com o XDM ou consulte a Visão geral do sistema XDM.

Objetivos de aprendizagem

No final desta lição, você poderá:

  • Criar um esquema XDM na interface da Coleção de dados
  • Adicionar grupos de campos ao esquema XDM
  • Criar esquemas XDM para dados de evento da Web usando práticas recomendadas

Pré-requisitos

Todas as permissões de usuário e provisionamento necessárias para a Coleção de dados e o Adobe Experience Platform descritas na visão geral página.

Criar um esquema do XDM

Os esquemas XDM são a maneira padrão de descrever dados no Experience Platform, permitindo que todos os dados em conformidade com os esquemas sejam reutilizados em uma organização sem conflitos ou até mesmo compartilhados entre várias organizações. Para saber mais, consulte a noções básicas da composição Esquema.

Neste exercício, você criará um esquema XDM usando os grupos de campos de linha de base recomendados para capturar dados de eventos da Web no Site de demonstração da Luma:

  1. Abra o Interface da coleção de dados

  2. Verifique se você está na sandbox correta. Localize a sandbox no canto superior direito

    note note
    NOTE
    Se você for o cliente de um aplicativo baseado em plataforma, como o Real-Time CDP ou o Journey Optimizer, recomendamos usar uma sandbox de desenvolvimento para este tutorial. Caso não esteja, use o Prod sandbox.
  3. Ir para Esquemas na navegação à esquerda

  4. Selecione o Criar esquema botão na parte superior direita

    Criar esquema

  5. Selecionar Evento de experiência na tela a seguir

  6. Selecionar Próxima

    Evento de experiência de esquema

  7. Insira o nome do esquema em Nome de exibição do esquema neste caso, Luma Web Event Data

    note tip
    TIP
    Uma convenção de nomenclatura comum para esquemas XDM é nomear o esquema após a origem dos dados.
  8. Selecione Concluir

    Término do Evento de Experiência de Esquema

Adicionar grupos de campos

Como observado anteriormente, o XDM é a estrutura principal que padroniza os dados de experiência do cliente, fornecendo estruturas e definições comuns para uso nos serviços downstream da Adobe Experience Platform. Ao aderir aos padrões XDM, todos os dados de experiência do cliente podem ser incorporados numa representação comum. Essa abordagem permite 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 usando dados de várias fontes. Consulte Práticas recomendadas para modelagem de dados para obter mais informações.

Quando possível, é recomendável usar grupos de campo existentes e aderir a um modelo independente de produto e convenções de nomenclatura. Para quaisquer dados específicos da sua organização que não se encaixem nos grupos de campos predefinidos acima, você pode criar um grupo de campos personalizado. Consulte Criação de um esquema usando o Editor de esquemas para obter etapas mais detalhadas sobre esquemas personalizados.

TIP
Neste exercício, você adiciona os grupos de campos predefinidos recomendados para a coleta de dados da Web: ExperienceEvent do SDK da Web da AEP e Evento de experiência do consumidor.
Se você estiver apenas implementando Adobe Analytics com o SDK da Web e não enviando dados para o Experience Platform, use o Modelo de evento de experiência do Adobe Analytics grupo de campos para definir o esquema XDM. Isso é usado no Configurar o Analytics lição.
  1. No Grupos de campos , selecione Adicionar

    Novo grupo de campos

  2. Pesquisar por AEP Web SDK ExperienceEvent

  3. Marque a caixa

  4. Pesquisar por Consumer Experience Event

  5. Marque a caixa

  6. Selecionar Adicionar grupos de campos

    Adicionar grupo de campos

Com ambos os grupos de campos, observe que você tem acesso aos pares de valores chave mais usados, necessários para a coleta de dados na Web. A variável nome de exibição de cada campo aparece para os profissionais de marketing na interface do construtor de segmentos dos aplicativos baseados em plataforma e você pode alterar o nome de exibição dos campos padrão para atender às suas necessidades. Também é possível remover campos indesejados. Ao clicar em qualquer nome de grupo de campos, a interface destaca quais agrupamentos de pares de valores chave pertencem a ele. No exemplo abaixo, você pode ver a quais campos pertencem Evento de experiência do consumidor.

Grupos de campos de esquema

Esta lição é apenas um ponto de partida. Ao criar seu próprio schema de eventos da Web, você deve explorar e documentar seus requisitos de negócios. Esse processo é semelhante à criação de um Documento de requisitos comerciais e Referência de design da solução para uma implementação do Adobe Analytics, mas deve incluir requisitos para todos os destinatários de dados downstream como Destinos de encaminhamento de eventos, Platform e Target.

O objeto identityMap

Há um campo especial usado para identificar usuários da Web chamado identityMap.

Dados de evento da Web da Luma

É um objeto obrigatório para qualquer coleta de dados relacionada à Web, pois abriga a ID de Experience Cloud necessária para identificar usuários na Web. Também é fundamental para definir IDs internas do cliente para usuários autenticados. identityMap é discutido mais na seção Configurar identidades lição. Ele é incluído automaticamente em todos os esquemas que usam a variável XDM ExperienceEvent classe.

IMPORTANT
É possível habilitar Perfil para um esquema antes de salvá-lo. Não ative-o neste ponto. Depois que um esquema é ativado para Perfil, ele não pode ser desativado ou excluído sem redefinir toda a sandbox. Os campos também não podem ser removidos de esquemas neste ponto, embora seja possível Substituir campos na interface do usuário. Essas implicações são importantes para ter em mente posteriormente quando você estiver trabalhando com seus próprios dados no ambiente de produção.
Essa configuração é discutida mais durante o Configurar Experience Platform lição.
Esquema de perfil

Para concluir esta lição, selecione Salvar no canto superior direito.

Salvar esquema

Agora, é possível fazer referência a esse esquema ao adicionar a extensão SDK da Web à propriedade da tag.

Próximo:

NOTE
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Web SDK. Se você tiver dúvidas, quiser compartilhar feedback geral ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta Publicação de discussão da comunidade do Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4