Интеграции

Интеграции подтягивают данные о результатах из внешних сервисов — Senler, SaleBot и Яндекс.Метрики — прямо в таблицы Вектора и в условия правил. Так вы видите не только клики VK, но и реальное качество лидов.

Интеграции подключаются кнопкой «Интеграции» в шапке раздела «Рекламный кабинет».

Senler

Senler — сервис рассылок и подписок ВКонтакте. Интеграция считает, сколько подписок принесла ваша реклама и насколько они качественные.

Что даёт:

• Подписки и отписки по объявлениям.
• Быстрые отписки — те, кто отписался почти сразу (признак нецелевого трафика).
• Чистые лиды — подписчики, попавшие в выбранную группу подписчиков Senler (её вы указываете при настройке интеграции).
• Цена подписки/лида (CPL).

В окне Senler есть вкладки настройки — «Подключение» (выбор сообществ для отслеживания), «Конверсии» (какие группы подписчиков считать конверсией) и «Покупатели». Статус Senler в меню «Интеграции»: «Не подключено», «Подключено» или «Подключено (выкл. статистика)».

Как привязываются подписки к объявлениям

Подписки сопоставляются с объявлениями по метке в ссылке. Подробные шаги привязки настраиваются в окне интеграции.

SaleBot

Интеграция с SaleBot собирает события и контакты проекта, связывает их с рекламными кампаниями, группами и объявлениями VK по UTM-меткам и показывает доступные метрики в таблицах Вектора. Каждый уникальный контакт, который удалось привязать к рекламе, считается одним лидом SaleBot на дату создания контакта. Для старых контактов данные можно загрузить ручной синхронизацией за выбранный период.

Подключение

1. В SaleBot откройте настройки нужного проекта → «Интеграции» → «API key» и создайте ключ только с разрешением на чтение информации о клиентах. Не выдавайте ключу права на изменение проекта.
2. В Векторе откройте SaleBot → «Подключение», вставьте ключ в поле «API key проекта SaleBot» и нажмите «Проверить и сохранить».
3. Скопируйте показанный Вектором Webhook URL в поле Webhook URL настроек проекта SaleBot. Для проекта нужен один проектный webhook: он принимает события всех блоков.
4. Не добавляйте этот URL как API-запрос в блоки, стрелки или метки SaleBot. Запросы из каждого блока дублируют события, расходуют лимит SaleBot и не нужны для интеграции.

API key хранится в Векторе как секрет и не показывается после сохранения. Webhook URL относится только к выбранной интеграции; не переносите его в другой проект.

UTM в рекламных ссылках

utm_content= нужен для точной привязки объявления. utm_campaign= используется как fallback, если объявление определить не удалось. Плейсхолдеры и вручную не заменяйте.

Выберите форму по исходной ссылке:

• Лендинг без query: https://site.ru/?utm_source=vk_ads&utm_campaign=&utm_content=
• Лендинг с существующим query — продолжите параметры через &, не ставьте второй ?: https://site.ru/?ref=vk&utm_source=vk_ads&utm_campaign=&utm_content=
• VK Mini App или страница подписки с hash token — сохраните часть после # и продолжите её через &: https://vk.ru/app7062840#razvitie&utm_source=vk_ads&utm_campaign=&utm_content=

После тестового перехода проверьте в статусе подключения пункты «Webhook получен» и «UTM распознаны».

Лиды и чистые лиды

Базовые метрики «Лиды SaleBot» и «Стоимость лида» доступны для контактов, которые удалось привязать к рекламе. Для базового лида не требуется достижение какого-либо блока SaleBot.

Вкладка «Чистые лиды» — необязательная настройка по аналогии с чистыми лидами Senler. Когда Вектор подтвердит контракт блоков проекта, на ней можно выбрать один или несколько блоков: контакт, достигший любого выбранного блока, один раз считается чистым лидом. Без выбранных блоков базовые лиды и их стоимость продолжают считаться, а история контакта ради чистых лидов не запрашивается.

Метрики отписок и чистых лидов появляются только когда Вектор подтвердил соответствующий контракт данных SaleBot. Если вкладка сообщает, что контракт ещё не подтверждён, это означает «метрика не поддерживается», а не нулевой результат. Не используйте отсутствующую метрику в правилах до её появления в интерфейсе.

Оценка и ручная синхронизация

1. На вкладке синхронизации задайте «С даты» и «По дату», затем нажмите «Рассчитать». Оценка показывает число контактов, фактически потраченные запросы на оценку и диапазон запросов на выполнение.
2. Если оценка не завершена, сузьте период и снова нажмите «Рассчитать». Запуск по неполной или устаревшей оценке недоступен.
3. Задайте «Бюджет попытки» — максимальное число API-запросов для этого запуска — и подтвердите, что API-запросы учитываются в лимите SaleBot.
4. Нажмите «Запустить». Вектор показывает прогресс, фактическое число запросов, обработанные контакты и предупреждения. Итог содержит число обработанных контактов и полное число лидов за выбранный период; число чистых лидов показывается только при доступной настройке блоков.

