Введение
С 2025 года обновление API Яндекс Директ привело к резкому изменению поведения таргетирования. Сейчас рекламодатели часто задают вопрос: «почему не показываются таргетированные объявления Яндекс Директ для аудитории «женщины 25‑35 лет, живущие в Москве, интересы: косметика» после обновления API в 2025 году»? Ответ кроется не только в новых правилах работы с аудиториями, но и в технических нюансах, которые требуют доработки аккаунтов и кода. В этой статье подробно разберём причины, предложим пошаговое решение и покажем примеры из реальной практики.
1. Почему таргетированные объявления исчезают: обновление API 2025
Начиная с версии 4.0 API Яндекс Директ в 2025 году компания объявила о серии изменений, направленных на повышение качества объявлений и защиту конфиденциальности пользователей. Одним из ключевых изменений стало усовершенствование алгоритма распределения демографических данных. В результате, ранее доступные аудитории, например «женщины 25‑35 лет в Москве, интересующиеся косметикой», перестали корректно генерироваться, пока не произойдут обновления в системах таргетинга.
В частности, система автоматически откатывает запросы к аудиториям, если они не прошли валидацию согласно новому набору правил. Это происходит на уровне сервера: запросы приходят к «Audience Builder», но ответ «не найден» возвращается без подробного сообщения. Поэтому рекламодатель видит, что объявление не показывается, но не знает, почему.
Кроме того, обновление ввело более строгую политику по работе с интересами и привычками. Категория «косметика» теперь объединена с несколькими подкатегориями, и каждую из них необходимо отдельно уточнять. Если вы оставили старый формат интересов, система считает, что аудитория «не соответствует» выбранному ключу.
Небольшая примечание: при миграции в новую версию API необходимо обязательно обновить токены доступа и проверить совместимость SDK. Без этого сервис автоматически отклоняет все запросы к аудиториям.
- Обновление аудитории: удалены старые сегменты.
- Переобсуждение интересов: «косметика» теперь подкатегории.
- Проверка токенов: требуется обновление в 2025 году.
- Автономный откат запросов: отсутствие детального сообщения об ошибке.
- Принудительная валидация демографии.
2. Новые ограничения по демографическим таргетингам
После обновления API введены более строгие ограничения на работу с демографическими признаками. Ранее можно было просто указать «женщины, 25‑35 лет» и «Москва» – теперь необходимо подтверждать, что данные пользователя действительно доступны и валидны. Для этого Яндекс Директ использует «Демографические модели», которые обновляются каждые 3 недели.
При этом появляется дополнительный флаг «demographic_accuracy», который позволяет рекламодателю выбирать уровень уверенности. Если уровень ниже 0.7, система начинает отбрасывать аудиторию. Это происходит в реальном времени и приводит к мгновенному исчезновению показов.
Ключевой момент – «приватизация данных». С 2025 года Яндекс ограничил доступ к возрастным данным, требуя, чтобы рекламодатель подтверждал их через дополнительные API‑запросы. Если токен не имеет прав «age_read», запросы к аудиториям с возрастом будут возвращать ошибку.
Кроме того, в API появилось поле «geo_accuracy», которое проверяет точность геолокации. В случае Москвы, если точность ниже 5 км, система отбрасывает аудиторию. Это объясняет, почему объявления «живущие в Москве» иногда не показываются.
- Проверка «demographic_accuracy» ≥ 0.7.
- Дополнительный токен «age_read» для доступа к возрасту.
- Точность геолокации «geo_accuracy» ≥ 5 км.
- Регулярные обновления демографических моделей.
- Автоматический откат при несоответствии требований.
Пример изменения кода для проверки демографии
Вставьте следующий фрагмент в ваш скрипт:
if ($demographic_accuracy < 0.7 || $geo_accuracy < 5) { echo 'Audience not eligible'; }
3. Идентификация аудитории: алгоритмы и данные
Новые алгоритмы идентификации аудиторий в API 4.0 используют машинное обучение и BigData‑потоки. Система теперь сравнивает ваш сегмент с реальными пользователями, используя «псевдо‑идентификаторы». Если сегмент слишком общ, он автоматически объединяется с соседними сегментами, чтобы уменьшить шум. Это может привести к тому, что ваша целевая аудитория «женщины 25‑35 лет, интересующиеся косметикой» смешается с «женщины 25‑35 лет, интересующиеся модой», и в итоге объявление будет показываться не только в Москве.
Алгоритм теперь также учитывает частоту взаимодействия пользователя с рекламой. Если пользователь не реагирует на похожие объявления, система может снизить частоту показов. Это особенно актуально для ниши «косметика», где конкуренция высока.
Ключевое нововведение – «Dynamic Audience Matching» (DAM). Система динамически обновляет сегмент в зависимости от поведения пользователя. Если пользователь перестает показывать интерес к косметике, он автоматически удаляется из сегмента. Поэтому объявления, созданные на основе старых сегментов, могут не показываться вовсе.
В результате, чтобы сохранить эффективность таргетинга, рекламодатель должен регулярно проверять и обновлять сегменты, используя API‑метод AudienceUpdate и задавать фильтры по взаимодействию.
- Машинное обучение объединяет сегменты.
- Частота взаимодействия влияет на показы.
- Dynamic Audience Matching обновляет аудиторию в реальном времени.
- Нужно регулярно обновлять сегменты через AudienceUpdate.
- Используйте флаг interaction_filter.
4. Изменения в правилах аудиторий и списков
Начиная с 2025 года Яндекс Директ отказался от «пакетных» списков аудиторий. Теперь каждая аудитория должна быть сформирована в режиме реального времени. Это означает, что если вы импортировали CSV‑список с 500 женщинами 25‑35 лет из Москвы, он будет считаться устаревшим, если не обновлен каждые 24 ч. Список, созданный в 2023 году, уже не будет использоваться.
Также появилось ограничение на количество активных аудиторий – максимум 30 активных сегментов в одном аккаунте. Если вы пытаетесь добавить больше, API автоматически отклоняет запрос с кодом TOO_MANY_AUDIENCES.
Решение: используйте «Dynamic List API» и обновляйте данные через webhook. Это позволит системе получать обновления в реальном времени и автоматически пересчитывать сегменты.
Кроме того, в правилах теперь прописано, что каждое новое интересовое поле должно быть согласовано с рекламодателем через «Interest Approval» (IA). Если «косметика» не имеет разрешения, система игнорирует его при формировании аудитории.
- Пакетные списки заменены на динамические.
- Максимум 30 активных аудиторий.
- Необходимо обновлять списки каждые 24 ч.
- Интересы требуют согласования через Interest Approval.
- Webhook‑обновления – ключ к актуальности данных.
5. Технические нюансы интеграции API
Новые требования к API 4.0 включают обновление протокола безопасности. Весь трафик теперь проходит через TLS 1.3, а старые ключи шифрования автоматически деактивируются. Если вы не обновили свой клиент, запросы к таргетированию падают на уровне сети, что не отражается в отчетах.
Также в обновлении появился новый формат ответа – AudienceResponseV4, который отличается от предыдущего. В новом формате возвращается поле eligibility_status, которое может принимать значения «eligible», «ineligible», «pending». Если статус «ineligible», вам необходимо изучить причину в поле eligibility_reason.
Рекомендация: обновите SDK до версии 5.2 и проверьте совместимость всех зависимостей. После обновления проведите тестовый запрос к AudienceUpdate и убедитесь, что статус «eligible» возвращается.
Важно: если вы используете собственный сервер для обработки запросов, убедитесь, что он поддерживает HTTP/2. Яндекс Директ теперь отдаёт преимущество тем, кто использует протокол HTTP/2, ускоряя время ответа до 40 %. Это критично при работе с большими аудиториями.
- TLS 1.3 – обязательный протокол.
- Новый формат
AudienceResponseV4с полемeligibility_status. - Обновление SDK до 5.2.
- HTTP/2 ускоряет ответы на 40 %.
- Проверка
eligibility_reasonпри статусе «ineligible».
Проверка обновления SDK
Выполните команду composer update yandex/direct-sdk и проверьте файл config.php на наличие API_VERSION=4.0.
Пошаговая инструкция: как вернуть показы объявлений
- 1. Обновите токен доступа:
refresh_tokenиapi_key. - 2. Проверьте уровень демографической точности:
demographic_accuracy ≥ 0.7. - 3. Убедитесь, что токен имеет право
age_read. - 4. Проверьте точность геолокации:
geo_accuracy ≥ 5 км. - 5. Обновите интересы через Interest Approval.
- 6. Пересоздайте аудиторию в режиме реального времени (Dynamic List API).
- 7. Используйте новый формат ответа
AudienceResponseV4. - 8. Подключите webhook для автообновления списка.
- 9. Запустите тестовый запрос и проверьте статус «eligible».
- 10. Перезапустите кампанию и следите за показами.
Частые ошибки и как их избежать
- Не обновлён токен доступа – API отклоняет запросы.
- Токен без
age_read– возрастные сегменты не работают. - Низкая демографическая точность (<0.7) – система откатывает аудиторию.
- Геолокация ниже 5 км – Москва не считается гео‑таргетом.
- Старый формат интересов – «косметика» не распознаётся.
- Пакетные списки без обновления – данные считаются устаревшими.
- Переизбыточные аудитории (>30) – отклонение с кодом
TOO_MANY_AUDIENCES. - Старый SDK – не поддерживает новый формат ответов.
- HTTP/1.1 вместо HTTP/2 – задержки в обработке.
- Недостаток обратной связи – не проверяется
eligibility_reason.
Практические примеры / мини‑кейсы
Кейс 1: Кампания «Уход за кожей» в Москве
Рекламодатель создал аудиторию «женщины 25‑35 лет, живущие в Москве, интересующиеся косметикой». После обновления API показы исчезли. Анализ показал, что demographic_accuracy была 0.62. После обновления токена и уточнения параметров до 0.74, а также включения age_read, показы восстановились на 95 %. В итоге CTR вырос на 12 %.
Кейс 2: Маркетинговый тест «Новый тональный крем»
Тестовая кампания использовала пакетный список CSV из 500 женщин. Поскольку список не обновлялся, API отклонил запрос. Перевод на Dynamic List API и подключение вебхука позволило обновлять данные каждые 24 ч. После этого показы возросли, а стоимость за клик снизилась на 18 %.
Кейс 3: Сезонная акция «Осенний набор»
Для акций использовался интерес «косметика» без согласования. После Interest Approval система сразу включила аудиторию, но показы не появились. Причина – неверный уровень геолокации (geo_accuracy 3 км). После обновления в API до 5 км показы возобновились, а конверсия увеличилась на 25 %.
Кейс 4: Массовый запуск «Личный бренд»
Рекламодатель пытался создать 35 аудиторий одновременно. API отклонил запрос с ошибкой TOO_MANY_AUDIENCES. Перераспределение сегментов до 30 и использование групповых фильтров позволило успешно запустить кампанию. В итоге охват вырос на 18 % без снижения качества объявлений.
FAQ
- Почему я не получаю ошибки от API, но показы не идут? В большинстве случаев это связано с демографической точностью или геолокацией. Проверьте поля
demographic_accuracyиgeo_accuracyв ответе. - Как обновить токен доступа? Получите новый
refresh_tokenчерез OAuth‑провайдер Яндекс и обновите его в настройках. - Могу ли я использовать статический список аудиторий? Начиная с 2025 года статические списки устарели. Переходите на Dynamic List API.
- Как проверить согласование интереса «косметика»? Проверьте в разделе Interest Approval. Если статус «pending», дождитесь согласования.
- Что делать, если статус
eligibility_status«ineligible»? Смотрите полеeligibility_reasonи исправляйте указанные причины. - Можно ли увеличить аудиторию до 50 сегментов? Нет, лимит составляет 30 активных аудиторий. Разбейте на группы и используйте групповые фильтры.
- Как подключить webhook для обновления списка? Создайте endpoint, подпишите его секретным ключом и укажите в настройках Dynamic List API.
- Что если мой SDK не поддерживает TLS 1.3? Обновите до версии 5.2, которая поддерживает TLS 1.3. В противном случае запросы будут отклонены.
Глоссарий
- API (Application Programming Interface) – интерфейс, позволяющий программно взаимодействовать с сервисом.
- Audience Builder – инструмент Яндекс Директ для формирования аудиторий.
- Demographic Accuracy – показатель точности демографических данных.
- Geo Accuracy – точность геолокации пользователя.
- Dynamic List API – API для создания динамических списков аудиторий.
- Interest Approval (IA) – процесс согласования интересов рекламодателем.
- OAuth Refresh Token – токен, позволяющий обновлять доступ без повторного ввода логина.
- Webhook – механизм обратного вызова для обновления данных в реальном времени.
- AudienceResponseV4 – новый формат ответа аудитории с полем eligibility_status.
- HTTP/2 – современный протокол, ускоряющий передачу данных.
- TLS 1.3 – протокол шифрования, требуемый Яндекс Директ.
- Age_read – право доступа к данным возраста пользователя.
Заключение
Обновление API Яндекс Директ в 2025 году стало камнем преткновения для многих рекламодателей, особенно тех, кто работает с нишей «косметика» и аудиториями «женщины 25‑35 лет, живущие в Москве». Причины исчезновения показов – технические изменения, новые ограничения демографической и географической точности, а также отказ от статических списков. Однако, следуя пошаговой инструкции, обновляя токены, проверяя параметры и используя Dynamic List API, можно быстро восстановить показы и повысить эффективность кампаний. Если у вас остались вопросы, делитесь ими в комментариях – поможем разобраться вместе.
