DocumentaçãoExperience PlatformTutorial do SDK da web

Criar regras de tag

Last update: Thu Mar 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Iniciante
  • Intermediário
  • Desenvolvedor

Saiba como enviar eventos para a Adobe Experience Platform Edge Network usando regras de tag. Uma regra de tag é uma combinação de eventos, condições e ações que instrui a propriedade de tag a fazer algo. Com o Platform Web SDK, as regras são usadas para enviar eventos para o Platform Edge Network com os dados corretos.

Objetivos de aprendizagem

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

  • Usar uma convenção de nomenclatura para gerenciar regras nas tags
  • Enviar um evento com campos XDM usando ações Atualizar variável e Enviar evento
  • Empilhar vários conjuntos de campos XDM em várias regras
  • Mapear elementos de dados de matriz individuais ou inteiros para o objeto XDM
  • Publicar uma regra de tag em uma biblioteca de desenvolvimento

Pré-requisitos

Você está familiarizado com as tags de Coleção de dados e o site de demonstração do Luma e concluiu as lições anteriores no tutorial:

Convenções de nomenclatura

Para gerenciar regras em tags, é recomendável seguir uma convenção de nomenclatura padrão. Este tutorial usa uma convenção de nomenclatura de quatro partes:

  • [local] - [evento] - [finalidade] - [ordem]

onde;

  1. local é a(s) página(s) no site em que a regra é acionada
  2. evento é o acionador da regra
  3. propósito é a ação principal executada pela regra
  4. ordem é a ordem na qual a regra deve ser acionada em relação a outras regras que compartilham o mesmo evento

Adicionar extensão da camada de dados do cliente da Adobe

O site Luma usa uma camada de dados orientada por eventos chamada Camada de dados do cliente Adobe (ACDL). Sempre que ocorrer um evento de camada de dados, ele será enviado por push para a matriz adobeDataLayer. Este tutorial usa uma extensão de tags chamada Camada de dados do cliente da Adobe para aproveitar esses eventos e criar nossas regras.

Para adicionar a extensão:

  1. Ir para Extensões

  2. Filtrar para Camada de Dados de Clientes Adobe

  3. Selecione Instalar

    Adicionar extensão da Camada de Dados do Cliente Adobe

  4. Mantenha as configurações padrão

  5. Selecione Salvar

NOTE
Não é necessário usar a Camada de dados de clientes Adobe para implementar o Experience Platform Web SDK. Muitos outros tipos de eventos são normalmente usados em implementações de tags (Biblioteca carregada, DOM Pronto, Janela carregada e assim por diante) para acionar regras.

Criar regras de tag

Nas tags, as regras são usadas para executar ações, como definir variáveis e acionar chamadas de rede em várias condições. A extensão de tags da Experience Platform Web SDK inclui duas ações usadas em regras:

  • A variável de atualização mapeia elementos de dados para o XDM ou variáveis de dados
  • Enviar Evento faz a chamada de rede para enviar dados ao Experience Platform Edge Network

No restante desta lição:

  1. Use a ação Atualizar variável para definir uma "configuração global" de campos XDM.

  2. Use a ação Atualizar variável novamente para substituir nossa "configuração global" e contribuir com campos XDM adicionais em determinadas condições (por exemplo, adicionar detalhes do produto em páginas de produtos).

  3. Use a ação Enviar Evento para enviar os dados ao Adobe Experience Platform Edge Network.

Todas essas regras serão sequenciadas corretamente usando a opção "order".

Este vídeo fornece uma visão geral do processo:

https://video.tv.adobe.com/v/3454032/?captions=por_br&learn=on&enablevpops

Campos de configuração global

Para criar uma regra de tag para os campos XDM globais:

  1. Abra a propriedade da tag que você está usando neste tutorial

  2. Vá para Regras na navegação à esquerda

  3. Selecione o botão Criar nova regra

    Criar uma regra

  4. Atribua um nome à regra all pages - adobeDataLayer push - set global variables - 1

  5. Na seção Eventos, selecione Adicionar

    Nomear a regra e adicionar um evento

  6. Use a extensão Camada de Dados de Clientes Adobe e selecione Dados Enviados como o Tipo de Evento

  7. Selecione a lista suspensa Avançado e digite 1 como Pedido

    note note
    NOTE
    Quanto menor o número do pedido, mais cedo ele será executado. Portanto, damos à nossa "configuração global" um número de ordem baixo.

  8. Ouvir Todos os Eventos

  9. Selecione Manter alterações para retornar à tela de regra principal
    Selecionar acionador de biblioteca carregada

  10. Na seção Ações, selecione Adicionar

  11. Como a Extensão, selecione Adobe Experience Platform Web SDK

  12. Como o Tipo de ação, selecione Atualizar variável

  13. Como o Elemento de dados, selecione o XDM Variable criado na lição Criar elementos de dados

    Atualizar Esquema De Variável

  14. Agora, especifique os campos XDM mapeando-os para valores apropriados:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo XDM Mapear para
    eventType Web Webpagedetails Page Views (comece a digitar para ver os valores sugeridos)
    identityMap Identity Map elemento de dados
    web.webPageDetails.name Page Name elemento de dados
    web.webPageDetails.pageViews.value 1
    note tip
    TIP
    Os campos XDM não serão incluídos na solicitação de rede se o elemento de dados for nulo. Portanto, quando o usuário não estiver autenticado e o elemento de dados Identity Map for nulo, o objeto identityMap não será enviado. É por isso que podemos defini-la com segurança em nossa "configuração global".
    note tip
    TIP
    A configuração web.webPageDetails.pageViews.value fornece uma maneira padrão de indicar uma exibição de página para outros aplicativos downstream. Não é necessário que o Adobe Analytics processe uma chamada de rede como uma exibição de página.

  15. Quando você terminar, seu XDM Variable será mais ou menos assim. Observe como os campos preenchidos e parcialmente preenchidos são indicados com os círculos azuis:
    Variável XDM

  16. Selecione Manter alterações e Salvar a regra

