Custom Postback — кастомная интеграция

Кастомная интеграция — для случаев, когда вашей партнёрки нет в списке готовых. Универсально для любой партнёрской программы, у которой есть постбеки. Тратите 15–30 минут на настройку, получаете полны

Обновлено 30 августа 2026 г.6 мин

Кастомная интеграция — для случаев, когда вашей партнёрки нет в списке готовых. Универсально для любой партнёрской программы, у которой есть постбеки. Тратите 15–30 минут на настройку, получаете полный контроль над набором событий и параметров.

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

Действующий партнёрский аккаунт у партнёрки с поддержкой постбеков (если нет — обратитесь в их саппорт). Документация партнёрки — какие у неё имена событий, какие параметры она передаёт. Понимание механики clickid + postback — Как работает передача событий. Настроенные кампании и Flow в боте, которые отправляют регистрационную ссылку лидам.

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

1. Лид кликнул по рекламе — Tracker создал clickid.

2. Лид получил регистрационную ссылку с{{tracker.clickid}}и зарегистрировался у партнёра.

3. При наступлении события (регистрация, депозит) партнёр отправляет постбек на ваш Postback URL.

4. Tracker находит лида по clickid и записывает событие.

Разница в том, что для Custom интеграции вам нужно вручную:

— Указать имя параметра, в котором партнёрка передаёт clickid.

— Создать каждое событие, которое будете обрабатывать.

— Получить Postback URLs для каждого события.

— Указать дополнительные параметры (cost, currency, fields).

Шаги

Откройте Integrations и создайте Custom

Tracker → Integrations → Create Custom integration. Откроется форма создания.

Укажите Click ID Parameter

Это самое важное поле. Имя параметра, под которым партнёрка передаёт идентификатор клика. Зависит от партнёрки. Типичные варианты:

— clickid — стандарт.

— sub1 / sub4 — широко используется.

— pbclick — некоторые партнёрки.

Сверьтесь с документацией партнёрки. Указанное здесь имя — должно совпадать с тем, что партнёрка реально присылает в постбеке.

Добавьте postback-события

Кнопка Add Postback Event. Для каждого нужного события — отдельный event с указанием имени и сгенерированного Postback URL.

Стандартные имена:

— registration — регистрация.

— sale — первый депозит (FD).

— resale — повторный депозит (RD).

— Любые кастомные (emailconf, kyc_verified, refund). Главное чтобы имя в Tracker совпадало с тем, что партнёрка использует.

Основные события — Три основных события: registration, sale, resale

Настройте параметры postback (опционально)

При настройке каждого события можно передавать дополнительные параметры:

— tracker.cost={amount} — сумма депозита.

— tracker.currency=usd — валюта.

— tracker.tid={event_id} — уникальный ID события (для дедупликации повторных постбеков).

Имена в фигурных скобках — макросы партнёрки, она подставляет реальные значения.

Параметры postback — Дополнительные параметры

Скопируйте Postback URLs

Tracker сгенерирует уникальный URL для каждого события. Их вид:

Это шаблон — партнёрка должна заполнить значения. После приёма Tracker распарсит и обработает.

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

В личном кабинете партнёрки откройте раздел Postbacks / Webhooks / Events. Для каждого события вставьте соответствующий Postback URL из Tracker. Партнёрка обычно использует свои макросы для значений ({click_id}, {amount}, {currency} и так далее) — указывайте их в URL вместо плейсхолдеров.

Добавьте регистрационную ссылку

В Tracker в Custom integration есть раздел Add Registration Link:

— Link name — внутреннее имя ссылки (для команды).

— Base URL — партнёрская регистрационная ссылка из вашего личного кабинета.

Tracker автоматически сформирует Final URL with Parameters — это финальная ссылка с подставленным макросом {{tracker.clickid}}. Пример:

https://partner.com/signup?pbclick={{tracker.clickid}}

Эту ссылку используйте в Flow бота — отправляйте её лиду.

