Как подготовить CSV аудитории для Яндекс Аудиторий
Готовь файл под конкретный тип сегмента Яндекс Аудиторий. Сначала определи допустимые поля и правила записи, затем преобразуй отдельную копию выгрузки. Исходник сохрани: иначе при ошибке формата будет трудно понять, какие значения изменились.
Для проверки структуры достаточно маленького набора вымышленных строк. Его не нужно загружать как рекламную аудиторию: такой набор проверяет парсер и преобразования, а не совпадение с реальными пользователями.
Составь паспорт будущего файла
Актуальная инструкция предлагает универсальный сегмент с CSV, заголовком и запятой как разделителем. Поддерживаются UTF-8 и Windows-1251, размер до 1 ГБ; для загрузки нужно не менее 100 записей. Эти требования к файлу не гарантируют готовность аудитории после сопоставления.
- Получатель и тип: Яндекс Аудитории, универсальный сегмент; дату требований запиши рядом.
- Источник и дата среза: откуда получены записи и по какому правилу отобраны.
- Столбцы и преобразования: что переносится, что нормализуется, какие пустые значения допустимы.
- Контроль: число исходных строк, строк после обработки, дублей и отбракованных записей.
- Ответственный: кто сверяет состав, загружает файл и фиксирует результат обработки.
Не добавляй в файл всё содержимое CRM ради удобства. Сначала реши, какие разрешённые идентификаторы нужны этому маршруту. Если тип старой загрузки отличается от универсального, открой его требования отдельно: одинаковое расширение не означает одинаковую схему.
Проверь заголовки и смысл значений
| Поле | Правило получателя | Что проверить в своей копии |
|---|---|---|
| phone | Мобильный номер с кодом страны, только цифры | Не потерян ли код страны; неоднозначные номера вынесены на проверку |
| Латиница, @ и домен; без прописных букв | Убраны случайные пробелы; значение не заменено догадкой | |
| client_id | Числовая строка ClientID Метрики | Это нужный тип идентификатора, а не внутренний ID другой системы |
| Дополнительные столбцы | Сохраняются, но не участвуют в сопоставлении | Не рассчитываешь на ИНН или статус сделки как на идентификатор матчинга |
Длинный идентификатор держи текстом. После открытия и сохранения через табличный редактор сравни его с исходником посимвольно: автоматическое преобразование в число может испортить точную запись. Проверь также фактический разделитель — внешне похожая таблица с точкой с запятой не заменяет CSV с запятой.
Если телефон и почта стоят в одной записи, убедись, что они относятся к одному пользователю: универсальный формат допускает использование разных типов данных в склейке. Не объединяй контакты по случайному совпадению названия компании.
Условная проверка без настоящих контактов
Ниже учебный набор. Адреса на домене example.test и числовые последовательности вымышлены; они нужны только для проверки преобразований и не предназначены для загрузки.
| Исходные поля | Что обнаружили | Действие |
|---|---|---|
| email: Test.A@example.test | Прописные буквы | Привести к test.a@example.test и записать преобразование |
| client_id: 1234567890123456789 | Длинная числовая строка | Сохранить как текст, сверить все символы после экспорта |
| email: test.a@example.test; повтор той же записи | Дубль после нормализации | Учесть один раз по выбранному правилу, сохранить счётчик дублей |
| Все идентификаторы пусты | Строка не несёт данных для сопоставления | Исключить из подготовленного файла с причиной |
| Телефон без однозначного кода страны | Нельзя надёжно нормализовать | Отправить на уточнение, не дописывать код наугад |
Прочитай полученный CSV тем же способом, которым его будет проверять твоя команда: заголовок, число полей в каждой строке, пустые ячейки, кавычки и кодировка. Сравни число записей до и после. Для каждой удалённой группы должна остаться причина; иначе сокращение файла нельзя объяснить.
После проверки файла начинается другая проверка
При ручной загрузке сохрани версию файла, выбранный тип сегмента и время операции. Затем зафиксируй статус обработки и доступный охват. Успешное создание объекта означает только начало или завершение конкретного этапа; оно не доказывает, что все строки сопоставились и реклама показана.
Готовность к ручной загрузке
Получить оставшиеся действия по конкретному файлу
Отметь выполненные проверки. Итог показывает оставшиеся действия, а не оценку качества бизнеса.
До загрузки нужны паспорт формата, проверка учебных строк, объяснимый состав, сохранённый исходник и ответственный за результат обработки. Отмеченные пункты не подтверждают сопоставление.
Что означает CSV-выгрузка Кирпича
В проверенном коде Кирпича есть подготовка ИИ-сегментов и выгрузка CSV, а также получение доступного ClientID Метрики. Само наличие этих функций не подтверждает, что любой полученный CSV совпадает с текущей схемой Яндекс Аудиторий или что реальная ИИ-операция успешно выполнена.
Поэтому используй данные и условия сервиса как вход для отдельной проверки. Прочитай реальные заголовки выгрузки, сопоставь поля с паспортом получателя и не переименовывай внутренний visitor_id в client_id только из-за похожего вида.
На выходе должны быть три вещи: неизменённый исходник, проверенный файл нужного формата и запись результата загрузки. Если последней записи ещё нет, честный статус — «подготовлено к загрузке». Это уже полезный результат, но аудитория в рекламной системе пока не подтверждена.
Источники и документация
- Требования к файлам · проверено 11.10.2026
- Сегмент на основе загружаемых данных · проверено 11.10.2026
- Кирпич: возможности сервиса · проверено 11.10.2026