Campos da página do produto

Agora, comece a usar a variável Update em regras sequenciadas adicionais para enriquecer o objeto XDM antes de enviá-lo para a Platform Edge Network.

TIP
A ordem das regras determina qual regra é executada primeiro quando um evento é acionado. Se duas regras tiverem o mesmo tipo de evento, a regra com o número de ordem mais baixo será executada primeiro.

Comece rastreando as exibições do produto na página de detalhes do produto da Luma:

  1. Selecionar Adicionar regra

  2. Nomeie como product detail pages - adobeDataLayer push - set product details variables - 20

  3. Selecione o + símbolo em Evento para adicionar um novo gatilho

  4. Em Extensão, selecione Camada de Dados de Clientes Adobe

  5. Em Tipo de evento, selecione Dados enviados

  6. Selecione para abrir as Opções Avançadas, digite 20. Este valor de ordem garante que a regra seja executada após a regra de variáveis globais.

  7. Ouvir um Evento específico

  8. Inserir productView como Evento / Chave para registrar

  9. Selecione Manter alterações

    Regras XDM do Analytics

  10. Em Ações, selecione Adicionar

  11. Selecione a extensão Adobe Experience Platform Web SDK

  12. Selecione o Tipo de ação como Atualizar variável

  13. Selecione XDM Variable como o Elemento de dados

  14. Mapeie esses campos XDM para valores apropriados:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo XDM Mapear para
    eventType Commerce Product Views (comece a digitar para ver os valores sugeridos)
    commerce.productViews.value 1
    productListItems.name Ecommerce Product Name elemento de dados (Selecione Fornecer itens individuais e Adicionar Item primeiro )
    productListItems.sku Ecommerce Product Id elemento de dados

  15. Selecione Manter alterações

  16. Selecione Salvar para salvar a regra

    note note
    NOTE
    Como essa regra tem uma ordem maior, ela substituirá o conjunto eventType na regra de "configuração global". eventType pode conter apenas um valor e recomendamos configurá-lo com o evento mais valioso.
    note tip
    TIP
    A configuração de commerce.productViews.value=1 no XDM mapeia automaticamente para o evento prodView no Analytics

Campos do carrinho de compras

Você pode mapear toda a matriz para um objeto XDM, desde que a matriz corresponda ao formato do esquema XDM. O elemento de dados de código personalizado Ecommerce Cart Products criado anteriormente faz loop pelo objeto de camada de dados adobeDataLayer.ecommerce.cart.items no site da Luma e o traduz no formato necessário do objeto productListItems do esquema XDM.

Para ilustrar, consulte a comparação abaixo da camada de dados do site Luma (esquerda) com o elemento de dados traduzido (direita):

Formato da matriz de objetos XDM

Compare o elemento de dados com a estrutura productListItems (dica, ele deve corresponder).

NOTE
Você não poderá executar _satellite.getVar('Ecommerce Cart Products') neste ponto do tutorial.
IMPORTANT
Ao mapear campos da camada de dados para o XDM, verifique se os campos correspondem ao tipo de dados do campo XDM. No exemplo acima, quantity e priceTotal devem ser números inteiros ou o registro não será assimilado na Platform.
Tipo de dados de esquema XDM ​

