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.
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.
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:
-
Abrir a interface de Coleção de Dados
-
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. -
Vá para Esquemas na navegação à esquerda
-
Selecione o botão Criar Esquema na parte superior direita
-
Selecione Evento de experiência na tela a seguir
-
Selecionar Próximo
-
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. -
Selecione Concluir
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.
-
Na seção Grupos de campos, selecione Adicionar
-
Pesquisar por
AEP Web SDK ExperienceEvent
-
Marque a caixa
-
Pesquisar por
Consumer Experience Event
-
Marque a caixa
-
Selecionar Adicionar grupos 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.
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
.
É 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.
Para concluir esta lição, selecione Salvar na parte superior direita.
Agora, é possível fazer referência a esse esquema ao adicionar a extensão SDK da Web à propriedade da tag.