file

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

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

Собранные данные используются при формировании отчета Загрузки файлов.

ym(XXXXXX, 'file', url[, options]);

Параметр

Значение по умолчанию

 Тип

Описание
url * —

String

URL загруженного файла.

ym(XXXXXX, '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

Доход по цели. Вы можете указать цену как в валюте, так и в условных единицах.
currency —

String

Используйте это поле, если хотите передать цену цели в валюте. Метрика распознает трехбуквенный код валюты по ISO 4217.

Если передается другая валюта, будут отправлены нулевые значения вместо валюты и суммы.

Параметр

Значение по умолчанию

 Тип

Описание
url * —

String

URL загруженного файла.

ym(XXXXXX, '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

Доход по цели. Вы можете указать цену как в валюте, так и в условных единицах.
currency —

String

Используйте это поле, если хотите передать цену цели в валюте. Метрика распознает трехбуквенный код валюты по ISO 4217.

Если передается другая валюта, будут отправлены нулевые значения вместо валюты и суммы.

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

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

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

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

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

Доход по цели

Если загрузка файла является одной из установленных на вашем сайте целей, вы можете передать в параметрах метода доход. Подробно о доходе по цели

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

Обратите внимание: служба поддержки не обзванивает пользователей. Не следуйте указаниям людей, которые вам звонят и представляются службой поддержки Яндекс Метрики.