Интеграция с Яндекс Директом

Что даёт подключение

После OAuth Maxiflow получает доступ только на чтение: подтягивает список кампаний, дневной расход и типы объявлений. Кампании в самом Директе не меняются — токен нужен только чтобы посчитать стоимость подписчика по каждому боту и показать её в /campaigns и на дашборде.

Без подключённого Директа воронка всё равно работает, но в отчётах не будет расхода — только клики и подписки.

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

1. Откройте /integrations. В карточке «Яндекс.Директ» нажмите «Перейти к подключению» — попадёте в /campaigns.
2. На странице /campaigns в блоке «Шаг 1» нажмите «Открыть Яндекс».
3. В окне Яндекса авторизуйтесь под логином, к которому привязан рекламный кабинет, подтвердите доступ и скопируйте показанный код подтверждения. Вернитесь на /campaigns, вставьте код в поле «Код подтверждения из Яндекса» и нажмите «Подключить аккаунт Директа». После этого в карточке появится логин и чип «подключён».

Подключается один аккаунт на арендатора. Если нужно поменять — отключите текущий и пройдите OAuth заново под нужным логином.

Ссылка для объявления

Атрибуцию Maxiflow строит по параметрам в URL. Готовую ссылку соберите в /traffic — там выбираете бота и вариант интеграции: «Невидимый редирект», «JS-сниппет на свой лендинг» или «Мини-лендинг Maxiflow» и получаете код с уже расставленными макросами.

Базовый шаблон для варианта «Невидимый редирект»:

https://maxiflow.ru/r/<bot>?yclid={yclid}&c={campaign_id}&post=<ссылка на пост в MAX>

Что происходит по шагам:

• Директ подставляет реальные значения вместо {yclid} и {campaign_id} в момент клика.
• Maxiflow регистрирует визит в вашей Метрике (чтобы офлайн-конверсия потом сматчилась), сохраняет yclid и campaign_id в сессию и редиректит на указанный post или сразу в бота.
• Когда пользователь подписывается через бота, Maxiflow привязывает подписку к клику и в /campaigns появляется точная стоимость подписчика.

Обязательные и рекомендуемые макросы

• {yclid} — обязателен. Без него офлайн-конверсия в Метрику не уйдёт, стоимость подписчика посчитать нельзя.
• {campaign_id} — обязателен для разбивки по кампаниям в дашборде и в /campaigns.
• {gbid} и {source} — не читаются Maxiflow, но полезны для отчётов самой Метрики (площадка показа, группа объявлений). Добавляйте, если планируете анализировать источники внутри Директа.

Фигурные скобки, регистр и подчёркивание — как в шаблоне. {Campaign_Id} или %yclid% Директ не подставит.

Что делать при «Яндекс (макрос не подставлен)»

Если в отчётах Метрики или в источниках Maxiflow попадаются визиты с yclid=%7Byclid%7D (это URL-энкоденные фигурные скобки) или подписью «Яндекс (макрос не подставлен)», значит Директ отдал клик, но не заменил плейсхолдер значением. Причины по частоте:

1. Ссылка вставлена не в поле «Ссылка» объявления, а в текст, быстрые ссылки или отображаемую ссылку — там макросы Директ не разворачивает. Перенесите URL в основное поле ссылки.
2. Ссылка предварительно прогнана через сокращатель (bit.ly, clck.ru и т. п.). Сокращатель фиксирует плейсхолдер как есть. Вставляйте прямую ссылку https://maxiflow.ru/r/....
3. Опечатка в макросе: пробел внутри { yclid }, кавычки, кириллическая «с» вместо латинской в {campaign_id}. Скопируйте шаблон из /traffic целиком.
4. Тип кампании не поддерживает макрос. Для мастера кампаний и товарных используйте автоматические utm-метки Директа плюс {yclid} — остальные подставятся из шаблона Директа.

Проверка после запуска

• Через 15–30 минут после первого клика откройте /campaigns и нажмите «Обновить статистику» — появится расход по кампании.
• В /campaigns включите тумблер «Отслеж.» у нужных кампаний и привяжите каждую к боту, иначе стоимость подписчика не посчитается.
• Первый живой подписчик из рекламы появится в /subscribers с источником «Директ» и заполненной колонкой «Кампания» — это финальное подтверждение, что цепочка работает.

Что дальше

• Настройка целей Метрики
• Атрибуция и отчёты
• Подключение MAX-бота