Для чего нужна интеграция
Яндекс Метрика собирает данные о посетителях сайта: откуда пришли, что делали, сколько времени провели. Но она не знает, что произошло после визита: оплатил ли человек курс, пришёл ли на вебинар, ответил ли на звонок.
Интеграция с Яндекс Метрикой позволяет передавать эти данные обратно: конверсии, звонки, контакты и заказы. В результате Метрика видит полную картину, а Яндекс.Директ может оптимизировать рекламу по реальным продажам, а не только по кликам.
Интеграция работает в одну сторону: Vakas-tools отправляет данные в Яндекс Метрику. Получать данные из Метрики (статистику, отчёты) через эту интеграцию нельзя.
Подключение Яндекс Метрики
Подключение выполняется через OAuth: вы авторизуетесь в Яндексе и разрешаете доступ. Вводить API-ключи вручную не нужно.
1 Перейдите в Сервисы и доступы → Добавить сервис → Яндекс Метрика
2 Введите название подключения
3 Нажмите «Подключить Яндекс Метрику»
4 Войдите в аккаунт Яндекса и разрешите доступ
5 Вернитесь в Vakas-tools
Авторизуйтесь в том аккаунте Яндекса, где находится нужный счётчик. Если счётчиков несколько на разных аккаунтах, создайте отдельное подключение для каждого.
Переподключение
Если токен перестал работать (ошибка авторизации), нажмите на подключение в списке сервисов и нажмите «Переподключить». Пройдите авторизацию заново. Все настройки и триггеры сохранятся.
Общие настройки
.jpg)
Выбор счётчика
В выпадающем списке отображаются все счётчики, доступные подключённому аккаунту. Выберите нужный и сохраните.
Если вы только что создали новый счётчик в Метрике и его нет в списке, нажмите «Очистить кэш» в быстрых действиях (список обновляется раз в час).
Если список не загружается, можно ввести ID счётчика вручную. ID счётчика указан в Метрике: Настройки → Информация о счётчике.
Без выбранного счётчика действия не будут отправляться. Система покажет предупреждение в конструкторе действий.
Как устроена передача данных
Передача данных настраивается через правила. На странице сервиса три вкладки: Регистрации, Отчёты, Заказы.
1 Правило
2 Условия
3 Действия
Подробная инструкция по созданию правил и настройке условий одинакова для всех сервисов. Здесь описаны только действия, специфичные для Яндекс Метрики.
Доступные действия
Нажмите «Действия» напротив триггера. В конструкторе доступно 6 действий:
| Действие | Для чего | ⧉ |
|---|---|---|
| Офлайн-конверсия | Передать конверсию для оптимизации Яндекс.Директ | — |
| Произвольная конверсия | Конверсия с произвольным названием цели (не из списка) | — |
| Загрузить звонок | Данные о входящем звонке для call-tracking | — |
| Загрузить контакт (CDP) | Контакт из CRM в Метрику для сегментации | — |
| Загрузить заказ (CDP) | Заказ из CRM для e-commerce аналитики | — |
| Обновить статус заказа (CDP) | Изменить статус существующего заказа | — |
Все действия добавляются по одному на правило (без значка ⧉). Если нужно передать несколько конверсий или заказов для одного события, создайте несколько правил.
Офлайн-конверсия
Главное действие интеграции. Передаёт информацию о конверсии (оплата, регистрация, заявка) в Яндекс Метрику. Яндекс.Директ использует эти данные для оптимизации рекламных кампаний: показывает рекламу тем, кто с большей вероятностью совершит целевое действие.
| Поле | Описание | По умолчанию |
|---|---|---|
| Цель | Выберите цель из выпадающего списка (подгружается из Метрики). Если список пуст, введите название вручную | — |
| Яндекс Click ID (yclid) | ID клика из Яндекс.Директ. Главный идентификатор для атрибуции рекламы | {#yclid#} |
| Client ID (_ym_uid) | Cookie Яндекс Метрики. Используется, если нет yclid | {#_ym_uid#} |
| User ID | Ваш внутренний ID пользователя | — |
| Сумма (доход) | Денежное значение конверсии | — |
| Валюта | RUB, USD, EUR, KZT, UAH, BYN | RUB |
| Дата и время | Формат: YYYY-MM-DD HH:MM:SS. Если пусто, подставляется текущее время | — |
Обязателен хотя бы один идентификатор: yclid, _ym_uid или User ID. Без него Метрика не сможет связать конверсию с посетителем. Приоритет: yclid → _ym_uid → User ID.
Как работают идентификаторы
Яндекс Метрика связывает офлайн-конверсию с посетителем сайта по одному из трёх идентификаторов:
- yclid (Яндекс Click ID): автоматически добавляется к URL при клике на рекламу в Яндекс.Директ. Самый точный способ атрибуции. Передаётся в Vakas-tools через UTM-метки или параметры URL.
- _ym_uid (Client ID): cookie-файл Яндекс Метрики. Ставится каждому посетителю сайта. Работает, даже если человек пришёл не из рекламы.
- User ID: ваш собственный идентификатор. Используйте, если настроен User ID в Метрике.
Источник данных (Bizon365, GetCourse, Tilda и др.) должен передавать yclid или _ym_uid в Vakas-tools. Обычно это делается через скрытые поля формы регистрации или UTM-метки.
Произвольная конверсия
То же, что офлайн-конверсия, но цель указывается произвольным текстом, а не выбирается из списка целей Метрики. Подходит, когда нужно передать событие, для которого ещё нет цели в Метрике, или когда название цели формируется динамически.
Метрика создаст её автоматически.| Поле | Описание |
|---|---|
| Название цели | Произвольный текст. Например: «Оплата курса», «Регистрация на вебинар» |
| Остальные поля | Аналогичны офлайн-конверсии: yclid, Client ID, User ID, сумма, валюта, дата |
Загрузить звонок
Передаёт данные о входящем звонке в Метрику для call-tracking. Позволяет Метрике учитывать телефонные обращения в статистике конверсий.
| Поле | Описание | По умолчанию |
|---|---|---|
| Яндекс Click ID (yclid) | ID клика из Яндекс.Директ | {#yclid#} |
| Client ID (_ym_uid) | Cookie Яндекс Метрики | {#_ym_uid#} |
| User ID | Ваш внутренний ID | — |
| Номер звонящего | В формате +71234567890 | {#phone#} |
| Дата и время звонка | Формат: YYYY-MM-DD HH:MM:SS | — |
| Тег | Метка или название цели звонка | — |
| Первичный звонок | Да / Нет / Не указывать | — |
| Длительность разговора | В секундах | — |
| Длительность ожидания | В секундах | — |
| Пропущенный звонок | Да / Нет / Не указывать | — |
| Доход | Денежное значение звонка | — |
| Валюта | RUB, USD, EUR, KZT, UAH, BYN | RUB |
| URL страницы | Страница, с которой пришёл звонок | — |
Для загрузки звонка обязателен хотя бы один идентификатор посетителя: yclid, _ym_uid или User ID.
Загрузить контакт (CDP)
Передаёт контакт из CRM или базы в Яндекс Метрику. Метрика использует контакты для сегментации аудитории и построения отчётов по CRM-данным.
| Поле | Описание | По умолчанию |
|---|---|---|
| Уникальный ID контакта | Email, телефон или внутренний ID. По этому полю Метрика определяет, новый контакт или существующий | {#email#} |
| Имя | Имя контакта | {#name#} |
| Email контакта | {#email#} |
|
| Телефон | Телефон контакта | {#phone#} |
| Client IDs Метрики | Список _ym_uid через запятую. Связывает контакт CRM с посетителем сайта | — |
| Дата создания | Формат: YYYY-MM-DD HH:MM:SS | — |
CDP (Customer Data Platform) это модуль Метрики для работы с CRM-данными. Загруженные контакты появляются в разделе Метрики «Клиентские данные → Контакты».
Загрузить заказ (CDP)
Передаёт заказ в Метрику для e-commerce аналитики. Заказ привязывается к контакту по полю «ID клиента».
| Поле | Обязательное | Описание |
|---|---|---|
| ID заказа | Да | Уникальный номер заказа |
| ID клиента | Да | Должен совпадать с «Уникальный ID» загруженного контакта |
| Сумма заказа | Да | Стоимость |
| Статус заказа | — | В обработке / Оплачен / Отменён / Доставлен / Возвращён |
| Валюта | — | RUB, USD, EUR, KZT, UAH, BYN |
| Дата создания | — | Формат: YYYY-MM-DD HH:MM:SS. Если пусто, подставляется текущее время |
Перед загрузкой заказа убедитесь, что контакт с таким «ID клиента» уже загружен. Если в одном правиле настроены оба действия (контакт + заказ), контакт будет загружен первым автоматически.
Обновить статус заказа (CDP)
Обновляет статус существующего заказа в Метрике. Используйте, когда статус меняется после создания: оплата подтверждена, заказ отменён, товар доставлен.
| Поле | Обязательное | Описание |
|---|---|---|
| ID заказа | Да | Номер заказа, статус которого обновляется |
| ID клиента | Да | Должен совпадать с контактом |
| Новый статус | Да | В обработке / Оплачен / Отменён / Доставлен / Возвращён |
| Сумма | — | Укажите, если сумма изменилась |
| Дата обновления | — | Формат: YYYY-MM-DD HH:MM:SS. Если пусто, текущее время |
Типичные сценарии настройки
Сценарий 1. Оплата → офлайн-конверсия в Метрику
Задача: передавать данные об оплатах в Метрику, чтобы Яндекс.Директ оптимизировал рекламу по реальным продажам.
1 Откройте вкладку «Заказы»
2 Создайте правило без условий
3 Добавьте действие «Офлайн-конверсия»
{#yclid#}, сумма = {#costMoney#}, валюта = RUB.4 Сохраните
Если цели «Оплата» ещё нет в Метрике, используйте действие «Произвольная конверсия» и напишите название цели текстом. Метрика создаст её автоматически.
Сценарий 2. Регистрация → контакт + конверсия
Задача: при регистрации на вебинар передать контакт в CDP Метрики и зафиксировать конверсию.
1 Откройте вкладку «Регистрации»
2 Создайте правило
3 Добавьте действие «Загрузить контакт (CDP)»
{#email#}, имя = {#name#}, телефон = {#phone#}.4 Добавьте действие «Произвольная конверсия»
{#yclid#}.5 Сохраните
Сценарий 3. Оплата → заказ в CDP + обновление статуса
Задача: передавать заказы с суммой и статусом оплаты для e-commerce аналитики в Метрике.
1 Правило 1 (вкладка «Регистрации», без условий)
{#email#}.2 Правило 2 (вкладка «Заказы», без условий)
{#payment_number#}, ID клиента = {#email#}, сумма = {#costMoney#}, статус = «Оплачен».3 Сохраните оба правила
Сценарий 4. Данные звонков в Метрику
Задача: передавать данные о звонках для анализа эффективности рекламы по телефонным обращениям.
1 Создайте правило на вкладке «Регистрации»
2 Добавьте действие «Загрузить звонок»
{#phone#}, yclid = {#yclid#}.3 Сохраните
Быстрые действия
На странице сервиса доступны две кнопки быстрых действий:
| Кнопка | Что делает |
|---|---|
| Очистить кэш | Сбрасывает кеш счётчиков и целей. Нажмите, если добавили новую цель или счётчик в Метрике, а они не появились в списке |
| Проверить подключение | Проверяет, что OAuth-токен действителен и Метрика доступна |
Шорткоды
Во всех текстовых полях действий можно использовать шорткоды. Они подставят данные из входящего события.
| Шорткод | Описание |
|---|---|
{#email#} |
Email контакта |
{#phone#} |
Телефон |
{#name#} |
Имя |
{#yclid#} |
Яндекс Click ID (из параметров URL) |
{#_ym_uid#} |
Cookie Яндекс Метрики (_ym_uid) |
{#costMoney#} |
Стоимость тарифа |
{#payedMoney#} |
Оплаченная сумма |
{#payment_number#} |
Номер заказа |
{#positions#} |
Название тарифа |
Частые вопросы
{#yclid#} или {#_ym_uid#}.Ограничения
- Офлайн-конверсии обрабатываются Яндексом с задержкой (от нескольких часов до суток).
- Дата конверсии не старше 21 дня.
- Максимум ~5000 записей на один пакетный запрос.
- Для конверсий обязателен хотя бы один идентификатор:
yclid,_ym_uidилиuser_id. - Список целей и счётчиков кешируется на 1 час.
- Поддерживаются 6 валют: RUB, USD, EUR, KZT, UAH, BYN.