Шаблон автозагрузки Avito: где взять и как не сломать XML

Где лежит официальный шаблон

Актуальный шаблон берут у самой площадки, не с форума и не из чужого фида. В кабинете Avito откройте автозагрузку, затем «Правила и шаблоны». Слева выберите категорию, в которой размещаетесь. Там же список обязательных полей и примеры значений.

Тот же справочник есть на autoload.avito.ru. Если объявлений ещё нет, скачайте пустой шаблон выбранного раздела. Если карточки уже висят, удобнее выгрузить файл из автозагрузки: в нём будут ваши Id и живые примеры заполнения.

Пустой файл быстрее, но в нём нет ваших ключей. Выгрузка из кабинета копирует живую структуру: вы видите, как площадка назвала колонку, а не гадаете по блогу 2023 года. Не скачивайте «универсальный xml» у подрядчика: он устаревает без уведомления, а ошибки потом ищут в вашей CRM.

Excel-шаблон и XML — разные оболочки одних полей

Скачанный файл чаще всего таблица: колонки Id, Title, Address, Category, цена, фото. XML — те же данные тегами внутри Ads и Ad. Avito принимает оба формата. Путать их опасно только если копировать «кусок xml» в ячейку Excel или наоборот.

Для постоянной работы удобнее XML по ссылке. Таблицу оставляют как старт: импортировали, проверили поля, дальше правите в редакторе. Каждый день заново скачивать шаблон и заливать файл с компьютера не нужно, если URL фида уже стоит в автозагрузке.

Кодировка — UTF-8. Открыли таблицу в старом редакторе и сохранили «как ANSI» — кириллица в заголовке и адресе поедет. Avito увидит кракозябры, хотя шаблон скачан верно. Сохраняйте из Excel или из CRM. В Excel-файле Avito несколько листов: инструкция, подсказки, категория. Объявления живут на листе раздела, не на листе с правилами.

Почему чужой шаблон ломает выгрузку

У услуг, товаров и недвижимости набор тегов разный. В клининге ждут Category вроде «Предложение услуг» и уточнения GoodsType или ServiceType. В объявлении квартиры появятся площадь и этаж. Скопировали структуру «как у риелтора» в уборку квартир — обязательные поля не совпадут, строка упадёт в отчёте.

Даже внутри услуг шаблон «мойка окон» не равен шаблону «ремонт стиральных машин». Берите файл той ветки, куда клиент ищет вашу работу. Не «где меньше колонок».

Перед копированием чужой строки спросите: это та же ветка справочника или просто похожий бизнес. Химчистка дивана и генеральная уборка квартир для клиента близки. Для автозагрузки это разные наборы полей. Ошибка всплывёт не сразу, а в отчёте по Id.

• Категория и подкатегория — из текущего справочника Avito
• Значения списков копируйте как есть, без своих формулировок
• Не переносите теги из фида другой ниши
• После смены раздела на площадке скачайте шаблон заново

Какие поля нельзя игнорировать даже в «простом» файле

Почти в любом шаблоне есть Id. Это ваш постоянный ключ карточки. Его не меняют между выгрузками. Рядом ListingFee: Package, PackageSingle или Single — откуда списать размещение. Пустой тег площадка часто читает как пакет. Тогда кошелёк полный, а объявление не встаёт.

Адрес, категория, заголовок, описание, цена и фото тоже должны соответствовать правилам раздела. Для фида по ссылке фото отдают публичными URL. Имена файлов из zip к постоянной ссылке XML почти не подходят.

Корень XML задаёт генератор: Ads, target Avito.ru, formatVersion как требует площадка. Не копируйте корень из YML Маркета и не ставьте версию формата из старого гайда. Описание лучше писать в редакторе обычным текстом: генератор сам обернёт спецсимволы. В блокноте символ & в фразе «уборка кухни и санузла» ломает разметку.

Как люди ломают XML в блокноте

Блокнот и случайный редактор легко портят кодировку и скобки. Лишний символ в Description, неэкранированный &, незакрытый тег — и Avito не читает файл целиком или отклоняет пачку строк. Человек смотрит «на глаз»: вроде текст на месте. Загрузчик смотрит разметку.

Вторая ошибка — править уже сгенерированный фид, а на следующий день снова выгрузить его из CRM и затереть правки. Источник правды должен быть один: таблица или редактор. XML — результат, не черновик.

