Интеграции

Экран устроен просто: сверху полоска вкладок, под ней у каждой вкладки — таблица и модалка «добавить / изменить». Пять вкладок: Рекламные сети · Facebook · TikTok · Google · Постбек 2.0.

Полоска вкладок и когда какая видна

Вкладка «Рекламные сети» есть всегда — учёт расхода это ядро трекера, а не хак. Остальные четыре — это отдельные хаки, и вкладка появляется, только если хак активен на твоём аккаунте (hacks.<имя>). Нет хака fbpix — нет вкладки Facebook. На демо-стенде включены все четыре, так что видно всю пятёрку.

• Голый адрес /app/integrations сам переезжает на /integrations/advnets — то есть по умолчанию открываются Рекламные сети.
• Сверху у каждой вкладки — переключатель Область: Мои / Команда. В командном режиме экран показывает интеграции всей команды; править их могут только админы команды (у обычного участника кнопки редактирования выключены).

Вкладка 1 — Рекламные сети (коннекторы расхода)

Коннектор — это робот, который ходит в API рекламной сети, забирает твой расход и проставляет цену каждого клика в трекере. Дальше отчёты и «Источники» считают ROI уже по реальным деньгам, а не по тому, что ты помнишь.

Панель сверху: Добавить коннектор · Лог запросов.

Колонки таблицы:

• Название — как ты назвал коннектор (например, «Импорт расхода — основная сеть»).
• Активен — галочка-переключатель прямо в строке (включает/выключает импорт).
• Сеть — тип коннектора (какая именно рекламная сеть).
• Последняя проверка — когда робот забирал расход в прошлый раз.
• Следующая проверка — когда пойдёт в следующий раз (по расписанию).
• Действия: Изменить · Запустить импорт · Лог запросов · Удалить.

Типы коннекторов (11 в Lite): facebook, tiktok, bigo, dolphin, dolphincl, fbtool, mgid, mixadvert, adpartner, luckyads, vk. Список типов трекер собирает сам — если в сборке появится новый коннектор, он появится и в выпадашке, без обновления интерфейса.

Workflow — добавить коннектор расхода, запустить и проверить лог

Добавление коннектора двухшаговое — сначала создаём строку, потом настраиваем. Иначе никак: у коннектора нет своих полей, пока не выбран тип.

1. Нажмите «Добавить коннектор».
2. Введите название и выберите сеть. В маленькой модалке введите Название и выберите Сеть (тип) из списка (facebook, tiktok, bigo, …). Нажмите Создать.
3. Строка создалась — и сразу открылся редактор этого коннектора.
4. Заполните редактор (сверху вниз):
   • Справка коннектора — блок-подсказка конкретной сети (что за доступы ей нужны).
   • Статус — галочка «активен».
   • Название.
   • Доступы — только те поля авторизации, которые нужны этой сети (у кого-то токен, у кого-то логин/пароль, у кого-то URL + ключ). Лишних полей не показываем.
   • Расписание — периодичность (6 вариантов: раз в сутки / раз в час / раз в 3 часа / 2 раза в день / 3 раза в день / раз в 3 дня) и период выборки (5 вариантов: сегодня / вчера / сегодня+вчера / 3 дня / неделя), плюс галочки Уникальные и Валидные.
   • Фильтр — Источник (ограничить импорт одним значением utm_source) и Поле (в какой UTM-метке лежит id креатива/объявления — это выбор из списка меток, а не текст).
   • Доп. поля коннектора — специфичные настройки конкретной сети (например, у facebook — режим + прокси).
5. Нажмите «Сохранить».
6. Запустите импорт вручную. Чтобы не ждать расписания — в строке коннектора нажмите Запустить импорт, подтвердите. Робот сходит в сеть и проставит цены кликов сейчас.
7. Проверьте лог запросов. Убедиться, что робот сходил удачно, — Лог запросов.

Лог запросов коннекторов

Открывается кнопкой Лог запросов (в панели сверху или из строки коннектора). Это шторка со списком всех обращений робота в API сетей, по 50 на страницу. Сверху — фильтры:

• Коннектор — показать лог одного конкретного коннектора.
• Результат — отфильтровать по типу ошибки (или показать только успешные).
• ↻ Обновить.

Каждую строку можно развернуть — внутри полный запрос и ответ: URL, тело POST, GET-параметры, ответ сети, заголовки, HTTP-статус и таймер. Сюда идёшь, когда «импорт не сработал» — тут видно, что именно сеть ответила.

Вкладка 2 — Facebook (fbpix, Conversions API)

Пиксель Facebook отдаёт события в Conversions API, когда лид меняет статус. Вкладка — это таблица пикселей плюс модалка настройки.

Колонки таблицы: Название · Активно · Пиксель · Поле лида · Новый · Домен.

Поля модалки (13):

• Название — как называется пиксель (оно же комментарий).
• Пиксель * — числовой id пикселя. Обязательное.
• Поле лида * — какая метка лида несёт нужное значение (выбор из меток). Обязательное.
• Значение — значение-ориентир.
• Новый / Холд / Аппрув — имена FB-событий для каждого статуса (выбор из списка событий, можно оставить пустым).
• Отправлять данные лида — галочка (слать ли PII лида).
• Без клика — галочка.
• Домен.
• Прокси.
• Цели — мультивыбор из твоих целей.
• Токен доступа * — обязательное.

Обязательный минимум, чтобы пиксель вообще сохранился: Пиксель + Поле лида + Токен доступа.