Agora, vamos mapear nossa matriz para o objeto XDM:

  1. Crie uma nova regra chamada cart page - adobeDataLayer push - set cart variables - 20

  2. Selecione o + símbolo em Evento para adicionar um novo gatilho

  3. Em Extensão, selecione Camada de Dados de Clientes Adobe

  4. Em Tipo de evento, selecione Dados enviados

  5. Selecione para abrir as Opções Avançadas, digite 20. Este valor de ordem garante que a regra seja executada após a regra de variáveis globais.

  6. Ouvir um Evento específico

  7. Inserir cartView como Evento / Chave para registrar

  8. Selecione Manter alterações

    Evento para regra de carrinho

  9. Em Ações, selecione Adicionar

  10. Selecione a extensão Adobe Experience Platform Web SDK

  11. Selecione o Tipo de ação como Atualizar variável

  12. Selecione XDM Variable como o Elemento de dados

  13. Mapeie esses campos XDM para valores apropriados:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Campo XDM Mapear para
    eventType Commerce Product List (Cart) Views (comece a digitar para ver os valores sugeridos)
    commerce.productListViews.value 1
    productListItems Elemento de dados Ecommerce Cart Products (selecione Fornecer toda a matriz primeiro )
    note tip
    TIP
    A configuração de commerce.productListViews.value=1 no XDM mapeia automaticamente para o evento scView no Analytics

  14. Selecione Manter alterações

  15. Selecione Salvar para salvar a regra

Campos de confirmação de pedido

Crie outra regra para eventos de compra:

  1. Crie uma nova regra chamada order confirmation - adobeDataLayer push - set purchase variables - 20

  2. Selecione o + símbolo em Evento para adicionar um novo gatilho

  3. Em Extensão, selecione Camada de Dados de Clientes Adobe

  4. Em Tipo de evento, selecione Dados enviados

  5. Selecione para abrir as Opções Avançadas, digite 20. Este valor de ordem garante que a regra seja executada após a regra de variáveis globais.

  6. Ouvir um Evento específico

  7. Inserir purchase como Evento / Chave para registrar

  8. Selecione Manter alterações

  9. Em Ações, selecione Adicionar

  10. Selecione a extensão Adobe Experience Platform Web SDK

  11. Selecione o Tipo de ação como Atualizar variável

  12. Selecione XDM Variable como o Elemento de dados

  13. Mapeie esses campos XDM para valores apropriados:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    Campo XDM Mapear para
    eventType Commerce Purchases (comece a digitar para ver os valores sugeridos)
    commerce.productListViews.value 1
    commerce.order.purchaseID Ecommerce Purchase Id elemento de dados
    commerce.order.currencyCode USD
    productListItems Ecommerce Cart Products elemento de dados (Selecione Fornecer toda a matriz primeiro )
    note tip
    TIP
    A configuração commerce.productListViews.value como 1, commerce.order.purchaseID e commerce.order.currencyCode no XDM mapeia automaticamente para as variáveis purchase, s.purchaseID e s.currencyCode no Analytics, respectivamente.

  14. Selecione Manter alterações

  15. Selecione Salvar

Enviar regra de evento

Agora que você definiu as variáveis, é possível criar a regra para enviar o objeto XDM completo para o Platform Edge Network com a ação Enviar evento.

  1. Crie uma nova regra chamada all pages - adobeDataLayer push - send event - 50

  2. Selecione o + símbolo em Evento para adicionar um novo gatilho

  3. Em Extensão, selecione Camada de Dados de Clientes Adobe

  4. Em Tipo de evento, selecione Dados enviados

  5. Selecione para abrir as Opções Avançadas, digite 50 (que provavelmente é o padrão). Este valor de ordem garante que a regra seja executada após as regras de configuração de variável.

  6. Ouvir um Todos os Eventos

  7. Selecione Manter alterações

  8. Em Ações, selecione Adicionar

  9. Selecione a extensão Adobe Experience Platform Web SDK

  10. Selecione Tipo de ação como Enviar variável de evento

  11. Como o Tipo de ação, selecione Enviar evento

  12. Como o XDM, selecione o elemento de dados XDM Variable criado na lição anterior

  13. Selecione Manter alterações para retornar à tela de regra principal

    Adicionar a ação Enviar Evento

  14. Selecione Salvar para salvar a regra

    Salvar a regra

Você deve ter as seguintes regras na propriedade:

Verificar lista de regras

Publicar as regras em uma biblioteca

Em seguida, publique a regra no ambiente de desenvolvimento para que você possa verificar se funciona.

Para criar uma biblioteca:

  1. Vá para Fluxo de Publicação na navegação à esquerda

  2. Selecione Adicionar biblioteca

    Selecione Adicionar Biblioteca

  3. Para o Nome, digite Luma Web SDK Tutorial

  4. Para o Ambiente, selecione Development

  5. Selecione Adicionar todos os recursos alterados

    note note
    NOTE
    Você deve ver todos os componentes de tag criados nas lições anteriores. A extensão principal contém a JavaScript básica exigida por todas as propriedades de tag da Web.

  6. Selecione Salvar e criar para desenvolvimento

    Criar e criar a biblioteca

A biblioteca pode levar alguns minutos para ser criada e, quando estiver concluída, exibirá um ponto verde à esquerda do nome da biblioteca:

Compilação concluída

Como você pode ver na tela Fluxo de publicação, há muito mais no processo de publicação, que está além do escopo deste tutorial. Este tutorial usa apenas uma única biblioteca no ambiente de desenvolvimento do.

Agora você está pronto para validar os dados na solicitação usando o Adobe Experience Platform Debugger.

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