Интеграция с amoCRM

Интеграция связывает рекламные кампании и объявления VK с лидами amoCRM по UTM-меткам. В результате в Векторе видно, сколько лидов дошло до выбранного этапа, сколько продаж и выручки они принесли и как выглядит фактическая воронка от рекламы до продажи.

Главное

Вектор читает только необходимые данные. Он не изменяет содержимое сделок, контактов, полей, задач или воронок в amoCRM. Техническое исключение — регистрация и удаление webhook-подписки для быстрых уведомлений.

Как это работает

Путь данных состоит из четырёх шагов:

1. Ссылка объявления передаёт utm_campaign и utm_content на сайт или форму.
2. Эти значения сохраняются в выбранных полях лида amoCRM.
3. Вектор связывает лид с объявлением или кампанией VK и запоминает реальные переходы по этапам.
4. Метрики появляются в Рекламном кабинете и в кабинетной Аналитике.

Для каждого рекламного кабинета задаётся одна воронка и одно сопоставление полей. Один и тот же аккаунт amoCRM можно использовать в нескольких кабинетах: у каждого кабинета будут собственные этапы и настройки выручки.

Подготовка и доступ

Кто может подключить и кто видит интеграцию

OAuth запускает один участник с правами редактора или владельца кабинета. После подключения интеграция принадлежит рекламному кабинету, а не этому человеку:

• все участники, которым доступен кабинет, видят подключённую amoCRM, статус и статистику;
• редактор или владелец может менять сопоставление, запускать ручную сверку, переподключать и отключать интеграцию;
• участник с доступом только на просмотр видит состояние и данные без управляющих действий;
• отдельное OAuth-подключение для каждого таргетолога не требуется.

Это покрывает работу команды с крупным клиентом: клиентская CRM подключается один раз, а все таргетологи, допущенные к кабинету, пользуются общей аналитикой.

Что подготовить

Перед подключением проверьте:

• у пользователя amoCRM есть доступ к нужному аккаунту, воронке, этапам и полям лидов;
• для регистрации быстрого webhook у авторизующегося пользователя есть права администратора amoCRM; без них интеграция остаётся рабочей через часовую сверку (Только сверка раз в час);
• в amoCRM созданы текстовые поля, в которые попадают utm_campaign и utm_content;
• при необходимости есть поле utm_source;
• выбран способ расчёта выручки: бюджет сделки или числовое/денежное поле;
• вы знаете этап, достижение которого считать целевым, и этап, на котором признавать выручку.

Вектор не создаёт, не редактирует и не удаляет сделки, контакты, поля, задачи и воронки. Права администратора используются только для регистрации или удаления webhook-подписки; если их нет, данные обновляются контрольной сверкой при активной авторизации.

Какие UTM нужны

Рекомендуемый шаблон ссылки для VK Рекламы:

utm_source=vk&utm_campaign={{campaign_id}}&utm_content={{banner_id}}

utm_content содержит ID объявления и даёт самое точное сопоставление. utm_campaign содержит ID кампании и служит запасным уровнем, если объявление определить нельзя. utm_source=vk можно включить как дополнительную проверку источника.

