---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/support/metrica/en/objects/reachgoal.md
  - https://yandex.com/support/metrica/es/objects/reachgoal.md
  - https://yandex.com/support/metrica/pt/objects/reachgoal.md
  - https://yandex.com/support/metrica/ru/objects/reachgoal.md
  - https://yandex.com/support/metrica/tr/objects/reachgoal.md
  - https://yandex.com/support/metrica/zh/objects/reachgoal.md
title: reachGoal
description: Transmite informações sobre um objetivo concluído.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/pt/llms.txt


# reachGoal

<!-- source: pt/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->
{% note warning %}

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 %}
<!-- endsource: pt/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->


Transmite informações sobre um [objetivo](https://yandex.com/support/metrica/pt/general/goals.md) concluído.

```javascript
ym(XXXXXXXX, 'reachGoal', target[, params[, callback[, ctx]]]);
```


#|
||
**Parâmetro**
|
**Valor padrão**
|
**Tipo**
|
**Descrição**
||
||
`alvo`[*](*parametr)
|
—
|
String
|
ID do objetivo. Definida na página de edição da tag ao [criar ou alterar](https://yandex.com/support/metrica/pt/general/goal-js-event.md) um objetivo do tipo "evento JavaScript".
||
||
`params`
|
—
|
Objeto
|
[Parâmetros de sessão](https://yandex.com/support/metrica/pt/data/visit-params-data.md)
||
||
`callback`
|
—
|
Função
|
A função callback a ser convocada após o envio dos dados de visualização de página
||
||
`ctx`
|
—
|
Objeto
|
Contexto acessado pela palavra-chave `this` na função callback
||
||
Campos para o objeto `params`:
|
>
|
>
|
>
||
||
`order_price ou price`
|
—
|
Duplo
|
[Custo do objetivo](https://yandex.com/support/metrica/pt/general/goal-js-event.md). Você pode especificar a receita em uma moeda ou em unidades convencionais.
||
||
`moeda`
|
—
|
String
|
Use este campo caso queira informar o custo do objetivo em moeda. O Yandex Metrica reconhece códigos monetários [ISO 4217](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=currency-codes) de três letras.

<!-- source: pt/_includes/ecommerce/data/id-about/currency-note.md -->
Se uma moeda diferente for informada, serão enviados valores nulos em vez de moedas e quantias.
<!-- endsource: pt/_includes/ecommerce/data/id-about/currency-note.md -->
||
|#


Caso queira rastrear a mesma ação em vários locais, basta [criar](https://yandex.com/support/metrica/pt/general/goal-js-event.md) um objetivo [evento JavaScript](https://yandex.com/support/metrica/pt/general/goal-js-event.md) e convocar o método `reachGoal` com a ID do objetivo cada vez que o objetivo for concluído.

Caso tenha vários eventos diferentes, crie um objetivo separado para cada evento e rastreie-os separadamente. Nesse caso, os objetivos devem possuir IDs diferentes.


{% note alert %}

Ao definir a ID do objetivo, não utilize os seguintes caracteres: / \ & # ? = ". Caso você queira adicionar um sinal de mais à ID, insira `%2B` no lugar do caractere +.

{% endnote %}


## Exemplos {#reach_goal_examples}

> Opções para incorporar objetivos no código-fonte do seu site:
> 
> 
> {% cut "Formulários" %}
> 
> 
> ```javascript
> ...
> <form action="" method="get" onsubmit="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;">
>     ...
> </form>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "Para um botão" %}
> 
> 
> ```javascript
> ...
> <form action="">
>     ...
>     <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;" value="Order" />
> </form>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "Links" %}
> 
> 
> ```javascript
> ...
> <a href="/preco.zip" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;">Lista de preços</a>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "Para um link com transmissão de parâmetros de usuário" %}
> 
> 
> ```javascript
> ...
> 
> <a href="/preco.zip" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME', goalParams, goalCallback); return true;">Lista de preços</a>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "Conclusão de objetivo ao carregar a página" %}
> 
> 
> Caso esteja usando um snippet de código **assíncrono** e o objetivo for convocado usando o elemento `script`, incorpore o seguinte código em qualquer seção da página:
> 
> 
> {% list tabs %}
> 
> - Solução genérica
> 
>   
>   ```javascript
>   
>   ```
>   
> 
> - Solução para jQuery
> 
>   
>   ```javascript
>   
>   ```
> 
> {% endlist %}
> 
> 
> 
> {% endcut %}
> 
> {% cut "Definição de receita por objetivo em um formulário" %}
> 
> 
> ```javascript
> ...
> <form action="">
>     ...
>     <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME', {order_price: '1000.35', currency: 'RUB'}); return true;" value="Order"/>
> </form>
> ...
> ```
> 
> {% cut "Como enviar dados de receita usando um seletor de atributos" %}
> 
> 
> Para transferir receita como `order_price` a partir de todas as páginas do site onde ela está definida por um seletor de atributo (por exemplo, `class` ou `id`), informe o nome do seletor junto com os dados de receita para o Yandex Metrica.
> 
> 1. Encontre no código do seu site o fragmento onde está definido um seletor desse tipo. Exemplo:
>     ```html
>     <div class="ORDER">Valor do pedido: <div class="PRICE">110</div> RUB</div>
>     ```
>     
> 1. Adicione o nome do seletor ao código do elemento que irá enviar a receita por objetivo para o Yandex Metrica. Exemplo:
>     ```javascript
>     <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'BUY', {order_price: document.querySelector('.PRICE')?.textContent}); return true;" value="Order" />
>     ```
>     
> 
> 
> {% endcut %}
> 
> 
> {% endcut %}
> 
> {% cut "Informar receita por objetivo dinamicamente usando JQuery" %}
> 
> 
> ```javascript
> 
> <form id="cart" action="/submit_order.php" method="post">
>     <div class="item">
>       <div class="name">Dakimakura com JoJo</div>
>       <div class="price">RUB 3.000,50</div>
>       <input class="price-input hidden" value="3.000,50" />
>     </div>
>     ...
> </form>
> ```
> 
> 
> {% endcut %}
> 
> 
> - `XXXXXXXX` — Número do contador.
> - `TARGET_NAME` — ID do objetivo.


<!-- source: pt/_includes/buttons/chat-button.md -->
[Fale conosco](https://yandex.com/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/objects/mail-button.md -->
<div class="cut-button">

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

Selecione uma pergunta para encontrar uma solução.

{% list tabs radio %}

- Nenhum dado relativo a uma origem determinada

  Os objetivos do Yandex Metrica funcionam da mesma forma para qualquer origem. Talvez nenhum usuário tenha concluído o objetivo a partir dessa origem ainda.      
      
  {% cut "As recomendações não ajudaram" %}      
    
  <!-- 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(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/1706/?&theme=Net dannyh po opredelennomu istochniku&iframe=1&lang=en">
    </iframe>
  </div>
    
  {% endcut %}
    
- Os dados relativos a um objetivo não correspondem aos dados reais
  
  Isso pode acontecer pelos seguintes motivos:
    - A condição do objetivo no Yandex Metrica não está cobrindo todas as possibilidades. Por exemplo, o objetivo foi definido como acessar a página de confirmação do pedido, mas o site também permite checkout instantâneo, sem passar por essa página.
    - O usuário do site possui algum plug-in de navegador que bloqueia a tag Yandex Metrica, por isso esse usuário não é contabilizado.
    - O usuário tem um sistema antivírus com configurações rigorosas de privacidade.
    - O usuário tem uma conexão de internet lenta, por isso a tag Yandex Metrica não chegou a carregar na página.      
      
  {% cut "As recomendações não ajudaram" %}      
      
  <!-- 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(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
          height="700"
          width="100%"
          frameborder="0"
          src="https://forms.yandex.com/surveys/1706/?&theme=Dannye po celi otlichayutsya ot realnyh dannyh&iframe=1&lang=en">
    </iframe>
  </div>
  
  {% endcut %}

- O objetivo não está funcionando
  
  <div style="padding: 15px;
      margin: 10px 0;
      background: #FFFFFF;
      border-radius: 10px;
      border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/10018080.618d9fdb2524ebc4674fd9e2a54cd71036f465a9/?&theme=Cel ne rabotaet&iframe=1&lang=en">
    </iframe>
  </div>

{% endlist %}

{% endcut %}

</div>

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

<!-- endsource: pt/_includes/styles/cut-button.md -->
<!-- endsource: pt/_includes/objects/mail-button.md -->

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

<div class="borderless-table">

#|
||
Links úteis

- [Tag de demonstração](https://metrica.yandex.com/r/dashboard?)
- [Adicionar uma tag](https://metrica.yandex.com/add/)
- [Configuração gratuita de tag](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&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.com/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 -->

[*parametr]: Parâmetro obrigatório.