Registration Link — Добавление регистрационной ссылки

Сделайте тестовую регистрацию

Возьмите Final URL with Parameters, замените {{tracker.clickid}} на тестовое значение или используйте реальный clickid из лида. Пройдите регистрацию у партнёра.

Проверьте логи Tracker

Откройте Logs — журналы событий → Postback logs. Должна появиться запись со статусом OK для события registration. Если статус Error — детали покажут, в чём проблема.

Признаки рабочей кастомной интеграции

После тестовой регистрации в Logs — журналы событий→ Postback logs появилась запись со статусом OK, правильным clickid и событием registration. В карточке тестового лида в Статьявидно событие в разделе Events. Если есть кастомные параметры — они отображаются в Custom Fields карточки лида.

Стандартные имена событий

Используйте эти имена, чтобы Tracker корректно отображал события в Dashboards — сводная аналитика и Analytics — детальная таблица.

—registration— регистрация. Главное событие top-of-funnel.

—sale— первый депозит (FD).

—resale— повторный депозит (RD).

Если назовёте иначе («fd», «firstdeposit», «recurring_payment») — Tracker всё равно зарегистрирует событие, но оно будет доступно только как кастомное (через фильтр). В стандартных метриках Dashboards / Analytics не учтётся.

Custom Fields через fields.<key>

Самая мощная фишка кастомной интеграции. В постбеке передавайте параметры с префиксом fields. — Tracker автоматически создаёт Custom Field в CRM с этим именем и записывает значение в карточку лида.

Пример постбека:

?clickid=abc123&tracker.event=sale&tracker.cost=200&fields.trader_id=99887&fields.promo=DEC2026&fields.product=BTC

После приёма в карточке лида появятся:

—trader_id= 99887

—promo= DEC2026

—product= BTC

Оператор в Messenger видит контекст лида: какой trader_id у партнёрки (для запросов в саппорт), какой promo использовал, какой продукт купил. Custom Fields доступны для фильтрации в Custom Filters — сохранённые выборки и в Custom Fields — пользовательские поля.

Примеры использования

Forex-партнёрка с нестандартным именем — арбитраж

Buyer работает с TradingHub Pro, у которой Click ID Parameter = pbclick. Создаёт Custom integration: Click ID Parameter = pbclick. События registration / sale / resale. В каждом — tracker.cost={amount}, tracker.currency={currency}. В регистрационной ссылке: https://thp.com/signup?pbclick={{tracker.clickid}}. Через час первый постбек.

Crypto-партнёрка с фокусом на trader_id — performance

Buyer льёт оффер crypto, важно знать ID игрока для запросов в саппорт. Custom integration с событиями registration / sale / resale. В постбеке для каждого:fields.trader_id={user_id}. Оператор в CRM видит «trader_id = 12345» при открытии чата — может быстро написать саппорту партнёрки.

Casino-партнёрка с extended событиями — арбитраж

Crystal Casino отдаёт нестандартные события:registration, email_confirm, kyc_passed, first_deposit, redeposit, big_deposit_500plus. Buyer создаёт Custom integration с этими 6 событиями. Tracker фиксирует каждое. В Auto Actions настраивает: послеbig_deposit_500plus автоматически переключать в VIP Flow с push-уведомлением менеджеру.

B2B-партнёрка для performance-маркетинга

Sales-агентство ведёт b2b-клиента в SaaS-компанию. У клиента партнёрская программа: signup, trial_started, paid, churn. Создают Custom integration. В каждом постбеке передают fields.plan_name и fields.mrr. Аналитика по plan_name даёт разрез: какие планы лучше продаются.

Что важно учесть