Если URL уже содержит параметры после ?, добавьте UTM через &. Если посадочная страница использует hash-маршрутизацию (#), UTM должны попасть в ту часть адреса, которую ваша форма действительно читает и передаёт в amoCRM. Например:

https://site.example/offer?utm_source=vk&utm_campaign={{campaign_id}}&utm_content={{banner_id}}#form

https://site.example/#/offer?utm_source=vk&utm_campaign={{campaign_id}}&utm_content={{banner_id}}

Во втором варианте обязательно проверьте, что скрипт сайта разбирает параметры после #. Вектор читает уже сохранённые поля amoCRM и не может восстановить метку, которую сайт не передал в CRM.

Подключение и настройка

Как подключить amoCRM

1. Откройте нужный Рекламный кабинет.
2. Нажмите «Интеграции» → «amoCRM».
3. Нажмите «Подключить amoCRM» и подтвердите доступ в окне amoCRM.
4. После возврата в Вектор выберите поля и этапы сопоставления.
5. Сохраните настройку. Начнётся загрузка доступной истории.

Подключение автоматически отображается у всех участников кабинета. Если этот же аккаунт amoCRM уже авторизован для другого кабинета, Вектор переиспользует безопасное общее подключение, но создаёт отдельное сопоставление для текущего кабинета.

Сопоставление полей и этапов

В настройке укажите:

• воронку amoCRM;
• текстовое поле для utm_campaign;
• отдельное текстовое поле для utm_content;
• при необходимости поле utm_source и ожидаемое значение, обычно vk;
• целевой этап для столбца «Дошли до…»;
• источник выручки;
• этап, на котором выручка считается признанной;
• валюту, если она не задана метаданными денежного поля.

Одно поле нельзя одновременно использовать для разных UTM. После изменения воронки или сопоставления Вектор пересчитывает историю по новой конфигурации; старая конфигурация не смешивается с новой.

Интеграция amoCRM · Сопоставление

Настройка для кабинета «Большой клиент»

✓ Подключено

Подключение

Аккаунт amoCRM

Client Group

Адрес

client.amocrm.ru

Доступ в Векторе

Общий для кабинета

OAuth-подключение видят все участники кабинета. Воронка, UTM и выручка ниже относятся только к этому кабинету.

UTM-поля

Поле utm_campaignUTM CampaignКампания VKПоле utm_contentUTM ContentОбъявление VKПоле utm_source · необязательноUTM SourceОжидаемое значение

Воронка, этапы и выручка

ВоронкаОсновная воронкаПовторные продажиЦелевой этапКвалифицированВстреча проведенаИсточник выручкиПоле «Оплата»Бюджет сделкиЭтап признания выручкиУспешно реализованоВалюта денежного поляВыводить статистику amoCRM

Основная воронка: этап «Квалифицирован», выручка — Поле «Оплата», RUB

Учебный пример: изменения остаются только на этой странице.

Пример интерфейса · настройки не сохраняются.

Как обновляются продажи

Синхронизация работает тремя способами:

• webhook быстро сообщает об изменениях в amoCRM, но это не обещание мгновенного обновления — событие ещё должно попасть в очередь и обработаться;
• контрольная сверка раз в час при активной авторизации находит изменения, которые могли не прийти через webhook, и является основной гарантией восстановления;
• ручная кнопка при активной авторизации запускает тот же устойчивый процесс по запросу редактора. Если сверка уже идёт, новый запрос присоединяется к ней, а не создаёт дубликат.

При временной ошибке прогресс сохраняется. Следующий запуск продолжает работу с последней подтверждённой позиции. После первого подключения или изменения сопоставления отдельно загружается доступная история.

Синхронизация продаж

Последняя успешная сверка: сегодня, 14:05

Загружаем историю

История

с 1 января 2024

Webhook

Активен

Контрольная сверка

Раз в час

Активный запуск · первичная историяВыполняется

Страниц сделок

12

Страниц событий

31

Лидов сохранено

2 460

Процент не показывается: amoCRM не сообщает заранее полный объём истории.

Контрольная сверка — раз в час
При активной авторизации Вектор перечитывает изменения и восстанавливает события, которые могли не дойти через webhook. Это нормальный резервный контур.

Если webhook временно недоступен, статус «Только сверка раз в час» нейтрален: при активной авторизации данные продолжат обновляться с задержкой до часа.

При активной авторизации webhook ускоряет обновление, а часовая сверка восстанавливает пропуски.

Пример интерфейса · кнопка не обращается к amoCRM.

Как считаются продажи

Сопоставление с рекламой

Сопоставление выполняется только по нормализованным UTM:

1. Сначала Вектор ищет точное совпадение utm_content с ID объявления VK.
2. Если точного объявления нет, используется точное совпадение utm_campaign с ID кампании.
3. Если метка отсутствует, не распознаётся или указывает сразу на несколько объектов, лид остаётся несопоставленным или неоднозначным.

Нечёткий поиск, телефон, email и имя контакта не используются. Вектор не «угадывает» источник. Доля сопоставленных, несопоставленных и неоднозначных лидов видна в диагностике Аналитики.

Достижение этапов

Этап считается достигнутым только после фактически зафиксированного перехода лида в этот статус. Достижение запоминается навсегда: если лид позже вернулся назад, ранее достигнутый этап не исчезает.

Пропущенные этапы не достраиваются. Если сделка перешла из первого этапа сразу в четвёртый, Вектор не считает второй и третий достигнутыми без реальных событий. Из-за возвратов, повторных переходов и особенностей фактической последовательности отношение между соседними этапами иногда может быть больше 100% — это не исправляется искусственным ограничением.

Выручка и валюта

Выручка учитывается только после фактического достижения выбранного этапа признания. Источником может быть:

• бюджет сделки;
• выбранное числовое поле;
• денежное поле amoCRM.

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

Для денежного поля валюта берётся из его метаданных. Для числового поля и бюджета сделки укажите трёхбуквенный код ISO в верхнем регистре, например RUB, USD или EUR.

Валюты в первой версии

Вектор не выполняет конвертацию валют. Расход, CPL и CPA рассчитываются в рублях. ROAS показывается только когда выручка также в RUB; для другой валюты выручка остаётся видимой со своим кодом, а ROAS отображается как недоступный.

К какой дате относится продажа

Лид и последующая продажа относятся к дате создания лида, а не к дате перехода в продажу. Это когортный подход: он показывает, какой рекламный трафик в итоге принёс результат.

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

Где смотреть результат

Столбцы в Рекламном кабинете

Откройте «Настроить отображение» и найдите группу amoCRM. Полный набор содержит восемь метрик:

• лиды amoCRM;
• дошли до выбранного целевого этапа;
• конверсия в выбранный целевой этап;
• стоимость лида в RUB;
• стоимость достижения выбранного этапа в RUB;
• продажи на этапе признания выручки;
• выручка с кодом настроенной валюты;
• ROAS, когда валюта выручки — RUB.

Названия этапов подставляются прямо в подписи столбцов. Если интеграция временно недоступна, сохранённый пресет не удаляется: значения показываются как — до восстановления данных. На нижних уровнях таблицы, где нет собственного сопоставления amoCRM, метрика также отображается как —, а не как ложный ноль.

Рекламный кабинет · Кампании

Кабинет «Большой клиент» · 1–31 августа

Данные на 14:05

Столбцы группы amoCRM

Лиды amoCRMДошли до «Квалифицирован»Выручка, RUB

Пример динамических столбцов amoCRM

Уровень	Объект	Расход	Лиды amoCRM	Дошли до «Квалифицирован»	Выручка, RUB
Кампания	Ретаргет · кейс	18 400 ₽	42	19	126 000 ₽
Группа	↳ Широкая 25–44	9 900 ₽	—	—	—
Группа	↳ Look-alike 3%	8 500 ₽	17	8	54 000 ₽

«—» означает, что лид сопоставлен только с кампанией и у нижнего уровня нет собственного агрегата; это не ноль.

Пример интерфейса · показаны учебные агрегаты без данных реального кабинета.

Подробнее о пресетах — в Настройке колонок.

Сквозная аналитика продаж

В кабинетной Аналитике появляется блок продаж amoCRM:

• карточки лидов, целевых достижений, продаж и выручки;
• фактическая воронка по статусам выбранной воронки;
• динамика по датам создания лидов;
• показатели качества сопоставления и свежести синхронизации;
• предупреждения о webhook, авторизации, незавершённой истории, конфигурации и несовместимой валюте ROAS.

Статусы идут в том порядке, в котором они настроены в amoCRM. Воронка не делает выводов о пропущенных этапах. В первой версии данные amoCRM доступны только в аналитике конкретного кабинета; общая Аналитика проекта их не суммирует.

Продажи amoCRM · Основная воронка

Кабинет «Большой клиент» · 1–31 августа

Данные на 14:05

Лиды amoCRM124

Продажи18

Выручка300 000 ₽

ROAS477%

Фактическая воронка по событиям amoCRM

ЭтапЛидыК пред.

Новый лид64—

Квалифицирован3148%

Встреча проведена40129%

Успешно реализовано1845%

129% — допустимое фактическое значение: Вектор не достраивает пропущенные этапы и не ограничивает реальные переходы искусственно.

Пример интерфейса · показаны учебные агрегаты без данных реального кабинета.

Подробнее об экране — в статье Аналитика.

Состояния и обслуживание

Состояния интеграции

Статус складывается из четырёх частей. Действия нужны не всегда: например, часовая сверка без webhook остаётся рабочим режимом.

Авторизация общей amoCRM

Состояние	Что означает	Кто и что делает
Активна	Доступ работает	Никто: синхронизация продолжается
Обновляем доступ	Вектор автоматически обновляет токен	Никто: дождаться завершения
Нужно переподключить	Автоматическое обновление не удалось	Редактор или владелец повторяет OAuth
Доступ отозван	amoCRM больше не принимает токен	Редактор или владелец повторяет OAuth; последние данные остаются видимыми
Отключается	Удаляется последнее подключение к этому аккаунту	Участники не повторяют действие; при зависшем состоянии обращаются в поддержку

Настройка кабинета

Состояние	Что означает	Кто и что делает
Требует настройки	Воронка, UTM или этапы ещё не сохранены	Редактор заполняет обязательные поля
Загружаем историю	Идёт первая загрузка или пересчёт новой конфигурации	Никто: дождаться; прогресс сохраняется
Готова	Сопоставление полно и актуально	Никто
Данные устарели	Выбранное поле/этап исчезли либо обработка конфигурации дала ошибку	Редактор выбирает актуальные значения и сохраняет; при повторе обращается в поддержку
Нужно переподключить	Настройка сохранена, но общая авторизация не работает	Редактор или владелец повторяет OAuth

Webhook

Состояние	Что означает	Кто и что делает
Настраивается	Вектор регистрирует быстрые уведомления	Никто: часовая сверка страхует данные
Активен	Изменения быстро попадают в обработку	Никто
Только сверка раз в час	Webhook недоступен; при активной авторизации данные продолжают обновляться	Обычно никто; учитывать задержку до часа. При требовании переподключить amoCRM сначала повторить OAuth
Быстрые обновления нарушены	Регистрация или обработка webhook дала ошибку	При активной авторизации часовая и ручная сверки продолжаются; при требовании переподключить amoCRM сначала повторить OAuth

Запуск синхронизации

Состояние	Что означает	Кто и что делает
В очереди	Запуск создан и ждёт обработчика	Никто: дождаться
Выполняется	Страницы лидов и событий обрабатываются	Никто: следить за фактическими счётчиками, без процента
Пауза из-за лимита	amoCRM временно ограничила частоту запросов	Никто: Вектор продолжит после разрешённой задержки
Завершено	Данные и контрольная точка сохранены	Никто
Завершено с предупреждениями	Основные данные сохранены, часть записей пропущена безопасно	Редактор смотрит предупреждение; после исправления причины запускает ручную сверку
Ошибка	Запуск остановлен без продвижения небезопасной контрольной точки	Редактор устраняет указанную причину и повторяет ручную сверку; для OAuth сначала переподключает
Отменено	Запуск завершён без продолжения; ранее сохранённые данные не удалены	Редактор запускает ручную сверку, если обновление всё ещё нужно

Состояние и качество данных

Статус виден всем участникам кабинета

✓ Подключено

Пример состоянияПодключеноУстаревшие / частичные данныеТребуется переподключениеНизкое качество UTM-сопоставления

✓ Подключено

Авторизация, сопоставление, webhook и часовая сверка работают.

Действие не требуется.

Качество сопоставления за период

До объявления

72%

До кампании

16%

Не сопоставлены / неоднозначны

9% / 3%

Пример интерфейса · цвет дублируется текстом статуса и действием.

Переподключение и отключение

Переподключение обновляет доступ общей CRM и возобновляет синхронизацию всех кабинетов, которые используют это подключение. Настройки воронки каждого кабинета сохраняются.

Действие «Отключить от кабинета» удаляет связь только с текущим рекламным кабинетом. Если та же amoCRM используется другими кабинетами, их сопоставления и синхронизация продолжают работать. Перед отключением Вектор показывает это различие в подтверждении.

Какие данные хранятся

Вектор хранит только данные, необходимые для устойчивой аналитики:

• стабильные технические идентификаторы аккаунта, лида/сделки, воронки, полей и статусов;
• временные метки создания и изменения;
• выбранные поля сопоставления;
• нормализованные UTM;
• распознанную сумму и валюту;
• факт достижения выбранных статусов и служебные точки синхронизации.

Вектор не хранит названия сделок и контактов, ID контактов, телефоны, email, заметки, задачи, сообщения и неиспользуемые поля. Стабильный технический ID лида/сделки хранится без имени и контактных данных — он нужен для повторяемой синхронизации одной и той же записи. OAuth-токены и персональные значения не записываются в журналы. Доступ к настройке и агрегатам ограничен участниками соответствующего рекламного кабинета.

Если данные не появились

Проверьте по порядку:

1. В статусе нет требования переподключить amoCRM или исправить настройку.
2. utm_campaign и utm_content действительно сохранены в выбранных полях лида.
3. utm_content содержит ID объявления, а utm_campaign — ID кампании без постороннего текста.
4. При включённой проверке utm_source значение точно равно настроенному, обычно vk.
5. Лид относится к выбранной воронке и действительно посещал выбранный этап.
6. Для выручки заполнено выбранное поле и достигнут этап признания.
7. Завершилась загрузка истории; при необходимости редактор нажал «Синхронизировать сейчас».
8. Выбран период, включающий дату создания лида, а не только дату продажи.

Если лиды есть, но они не сопоставлены, посмотрите доли «Несопоставленные» и «Неоднозначные» в Аналитике. Если проблема сохраняется, откройте расширенную памятку по диагностике.

См. также: все интеграции, Рекламный кабинет, Глоссарий метрик.