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.

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.

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.