DocumentaçãoExperience PlatformTutorial do SDK da web

Criar regras de tag

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
  • undefined

Saiba como enviar eventos para o Edge Network Adobe Experience Platform com seu objeto XDM 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 SDK da Web da Platform, 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 a Site de demonstração Luma e concluíram 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 cinco partes:

  • [localização] - [evento] - [finalidade] - [pedido]

onde;

  1. localização é a página ou páginas no site em que a regra é acionada
  2. evento é o acionador da regra
  3. finalidade é a ação principal executada pela regra
  4. pedido é a ordem na qual a regra deve ser acionada em relação a outras regras

Criar regras de tag

Nas tags, as regras são usadas para executar ações (acionar chamadas) em várias condições. A extensão de tags do SDK da Web da Platform inclui duas ações usadas nesta lição:

  • Atualizar variável mapeia elementos de dados para propriedades em um objeto XDM
  • Enviar evento envia o objeto XDM para o Edge Network Experience Platform

No restante desta lição:

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

  2. Crie regras adicionais com o Atualizar variável Ações que substituem nossa "configuração global" e contribuem com campos XDM adicionais em determinadas condições (por exemplo, adicionar detalhes do produto nas páginas do produto).

  3. Criar outra regra com o Enviar evento ação, que enviará o objeto XDM completo para o Edge Network do Adobe Experience Platform.

Todas essas regras serão sequenciadas corretamente usando o "pedido".

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

https://video.tv.adobe.com/v/3427710/?learn=on

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. Ir para Regras na navegação à esquerda

  3. Selecione o Criar nova regra botão

    Criar uma regra

  4. Atribua um nome à regra all pages - library loaded - set global variables - 1

  5. No Eventos , selecione Adicionar

    Nomear a regra e adicionar um evento

  6. Use o Extensão principal e selecione Biblioteca carregada (início da página) como o Tipo de evento

  7. Selecionar Avançado e insira 1 como o 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. Selecionar Manter alterações para retornar à tela principal da regra
    Selecionar acionador da biblioteca carregada

  9. No Ações , selecione Adicionar

  10. Como a variável Extensão, selecione Adobe Experience Platform Web SDK

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

  12. Como a variável Elemento de dados, selecione o xdm.variable.content você criou na Criar elementos de dados lição

    Atualizar esquema de variável

Agora, mapeie seu elementos de dados para o schema usado pelo seu objeto XDM. Você pode mapear para propriedades individuais ou objetos inteiros. Neste exemplo, você mapeia para propriedades individuais:

  1. Localize o campo eventType e selecione-o

  2. Insira o valor web.webpagedetails.pageViews

    note tip
    TIP
    Para entender quais valores devem ser preenchidos na variável eventType , você deve ir para a página do esquema e selecionar a eventType para exibir os valores sugeridos no painel direito. Você também pode inserir um novo valor, se necessário.
    Valores sugeridos de eventType na página esquemas

  3. Em seguida, localize o identityMap no esquema e selecione-o

  4. Mapear para o identityMap.loginID elemento de dados

    Atualizar mapa de identidade da variável

    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 a variável identityMap.loginID elemento de dados for nulo, a variável identityMap objeto não será enviado. É por isso que podemos defini-la em nossa "configuração global".

  5. Role para baixo até alcançar a web objeto

  6. Selecione para abri-lo

  7. Mapeie os seguintes elementos de dados para o correspondente web Variáveis XDM

    • web.webPageDetials.name para %page.pageInfo.pageName%
    • web.webPageDetials.server para %page.pageInfo.server%
    • web.webPageDetials.siteSection para %page.pageInfo.hierarchie1%

  8. Defina web.webPageDetials.pageViews.value como 1

    Atualizar conteúdo variável

    note tip
    TIP
    Embora nenhuma eventType definir como web.webpagedetails.pageViews nem web.webPageDetails.pageViews.value são necessários para que o Adobe Analytics processe um sinal como uma exibição de página. É útil ter uma maneira padrão de indicar uma exibição de página para outros aplicativos downstream.

  9. Selecionar Manter alterações e depois Salvar na próxima tela para concluir a criação da regra

