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 |
|
|
Booleano | Número |
Taxa de rejeição precisa O parâmetro pode aceitar os seguintes valores:
|
|
|
Booleano |
Se deve registrar conteúdos de iframe sem uma tag na janela derivada. |
|
|
Booleano |
Se deve coletar dados para um mapa de cliques |
|
|
Booleano |
Se deve desativar o envio automático de dados durante a inicialização da tag. |
|
|
Booleano | String | Arranjo |
Coleta de dados de E-commerce.
|
|
: |
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. |
|
— |
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. |
|
|
Booleano |
Rastreamento de mudanças no hash na barra de endereços do navegador |
|
|
Booleano |
Rastrear cliques em links de saída. |
|
— |
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 |
|
|
Número |
Tipo de tag. 1 para RPY |
|
|
Booleano |
Se deve usar a Reprise de Sessão |
|
|
Booleano |
Se deve verificar se a tag está pronta. |
|
|
Booleano |
Registros de título. Se os títulos contiverem dados privados, o parâmetro deve ser definido como |
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');
});
Habilitar uma tag usando o sistema de gerenciamento de tags
Também é possível habilitar uma tag Yandex Metrica usando sistemas de gerenciamento de tags (também chamados de despachantes de tag ou contêineres de tag). Esses sistemas permitem armazenar todo o código HTML/JavaScript necessário em um servidor externo e conectá-lo a páginas da web usando pequenos snippets de código. Ou seja, você poderá fazer mudanças no código conectado sem alterar o código das páginas.
Normalmente, os sistemas de gerenciamento de tags aceitam dois tipos de código integrado para tags: JavaScript e imagem. O Yandex Metrica aceita ambos os tipos de tag. Para integrá-los usando sistemas de gerenciamento de tags, utilize os snippets de código da página Configurações (na aba Tag).
<script type="text/javascript">
(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(XXXXXX, "init", {<initialization parameters>});
</script>
<img src="https://mc.yandex.ru/watch/XXXXXX" style="position:absolute; left:-9999px;" alt="" />
Aqui, XXXXXX
é o número da tag Yandex Metrica.
Os dados coletados podem variar, a depender do tipo de código da tag. Para saber mais, consulte Dados coletados pela tag Yandex Metrica.
Dentro de cada tag, é possível conectar vários contadores de uma só vez, semelhante ao que é descrito na seção Instalação de várias tags em um site.
Links úteis |
Treinamento online |