База знаний / Тексты / Переменные из колонок

Переменные из колонок в заголовке и описании

Чтобы не вписывать цену, город или характеристики вручную в каждое объявление, используйте $(Название колонки). При сборке XML ТАБС заменит переменную значением из указанной колонки в той же строке того же листа.

Пример: цена в описании

  1. Найдите колонку с ценой и посмотрите её название в строке заголовков таблицы. В примере она называется «Цена».
  2. В нужной строке укажите в этой колонке 4113.
  3. В колонке описания этой же строки напишите: Стоимость — $(Цена) ₽ за штуку.
  4. Запустите сборку XML проекта. В описание для выгрузки попадёт: «Стоимость — 4113 ₽ за штуку.»

Это не формула Google Таблиц: знак = не нужен. В самой ячейке описания останется шаблон $(Цена); готовый текст формируется в XML. Если колонка у вас называется иначе, укажите именно её название.

Несколько переменных и свои колонки

В одном тексте можно использовать несколько переменных и повторять их. Например, при колонках «Модель», «Город», «Цена» и вашей дополнительной колонке «Хар»:

$(Модель) в городе $(Город).
Цена — $(Цена) ₽.
$(Хар)

Такой шаблон можно скопировать на другие строки: для каждого объявления подставятся его собственные значения. Дополнительную колонку можно использовать как источник текста, даже если у неё нет XML-тега Avito. Не меняйте служебные строки и теги существующих колонок ради подстановки.

Переменные поддерживаются в колонках заголовка (Title) и описания (Description). Например, в заголовке: $(Модель) — доставка в $(Город). Учитывайте требования Avito к длине и содержимому готового заголовка.

Подстановка по техническому тегу

Вместо названия колонки можно указать её технический XML-тег из служебной строки: $(tag:Price). Например:

Стоимость — $(tag:Price) ₽ за штуку.

Этот вариант ищет колонку по тегу Price, а не по русскому названию «Цена». Он удобен, если название колонки переименовано. Для своей колонки без XML-тега используйте обычный вариант — например, $(Хар).

Правила подстановки

  • Используйте знак доллара и круглые скобки: $(Цена). Варианты ${Цена} и {Цена} для этой функции не подходят.
  • Регистр букв не важен: $(Цена) и $(цена) найдут одну колонку. Пробелы по краям имени и начальная отметка обязательности * не мешают поиску.
  • При одинаковых названиях нескольких колонок выбирается первая слева. Лучше дать вспомогательным колонкам разные имена.
  • Подставляется содержимое ячейки, а не результат отдельного расчёта. Запись $(Цена * 1.05) не увеличивает цену: сервис будет искать колонку с именем «Цена * 1.05».
  • Знаки валюты и пояснения добавляйте в сам шаблон. Если в ячейке уже есть «₽», не дублируйте его после переменной. Подстановка сама не округляет и не форматирует число.
  • Подстановка выполняется за один проход. Если ячейка-источник сама содержит $(Другая колонка), вложенная переменная повторно не раскрывается. Не ссылайтесь на саму колонку заголовка или описания.
  • Это подстановка для сборки XML из таблицы, а не переменные брифа ИИ-продавца и не замена значений во всех колонках таблицы.

Если цена приходит из входящего фида

Сначала синхронизируйте цены из фида в таблицу, затем соберите XML. Переменная возьмёт значение, которое находится в строке таблицы на момент сборки. Она не обращается к фиду поставщика самостоятельно и не запускает синхронизацию.

Если включено «Управление ценой», после синхронизации в колонке Price будет цена с выбранной наценкой или скидкой и округлением. Именно значение этой ячейки можно вставить в текст через $(tag:Price).

Если вместо значения получилось пустое место

  • Колонки нет или в имени опечатка: переменная заменяется пустой строкой, а в отчёте проверки появляется предупреждение «Не найдена переменная $(…)». Сверьте название с заголовком или используйте правильный tag:.
  • Колонка есть, но ячейка пуста: подставится пустой текст, без предупреждения о ненайденной переменной. Заполните значение в той же строке, где находится объявление.
  • Шаблон остался как есть: проверьте запись со знаком доллара и закрывающей скобкой, а также то, что шаблон стоит именно в Title или Description. В таблице исходный шаблон должен сохраняться — проверяйте результат в XML.
  • В тексте старая цена: сначала обновите её в таблице, затем повторите сборку XML. Для изменения объявления на Avito площадка должна обработать обновлённую выгрузку.

Перед массовым использованием проверьте готовое объявление в XML: название, цену в тексте, единицы измерения и отсутствие пустых фраз. Подробнее — «Проверка строк перед сборкой XML».