Campos da página do produto

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

TIP
A ordem das regras determina qual regra é executada primeiro quando um evento é acionado. Se duas regras tiverem o mesmo tipo de evento, aquela com o número 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. Nomear como ecommerce - library loaded - set product details variables - 20

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

  4. Em Extensão, selecione Núcleo

  5. Em Tipo de evento, selecione Biblioteca carregada (início da página)

  6. Selecione para abrir Opções avançadas, digite 20. Esse valor de pedido garante a execução da regra após o all pages - library loaded - set global variables - 1 que define a configuração global.

  7. Selecionar Manter alterações

    Regras XDM do Analytics

  8. Em Condições, selecione para Adicionar

  9. Sair Tipo de lógica as Regular

  10. Sair Extensão as Núcleo

  11. Selecionar Tipo de condição as Caminho sem cadeia de caracteres de consulta

  12. À direita, ative a opção Regex alternar

  13. Em caminho igual a set /products/. Para o site de demonstração Luma, ele garante que a regra seja acionada somente nas páginas do produto

  14. Selecionar Manter alterações

    Regras XDM do Analytics

  15. Em Ações selecionar Adicionar

  16. Selecionar Adobe Experience Platform Web SDK extensão

  17. Selecionar Tipo de ação as Atualizar variável

  18. Selecionar xdm.variable.content como o Elemento de dados

  19. Role para baixo até commerce objeto

  20. Abra o productViews object e set value para 1

    configurar exibição de produto

    note tip
    TIP
    A configuração commerce.productViews.value=1 no XDM mapeia automaticamente para o prodView evento no Analytics

  21. Role para baixo até eventType e defina-o como commerce.productViews

    note note
    NOTE
    Como essa regra tem uma ordem maior, ela substituirá eventType definido na regra "configuração global". eventType O só pode conter um valor, e recomendamos configurá-lo com o evento mais valioso.

  22. Role para baixo e selecione productListItems matriz

  23. Selecionar Fornecer itens individuais

  24. Selecionar Adicionar item

    Configuração do evento de exibição de produto

    note caution
    CAUTION
    A variável productListItems é um array tipo de dados para que espere que os dados entrem como uma coleção de elementos. Devido à estrutura da camada de dados do site de demonstração Luma e como é possível visualizar apenas um produto de cada vez no site Luma, você adiciona itens individualmente. Ao implementar o em seu próprio site, dependendo da estrutura da camada de dados, talvez você possa fornecer um storage inteiro.

  25. Selecione para abrir Item 1

  26. Mapa productListItems.item1.SKU para %product.productInfo.sku%

    Variável de objeto XDM do SKU do produto

  27. Selecionar Manter alterações

  28. Selecionar Salvar para salvar a regra

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 do código personalizado cart.productInfo você criou loops anteriores por meio da variável digitalData.cart.cartEntries objeto de camada de dados no Luma e traduz no formato necessário do productListItems objeto 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 o productListItems estrutura (dica, deve corresponder).

IMPORTANT
Observe como as variáveis numéricas são convertidas, com valores de string na camada de dados, como price e qty reformatada para números no elemento de dados. Esses requisitos de formato são importantes para a integridade dos dados na Platform e são determinados durante o configurar schemas etapa. No exemplo, quantidade usa o Integer tipo de dados.
Tipo de dados de esquema XDM

