Leadgid: настройка постбэка, параметры и статусы

Как работает постбэк Leadgid

Постбэк Leadgid сообщает вашему сервису о новой конверсии, изменении её статуса или выплаты. Сеть отправляет HTTP-запрос на указанный вами URL и подставляет данные заявки вместо макросов. Например, {lead_id} превращается в ID лида, а {status} в его текущий статус.

Полная цепочка выглядит так:

1. Посетитель открывает ваш сайт. Метрика и GA4 регистрируют посещение и выдают собственные идентификаторы.
2. Посетитель переходит по партнёрской ссылке. Вместе с переходом в Leadgid передаются SubID, в том числе идентификаторы аналитики.
3. На стороне рекламодателя происходит целевое действие. Leadgid получает конверсию и связывает её с переходом.
4. Leadgid отправляет серверный постбэк в ВебНиндзя.
5. ВебНиндзя сохраняет заявку и передаёт настроенные события в Метрику, GA4 или VK.

Серверная передача позволяет получить заявку после ухода посетителя с сайта. Однако для привязки к первоначальному посещению аналитика должна получить данные о самом посещении. Наличие ClientID в партнёрской ссылке само по себе этого не подтверждает.

Как настроить постбэк в кабинете Leadgid

1. Подготовьте URL принимающего сервиса. В ВебНиндзя он доступен в карточке постбэка после выбора шаблона Leadgid.
2. В Leadgid откройте «Инструменты → Постбеки → Мои постбеки».
3. Выберите глобальный постбэк, если правило нужно для всех подходящих конверсий. Для отдельного оффера используется индивидуальная настройка.
4. Нажмите «Новый постбек» и выберите статусы, которые должны передаваться.
5. Отметьте нужные события: создание конверсии, обновление статуса и, если отслеживаете сумму, обновление выплаты.
6. Вставьте URL с макросами и сохраните постбэк. Убедитесь, что он включён.

Для настройки ВебНиндзя используется URL-постбэк с методом GET. Если форма автоматически дописывает протокол, проверьте итоговый адрес: двойного https:// быть не должно. Ограничение поля URL в проверенной форме Leadgid составляет 1024 символа, поэтому не добавляйте ненужные параметры.

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

Параметры и полный список макросов Leadgid

Слева от знака = находится имя поля, которое читает ваш сервис. Справа находится макрос Leadgid. В примере lead_id={lead_id} они совпадают, но это соглашение интеграции: принимающая система могла бы ожидать поле с другим именем.

Ниже перечислены все переменные, показанные в форме глобального постбэка Leadgid при проверке 8 ноября 2026 года. Макросы копируйте без пробелов внутри скобок.

Доступность переменной не означает, что у каждого лида будет непустое значение. SubID возвращает то, что было передано при переходе. Бонус и другие дополнительные данные зависят от соответствующего события и условий сети.

Статусы конверсии и типы событий

Статус отвечает на вопрос о состоянии заявки. Тип события объясняет, почему отправлено уведомление. Одна заявка может породить несколько постбэков, сохраняя тот же lead_id.

Какие события доступны в форме

• Новая конверсия. Уведомление о появлении конверсии.
• Обновление статуса. Изменение состояния уже существующей заявки.
• Обновление выплаты. Изменение суммы, в том числе при сохранении статуса.
• Обновление бонуса. Изменение бонусной части, если она применяется.

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

Целевые события в аналитике настраиваются отдельно. Например, new_lead для появления заявки, approved для одобрения и reject для отказа. Их точные названия задаются в подключении ВебНиндзя. Названия статусов сети автоматически не создают цели Метрики.

Как использовать SubID для Метрики и GA4

В стандартном шаблоне ВебНиндзя аналитика использует поля 5–9. Это схема сервиса, а не обязательное назначение SubID в Leadgid. При другом маппинге назначение может отличаться.

ClientID Метрики и Client ID GA4 нужно получить на вашем сайте средствами соответствующей аналитики. Для Метрики используется метод getClientID. Идентификаторы хранятся и передаются строками: преобразование длинного ClientID в JavaScript Number может изменить последние цифры.

