Inicialização da tag

Sugestão

Trabalhar com a API JavaScript exige conhecimentos de HTML e JavaScript. Se você não conhece essas linguagens, entre em contato com o desenvolvedor ou webmaster do seu site.

Acesse https://mc.yandex.ru/metrika/tag.js e baixe a biblioteca JavaScript, que é necessária para que a tag funcione.

O código para habilitar a biblioteca está disponível na página de edição da tag. A biblioteca pode ser carregada de forma assíncrona (recomendado) ou síncrona, mas sua funcionalidade permanece a mesma.

Para criar e gerenciar uma tag, use o método ym. Ele é criado no código de download:

(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
(window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");

ym requer a ID da tag e o nome da função que está sendo chamada. O método também pode informar argumentos da função invocada. Por exemplo, para inicializar uma tag, é necessário informar a ID da tag, o nome da função init e um arranjo de parâmetros:

ym(XXXXXX, "init", {clickmap: true, webvisor: true});

Se você não quiser informar parâmetros para a função, a inicialização ficará assim:

ym(XXXXXX, "init", {});

A parte do código que contém os parâmetros de inicialização principais é gerada na página Configurações. A lista completa de parâmetros de inicialização é mostrada na tabela.

As funções que podem ser chamadas pelo método ym são descritas nas referências de métodos.

Parâmetros de inicialização da tag

Nome	Valor padrão	Tipo	Descrição
`accurateTrackBounce`	`true`	Booleano \| Número	Taxa de rejeição precisa O parâmetro pode aceitar os seguintes valores: `true` — Habilitar a taxa de rejeição precisa, com um evento de não rejeição registrado após 15.000 ms (15 s). `false` — Não habilitar a taxa de rejeição precisa. `<N>` (inteiro) — Habilitar a taxa de rejeição precisa. Eventos de não rejeição são registrados após `<N> ms`.
`childIframe`	`false`	Booleano	Se deve registrar conteúdos de iframe sem uma tag na janela derivada.
`clickmap`	`true`	Booleano	Se deve coletar dados para um mapa de cliques
`defer`	`false`	Booleano	Se deve desativar o envio automático de dados durante a inicialização da tag.
`ecommerce`	`false`	Booleano \| String \| Arranjo	Coleta de dados de E-commerce. `true` — Habilitar a coleta de dados de e-commerce. Equivalente ao valor `dataLayer` (se a opção estiver habilitada no Yandex Metrica). Os dados são transmitidos através de um arranjo JavaScript chamado `dataLayer` no namespace global (`window.dataLayer`). `false` — Desabilitar a coleta de dados de E-commerce. `<objectName>` (String) — Habilitar a coleta de dados de E-commerce. Os dados são transmitidos através de um arranjo JavaScript chamado `<objectName>` no namespace global (`window.<objectName>`). `<array>` (Arranjo) — Habilitar a coleta de dados de E-commerce. Os dados são transmitidos através de um `<array>` JavaScript
`params`	—	Objeto \| Arranjo	Parâmetros de sessão transmitidos durante a inicialização da tag. Para transmitir parâmetros de sessão a qualquer outro momento, use o método params.
`userParams`	—	Objeto	Parâmetros dos usuários do site transmitidos na inicialização da tag. Para transmitir parâmetros de usuário a qualquer outro momento, use o método userParams.
`trackHash`	`false`	Booleano	Rastreamento de mudanças no hash na barra de endereços do navegador
`trackLinks`	`true`	Booleano	Rastrear cliques em links de saída.
`trustedDomains`	—	Arranjo	Indica um domínio confiável para gravação do conteúdo de um iframe derivado Contém o endereço de domínio da janela matriz
`tipo`	`0`	Número	Tipo de tag. 1 para RPY.
`webvisor`	`false`	Booleano	Se deve usar a Reprise de Sessão
`triggerEvent`	`false`	Booleano	Se deve verificar se a tag está pronta.
`sendTitle`	`true`	Booleano	Registros de título. Se os títulos contiverem dados privados, o parâmetro deve ser definido como `false` durante a inicialização: `sendTitle: false`.
`ssr`	`true`	Booleano	Um parâmetro técnico utilizado pela tag de anúncio.

Checagem da inicialização da tag

É possível usar um evento especial JavaScript para descobrir se a tag está pronta para operar. No entanto, você precisa adicionar o parâmetro triggerEvent definido como true no snippet de código:

ym(XXXXXX, "init", {triggerEvent: true});

Para jQuery, é possível usar o seguinte exemplo de código até o momento de inicialização da tag:

jQuery(document).on('yacounterXXXXXXinited', function () {
    console.log('tag yaCounterXXXXXX ready');
});

Fale conosco

Escrever um e-mail

Observe, por gentileza, que nossa equipe de suporte jamais iniciará uma chamada com você. Se alguém ligar para você e se apresentar como a equipe de suporte do Yandex Metrica, não siga as instruções dessa pessoa.

Links úteis

Treinamento online

Este artigo foi útil?

Estatísticas de termos de pesquisa de navegadores com restrições de cookies de terceiros

Seguinte

Métodos