Agora, vamos mapear nossa matriz para o objeto XDM:

  1. Crie uma nova regra chamada ecommerce - library loaded - set shopping cart variables - 20

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

  3. Em Extensão, selecione Núcleo

  4. Em Tipo de evento, selecione Biblioteca carregada (início da página)

  5. Selecione para abrir Opções avançadas, digite 20

  6. Selecionar Manter alterações

    Regras XDM do Analytics

  7. Em Condições, selecione para Adicionar

  8. Sair Tipo de lógica as Regular

  9. Sair Extensões as Núcleo

  10. Selecionar Tipo de condição as Caminho sem cadeia de caracteres de consulta

  11. À direita, não habilitar o Regex alternar

  12. Em caminho igual a set /content/luma/us/en/user/cart.html. Para o site de demonstração Luma, ele garante que a regra seja acionada somente na página do carrinho

  13. Selecionar Manter alterações

    Regras XDM do Analytics

  14. Em Ações selecionar Adicionar

  15. Selecionar Adobe Experience Platform Web SDK extensão

  16. Selecionar Tipo de ação as Atualizar variável

  17. Selecionar xdm.variable.content como o Elemento de dados

  18. Role para baixo até commerce e selecione para abri-lo.

  19. Abra o productListViews object e set value para 1

    configurar exibição de produto

    note tip
    TIP
    A configuração commerce.productListViews.value=1 no XDM mapeia automaticamente para o scView evento no Analytics

  20. Selecionar eventType e definida como commerce.productListViews

  21. Role para baixo e selecione productListItems matriz

  22. Selecionar Fornecer todo o array

  23. Mapear para cart.productInfo elemento de dados

  24. Selecionar Manter alterações

  25. Selecionar Salvar para salvar a regra

Crie duas outras regras para finalização e compra seguindo o mesmo padrão, com as diferenças abaixo:

Nome da regra: ecommerce - library loaded - set checkout variables - 20

  1. Condição: /content/luma/us/en/user/checkout.html

  2. Defina eventType como commerce.checkouts

  3. Defina commerce.checkout.value como 1

    note tip
    TIP
    É equivalente à configuração scCheckout evento no Analytics

Nome da regra: ecommerce - library loaded - set purchase variables - 20

  1. Condição: /content/luma/us/en/user/checkout/order/thank-you.html

  2. Defina eventType como commerce.purchases

  3. Defina commerce.purchases.value como 1

    note tip
    TIP
    É equivalente à configuração purchase evento no Analytics

  4. Definir commerce.order.purchaseID para o cart.orderId elemento de dados

  5. Definir commerce.order.currencyCode ao valor codificado USD

    Configuração de purchaseID para o Analytics

    note tip
    TIP
    É equivalente à configuração s.purchaseID e s.currencyCode variáveis no Analytics

  6. Role para baixo e selecione productListItems matriz

  7. Selecionar Fornecer todo o array

  8. Mapear para cart.productInfo.purchase elemento de dados

  9. Selecionar Manter alterações

  10. Selecionar Salvar

Quando terminar, você deverá ver as seguintes regras criadas.

Regras XDM do Analytics

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 o Enviar evento ação.

  1. À direita, selecione Adicionar regra para criar outra regra

  2. Atribua um nome à regra all pages - library loaded - send event - 50

  3. No Eventos , selecione Adicionar

  4. Use o Extensão principal e selecione Library Loaded (Page Top) como o Tipo de evento

  5. Selecionar Avançado e insira 50 in Pedido. Isso garantirá que essa regra seja acionada depois de todas as outras regras configuradas (que tinham 1 ou 20 como seu Pedido).

  6. Selecionar Manter alterações para retornar à tela principal da regra
    Selecionar acionador da biblioteca carregada

  7. No Ações , selecione Adicionar

  8. Como a variável Extensão, selecione Adobe Experience Platform Web SDK

  9. Como a variável Tipo de ação, selecione Enviar evento

  10. Como a variável XDM, selecione o xdm.variable.content elemento de dados criado na lição anterior

  11. Selecionar Manter alterações para retornar à tela principal da regra

    Adicionar a ação Enviar evento

  12. Selecionar Salvar para salvar a regra

    Salvar a regra

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. Ir para Fluxo de publicação na navegação à esquerda

  2. Selecionar Adicionar biblioteca

    Selecione Adicionar biblioteca

  3. Para o Nome, insira Luma Web SDK Tutorial

  4. Para o Ambiente, selecione Development

  5. Selecionar 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 o JavaScript básico exigido por todas as propriedades de tag da Web.

  6. Selecionar Salvar e criar para desenvolvimento

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

Próximo

NOTE
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Web SDK. Se você tiver dúvidas, quiser compartilhar feedback geral ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta Publicação de discussão da comunidade do Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4