Criar elementos de dados

Última atualização em 2023-11-17
  • Tópicos
  • Tags
    Exibir mais informações sobre este tópico
  • Criado para:
  • Beginner
    Intermediate
    Developer

Saiba como criar os elementos de dados essenciais necessários para capturar dados com o SDK da Web do Experience Platform. Capturar dados de conteúdo e de identidade no Site de demonstração Luma. Saiba como usar o esquema XDM criado anteriormente para coletar dados usando o SDK da Web da plataforma por meio de um novo elemento de dados chamado Objeto XDM.

OBSERVAÇÃO

Para fins de demonstração, os exercícios desta lição baseiam-se no exemplo usado durante Configurar um esquema etapa; criação de objetos XDM de exemplo que capturam o conteúdo visualizado e as identidades dos usuários na Site de demonstração Luma.

IMPORTANTE

Os dados para esta lição vêm do digitalData camada de dados no site Luma. Para visualizar a camada de dados, abra o console do desenvolvedor e digite digitalData para ver a camada de dados completa disponível.camada de dados digitalData

Independentemente do SDK da Web da Platform, você deve continuar criando elementos de dados dentro da propriedade de tag que mapeiam para variáveis de coleção de dados do seu site, como uma camada de dados, atributo HTML ou outros. Depois de criar esses elementos de dados, você deve mapeá-los para o esquema XDM criado durante o configurar schemas lição. Para fazer isso, a extensão SDK da Web da Platform disponibiliza um novo tipo de elemento de dados chamado objeto XDM. Portanto, a criação de elementos de dados consiste em duas ações:

  1. Mapear variáveis de site para elementos de dados e
  2. Mapeamento desses elementos de dados para um objeto XDM

Para a etapa 1, você continua a mapear a camada de dados para elementos de dados da maneira que faz no momento, usando qualquer um dos tipos de elementos de dados da extensão de tag principal. Para a etapa 2, a extensão SDK da Web da Platform cria um conjunto de novos tipos de elementos de dados que não estavam disponíveis anteriormente:

  • ID de mesclagem de eventos
  • Mapa de identidade
  • Objeto XDM

Esta lição se concentra nos tipos de objetos XDM e elementos de dados do mapa de identidade. Você criará objetos XDM para capturar a atividade e o status de autenticação dos visitantes do Luma.

Objetivos de aprendizagem

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

  • Criar elementos de dados para capturar conteúdo e dados de ID de logon do usuário
  • Criar um elemento de dados do mapa de identidade
  • Mapear elementos de dados para um elemento de dados de objeto XDM

Pré-requisitos

Você entende o que é uma camada de dados, familiarizado com o Site de demonstração Luma camada de dados e saiba como fazer referência a elementos de dados em tags. Você deve ter concluído as seguintes etapas anteriores no tutorial

IMPORTANTE

A variável Extensão do Experience Cloud ID Service não é necessário ao implementar o SDK da Web da Adobe Experience Platform, pois a funcionalidade do Serviço de ID é incorporada no SDK da Web da plataforma.

Criar elementos de dados para capturar a camada de dados

Antes de começar a criar o objeto XDM, crie o seguinte conjunto de elementos de dados mapeando para o Site de demonstração Luma camada de dados:

  1. Ir para Elementos de dados e selecione Adicionar elemento de dados (ou Criar novo elemento de dados se não houver elementos de dados existentes na propriedade tag )

    Criar elemento de dados

  2. Nomeie o elemento de dados page.pageInfo.pageName

  3. Use o Variável JavaScript Tipo de elemento de dados para apontar para um valor na camada de dados do Luma: digitalData.page.pageInfo.pageName

  4. Marque as caixas Forçar valor minúsculo e Texto limpo para padronizar o caso e remover espaços irrelevantes

  5. Sair None como o Duração do armazenamento já que esse valor é diferente em cada página

  6. Selecione Salvar

    Elemento de dados do nome da página

Siga as mesmas etapas para criar esses quatro elementos de dados adicionais:

  • page.pageInfo.server mapeado para
    digitalData.page.pageInfo.server

  • page.pageInfo.hierarchie1 mapeado para
    digitalData.page.pageInfo.hierarchie1

  • user.profile.attributes.username mapeado para
    digitalData.user.0.profile.0.attributes.username

  • user.profile.attributes.loggedIn mapeado para
    digitalData.user.0.profile.0.attributes.loggedIn

  • cart.orderId mapeado para digitalData.cart.orderId (você usará isso durante o Configurar o Analytics lição)

ATENÇÃO

