Как настроить цель скачивания файла в Метрике

Настроить цель скачивания файла в Метрике можно так: выберите нужный файл и проверьте достижение после контрольного клика — ^[1], при этом достижение цели «Скачивание файла» фиксируется при клике по ссылке на файл и само по себе не подтверждает сохранение или прочтение документа, а понять, как настроить цель скачивания файла в интерфейсе, помогает выбор нужного файла и контрольный клик.

Если цель нужна только под конкретный PDF, посетитель нажал на ссылку — достижение зафиксировано; отменил загрузку в диалоговом окне — с точки зрения Метрики клик уже был. Дальше в отчётах Конверсии и Загрузки файлов видно, сколько раз нажали. Про то, какие действия вообще считаются целями, есть отдельный разбор в статье про таксономию событий.

Создание цели «Скачивание файла» по шагам

Последовательность из интерфейса Метрики:

В левом меню счётчика откройте раздел Цели. Нажмите Добавить цель — ^[1].
Выберите тип Скачивание файла.
В поле Название укажите имя цели. Оно попадёт в отчёты — лучше коротко и однозначно: «PDF-чеклист».
Выберите охват файлов: Любой файл или Конкретный файл.
Для конкретного файла впишите имя вручную и проверьте написание. Создание цели заканчивается кнопкой Добавить цель — ^[1].

Сбор статистики по новой цели начинается в течение нескольких минут после сохранения.

Полезно сразу договориться о номенклатуре целей на счётчике, иначе чужие формулировки быстро разойдутся с тем, что вы вкладывали в измерение. Об этом — заметка про дубли целей.

Конкретный файл или любое скачивание: как задать и чем отличаются

Если на сайте размещены прайс, лицензионное соглашение или другие файлы, цель позволяет отследить, как часто посетители их скачивают — ^[1].

Два режима отличаются тем, что попадает в цель:

Любой файл на сайте работает для самых популярных типов: документ, текст, исполняемый, презентация, приложения, сжатый, видео, аудио — ^[1]. Поддерживаемые расширения: 3GP, 7Z, AAC, AVI, APK, CSV, DJVU, DOCX, EXE, FLAC, FLV, GZ, KEY, MIDI, MKA, MKV, MP3, MP4, MPEG, MOV, MSI, OGG, PDF, PKG, PPS, PPT, PPTX, RAR, RTF, TXT, WAV, WMA, WMV, WMF, XLSX, ZIP — ^[1].
Конкретный файл ищет совпадение названия в ссылках: в поле вводят название файла с расширением или без, например file или file.pdf — ^[1]. Можно задать любое расширение, и при необычном имеет смысл проверить, работает ли с ним цель — ^[1].

Поле условия — это имя файла, а не полный URL. Полный адрес нужен, чтобы проверить саму ссылку на странице и свериться в отладочной панели.

Учебный пример

На странице есть две ссылки для скачивания:

нужная — на чек-лист: https://example.com/files/checklist.pdf
лишняя — на каталог: https://example.com/files/catalog.pdf

Задача — считать клики только по чек-листу. Цель «Любой файл» тут не подходит: она поймает обе ссылки, потому что обе имеют расширение .pdf из списка.

Что вводим в условие и что ожидаем увидеть при проверке:

Ссылка в HTML	Имя в условии цели	Контрольный клик	Запись файлового события в Console	Достижение цели «PDF-чеклист» в отчёте «Конверсии»
`https://example.com/files/checklist.pdf`	`checklist.pdf`	по чек-листу	ожидается строка вида `File. … Url: https://example.com/files/checklist.pdf`	ожидается достижение этой цели
`https://example.com/files/catalog.pdf`	не указано	по каталогу	возможна строка `File.` про `catalog.pdf` — счётчик видит скачивание	достижения этой цели не ожидается

Условие ловит совпадение checklist.pdf в адресе ссылки. Ссылка на catalog.pdf такого совпадения не даёт, и выбранная цель по ней не срабатывает. Полный URL https://example.com/files/checklist.pdf при этом нужен только для сверки на странице и в отладочной панели — в поле условия вводят имя checklist.pdf, как в колонке выше.

Разделять стоит две вещи. Строка File. в Console говорит, что счётчик зарегистрировал скачивание файла. Достижение конкретной цели «PDF-чеклист» — это отдельный факт, и его смотрят в отчёте. Клик по каталогу может дать строку File. про catalog.pdf, потому что файл скачивается; но цели на checklist.pdf это не касается.

