Целевое событие
Целевое событие позволяет отслеживать как онлайн-события, так и офлайн-события.
Такая цель позволяет отслеживать различные события на сайте — от простых действий (нажатие кнопки, заполнение формы) до сложных запрограммированных сценариев с учетом множества условий. Цель также поддерживает передачу данных об офлайн-конверсиях, которые произошли вне сайта (например, оплата заказа). С помощью целевых событий можно фиксировать практически любые действия пользователей.
Чтобы передать данные об онлайн-событиях, используйте метод reachGoal. Для офлайн-событий следуйте инструкции по передаче офлайн-данных.
Совет
Если вы не умеете программировать, используйте:
- цель Отправка формы;
- цель Клик по кнопке;
- готовые интеграции с Метрикой;
- другие цели из разделов Конверсионные действия и Вовлеченность в конструкторе целей.
Как создать целевое событие
Примечание
Идентификаторы цели для условий совпадает и содержит не должны содержать следующие символы: /, \, &, #, ?, =, ". Если в идентификатор нужно добавить символ +, замените его на %2B.
-
В Метрике перейдите на страницу Цели в левом меню и нажмите кнопку Добавить цель.
-
Выберите тип цели Целевое событие.
-
В поле Название введите имя цели.
-
Укажите условие и идентификатор цели.
-
Настройте отправку данных в Метрику в зависимости от способа передачи данных (онлайн или офлайн).
-
Онлайн
Чтобы передать в Метрику целевое событие с сайта, добавьте на страницу код с методом reachGoal.
Примеры:
Нажатие кнопки
<form action=""> ... <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;" value="Order" /> </form>XXXXXX— номер вашего счетчика.TARGET_NAME— идентификатор цели.
Заполнение формы
... <form action="" method="get" onsubmit="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;"> ... </form> ...XXXXXX— номер вашего счетчика.TARGET_NAME— идентификатор цели.
... <form action=""> ...
-
<<<<<<< arcadia/trunk: LEGALDOC-22520: Обновление: svoedelo
<input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME', {order_price: '1000.35', currency: 'RUB'}); return true;" value="Заказать"/>
DOCSUP-131485.DOCORG-12158.example-id-tag: DOCSUP-131485.DOCORG-12158.example-id-tag.01
</form>
...
```
- `XXXXXX` — номер вашего счетчика.
- `TARGET_NAME` — идентификатор цели.
- `order_price` — доход по цели. Можно указать доход в валюте или условных единицах.
- `currency` — валюта дохода по цели. Метрика понимает трехбуквенный [код валюты по ISO 4217](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=currency-codes).
Чтобы в качестве `order_price` передавать доход со всех странниц сайта, на которых он задан атрибутом-селектором (например, `class` или `id`), передавайте в Метрику вместе с данными о доходе имя селектора.
1. Найдите в коде вашего сайта фрагмент, где задан подобный селектор. Пример:
```html
<div class="ORDER">Сумма заказа: <div class="PRICE">110</div> рублей</div>
```
1. В код элемента, который будет передавать в Метрику доход по цели, добавьте имя селектора. Пример:
```javascript
<input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'BUY', {order_price: document.querySelector('.PRICE')?.textContent}); return true;" value="Заказать" />
```
{% endcut %}
- Офлайн
Чтобы передать целевое событие офлайн, используйте:
- [веб-интерфейс Метрики](../data/offline-conversion-data.md#upload-file);
- [API Метрики](https://yandex.ru/dev/metrika/doc/api2/practice/offline-conv-docpage/);
- сервис автоматизации Albato ([Инструкция по подключению](https://albato.ru/yandex-offline-conversion)).
Подробнее читайте в разделе [Передача и обработка данных](../data/offline-conversion-data.md).
{% endlist %}
- `XXXXXXXX` — номер вашего счетчика.
- `TARGET_NAME` — идентификатор цели.
- `order_price` — доход по цели. Можно указать доход в валюте или в условных единицах.
- `currency` — валюта дохода по цели. Метрика распознает трехбуквенный [код валюты по ISO 4217](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=currency-codes).
-
Нажмите кнопку Добавить цель. Созданная цель отобразится в списке целей. Метрика начнет сбор статистики по ней в течение нескольких минут.
-
Проверьте, правильно ли работает цель.
-
Нажмите Добавить цель. Новая цель появится в списке. Метрика начнет собирать статистику через несколько минут.
-
Проверьте, работает ли цель корректно.

Условия отслеживания цели
При создании цели доступно несколько типов условий. Условия объединяются логическим оператором ИЛИ, то есть цель считается достигнутой, если выполнено хотя бы одно из заданных условий.
|
Условие |
Описание |
|
совпадает |
Указывается полный идентификатор цели. |
|
содержит |
Указывается часть идентификатора. Используйте этот вариант, если целей несколько, и их можно объединить одним условием. Указывайте как можно большую часть идентификатора, чтобы были достигнуты только нужные цели ПримерЕсли задано условие |
|
регулярное выражение |
Используется для отслеживания идентификаторов целей, соответствующих произвольным шаблонам. При настройке условия регулярное выражение должно содержать только значение идентификатора (без домена и протокола сайта) ПримерЧтобы отследить нажатие кнопки с идентификатором, который содержит |
Ограничения
-
Для каждого счетчика можно задать до 200 целей.
-
Сервис фиксирует достижение посетителем одной и той же цели на одном счетчике не чаще, чем раз в секунду.
-
Во время одного визита посетителя сервис может фиксировать до 1000 достижений офлайн-целей и 400 достижений онлайн-целей, созданных для счетчика.
-
При редактировании счетчика или цели накопленная ранее информация не изменяется.
-
Если вы удалите цель, собранная по ней информация будет недоступна в отчетах.