Transmissão de eventos

A maior parte dos dados de sessão é coletada automaticamente pela tag Yandex Metrica. No entanto, há grandes chances de você querer complementar esses dados com os seus próprios dados. Por exemplo, você pode estar interessado em estatísticas sobre quais itens específicos foram comprados ou quais ações os usuários que estavam logados realizaram.

O Yandex Metrica permite que você conecte um conjunto personalizado de dados a uma sessão. Esses conjuntos são chamados de parâmetros de evento. Esses dados podem ser mostrados em relatórios ou usados como condições para dimensões e segmentação.

Os parâmetros de sessão são transmitidos para o armazenamento do contador usando a API JavaScript. Os dados podem ser enviados durante a inicialização da tag ou a qualquer momento antes do tempo-limite da sessão esgotar.

Durante a inicialização da tag, os parâmetros de sessão são especificados no parâmetro params.

Para transferir parâmetros de evento durante a sessão de um usuário no seu site, use o método params ou um argumento opcional dos métodos extLink, file, hit, reachGoal.

Os parâmetros de evento são transmitidos como objetos ou arranjo de objetos.

Transferência e processamento de dados

Os dados são transferidos para o Yandex Metrica como objetos JavaScript.

A solicitação de dados enviada para o Yandex Metrica pode conter no máximo 8 KB (8.192 caracteres). Quando você envia dados hierarquicamente estruturados, os relatórios do Yandex Metrica exibem até 10 níveis de aninhamento. Se, no espaço de uma única sessão, um parâmetro tiver sido transmitido com diferentes valores, o Yandex Metrica exibirá todos os valores. Observe que é possível enviar até 512 parâmetros em uma só sessão. Para mais informações, consulte Restrições.

O valor do campo é processado da seguinte forma, a depender do seu tipo:

• objeto — Cria um novo ramo de árvore para cada chave de objeto e invoca o algoritmo recursivamente para cada valor.
• string — Conta o número de vezes que cada valor da string ocorre.
• número — Calcula o valor total e o médio de todos os números.
• arranjo — Cria um ramo de árvore [Parâmetros], calcula o número de vezes que o valor é um arranjo e invoca o algoritmo recursivamente para cada item do arranjo.
• true, false ou null — Calcula o número de vezes que cada valor ocorre.

Exemplo de dados transferidos:

// Exemplo de transferência de objeto. Máxima profundidade de aninhamento: 10 níveis. 
ym(XXXXXX, "params", { 
  level1_1: {
    level2_1: {
      level3_1: "exemplo1" ,
      level3_2: "exemplo2",
    },
    ...
    level2_2: "exemplo3"
  }
})

Onde:

• XXXXXX é o número da tag.
• level1_1, level1_2, level2_1 — estrutura dos parâmetros de evento.
• exemplo1, exemplo2, exemplo3 — valores de parâmetros.

Para mais exemplos, consulte a seção Exemplos de envio de parâmetros de sessão.

Relatórios por parâmetros

Os eventos são transferidos para o Yandex Metrica como dimensões ou objetivos. Os números que são calculados pelo processamento dos dados são as métricas.

Para visualizar estatísticas sobre eventos transmitidos, use o relatório "Parâmetros de evento" ou o relatório "Parâmetros de sessão". Você também pode usar os parâmetros como condição para a criação de segmentos em outros relatórios do Yandex Metrica.

Fale conosco