---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://yandex.ru/support/metrica/en/code/counter-initialize.md
  - https://yandex.ru/support/metrica/es/code/counter-initialize.md
  - https://yandex.ru/support/metrica/pt/code/counter-initialize.md
  - https://yandex.ru/support/metrica/ru/code/counter-initialize.md
  - https://yandex.ru/support/metrica/tr/code/counter-initialize.md
  - https://yandex.ru/support/metrica/zh/code/counter-initialize.md
  - href: pt/code/counter-initialize.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Inicialização da tag
description: Como inicializar uma tag e parâmetros de inicialização; como habilitar uma tag usando o sistema de gerenciamento de tags.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/metrica/pt/llms.txt


# Inicialização da tag


{% note tip %}

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.

{% endnote %}


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:
```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` 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:

```javascript
ym(XXXXXXXX, "init", {clickmap: true, webvisor: true});
```

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

```javascript
ym(XXXXXXXX, "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](https://yandex.ru/support/metrica/pt/objects/method-reference.md).

## 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](https://yandex.ru/support/metrica/pt/webvisor/iframe-support.md) 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](https://yandex.ru/support/metrica/pt/ecommerce/about.md).

- `true` — Habilitar a coleta de dados de e-commerce. Equivalente ao valor `dataLayer` (se a opção estiver [habilitada no Yandex Metrica](https://yandex.ru/support/metrica/pt/data/e-commerce.md#3)). 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](https://yandex.ru/support/metrica/pt/objects/params-method.md).
||
||
`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](https://yandex.ru/support/metrica/pt/objects/user-params.md).
||
||
`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](https://yandex.ru/support/metrica/pt/webvisor/iframe-support.md) 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 {#check-initialize}

É 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(XXXXXXXX, "init", {triggerEvent: true});
```
 Para jQuery, é possível usar o seguinte exemplo de código até o momento de inicialização da tag:

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




<!-- source: pt/_includes/buttons/chat-button.md -->
[Fale conosco](https://yandex.ru/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: pt/_includes/styles/href-to-button.md -->

<!-- endsource: pt/_includes/styles/href-to-button.md -->
<!-- endsource: pt/_includes/buttons/chat-button.md -->

<!-- source: pt/_includes/support-2.md -->
<div class="cut-button">

{% cut "Escrever um e-mail" %}

<!-- source: pt/_includes/popup/id-popup/wrong-sup.md -->
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.
<!-- endsource: pt/_includes/popup/id-popup/wrong-sup.md -->

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.ru/surveys/10011833/?&iframe=1&lang=en">
  </iframe>
</div>

{% endcut %}

</div>

<!-- source: pt/_includes/styles/cut-button.md -->

<!-- endsource: pt/_includes/styles/cut-button.md -->
<!-- endsource: pt/_includes/support-2.md -->

<!-- source: pt/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Links úteis

- [Tag de demonstração](https://metrika.yandex.com/r/dashboard?)
- [Adicionar uma tag](https://metrika.yandex.com/add/)
- [Configuração gratuita de tag](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_ru&utm_medium=cpc&utm_campaign=1)
- [API do Yandex Metrica](https://tech.yandex.com/metrika/)
- [Sugerir uma idea](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Debater no Telegram](https://t.me/yandexmetrika)
|
Treinamento online

- [Obter um certificado do Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Fazer um curso](https://yandex.ru/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: pt/_includes/styles/table-style.md -->

<!-- endsource: pt/_includes/styles/table-style.md -->
<!-- endsource: pt/_includes/footer-links.md -->