SubID 10 поддерживается самой сетью, но стандартной интеграции ВебНиндзя он не нужен. Дублировать в нём SubID 2 не требуется. Уже занятые поля 5–9 необходимо согласовать с маппингом до установки скрипта.

Пример подключения Leadgid к ВебНиндзя

1. В разделе «Интеграции» подключите Метрику и, если нужно, GA4 или VK.
2. Проверьте цели и события. Событие клика по кнопке учитывайте отдельно от заявки.
3. Создайте постбэк, выберите шаблон Leadgid и нужные подключения.
4. Скопируйте готовый URL из карточки в Leadgid.
5. Установите стандартные коды счётчиков и код отслеживания из карточки на свой сайт. Используйте прямые партнёрские ссылки.
6. Проверьте, что реальные значения ClientID попадают в нужные SubID до перехода.

Схематический URL ниже показывает назначение полей. Это пример, а не готовая ссылка вашего аккаунта. Значения YOUR_PROJECT и YOUR_TOKEN здесь условные. Рабочий URL копируйте из кабинета.

https://webnindja.ru/postback/index.php?route=webhook&key=YOUR_PROJECT&user=YOUR_TOKEN&lead_id={lead_id}&status={status}&payout={payout}&currency={currency}&offer_name={offer_name}&offer_id={offer_id}&transaction_id={transaction_id}&goal_id={goal_id}&lead_date={lead_date}&aff_sub={aff_sub}&aff_sub2={aff_sub2}&aff_sub3={aff_sub3}&aff_sub4={aff_sub4}&aff_sub5={aff_sub5}&aff_sub6={aff_sub6}&aff_sub7={aff_sub7}&aff_sub8={aff_sub8}&aff_sub9={aff_sub9}

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

Как проверить, что конверсия дошла

1. Переход. В ссылке присутствуют ожидаемые метки, правильный счётчик и идентификаторы посетителя. Номер счётчика не подменён ClientID.
2. Leadgid. Заявка существует в статистике. Зафиксируйте её ID, статус, время, выплату и валюту.
3. История постбэков. Найдите отправку по этой заявке. Проверьте фактический URL с подставленными значениями и ответ принимающего сервера.
4. ВебНиндзя. Найдите тот же lead_id. Сверьте исходный статус, сумму и идентификаторы.
5. Отправка в аналитику. Откройте подробности доставки для каждой платформы. Приём запроса API является отдельным этапом.
6. Отчёт. Проверьте обработку загрузки в Метрике и соответствующее событие в GA4. Учитывайте время обработки, период отчёта, часовой пояс и фильтры.

По документации GA4 Measurement Protocol, успешный HTTP-ответ не подтверждает корректную обработку каждого переданного события. В Метрике также проверяют результат обработки и привязки загрузки, а не только HTTP-код запроса.

Почему постбэк или конверсия не появляются

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

Частые вопросы

Можно ли одним постбэком обслуживать несколько сайтов?

Да, если в запросе передаются идентификаторы нужного подключения и маппинг настроен одинаково. В шаблоне ВебНиндзя номер счётчика передаётся через aff_sub5, поток GA4 через aff_sub7.

Можно ли работать без собственного сайта?

Постбэк позволяет учитывать заявки из прямых партнёрских ссылок. Для сопоставления с посещением вашего счётчика нужен реальный идентификатор соответствующей аналитики. Выдуманный ClientID не создаст подтверждённое посещение.

Нужно ли отправлять new_lead при клике по кнопке?

Клик отражает переход к рекламодателю. Заявка подтверждается данными сети. Используйте отдельные события для этих двух действий.

Почему одна заявка приходит несколько раз?

Сеть может уведомлять о создании, смене статуса и изменении суммы. Разбирайте уведомления по ID лида и событию. Повтор доставки того же события не должен повторно увеличивать число заявок.

Источники и дата проверки

Макросы и элементы формы проверены 8 ноября 2026 года в официальном кабинете Leadgid: «Мои постбеки». Для просмотра справочника нужен вход. Назначение SubID под аналитику сверено с шаблоном Leadgid в ВебНиндзя.

• Яндекс.Метрика: getClientID.
• Яндекс.Метрика: передача офлайн-конверсий.
• Google: справочник Measurement Protocol для GA4.