Подключения

Маркетинг → Подключения: рекламные кабинеты, счётчики и продукт. Слева — мастер в режиме чата, справа — список подключений с состоянием, ниже — события продукта. Кнопки подключений и поле мастера доступны администратору; остальные видят только состояние. Ответ на действие — строкой над экраном: зелёной («Сохранено.», «Загружено: …») или красной — текст ошибки (Ошибки).

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

Напишите, что нужно («подключи Директ», «загрузи Telegram Ads») или нажмите подсказку — мастер ответит и предложит действие кнопкой под ответом: «Войти: …», «Настроить: …» (открывает форму в списке), «Загрузить CSV: Telegram Ads», «Ключ событий продукта». Подсказки: «Подключи Яндекс Директ», «Google Ads», «Telegram Ads», «Метрика», «Подключить продукт». Если подключена модель — Claude (Креативы → подключить модель) или модель из настроек сервера, — отвечает она; нет — правила по ключевым словам.

Токен Яндекса можно вставить прямо в сообщение мастеру. Сервер узнаёт его до модели: модели и в историю чата токен не уходит, в чате вместо него — •••• и последние четыре знака. Есть в сообщении слово «Метрика» — это токен Метрики, нет — Директа. Токен проверяется и сохраняется так же, как в форме (Яндекс Директ); не подошёл — мастер отвечает «Токен Директа не сохранён: <причина>» и ничего не подключает.

Яндекс Директ

«Войти» — вход через Яндекс (у подключённого — «Войти заново»). После входа:

• Загрузить кампании (кнопка в строке Директа) — кампании, группы, объявления и фразы появляются в Webvane, каждому объявлению — своя метка; повторная загрузка не создаёт дублей;
• расходы, показы и клики по объявлениям — раз в час (Расходы);
• Проставить метки в карточке кампании — ссылки объявлений с метками (на модерацию);
• Отправить изменения — черновик кампании в Директ (Кампании → черновик).

Для агентского аккаунта в «Настроить» укажите логин клиента.

Токен вручную. Если входа через Яндекс на сервере нет (не зарегистрировано приложение Яндекса), подключите Директ OAuth-токеном: «Настроить» → поле «OAuth-токен Директа» → «Сохранить», или вставьте токен в чат мастеру. Webvane сначала проверяет токен в Директе — неверный не сохраняется («Директ не принял токен…»), — и берёт из Директа логин клиента; верный — «Токен проверен и сохранён (••••x7Qz).». Так же подключается Метрика: поле «OAuth-токен Метрики» в её «Настроить». «Сохранить» без токена и без входа только запоминает логин (номер) — в строке «подключено», но данных не будет, пока нет токена.

Как получить токен

У API Директа нет отдельного ключа — только OAuth-токен. Получается один раз:

1. Приложение. На oauth.yandex.ru — «Для доступа к API или отладки». В поле «Доступ к данным» начните вводить «Директ» и выберите «Использование API Яндекс Директа» (direct:api) — без этого права приложения нет в заявке (для Метрики — доступ к Метрике). Скопируйте ClientID. Иконка — /logo/webvane-mark-512.png.
2. Заявка на доступ к API (только для Директа). В Директе, под тем же логином: API → Мои заявки → «Получить доступ к API» → «Новая заявка» → ClientID, почта, сведения о приложении → «Отправить». Страница открывается, когда в Директе есть хотя бы одна кампания. Рассмотрение — от часа до трёх суток; до одобрения Директ отклоняет даже верный токен.
3. Токен. «Подключения» → Яндекс Директ → «Настроить» → впишите ClientID в поле «ID приложения Яндекса» — появится кнопка «Получить токен ↗» → она открывает страницу Яндекса в новой вкладке → войдите под аккаунтом Директа → скопируйте y0_… в поле «OAuth-токен Директа» → «Сохранить». ClientID не секрет — браузер его запоминает и подставляет в следующий раз (и в форму Метрики).

«У этого приложения нет доступа в Директ» в заявке — у приложения нет права direct:api: oauth.yandex.ru → приложение → «Редактировать» → «Доступ к данным» → «Использование API Яндекс Директа» → сохранить, затем обновить заявку и снова выбрать ClientID. Если право есть — проверьте, что приложение типа «Для доступа к API или отладки» и создано под тем же логином, под которым подаётся заявка.

Заявку подаёт один раз владелец приложения; если на сервере задан WEBVANE_YANDEX_CLIENT_ID, ClientID уже вписан, а кнопка «Войти» получает токен сама.

Где хранится токен. Токен — ваш: он принадлежит пользователю, который его ввёл или вошёл через Яндекс, а сайт на него ссылается. В базе он зашифрован ключом сервера (WEBVANE_MASTER_KEY), в панели виден только конец — «токен ••••x7Qz · ваш» (или «другого пользователя»; «сайта» — токен, перенесённый из прежней версии). Новый токен заменяет прежний; пустое поле токена в форме — не менять (в поле подсказка «сохранён ••••x7Qz — пусто: не менять»). «Отключить» — сразу, без подтверждения: подключение убирается с сайта, токен удаляется, если на него не ссылается другой сайт. Если ключ шифрования на сервере не задан, под списком подключений — предупреждение: токены хранятся открыто, пока владелец сервера не задаст ключ.

Google Ads

«Войти» через Google и в «Настроить» — «Номер клиента Google Ads (10 цифр)». Метка — в суффиксе конечного URL объявления, расходы — раз в час; сразу — кнопкой «Обновить расходы» («Обновлено строк расходов: N.»).

Telegram Ads

API у рекламодателя нет: выгружайте статистику CSV из кабинета и загружайте в Расходы — кнопка «Загрузить CSV» в строке Telegram Ads открывает их. После первой загрузки строка — «подключено». Объявления заводятся в Новом размещении — у каждого своя метка.

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

«Войти» через Яндекс (или токен вручную, как у Директа) и в «Настроить» — «Номер счётчика». Включите в настройках сайта опознание по cookie Метрики (Счётчик): один номер посетителя в Webvane и Метрике. Отправить конверсии — регистрации, запросы кредитов и оплаты уходят в Метрику офлайн-конверсиями по ClientID (цели wv_signup, wv_credits_requested, wv_payment) — Директ оптимизирует показы по ним. Ответ — «Отправлено: N.»; 0 — нет опознанных по cookie Метрики посетителей с регистрацией или оплатой за период.

Google Analytics 4

«Настроить»: «Название потока (для себя)», «Measurement ID» (G-…) и «API secret потока». Secret хранится секретом сайта, зашифрованно, в поле видна подсказка «сохранён ••••…»; пустое поле — прежний не меняется. Отправить события — sign_up, generate_lead (запрос) и purchase (с суммой) уходят в GA4 по client_id посетителя (Measurement Protocol); ответ — «Отправлено: N.».

Приложения Яндекса и Google

Вход через Яндекс и Google работает, когда владелец сервера зарегистрировал приложения и задал WEBVANE_YANDEX_CLIENT_ID / SECRET и WEBVANE_GOOGLE_CLIENT_ID / SECRET / DEVELOPER_TOKEN. Адрес возврата для обоих — https://ваш-сервер/mk/oauth/callback (показан внизу списка подключений, пока вход выключен). Токены хранятся только на вашем сервере.

Ошибки