Criar elementos de dados
Saiba como criar elementos de dados em tags para dados de conteúdo, comércio e identidade na Site de demonstração Luma. Em seguida, preencha os campos no esquema XDM com o tipo de elemento de dados Variável da extensão do SDK da Web da Adobe Experience Platform.
Objetivos de aprendizagem
No final desta lição, você poderá:
- Entender diferentes abordagens para mapear uma camada de dados para o XDM
- Criar elementos de dados para capturar dados
- Mapear elementos de dados para um objeto XDM
Pré-requisitos
Você entende o que é uma camada de dados e concluiu as lições anteriores no tutorial:
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.
Abordagens da camada de dados
Há várias maneiras de mapear dados da camada de dados para o XDM usando a funcionalidade de tags do Adobe Experience Platform. Abaixo estão alguns prós e contras de três abordagens diferentes. É possível combinar abordagens, se desejado:
- Implementar o XDM na camada de dados
- Mapear para XDM em tags
- Mapear para XDM no fluxo de dados
Implementar o XDM na camada de dados
Essa abordagem envolve o uso do objeto XDM totalmente definido como a estrutura da camada de dados. Em seguida, mapeie toda a camada de dados para um elemento de dados de objeto XDM nas tags. Se sua implementação não estiver usando um gerenciador de tags, essa abordagem poderá ser ideal, pois você pode enviar dados para o XDM diretamente do aplicativo usando o Comando sendEvent do XDM. Se você usar tags, poderá criar um elemento de dados de código personalizado capturando toda a camada de dados como um objeto JSON de passagem para o XDM. Em seguida, mapeie o JSON de passagem para o campo do objeto XDM na Ação Enviar evento.
Veja abaixo um exemplo de como seria a camada de dados usando o formato da Camada de dados do cliente Adobe:
code language-json |
---|
|
Pontos positivos
- Elimina etapas adicionais de remapeamento de variáveis de camada de dados para o XDM
- A implantação pode ser mais rápida se a sua equipe de desenvolvimento na Web também tiver um recurso de marcação de comportamento digital
Pontos negativos
- Confiança total na equipe de desenvolvimento e no ciclo de desenvolvimento para atualizar quais dados vão para o XDM
- Flexibilidade limitada, pois o XDM recebe a carga exata da camada de dados
- Não é possível usar recursos de tags incorporadas, como recursos de raspagem, persistência e implantação rápida
- É mais difícil usar a camada de dados para pixels de terceiros (mas convém mover esses pixels para encaminhamento de eventos!
- Não há capacidade de transformar os dados entre a camada de dados e o XDM
Mapear a camada de dados nas tags
Essa abordagem envolve o mapeamento de variáveis de camada de dados individuais OU objetos de camada de dados para elementos de dados em tags e, por fim, para o XDM. Essa é a abordagem tradicional de implementação usando um sistema de gerenciamento de tags.
Pontos positivos
- A abordagem mais flexível, pois você pode controlar variáveis individuais e transformar dados antes que eles cheguem ao XDM
- Pode usar acionadores de tags Adobe e a funcionalidade de refugo para transmitir dados ao XDM
- Pode mapear elementos de dados para pixels de terceiros no lado do cliente
Pontos negativos
- Demora para reconstruir a camada de dados como elementos de dados
Mapear para XDM no fluxo de dados
Essa abordagem usa uma funcionalidade integrada à configuração de sequência de dados chamada Preparação de dados para coleção de dados O e o ignoram o mapeamento de variáveis de camada de dados para o XDM nas tags.
Pontos positivos
- Flexível, pois é possível mapear variáveis individuais para o XDM
- Capacidade para calcular novos valores ou transformar tipos de dados de uma camada de dados antes de ela ir para o XDM
- Aproveitar um Mapeamento da interface do usuário para mapear campos nos dados de origem para o XDM com uma interface de apontar e clicar
Pontos negativos
- Não é possível usar variáveis de camada de dados como elementos de dados para pixels de terceiros do lado do cliente, mas você pode usá-las com o encaminhamento de eventos
- Não é possível usar a funcionalidade de reaproveitamento do recurso de tags do Adobe Experience Platform
- A complexidade de manutenção aumenta se o mapeamento da camada de dados for feito em tags e na sequência de dados
Criar elementos de dados para capturar a camada de dados
Antes de criar o objeto XDM, crie o seguinte conjunto de elementos de dados 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 para Forçar valor de minúsculas 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 -
Selecionar Salvar
Crie esses elementos de dados adicionais seguindo as mesmas etapas:
-
page.pageInfo.server
mapeado paradigitalData.page.pageInfo.server
-
page.pageInfo.hierarchie1
mapeado paradigitalData.page.pageInfo.hierarchie1
-
user.profile.attributes.username
mapeado paradigitalData.user.0.profile.0.attributes.username
-
user.profile.attributes.loggedIn
mapeado paradigitalData.user.0.profile.0.attributes.loggedIn
-
product.productInfo.sku
mapeado paradigitalData.product.0.productInfo.sku
-
product.productInfo.title
mapeado paradigitalData.product.0.productInfo.title
-
cart.orderId
mapeado paradigitalData.cart.orderId
-
product.category
usando o Custom Code Tipo de elemento de dados e o seguinte código personalizado para analisar o URL do site para a categoria de nível superior:code language-javascript var cat = location.pathname.split(/[/.]+/); if (cat[5] == 'products') { return (cat[6]); } else if (cat[5] != 'html') { return (cat[5]); }
-
cart.productInfo
usando o seguinte código personalizado:code language-javascript var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ cartItem.push({ "SKU": item.sku }); }); return cartItem;
-
cart.productInfo.purchase
usando o seguinte código personalizado:code language-javascript var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ var qty = parseInt(item.qty); var price = parseInt(item.price); cartItem.push({ "SKU": item.sku, "quantity": qty, "priceTotal": price }); }); return cartItem;
digitalData.user[0].profile[0].attributes.username
não funcionará.Criar elementos de dados variáveis para XDM e objetos de dados
Os elementos de dados que você acabou de criar serão usados para criar um objeto XDM (para aplicativos da Platform) e um objeto de dados (para o Analytics, Target e Audience Manager). Esses objetos têm seus próprios elementos de dados especiais chamados Variável elementos de dados que são muito fáceis de criar.
Para criar o elemento de dados Variável para XDM, vincule-o ao esquema criado na variável Configurar um esquema lição:
-
Selecionar Adicionar elemento de dados
-
Nomeie seu elemento de dados
xdm.variable.content
. Recomenda-se adicionar um prefixo "xdm" aos Elementos de dados específicos do XDM para organizar melhor a propriedade da tag -
Selecione o Adobe Experience Platform Web SDK como o Extensão
-
Selecione o Variável como o Tipo de elemento de dados
-
Selecionar XDM como o propriedade
-
Selecione o Sandbox no qual você criou o esquema
-
Selecione o apropriado Esquema, neste caso
Luma Web Event Data
-
Selecionar Salvar
Em seguida, crie o elemento de dados Variable para seu objeto de dados:
-
Selecionar Adicionar elemento de dados
-
Nomeie seu elemento de dados
data.variable
. Recomenda-se usar o prefixo "dados" nos elementos de dados específicos do objeto de dados para organizar melhor a propriedade da tag -
Selecione o Adobe Experience Platform Web SDK como o Extensão
-
Selecione o Variável como o Tipo de elemento de dados
-
Selecionar dados como o propriedade
-
Selecione as soluções de Experience Cloud que deseja implementar como parte deste tutorial
-
Selecionar Salvar
Ao final dessas etapas, você deve ter os seguintes elementos de dados criados:
cart.orderId
data.variable
cart.productInfo
xdm.variable.content
cart.productInfo.purchase
page.pageInfo.hierarchie1
page.pageInfo.pageName
page.pageInfo.server
product.category
product.productInfo.sku
product.productInfo.title
user.profile.attributes.loggedIn
user.profile.attributes.username
Com esses elementos de dados implementados, você estará pronto para começar a enviar dados para o Platform Edge Network com uma regra de tags. Mas, primeiro, saiba mais sobre como coletar identidades com o SDK da Web.