---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://yandex.com/support/metrica/en/objects/file.md
  - https://yandex.com/support/metrica/es/objects/file.md
  - https://yandex.com/support/metrica/pt/objects/file.md
  - https://yandex.com/support/metrica/ru/objects/file.md
  - https://yandex.com/support/metrica/tr/objects/file.md
  - https://yandex.com/support/metrica/zh/objects/file.md
  - href: ru/objects/file.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: file
description: Отправка информации о загрузке файла.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/ru/llms.txt


# file

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

Для работы с JavaScript API необходимы навыки работы с HTML и JavaScript. Если вы не обладаете такими навыками, обратитесь к разработчику или вебмастеру вашего сайта.

{% endnote %}
<!-- endsource: ru/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->


Отправка информации о загрузке файла.

Собранные данные используются при формировании отчета [Загрузки файлов](https://yandex.com/support/metrica/ru/content/file-downloads.md).

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


#|
||
**Параметр**
|
**Значение по умолчанию**
|
**Тип**
|
**Описание**
||
||
`url`[*](*Параметр)
|
—
|
String
|
URL загруженного файла
```javascript ym(XXXXXXXX, 'file', 'http://example.com/files/price.zip'); ```
||
||
`options`
|
—
|
Object
|
—
||
||
Поля объекта `options`
|
>
|
>
||
||
`options.callback`
|
—
|
Function
|
Callback-функция, вызываемая после отправки данных о загрузке файла
||
||
`options.ctx`
|
—
|
Object
|
Контекст, доступный в callback-функции по ключевому слову `this`
||
||
`options.params`
|
—
|
Object
|
Параметры визита
||
||
`options.referer`
|
—
|
String
|
URL с которого посетитель загрузил файл
||
||
`options.title`
|
`document.title`
|
String
|
Заголовок текущей страницы
||
||
Поля объекта `options.params`:
|
>
|
>
||
||
`order_price`
|
—
|
Double
|
[Доход по цели](#price). Вы можете указать цену как в валюте, так и в условных единицах
||
||
`currency`
|
—
|
String
|
Используйте это поле, если хотите передать цену цели в валюте. Метрика распознает трехбуквенный [код валюты по ISO 4217](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=currency-codes).

<!-- source: ru/_includes/ecommerce/data/id-about/currency-note.md -->
Если передается другая валюта, будут отправлены нулевые значения вместо валюты и суммы
<!-- endsource: ru/_includes/ecommerce/data/id-about/currency-note.md -->
||
|#

<sup >*</sup> Обязательный параметр.

Параметры `url` и `options.referer` допускают использование URL-путей, без указания схемы (протокола) и хоста.

В этом случае, если путь начинается с символа `/`, URL считается заданным от корня хоста.
```javascript
ym(XXXXXXXX, 'file', '/downloads/price.zip');
```

В противном случае путь считается заданным относительно текущей страницы.

```javascript
ym(XXXXXXXX, 'file', '../downloads/price.zip', {referer: 'index.html?page=goods'});
```

## Доход по цели {#price}

Если загрузка файла является одной из установленных на вашем сайте целей, вы можете [передать в параметрах метода доход](https://yandex.com/support/metrica/ru/general/price-goal.md).

Пример:
```javascript
var goalParams =
{
   order_price: 1000.35,
   currency: "RUB"
};
ym(XXXXXXXX, 'file', '../downloads/price.zip', goalParams)
```

<!-- source: ru/_includes/buttons/chat-button.md -->
[Написать в чат](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

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

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

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

{% cut "Написать письмо" %}

<!-- source: ru/_includes/popup/id-popup/wrong-sup.md -->
Обратите внимание: служба поддержки не обзванивает пользователей. Не следуйте указаниям людей, которые вам звонят и представляются службой поддержки Яндекс Метрики.
<!-- endsource: ru/_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: ru/_includes/styles/cut-button.md -->

<!-- endsource: ru/_includes/styles/cut-button.md -->
<!-- endsource: ru/_includes/buttons/support-button.md -->

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

<div class="borderless-table">

#|
||
Полезные ссылки

- [Демосчетчик](https://metrica.yandex.com/r/dashboard?)
- [Добавить счетчик](https://metrica.yandex.com/add/)
- [Бесплатная настройка счетчика](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [API Яндекс Метрики](https://tech.yandex.com/metrika/)
- [Предложить идею](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Обсудить в Telegram](https://t.me/yandexmetrika)
|
Онлайн-обучение

- [Получить сертификат по Яндекс Метрике](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Пройти обучающий курс](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

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

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

[*Параметр]: <sup >*</sup> Обязательный параметр.