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
.
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.
- Faça logon na Coleção de dados da Adobe Experience Platform usando suas credenciais da Adobe ID.
- Clique na propriedade de tag desejada.
- Vá até a guia Regras e clique na regra desejada (ou crie uma regra).
- Em Ações, clique em uma ação Adobe Analytics - Definir variáveis ou clique no ícone “+”.
- Defina a lista suspensa Extensão como Adobe Analytics e o Tipo de Ação como Definir Variáveis.
- 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 incluir10
neste campo incrementaevent1
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:
event1
eevent1000
: eventos personalizados, definidos como você desejar. Registre como você usa cada evento no documento de design de solução da sua organização. O número de eventos disponíveis depende do contrato do Analytics de sua organização. A maioria das organizações com contratos não herdados tem 1000 eventos personalizados disponíveis. Entre em contato com a equipe de conta do Adobe se não tiver certeza de quantos eventos personalizados estão disponíveis para você.purchase
: incrementa a métrica "Pedidos" em 1 e obtém valores definidos na variávelproducts
para calcular "Unidades" e "Receita". Consulte Evento de compra para obter mais informações.prodView
: incrementa a métrica “Visualizações de produto”.scOpen
: incrementa a métrica “Carrinhos”.scAdd
: incrementa a métrica “Adições ao carrinho”.scRemove
: incrementa a métrica “Remoções do carrinho”.scView
: incrementa a métrica “Visualizações do carrinho”.scCheckout
: incrementa a métrica “Check-outs”.
// 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";
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";
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";
events
e na products
, o valor numérico em events
será usado. Evite definir valores numéricos nas variáveis events
e products
.