Третья — править «только одну кавычку» в чужом редакторе с автозаменой. Он может переставить теги, сменить кодировку или вставить типографское тире внутрь атрибута. Для клининга с сотней городов цена такой правки — красный отчёт на всю пачку, не на одну строку.

Типичные поломки, которые маскируются под «битый шаблон»

Смешали ImageUrls и ImageName в одной карточке. Поставили новый Id той же услуге в том же городе. Указали ListingFee, которого нет в шаблоне раздела. Добавили тег «для красоты» из чужого фида. В отчёте это выглядит как ошибка формата, хотя «шаблон вроде скачали».

Для клининга частый сюжет: в Excel оставили колонку из другого листа, генератор вывел пустой обязательный параметр. Или в адресе написали «Мск» вместо «Москва». Шаблон тут ни при чём — значение не из справочника площадки.

Ещё маска: две карточки с одним Id. Площадка не понимает, какую обновлять. Шаблон скачан правильно, ключи — нет. Перед выгрузкой пробегите Id глазами. Пустые обязательные списки (категория, способ связи, ListingFee) тоже выглядят как «формат», хотя это просто незаполненная ячейка.

• Либо ссылки на фото, либо имена из архива
• Id стабильный, без даты и цены внутри ключа
• ListingFee только из списка шаблона
• Не добавляйте теги, которых нет в вашей категории

Проверьте файл до кабинета Avito

На autoload.avito.ru есть проверка XML. Она ловит сломанную разметку и грубые структурные ошибки раньше, чем вы ждёте отчёт в кабинете. Это не модерация текста и не проверка фото по смыслу. Но скобку и кодировку отсекает.

Откройте и саму ссылку фида в браузере. Должен показаться XML-текст, не страница входа и не 404. Если файл открывается только из вашего офиса, робот Avito его тоже может не забрать.

xmlcheck не заменяет отчёт кабинета. Он не узнает, что фото закрыто логином и что Package не сработает без пакета размещений. Сначала структура файла, потом смысл полей в отчёте автозагрузки. Если проверка зелёная, а кабинет красный — ищите конкретный Id, не «весь шаблон».

Как пользоваться шаблоном через FeedCRM

Импортируйте Excel-шаблон Avito в нужный API-аккаунт. Поля попадут в редактор: заголовок, адрес, категория, ListingFee, фото ссылками. XML собирается сам. У каждого кабинета Avito — своя публичная ссылка. Её один раз вставляют в автозагрузку.

Дальше не скачивайте «последний правильный xml» на рабочий стол. Меняете цену генеральной уборки в карточке — фид по тому же URL уже новый. Avito заберёт его по расписанию. Смотрите отчёт, не витрину через минуту.

После импорта число строк может быть меньше, чем в Excel: пустые без заголовка пропускаются. Откройте три карточки: мойка окон, генеральная, химчистка. Проверьте Id, категорию из справочника, полный адрес, ListingFee и ссылки на фото. Так ловите сдвиг колонок до первой массовой загрузки.

Когда шаблон на площадке обновился

Avito периодически добавляет поля в категорию. В инструкции к файлу прямо сказано: новые параметры лучше заполнять, даже если они пока необязательные. Имеет смысл раз в несколько месяцев открыть «Правила и шаблоны» своей ветки и сверить список.

Не копируйте старый фид годичной давности как эталон. Если в актуальном шаблоне услуг нет какого-то тега, не держите его «на всякий случай». Лишнее поле иногда проходит, иногда валит строку. Ориентир — текущий шаблон, не архив подрядчика.

Сменили нишу в кабинете — с мойки окон на химчистку — скачайте шаблон новой ветки. Старые колонки могут исчезнуть, появятся новые обязательные. Рабочие Id сохраните. Поля раздела заполните заново, не «допишите рядом» старые теги.

Что считать успехом после смены шаблона

Ссылка фида не должна меняться только из-за новых колонок. Меняется содержимое XML. В автозагрузке остаётся тот же URL кабинета. Сверяете отчёт: сколько строк принято, нет ли ошибок категории, адреса и ListingFee. Витрина подождёт цикл.

Для сети кабинетов не предполагайте, что Тула и Москва живут на одном файле «как в прошлом году». У каждого профиля свой фид и своя проверка. Обновили справочник — пройдите по аккаунтам, а не один раз «для всей компании».