Criar elementos de dados
Saiba como criar elementos de dados em tags para dados de conteúdo, comércio e identidade no 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
no site Luma. Para exibir 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 seu 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 Coleta de Dados e ignora o mapeamento de variáveis de camada de dados para XDM nas marcas.
Pontos positivos
- Flexível, pois é possível mapear variáveis individuais para o XDM
- Capacidade de calcular novos valores ou transformar tipos de dados a partir de uma camada de dados antes que ela vá para o XDM
- Aproveite uma Interface do usuário de mapeamento para mapear campos nos dados de origem para o XDM com uma interface do tipo 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 a camada de dados site de demonstração Luma:
-
Vá 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 de marca)
-
Nomeie o elemento de dados
page.pageInfo.pageName
-
Use a Variável JavaScript Tipo de elemento de dados para apontar para um valor na camada de dados da Luma:
digitalData.page.pageInfo.pageName
-
Marque as caixas Forçar valor minúsculo e Limpar texto para padronizar o caso e remover espaços irrelevantes
-
Deixe
None
como a configuração de Duração do Armazenamento, pois esse valor é diferente em cada página -
Selecione 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 Código personalizado Tipo de elemento de dados e o seguinte código personalizado para analisar a 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 elementos de dados Variável, que são muito fáceis de criar.
Para criar o elemento de dados Variable para XDM, vincule-o ao esquema criado na lição Configurar um esquema:
-
Selecione 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 a Extensão
-
Selecione a Variável como o Tipo de Elemento de Dados
-
Selecione XDM como a propriedade
-
Selecione a Sandbox em que você criou o esquema
-
Selecione o Esquema apropriado, neste caso
Luma Web Event Data
-
Selecione Salvar
Em seguida, crie o elemento de dados Variable para seu objeto de dados:
-
Selecione 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 a Extensão
-
Selecione a Variável como o Tipo de Elemento de Dados
-
Selecione dados como a propriedade
-
Selecione as soluções de Experience Cloud que deseja implementar como parte deste tutorial
-
Selecione 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.