Если бюджет исчерпан, SaleBot ограничил частоту запросов или сервис временно недоступен, синхронизация приостанавливается с сохранением прогресса. Нажмите «Продолжить», укажите новый «Бюджет попытки» и подтвердите его. Кнопка «Отменить» завершает задание; уже выполняющийся запрос закончится безопасно, но следующий не начнётся.

Сообщения об ошибках

• «Проверьте диапазон дат» — дата начала позже даты окончания или одна из дат не заполнена.
• «Сначала сохраните API key SaleBot» — подключение ещё не настроено.
• «SaleBot отклонил API key. Проверьте подключение.» — ключ недействителен, отозван или не имеет нужного read-only доступа.
• «SaleBot временно недоступен» или «SaleBot временно ограничил частоту запросов» — прогресс сохранён; дождитесь доступного времени и нажмите «Продолжить».
• «Бюджет запросов исчерпан. Прогресс сохранён.» — задайте новый «Бюджет попытки» и нажмите «Продолжить».
• «Формат ответа SaleBot изменился.» — Вектор остановил обработку, чтобы не записать неверные данные; повторный запуск без исправления контракта не поможет.
• «Оценка устарела. Рассчитайте её заново.» — снова нажмите «Рассчитать» перед запуском.

Лимит API SaleBot

И оценка, и выполнение расходуют запросы API SaleBot. Всегда проверяйте оценку и выбирайте «Бюджет попытки» с учётом тарифа проекта.

Яндекс.Метрика

Интеграция с Яндекс.Метрикой показывает, что происходит с трафиком на сайте после клика по рекламе.

Что даёт:

• Визиты на сайт с рекламы.
• Лиды — достижения выбранных целей Метрики.
• Конверсию (CR) и цену лида (CPL).

Подключение:

1. В меню «Интеграции» выберите Яндекс.Метрику и авторизуйтесь (OAuth).
2. В окне настройки нажмите «Добавить счётчик» и выберите доступный счётчик Метрики.
3. Отметьте цели этого счётчика, которые нужно использовать в Векторе, и сохраните настройку.
4. Повторите добавление для остальных сайтов, если рекламный кабинет ведёт трафик на несколько счётчиков.

Для одного рекламного кабинета подключается один аккаунт Яндекса, но из этого аккаунта можно добавить несколько доступных счётчиков Метрики. У каждого добавленного счётчика свой набор целей — до 9 целей включительно.

В окне настройки каждый счётчик показан отдельной карточкой. Для отдельного счётчика можно:

• нажать «Изменить цели» и сохранить новый набор целей;
• нажать «Удалить», чтобы убрать только этот счётчик и его данные из Вектора;
• добавить ещё один счётчик кнопкой «Добавить счётчик».

Удаление последнего счётчика не отвязывает аккаунт Яндекса: подключение сохраняется и получает статус «Требует настройки». Чтобы удалить всю интеграцию вместе со всеми её счётчиками, используйте отдельное действие «Отвязать аккаунт».

Как считаются данные нескольких счётчиков

• Визиты суммируются по всем добавленным счётчикам.
• На дашборде в селекторе целей можно отметить флажками несколько целей, в том числе цели разных счётчиков. В колонках «Лиды», CPL и CR используется сумма выбранных целевых визитов или достижений — в зависимости от переключателя над списком.
• Достижения из всех выбранных ячеек целей складываются без дедупликации. Если один человек достиг двух выбранных целей, он будет учтён дважды. Это намеренная логика мультивыбора.
• Для каждого отдельного условия правила по Метрике выбирается ровно одна цель одного конкретного счётчика; при этом в правиле может быть несколько условий. В профиле лимитов также выбирается ровно одна цель. Название счётчика указано рядом с целью, чтобы различать одинаковые названия и идентификаторы.

Данные Метрики обновляются периодически (не мгновенно), поэтому свежие визиты появляются с небольшой задержкой.

Статус Яндекс.Метрики в меню «Интеграции»: «Не подключено», «Требует настройки», «Переподключите», «Подключено (выкл. статистика)» или «✓ Подключено».

Лимит целей

Для каждого добавленного счётчика можно отслеживать до 9 целей Метрики.

Метрики интеграций в правилах

Когда интеграция подключена, её метрики становятся доступны как условия в правилах и как колонки в таблицах. Например, можно останавливать объявления с дорогим чистым лидом или с большим числом быстрых отписок.

Если данные не настроены

Если конверсионные группы Senler или блоки чистых лидов SaleBot не выбраны либо цели Метрики не настроены, условия по соответствующим метрикам пропускаются (не считаются нулём) — правило по ним просто не сработает. Это защита от ложных остановок.

См. также: Правила, Аналитика, Глоссарий.