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.
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.
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.
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:
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:
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.
No final desta lição, você poderá:
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
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.
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:
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 )
Nomeie o elemento de dados page.pageInfo.pageName
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
Marque as caixas Forçar valor minúsculo e Texto limpo para padronizar o caso e remover espaços irrelevantes
Sair None
como o Duração do armazenamento já que esse valor é diferente em cada página
Selecione Salvar
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)
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á.
Em seguida, você pode criar o elemento de dados Mapa de identidade:
Ir para Elementos de dados e selecione Adicionar elemento de dados
Nome o elemento de dados identityMap.loginID
Como a variável Extensão, selecione Adobe Experience Platform Web SDK
Como a variável Tipo de elemento de dados, selecione Identity map
Isso solicita uma área de tela à direita dentro da Interface da coleção de dados para configurar a identidade:
Como a variável Namespace, selecione o Luma CRM Id
que você criou anteriormente na variável Configurar identidades liçã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.
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.
Como a variável Estado autenticado, selecione Autenticado
Selecionar Principal
Selecione Salvar
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.
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:
Na navegação à esquerda, selecione Elementos de dados
Selecione Adicionar elemento de dados
Nomeie o elemento de dados xdm.content
Como a variável Extensão selecionar Adobe Experience Platform Web SDK
Como a variável Tipo de elemento de dados selecionar XDM object
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
Como a variável Esquema, selecione o Luma Web Event Data
esquema:
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.
Role para baixo até alcançar a web
objeto
Selecione para abri-lo
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%
Em seguida, localize o identityMap
no esquema e selecione-o
Mapear para o identityMap.loginID
elemento de dados
Selecione Salvar
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.
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