---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://yandex.com/support/metrica/en/objects/extlink.md
  - https://yandex.com/support/metrica/es/objects/extlink.md
  - https://yandex.com/support/metrica/pt/objects/extlink.md
  - https://yandex.com/support/metrica/ru/objects/extlink.md
  - https://yandex.com/support/metrica/tr/objects/extlink.md
  - https://yandex.com/support/metrica/zh/objects/extlink.md
  - href: pt/objects/extlink.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/pt/llms.txt

# extLink

<!-- 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 -->


Envio de informações sobre tráfego de links externos.

Os dados coletados são usados para gerar [mapas de cliques](https://yandex.com/support/metrica/pt/behavior/link-map.md) e relatórios de [Cliques de saída](https://yandex.com/support/metrica/pt/content/external-links.md).

```javascript
ym(XXXXXXXX, 'extLink', url[, options]);
```


#|
||
**Parâmetro**
|
**Valor padrão**
|
**Tipo**
|
**Descrição**
||
||
`url`[*](*Параметр)
|
—
|
String
|
A URL da página de destino
||
||
`opções`
|
—
|
Objeto
|

||
||
campos de `opções`
|
>
|
>
||
||
`options.callback`
|
Tipo: Função
|
—
|
A função callback, chamada após o envio de dados sobre um download de arquivo
||
||
`options.ctx`
|
—
|
Objeto
|
Contexto acessado pela palavra-chave `this` na função callback
||
||
`options.params`
|
—
|
Objeto
|
Parâmetros de sessão
||
||
`options.title`
|
`document.title`
|
String
|
Título da página atual
||
||
Campos para o objeto `params`:
|
>
|
>
||
||
`order_price`
|
—
|
Duplo
|
[Receita por objetivo](#price). Você pode estipular o custo em alguma 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 -->
||
|#

<sup >*</sup> Parâmetro obrigatório.

> # Exemplo
> 
> ```javascript
> ym(XXXXXXXX, 'init', {});
> 
> //...
> 
> ym(XXXXXXXX, 'extLink', 'https://yandex.com');
> ```

## Receita por objetivo {#price}

Se um clique de saída for um dos objetivos configurados no seu site, é possível transmitir a receita nos parâmetros do método. [Detalhes sobre receita por objetivo](https://yandex.com/support/metrica/pt/general/price-goal.md)
Exemplo:
```javascript
var goalParams =
{
   order_price: 1000.35,
   currency: "RUB"
};
ym(XXXXXXXX, 'extLink', 'https://yandex.com', goalParams)
```

<!-- 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/buttons/support-button.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(--g-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/1706/?&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/buttons/support-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 -->

[*Параметр]: <sup >*</sup> Parâmetro obrigatório.