Вкладка 3 — TikTok (ttpix)

Почти копия Facebook — тот же смысл, тот же набор полей, но с двумя отличиями:

• Пиксель здесь строка, а не число (TikTok-код вида TTPIXCODE999, а не голые цифры).
• Нет полей «Отправлять данные лида» и «Без клика» — их у TikTok просто не бывает.

Итого в модалке 11 полей вместо 13. Всё остальное — Название, Поле лида, Значение, Новый/Холд/Аппрув, Домен, Прокси, Цели, Токен доступа — как у Facebook. Обязательный минимум тот же по смыслу: Пиксель + Поле лида + Токен доступа.

Вкладка 4 — Google (gclid, офлайн-конверсии)

Это не «живой» пиксель, а сборщик документа офлайн-конверсий на каждую кампанию — из него Google тянет конверсии по gclid. Поэтому у Google нет переключателя «Активно» (нечего включать — есть или нет документа) и запись адресуется по-другому под капотом (doc, а не pb).

Колонки таблицы: Название · Привязанный тег · Домен · Страны · Прогресс.

Поля модалки (14 полей, сгруппированы двумя заголовками — «Переопределение UTM» и «Область и окна»):

• Название * — обязательное.
• Привязанный тег * — какая метка несёт gclid (выбор из меток). Обязательное.
• Домен * — привязанный домен, из которого строится URL выгрузки. Обязательное.
• Страны — коды стран.
• UTM ×6 — переопределение utm-меток (source/campaign/content/term/medium/domain).
• Потоки — ограничение по потокам (список id).
• Мусор / Отмена / Лид — окна и настройки статусов.

Обязательный минимум: Название + Привязанный тег + Домен.

Вкладка 5 — Постбек 2.0 (p2b, исходящий конструктор)

Это конструктор исходящих постбеков/вебхуков: трекер сам стучится на твой URL, когда лид меняет статус. Например, «Постбек в Телегу котиков».

Колонки таблицы: Название · Активно · Канал · Фильтр по полю лида · Значение.

Поля модалки сгруппированы тремя заголовками:

• События — флажки, на какие статусы слать: Глобально · Новый · Холд · Аппрув · Отмена · Мусор.
• Тело запроса — URL * (обязательное), метод POST, формат, заголовки; плюс галочки Async (слать асинхронно) и Nolog (не писать в лог).
• Авторизация — переключатель handshake. Пока он выключен — блок пустой. Включаешь — и появляются дополнительные поля: URL авторизации · Тело авторизации · Формат авторизации · Заголовки авторизации · Путь к токену · TTL токена. Выключаешь — снова прячутся.

Обязательный минимум: Название + URL. Если канал требует POST (тип 1) — понадобятся ещё тело и заголовки.

Общие приёмы всех пяти вкладок

Все четыре пиксельные вкладки (Facebook, TikTok, Google, Постбек) устроены одинаково — таблица плюс модалка «добавить / изменить». Строки действий у каждой записи одни и те же:

• Переключить «Активно» — прямо в строке, одним кликом (у Google этого нет — там нет статуса).
• Изменить — открыть модалку. Модалка дозапрашивает полную запись (например, чтобы подтянуть токен, которого нет в списке).
• Клонировать — просит новое имя (без имени клон не создастся).
• Удалить — под подтверждением.

Workflow 1 — добавить пиксель (на примере Facebook)

1. Откройте вкладку Facebook.
2. Нажмите + Добавить (пустой список подскажет «Добавьте первую интеграцию»).
3. Заполните модалку: Пиксель (число), Поле лида, Токен доступа — это минимум, остальное по вкусу (события Новый/Холд/Аппрув, домен, цели).
4. Нажмите «Сохранить» → тост «Создано».
5. Новая строка появилась в таблице.

Workflow 2 — включить/выключить интеграцию галочкой

1. Найдите строку в таблице.
2. Кликните переключатель в колонке Активно.
3. Готово — состояние сохраняется сразу, без открытия модалки.

Что стоит знать (грабли)

• Google — особенный. У него нет «Активно», а запись внутри адресуется как doc, а не как у остальных (pb). Для тебя это значит одно: не ищи у Google переключатель — его нет по задумке.
• «Запустить импорт» у коннекторов реально тратит и меняет цены. Ещё раз, потому что важно: это не тест. Под подтверждением — не зря.
• Справочники (события / метки / цели) — по области. Цели зависят от владельца, поэтому при переключении Мои ↔ Команда списки перезагружаются. Не удивляйся, что в командном режиме набор целей другой.
• Клон просит имя. Копия без нового имени не создаётся — это защита от дублей-безымянок.
• Пагинация «объектная». Технически четыре пикселя отдают данные не плоским списком, а объектом с ключами — тебе это видно только как обычная постраничная таблица (50 на страницу), но знай: это тот же экран, просто под капотом иначе.
• Заголовки коннектора могут быть по-английски — см. выше, это локаль сервера, а не битый перевод.

Из старого трекера сюда

Здесь живёт всё, что на твоём прошлом трекере было размазано по пикселям, постбекам и cost-интеграциям. Пиксели Facebook/TikTok и Google-конверсии — это твои «S2S/pixel»-настройки; Постбек 2.0 — твой исходящий постбек-конструктор; «Рекламные сети» — это cost-интеграции, которые тянут расход, чтобы ROI считался по реальным деньгам. Те же провода — только подписаны привычными словами и без отдельного ценника за интерфейс.