Параметрclickid—обязательный. Без него партнёрка не сможет связать постбек с лидом, события будут «orphan». Имена событий в Tracker должны точно совпадать с тем, что отправляет партнёрка (с учётом регистра). Если партнёрка отправляетSale, а в Tracker заданоsale— несовпадение, событие не запишется. Черезfields.<key>создаются Custom Fields автоматически — не нужно их предсоздавать в Статья. Тестируйте каждое событие отдельно после настройки. Парнёрка может молча отключить постбеки если ваш URL отдаёт ошибки — следите за логами регулярно.

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

Связь с другими разделами

Custom — наиболее гибкий вариант. Если партнёрка уже в каталоге готовых интеграций — см. Настройка готовой интеграции (обычно проще и быстрее). Перед настройкой см. Как работает передача событий. Для отладки см. Logs — журналы событий. Custom Fields через fields.<key> — см. Custom Fields — пользовательские поля. Auto Actions по событиям — см. Auto Actions — автодействия по событиям.

Связанное

Integrations — партнёрские программы

Integrations — подключение партнёрских программ. Когда лид делает депозит, партнёрка отправляет постбек в Tracker.

Настройка готовой интеграции

интеграция — самый быстрый способ подключить популярную партнёрскую программу.

Как работает передача событий

Эта статья — ментальная модель того, как Tracker связывает события партнёрки с конкретными лидами.

Типы интеграций

В Tracker → Integrations есть два типа интеграций.

Logs — журналы событий

Откройте Tracker → Logs. В верхней части страницы доступны четыре журнала: отправка постбэков, события источников, S2S-запросы и история изменений объектов Tracker. Для поиска одной цепочки используйт

Auto Actions — автодействия по событиям

Вкладка Auto Actions — автодействия по событиям. Раздел помогает автоматически менять состояние лида в CRM при наступлении события в Tracker . Без ручного вмешательства событие приходит, и лид перевод

Название кастомной интеграции

При создании или редактировании Custom integration заполните поле Integration name. Название используется внутри Chatterfy, чтобы быстро отличать несколько интеграций и находить нужную конфигурацию в списке.

Поле Integration name в форме Custom integration — Задайте понятное внутреннее название до настройки параметров и постбэков.

Эта статья была полезна?

Custom Postback — кастомная интеграция

Обновлено 30 августа 2026 г.6 мин

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

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

1. Лид кликнул по рекламе — Tracker создал clickid.

2. Лид получил регистрационную ссылку с{{tracker.clickid}}и зарегистрировался у партнёра.

3. При наступлении события (регистрация, депозит) партнёр отправляет постбек на ваш Postback URL.

4. Tracker находит лида по clickid и записывает событие.

Разница в том, что для Custom интеграции вам нужно вручную:

— Указать имя параметра, в котором партнёрка передаёт clickid.

— Создать каждое событие, которое будете обрабатывать.

— Получить Postback URLs для каждого события.

— Указать дополнительные параметры (cost, currency, fields).

Шаги

Откройте Integrations и создайте Custom

Tracker → Integrations → Create Custom integration. Откроется форма создания.

Укажите Click ID Parameter

— clickid — стандарт.

— sub1 / sub4 — широко используется.

— pbclick — некоторые партнёрки.

Добавьте postback-события

Кнопка Add Postback Event. Для каждого нужного события — отдельный event с указанием имени и сгенерированного Postback URL.

Стандартные имена:

— registration — регистрация.

— sale — первый депозит (FD).

— resale — повторный депозит (RD).

— Любые кастомные (emailconf, kyc_verified, refund). Главное чтобы имя в Tracker совпадало с тем, что партнёрка использует.

Настройте параметры postback (опционально)

При настройке каждого события можно передавать дополнительные параметры:

— tracker.cost={amount} — сумма депозита.

— tracker.currency=usd — валюта.

— tracker.tid={event_id} — уникальный ID события (для дедупликации повторных постбеков).

Имена в фигурных скобках — макросы партнёрки, она подставляет реальные значения.

Скопируйте Postback URLs

Tracker сгенерирует уникальный URL для каждого события. Их вид:

Это шаблон — партнёрка должна заполнить значения. После приёма Tracker распарсит и обработает.

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

