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.

NOTE
Um esquema XDM não é necessário para implementar o Adobe Analytics, o Adobe Target ou o Adobe Audience Manager com o SDK da Web (os dados podem ser passados no objeto data em vez do objeto xdm, como você verá mais tarde). Um esquema XDM é necessário para as implementações mais eficientes de aplicativos nativos da plataforma, como Journey Optimizer, Real-time Customer Data Platform e Customer Journey Analytics. Embora você possa decidir não usar um esquema XDM em sua própria implementação, espera-se que faça isso como parte deste tutorial.

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 propriedade priceTotal que representasse 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 significam 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.

Esta é a meta do Modelo de Dados de Experiência do Adobe. 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 esquema de exemplo para capturar o conteúdo exibido 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, assista à lista de reprodução Modelar seus dados de experiência do cliente com 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 estão descritas na página visão geral.

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 as noções básicas da composição de Esquema.

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

  1. Abrir a interface de 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 contrário, use a sandbox Prod.
  3. Vá para Esquemas na navegação à esquerda

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

    Criar Esquema

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

  6. Selecionar Próximo

    Evento de experiência de esquema

  7. Insira o nome do esquema no campo Nome para 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 seguir os padrões XDM, todos os dados de experiência do cliente podem ser incorporados a uma 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 Criar 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 na Web: ExperienceEvent do SDK da Web da AEP e Evento de experiência do consumidor.
  1. Na seção 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. O nome para exibição de cada campo aparece para os profissionais de marketing na interface do construtor de segmentos dos aplicativos baseados na Platform e você pode alterar o nome para 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ê vê quais campos pertencem ao 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. Este processo é semelhante à criação de um Documento de requisitos comerciais e uma Referência de design de solução para uma implementação do Adobe Analytics, mas deve incluir requisitos para todos os destinatários de dados downstream, como destinos de Plataforma, Destino e encaminhamento de eventos.

O objeto identityMap

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

Dados do Evento da Web 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 lição Configurar identidades. Ele é incluído automaticamente em todos os esquemas que usam a classe XDM ExperienceEvent.

IMPORTANT
É possível habilitar o Perfil para um esquema antes de salvá-lo. Não habilite-o neste momento. 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 Descontinuar Campos na interface. 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.
Esta configuração é discutida mais detalhadamente durante a lição Setup Experience Platform.
Esquema de Perfil

Para concluir esta lição, selecione Salvar na parte superior direita.

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 comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta postagem de Discussão da Comunidade Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4