DocumentaçãoExperience PlatformTutorial do SDK da web

Criar elementos de dados

Last update: Thu Jul 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Iniciante
  • Intermediário
  • Desenvolvedor

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 Adobe Experience Platform Web SDK.

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:

IMPORTANT
Os dados para esta lição vêm da camada de dados 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. camada de dados digitalData

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:

  1. Implementar o XDM na camada de dados
  2. Mapear para XDM em tags
  3. Mapear para XDM no fluxo de dados
NOTE
Os exemplos neste tutorial seguem a abordagem Mapear para XDM em tags.

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 a camada de dados seria usada com o formato da Camada de dados do cliente Adobe:

XDM no exemplo de Camada de dados
code language-json 
window.adobeDataLayer.push({
"eventType": "web.webPageDetails.pageViews",
"web":{
         "webInteraction":{
            "linkClicks":{
               "id":"",
               "value":""
            },
            "URL":"",
            "name":"",
            "region":"",
            "type":""
         },
         "webPageDetails":{
            "pageViews":{
               "id":"",
               "value":"1"
            },
            "URL":"https://luma.enablementadobe.com/",
            "isErrorPage":"",
            "isHomePage":"",
            "name":"luma:home",
            "server":"enablementadobe.com",
            "siteSection":"home",
            "viewName":""
         },
         "webReferrer":{
            "URL":"",
            "type":""
         }
      }
});

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 da 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
TIP
Camada de dados Google
Se sua organização já usa a Google Analytics e tem o objeto tradicional dataLayer da Google em seu site, você pode usar a extensão de Camada de Dados da Google nas tags. Isso permite implantar a tecnologia Adobe mais rapidamente, sem precisar solicitar suporte da sua equipe de TI. O mapeamento da camada de dados do Google para o XDM seguiria as mesmas etapas descritas acima.

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

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
IMPORTANT
Como observado anteriormente, os exemplos neste tutorial seguem a abordagem Mapear para XDM em tags.

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 do site de demonstração Luma:

  1. 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)

    Criar Elemento de Dados

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

  3. 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

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

  5. Deixe None como a configuração de Duração do Armazenamento, pois esse valor é diferente em cada página

  6. Selecione Salvar

    Elemento de dados do nome da página

Crie esses elementos de dados adicionais seguindo as mesmas etapas:

  • 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

  • product.productInfo.sku mapeado para digitalData.product.0.productInfo.sku

  • product.productInfo.title mapeado para digitalData.product.0.productInfo.title

  • cart.orderId mapeado para digitalData.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;
CAUTION
O tipo de elemento de dados variável JavaScript trata referências de matriz como pontos em vez de colchetes, portanto, referenciar o elemento de dados username como 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:

  1. Selecione Adicionar elemento de dados

  2. 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

  3. Selecione a Adobe Experience Platform Web SDK como a Extensão

  4. Selecione a Variável como o Tipo de Elemento de Dados

  5. Selecione XDM como a propriedade

  6. Selecione a Sandbox em que você criou o esquema

  7. Selecione o Esquema apropriado, neste caso Luma Web Event Data

  8. Selecione Salvar

    Elemento de dados de variável para XDM

Em seguida, crie o elemento de dados Variable para seu objeto de dados:

  1. Selecione Adicionar elemento de dados

  2. 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

  3. Selecione a Adobe Experience Platform Web SDK como a Extensão

  4. Selecione a Variável como o Tipo de Elemento de Dados

  5. Selecione dados como a propriedade

  6. Selecione as soluções da Experience Cloud que deseja implementar como parte deste tutorial

  7. Selecione Salvar

    Elemento de dados de variável para o objeto de dados

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

Elementos de dados da extensão principal
Elementos de dados da extensão do Platform Web SDK
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
TIP
Em uma lição futura Criar regras de tag, você aprenderá como os elementos de dados Variável permitem empilhar várias regras em tags usando o Tipo de ação Atualizar variável.

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 como coletar identidades com o Web SDK.

NOTE
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 postagem de discussão da Comunidade Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4