Добавьте регистрационную ссылку

В Tracker в Custom integration есть раздел Add Registration Link:

— Link name — внутреннее имя ссылки (для команды).

— Base URL — партнёрская регистрационная ссылка из вашего личного кабинета.

https://partner.com/signup?pbclick={{tracker.clickid}}

Эту ссылку используйте в Flow бота — отправляйте её лиду.

Сделайте тестовую регистрацию

Проверьте логи Tracker

Признаки рабочей кастомной интеграции

Стандартные имена событий

—registration— регистрация. Главное событие top-of-funnel.

—sale— первый депозит (FD).

—resale— повторный депозит (RD).

Custom Fields через fields.<key>

Пример постбека:

?clickid=abc123&tracker.event=sale&tracker.cost=200&fields.trader_id=99887&fields.promo=DEC2026&fields.product=BTC

После приёма в карточке лида появятся:

—trader_id= 99887

—promo= DEC2026

—product= BTC

Примеры использования

Forex-партнёрка с нестандартным именем — арбитраж

Crypto-партнёрка с фокусом на trader_id — performance

Casino-партнёрка с extended событиями — арбитраж

B2B-партнёрка для performance-маркетинга

Что важно учесть

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

Связь с другими разделами

Связанное

Integrations — партнёрские программы

Integrations — подключение партнёрских программ. Когда лид делает депозит, партнёрка отправляет постбек в Tracker.

Настройка готовой интеграции

интеграция — самый быстрый способ подключить популярную партнёрскую программу.

Как работает передача событий

Эта статья — ментальная модель того, как Tracker связывает события партнёрки с конкретными лидами.

Типы интеграций

В Tracker → Integrations есть два типа интеграций.

Logs — журналы событий

Auto Actions — автодействия по событиям

Название кастомной интеграции

Эта статья была полезна?

Custom Postback — кастомная интеграция

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

Шаги

Откройте Integrations и создайте Custom

Укажите Click ID Parameter

Добавьте postback-события

Настройте параметры postback (опционально)

Скопируйте Postback URLs

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

Добавьте регистрационную ссылку

Сделайте тестовую регистрацию

Проверьте логи Tracker

Стандартные имена событий

Custom Fields через fields.<key>

Примеры использования

Forex-партнёрка с нестандартным именем — арбитраж

Crypto-партнёрка с фокусом на trader_id — performance

Casino-партнёрка с extended событиями — арбитраж

B2B-партнёрка для performance-маркетинга

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

Партнёрка не отправляет постбеки — что делать?

События приходят с пустым clickid

Как добавить ещё одно событие после настройки?

Партнёрка отправляет дубликаты постбеков (один lid → 3 одинаковых события)

Custom Fields из fields.<key> не появляются в карточке лида

Можно ли пересоздать постбек URL?

Связь с другими разделами

Связанное

Название кастомной интеграции

Custom Postback — кастомная интеграция

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

Шаги

Откройте Integrations и создайте Custom

Укажите Click ID Parameter

Добавьте postback-события

Настройте параметры postback (опционально)

Скопируйте Postback URLs

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

Добавьте регистрационную ссылку

Сделайте тестовую регистрацию

Проверьте логи Tracker

Стандартные имена событий

Custom Fields через fields.<key>

Примеры использования

Forex-партнёрка с нестандартным именем — арбитраж

Crypto-партнёрка с фокусом на trader_id — performance

Casino-партнёрка с extended событиями — арбитраж

B2B-партнёрка для performance-маркетинга

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

Партнёрка не отправляет постбеки — что делать?

События приходят с пустым clickid

Как добавить ещё одно событие после настройки?

Партнёрка отправляет дубликаты постбеков (один lid → 3 одинаковых события)

Custom Fields из fields.<key> не появляются в карточке лида

Можно ли пересоздать постбек URL?

Связь с другими разделами

Связанное

Название кастомной интеграции