Проверка идёт двумя контрольными кликами и сверкой в отчёте:

Открыть страницу с _ym_debug=2, кликнуть по ссылке на чек-лист и убедиться, что в Console появилась строка File. со ссылкой на checklist.pdf, а в отчёте «Конверсии» по цели «PDF-чеклист» появилось достижение.
Открыть страницу с _ym_debug=2 заново, кликнуть по ссылке на каталог и проверить, что достижения цели «PDF-чеклист» в отчёте не прибавилось.

Результаты выше — ожидаемые, из условий цели и поведения ссылок. Проверку стоит проводить один раз в приватном режиме, если включён фильтр «Не учитывать мои визиты»; если цель только что создана, сбор статистики начинается в течение нескольких минут и в отчёте какое-то время будет пусто. Свежие клики ложатся в отчёт по мере обработки, поэтому сверку делать лучше через несколько минут после шагов.

Проверка цели через отладочную панель и отчёты

Отладочная панель показывает, что счётчик увидел и как интерпретировал действие.

К адресу страницы, где есть ссылка для скачивания, добавьте параметр _ym_debug=2 и откройте страницу в браузере, например http://example.com/?_ym_debug=2 — ^[1].
Внизу страницы появится панель отладки, откройте её по значку.
Нажмите на странице ссылку для загрузки.
Информация о достижении цели появится во вкладке Console. Всё в порядке, если там есть строка вида File. Counter 12345. Url: https://example.com/download/price.nameshop, где Url — ссылка на скачивание, указанная при создании цели — ^[1].

После подтверждения клика по цели идёт разбор в отчётах.

Отчёт «Конверсии»: используется для статистики по цели — ^[1].
Отчёт «Загрузки файлов»: должен показать данные после того, как на сайте выполнено целевое действие — ^[1].

Если в настройках счётчика включён фильтр Не учитывать мои визиты, свои нажатия вы в отчётах не увидите — проверяйте цель в приватном режиме браузера, например в Инкогнито Яндекс Браузера — ^[1].

Ограничения и типичные причины расхождений

Сервис фиксирует достижение одной и той же цели на одном счётчике не чаще, чем раз в секунду — ^[1]. Если посетитель подряд нажимает несколько ссылок на один и тот же файл, часть кликов в отчёт не попадёт.

Во время одного визита сервис может зафиксировать до 1000 достижений офлайн-целей и 400 достижений онлайн-целей, созданных для счётчика — ^[1]. Для сценария «PDF-чеклист» это запас с большим избытком.

Редактирование счётчика или цели не меняет ранее накопленную информацию — ^[1]. Если поменяли написание имени файла, старые данные останутся прежними, новые пойдут уже по новому условию. Если вы удалите цель, собранная по ней информация будет недоступна в отчётах — ^[1].

Отдельно про расхождения с фактическими скачиваниями. Данные по цели отличаются от реальных по нескольким причинам: условие цели не охватывает все варианты; у посетителя браузерный плагин блокирует работу счётчика; подключён антивирус с жёсткими настройками приватности; на целевой странице не успел загрузиться счётчик из-за низкой скорости соединения — ^[1].

Что проверить, если цель не сработала

Порядок действий, который быстрее всего показывает причину:

Откройте страницу с _ym_debug=2 и повторите клик. Если в Console строка File. есть, а в отчёте пусто, проверьте выбранную цель и период отчёта. Если цель только что создана, учтите, что сбор статистики начинается в течение нескольких минут. При включённом фильтре «Не учитывать мои визиты» повторите проверку в приватном режиме браузера.
Если строка есть, но совпадение имени в условии промахивается — сверьте написание: checklist.pdf и check-list.pdf для цели разные.
Если строки нет, а остальные цели срабатывают — проверьте, что ссылка на странице реально ведёт на этот файл, и расширение входит в список поддерживаемых (для цели «Любой файл»).

После проверки в Console возвращайтесь в отчёт «Загрузки файлов» за цифрами. Там цель видна не как «скачали PDF», а как «нажали на ссылку с PDF». Этого достаточно, чтобы сравнивать спрос между страницами, форматами файлов и рекламными каналами, приводящими на страницу скачивания.