Яндекс Аудитории в LidFly

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

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

1. Откройте личный кабинет LidFly. На главной найдите карточку «Аудитории и AppMetrica» и нажмите «Подключить».
2. Войдите под логином Яндекса, на котором работает Директ. Сегмент должен быть на том же логине, что и рекламная кампания, иначе понадобится выдать доступ к сегменту.
3. Разрешите LidFly доступ. Яндекс спросит одно разрешение сразу на Аудитории, приложения AppMetrica и данные логина.
4. Вернитесь на главную LidFly: логин появится в карточке. Для другого логина нажмите «Подключить ещё».
5. Подключите ИИ-клиент к MCP-серверу LidFly https://lidfly.ru/mcp/v3 по инструкции быстрого старта или работайте во встроенном чате LidFly.

Одно подключение сразу открывает и AppMetrica. Подключение относится к аккаунту LidFly, а не к отдельному Проекту. Если подключено несколько логинов, ИИ уточнит нужный и передаст его как audience_connection_id — это не тот же connection_id, что у Директа.

Что можно делать

От базы клиентов до рекламы в Директе

1. ИИ получает одноразовую приватную ссылку и загружает по ней ваш CSV-файл командой curl -T. Ссылка действует 5 минут.
2. ИИ запускает проверку без отправки и показывает отчёт: сколько строк подошло, сколько отброшено и почему.
3. После вашего подтверждения LidFly создаёт сегмент. Исходный файл удаляется сразу после отправки.
4. Яндекс обрабатывает сегмент, обычно несколько часов. Пока статус не «готов», Директ сегмент не видит.
5. При необходимости ИИ создаёт на основе сегмента похожую аудиторию.
6. ИИ создаёт в Директе условие ретаргетинга с этим сегментом и добавляет его в группу объявлений.

Требования к файлу

• CSV в кодировке UTF-8 или Windows-1251, до 10 МБ. Разделитель — запятая, точка с запятой или табуляция.
• Колонки phone и/или email. Подойдут и русские названия «Телефон», «Почта». Уже захешированные данные — колонки phone_SHA256 и email_SHA256.
• Остальные колонки в Яндекс не отправляются. Файл XLSX не принимается: сохраните таблицу как «CSV UTF-8».
• Нужно минимум 100 записей после очистки. Телефоны приводятся к виду 79991234567, e-mail — к нижнему регистру, дубли и строки без контактов убираются.
• Файл хранится у LidFly приватно не больше часа. Большую базу можно дозагрузить частями в тот же сегмент.

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

Типы геосегментов

Точки должны быть внутри региона показа кампании, иначе объявления не покажутся. В одном сегменте — до 1000 точек.

Примеры запросов к ИИ

• Покажи мои сегменты в Яндекс Аудиториях и какие из них уже можно использовать в Директе.
• Загрузи базу клиентов из файла ~/Downloads/clients.csv и сначала покажи отчёт проверки.
• Сделай похожую аудиторию на покупателей из этого сегмента.
• Создай сегмент из тех, кто отправил заявку на сайте по цели Метрики.
• Собери геосегмент людей, которые живут в радиусе 1 км от наших трёх магазинов.
• Подключи готовый сегмент к кампании «Ретаргетинг» в Директе.
• Выдай доступ к сегменту логину агентства.

Инструменты чтения

Эти инструменты только смотрят данные и ничего не меняют в Аудиториях.

• audience_get_segments — сегменты логина: тип, статус обработки, размер и готовый идентификатор цели для Директа. Можно отфильтровать по типу и показать только готовые.
• audience_get_segment_grants — кому выдан доступ к сегменту.

Инструменты изменения

Эти инструменты меняют данные в Аудиториях. Перед ними ИИ должен описать действие, а удаление и замену данных — подтвердить у вас.

• audience_request_file_upload — приватная ссылка для загрузки CSV с базой клиентов.
• audience_create_segment_from_file — сегмент из базы клиентов: сначала проверка, затем создание.
• audience_update_segment_data — дописать, удалить или полностью заменить данные сегмента из файла.
• audience_create_lookalike — похожие пользователи на основе готового сегмента, степень похожести от 1 до 5.
• audience_create_metrika_segment — сегмент из цели, сегмента или счётчика Метрики.
• audience_create_appmetrica_segment — сегмент из пользователей приложения или сегмента AppMetrica.
• audience_create_geo_segment — геосегмент вокруг точек на карте.
• audience_rename_segment — переименовать сегмент. Условия ретаргетинга в Директе продолжат работать.
• audience_delete_segment — удалить сегмент.
• audience_grant_segment_access — выдать доступ к сегменту другому логину.
• audience_revoke_segment_access — отозвать доступ.

Для рекламы ИИ дальше использует инструменты Директа: add_retargeting_list и add_audience_targets. Подробнее — в документации по Яндекс Директу.

Безопасность и ограничения

• В Яндекс уходят только хеши телефонов и e-mail. Сырой файл не передаётся и удаляется после создания сегмента.
• Удаление сегмента и отзыв доступа ломают условия ретаргетинга в Директе, где он используется: Директ покажет «Сегмент не найден». Перед удалением ИИ проверяет условия ретаргетинга.
• Менять данные можно только у сегмента из файла и только после его обработки.
• Яндекс ограничивает создание и изменение сегментов: 10 в минуту, 100 в час и 500 в сутки на логин. LidFly проверяет лимиты до запроса.
• Если на логине больше 1000 геосегментов и в Директе используется меньше 5 % из них, Яндекс запретит создавать новые.
• Базы с идентификаторами мобильных устройств и сегменты по пикселю через LidFly не создаются. Готовые сегменты по пикселю ИИ видит в списке.