events

Última atualização em 2024-01-26
  • Tópicos
  • Variables
    Exibir mais informações sobre este tópico
  • Criado para:
  • Admin
    Developer

Dimensões e métricas são componentes vitais para os relatórios. A variável events é responsável pela coleta de dados de muitas métricas do site. Eventos normalmente incrementam métricas em relatórios.

Antes de implementar eventos, você deve criá-los e configurá-los em Eventos-bem sucedidos nas configurações do Conjunto de relatórios. Se você planeja usar eventos personalizados em ocorrências de rastreamento de link, verifique se linkTrackVars e linkTrackEvents estão definidos corretamente.

Evento usando o SDK da Web

Os eventos personalizados são mapeados para o Adobe Analytics nos seguintes campos XDM:

  • Os eventos personalizados 1-100 são mapeados para _experience.analytics.event1to100.event1 - _experience.analytics.event1to100.event100.
  • Os eventos personalizados 101-200 são mapeados para _experience.analytics.event101to200.event100 - _experience.analytics.event101to200.event200.
  • Esse padrão se repete a cada 100 eventos para _experience.analytics.event901to1000.event901 - _experience.analytics.event901to1000.event1000. eventx.value é usado para especificar a quantidade a ser incrementada. eventx.id é usado para serialização.
  • Os pedidos são mapeados para commerce.purchases.value.
  • As unidades são mapeadas para a soma de todos os campos productListItems[].quantity.
  • A receita é mapeada para a soma de todos os campos productListItems[].priceTotal.
  • As Exibições do produto são mapeadas para commerce.productListViews.value.
  • Os carrinhos são mapeados para commerce.productListOpens.value.
  • Adições ao carrinho são mapeadas para commerce.productListAdds.value.
  • As Remoções do carrinho são mapeadas para commerce.productListRemovals.value.
  • As exibições do carrinho são mapeadas para commerce.productListViews.value.
  • Os check-outs são mapeados para commerce.checkouts.value.
OBSERVAÇÃO

Se um evento for definido em productListItems (por exemplo, productListItems._experience.analytics.event1.value) e o evento ainda não estiver nesse campo, ele será adicionado automaticamente a esse campo.

Evento usando a extensão do Adobe Analytics

Você pode definir eventos ao configurar a extensão do Analytics (variáveis globais) ou em Regras.

  1. Faça logon na Coleção de dados da Adobe Experience Platform usando suas credenciais da Adobe ID.
  2. Clique na propriedade de tag desejada.
  3. Vá até a guia Regras e clique na regra desejada (ou crie uma regra).
  4. Em Ações, clique em uma ação Adobe Analytics - Definir variáveis ou clique no ícone “+”.
  5. Defina o Extensão para o Adobe Analytics e a caixa de diálogo Tipo de ação para Definir variáveis.
  6. Localize a seção Eventos.

Vários recursos estão disponíveis:

  • Uma lista suspensa que permite selecionar o evento a ser incluído
  • um campo de texto opcional para serialização. Consulte Serialização de eventos para obter mais informações.
  • Um campo de texto opcional para um valor de evento. Você pode incluir moeda para eventos de moeda, ou um número inteiro para eventos que não sejam de moeda para incrementá-lo várias vezes. Por exemplo, selecionar event1 na lista suspensa e incluindo 10 neste campo incrementa event1 por 10 em relatórios.
  • Um botão para adicionar outro evento. Você pode adicionar quantos eventos desejar a uma única regra dentro do razoável.

s.events no AppMeasurement e no editor de código personalizado da extensão do Analytics

A variável s.events é uma string que contém uma lista de eventos delimitada por vírgulas para inclusão na ocorrência. A variável permite até 64k bytes, permitindo efetivamente quantos eventos forem necessários para uma ocorrência. Os valores válidos incluem:

OBSERVAÇÃO

Essa variável diferencia maiúsculas e minúsculas. Evite usar maiúsculas e minúsculas incorretas em valores de evento para garantir uma coleta de dados precisa.

// Set the events variable to a single value
s.events = "event1";

// Set the events variable to multiple values
s.events = "event1,event13,purchase";

Incrementar eventos contadores várias vezes

Se desejar, é possível contar eventos personalizados mais de uma vez. Atribua um número inteiro ao evento desejado dentro da string. Os eventos criados nas configurações do conjunto de relatórios são eventos contadores por padrão.

// Count event1 ten times
s.events = "event1=10";

// Count event1 twice and event2 once
s.events = "event1=2,event2";
OBSERVAÇÃO

Os eventos contadores não suportam valores decimais ou de moeda. Use eventos de moeda para moedas ou eventos numéricos para valores decimais.

Usar eventos de moeda

Você pode alterar um evento personalizado para usar moeda em vez de números inteiros. Os eventos de moeda são convertidos automaticamente para a moeda do conjunto de relatórios se ela e a variável currencyCode não coincidirem. Eles são úteis para ajudar a calcular custos de envio, descontos ou reembolsos. Você pode definir eventos de moeda na variável products se quiser atribuir o evento somente a esse produto.

Antes de implementar eventos de moeda, defina o evento desejado como “Moeda” em Eventos bem-sucedidos nas configurações do Conjunto de relatórios.

// Send $9.99 USD in event1 using the events variable. Make sure the event type for event1 is Currency in Report suite settings
s.currencyCode = "USD";
s.events = "event1=9.99";

// Send $9.99 USD in event1 using the products variable. Make sure the event type for event1 is Currency in Report suite settings
s.currencyCode = "USD";
s.events = "event1";
s.products = "Example category;Example product;1;0;event1=9.99";
OBSERVAÇÃO

Se você definir um valor de moeda na variável events e na products, o valor de moeda em events será usado. Evite definir valores de moeda nas variáveis events e products.

Usar eventos numéricos

É possível alterar um evento personalizado para aceitar valores decimais em vez de números inteiros. Os eventos numéricos se comportam de forma semelhante aos eventos de moeda, exceto por não usarem a conversão de moeda. Você pode definir eventos numéricos na variável products se quiser atribuir o evento somente a esse produto.

Antes de implementar eventos numéricos, defina o evento desejado como “Numérico” em Eventos bem-sucedidos nas configurações do Conjunto de relatórios.

// Send 4.5 in event1 using the events variable. Make sure the event type for event1 is Numeric in Report suite settings
s.events = "event1=4.5";

// Send 4.5 in event1 using the products variable. Make sure the event type for event1 is Numeric in Report suite settings
s.events = "event1";
s.products = "Example category;Example product;1;0;event1=4.5";
OBSERVAÇÃO

Se você definir um valor numérico na variável events e na products, o valor numérico em events será usado. Evite definir valores numéricos nas variáveis events e products.

Nesta página