events

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

Se estiver usando o objeto XDM, os eventos personalizados usarão os seguintes campos XDM:

  • Os eventos personalizados 1-100 são mapeados para xdm._experience.analytics.event1to100.event1 - xdm._experience.analytics.event1to100.event100.
  • Os eventos personalizados 101-200 são mapeados para xdm._experience.analytics.event101to200.event100 - xdm._experience.analytics.event101to200.event200.
  • Esse padrão se repete a cada 100 eventos para xdm._experience.analytics.event901to1000.event901 - xdm._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 xdm.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 xdm.commerce.productViews.value.
  • Os carrinhos são mapeados para xdm.commerce.productListOpens.value.
  • Adições ao carrinho são mapeadas para xdm.commerce.productListAdds.value.
  • As Remoções do carrinho são mapeadas para xdm.commerce.productListRemovals.value.
  • As exibições do carrinho são mapeadas para xdm.commerce.productListViews.value.
  • Os check-outs são mapeados para xdm.commerce.checkouts.value.
NOTE
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.

Se estiver usando o objeto de dados, todos os eventos usarão data.__adobe.analytics.events, seguindo a sintaxe da cadeia de caracteres do AppMeasurement. Se você definir esse campo, todos os eventos definidos no objeto XDM serão substituídos e não enviados para o Adobe Analytics.

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 a lista suspensa Extensão como Adobe Analytics e o Tipo de Ação como 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 incluir 10 neste campo incrementa event1 por 10 nos 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:

NOTE
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";
NOTE
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";
NOTE
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";
NOTE
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.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690