A variável Variável JavaScript o tipo de elemento de dados trata as referências de matriz como pontos em vez de colchetes, de modo que fazer referência ao elemento de dados username como digitalData.user[0].profile[0].attributes.username não funcionará.

Criar elemento de dados do Mapa de identidade

Em seguida, você pode criar o elemento de dados Mapa de identidade:

  1. Ir para Elementos de dados e selecione Adicionar elemento de dados

  2. Nome o elemento de dados identityMap.loginID

  3. Como a variável Extensão, selecione Adobe Experience Platform Web SDK

  4. Como a variável Tipo de elemento de dados, selecione Identity map

  5. Isso solicita uma área de tela à direita dentro da Interface da coleção de dados para configurar a identidade:

    Interface da coleção de dados

  6. Como a variável Namespace, selecione o Luma CRM Id que você criou anteriormente na variável Configurar identidades lição.

    OBSERVAÇÃO

    Se você não vir o seu Luma CRM Id , verifique se você também o criou na sandbox de produção padrão. Atualmente, somente os namespaces criados na sandbox de produção padrão são exibidos na lista suspensa namespace.

  7. Depois que a variável Namespace for selecionada, uma ID deverá ser definida. Selecione o user.profile.attributes.username elemento de dados criado anteriormente nesta lição, que captura uma ID quando os usuários são conectados ao site Luma.

  8. Como a variável Estado autenticado, selecione Autenticado

  9. Selecionar Principal

  10. Selecione Salvar

    Interface da coleção de dados

DICA

Adobe recomenda enviar identidades que representam uma pessoa, como Luma CRM Id, como a principal identidade.

Se o mapa de identidade contiver o identificador de pessoa (por exemplo, Luma CRM Id), o identificador de pessoa se tornará o principal identidade. Caso contrário, ECID torna-se o principal identidade.

Mapear elementos de dados para objetos XDM

Todos os elementos de dados criados devem ser mapeados para um objeto XDM. Esse objeto deve estar em conformidade com o esquema XDM criado durante o Configurar um esquema lição.

Há diferentes maneiras de mapear elementos de dados para campos de objeto XDM. Você pode mapear elementos de dados individuais para campos XDM individuais ou mapear elementos de dados para objetos XDM inteiros, desde que seu elemento de dados corresponda ao esquema de par de valor-chave exato presente no objeto XDM. Nesta lição, você capturará os dados de conteúdo mapeando para campos individuais. Você aprenderá a mapear um elemento de dados para um objeto XDM inteiro no Configurar o Analytics lição.

Crie um objeto XDM para capturar dados de conteúdo:

  1. Na navegação à esquerda, selecione Elementos de dados

  2. Selecione Adicionar elemento de dados

  3. ​Nomeie o elemento de dados xdm.content

  4. Como a variável Extensão selecionar Adobe Experience Platform Web SDK

  5. Como a variável Tipo de elemento de dados selecionar XDM object

  6. Selecione a plataforma Sandbox no qual você criou o esquema XDM no durante o Configurar um esquema XDM lição, neste exemplo DEVELOPMENT Mobile and Web SDK Courses

  7. Como a variável Esquema, selecione o Luma Web Event Data esquema:

    Objeto XDM

    OBSERVAÇÃO

    A sandbox corresponde à sandbox Experience Platform em que você criou o esquema. Pode haver várias sandboxes disponíveis na instância do Experience Platform, portanto, selecione a correta. Sempre trabalhe em desenvolvimento primeiro, depois em produção.

  8. Role para baixo até alcançar a web objeto

  9. Selecione para abri-lo

    Objeto da Web

  10. Mapear as seguintes variáveis XDM da Web para elementos de dados

    • web.webPageDetials.name para %page.pageInfo.pageName%
    • web.webPageDetials.server para %page.pageInfo.server%
    • web.webPageDetials.siteSection para %page.pageInfo.hierarchie1%

    Objeto XDM

  11. Em seguida, localize o identityMap no esquema e selecione-o

  12. Mapear para o identityMap.loginID elemento de dados

  13. Selecione Salvar

    Interface da coleção de dados

Ao final dessas etapas, você deve ter os seguintes elementos de dados criados:

Elementos de dados da extensão CORE Elementos de dados do SDK da Web da plataforma
cart.orderId identityMap.loginID
page.pageInfo.hierarchie1 xdm.content
page.pageInfo.pageName
page.pageInfo.server
user.profile.attributes.loggedIn
user.profile.attributes.username

Com esses elementos de dados implementados, você estará pronto para começar a enviar dados para a Platform Edge Network por meio do objeto XDM criando uma regra nas tags.

Próximo:

OBSERVAÇÃO

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 Publicação de discussão da comunidade do Experience League

Nesta página