Назад ко всем руководствам

Как создавать повторно используемые атрибуты для конкретных каналов, не перезаписывая исходные данные

Узнайте, когда следует заменить существующий атрибут товара, а когда создать отдельное значение для конкретного канала. В руководстве также объясняется, как выбирать имена, настраивать приоритет правил, повторно использовать значения в нескольких экспортах и проверять итоговый XML.

Когда этот подход полезен

Поставщик может передавать одну цену, название, значение остатка или описание, тогда как для разных каналов продаж требуются разные версии этих данных. Например, для вашего сайта может понадобиться цена с учётом маржи, а для маркетплейса — другое название или описание на другом языке.

B2BLIX Feed позволяет сопоставить данные поставщика с единой структурой товара, а затем применить отдельные правила преобразования при подготовке экспортов. Преобразование может заменить существующий атрибут или создать новый атрибут, который впоследствии можно использовать в шаблоне экспорта.

Краткий ответ

Заменяйте существующий атрибут, если преобразованное значение должно использоваться единообразно и вам не нужна отдельная версия сопоставленного значения в рабочем процессе экспорта.

Создавайте новый производный атрибут, если вам нужно:

  • Сохранить сопоставленное значение для сравнения или другого канала.
  • Создать разные цены, названия, описания или значения остатков для разных направлений.
  • Поддерживать контент на нескольких языках.
  • Повторно использовать одно и то же рассчитанное значение в нескольких экспортах.
  • Сделать шаблоны экспорта более понятными и удобными для сопровождения.

Изменения правил преобразования могут повлиять на сформированный XML после следующего создания экспорта. Проверьте результат в Export Checker, прежде чем использовать изменённый экспорт на работающем сайте, маркетплейсе или в другом направлении.

Как работают производные атрибуты

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

Например, вместо замены price можно создать:

  • price_for_website — для собственного магазина.
  • price_marketplace — для экспорта на маркетплейс.
  • price_comparison — для платформы сравнения цен.

Исходный сопоставленный price остаётся доступным под своим именем, а каждый экспорт может использовать производную цену, предназначенную для соответствующего направления. Преобразование не изменяет внешний исходный файл поставщика.

Когда замена существующего атрибута оправданна

Замена атрибута может быть уместна, если есть один однозначный результат, который должен использоваться во всём соответствующем рабочем процессе экспорта.

Распространённые примеры:

  • Замена price на цену, которая всегда включает требуемую маржу.
  • Замена stock на стандартизированное значение остатка, необходимое для направления.
  • Удаление HTML из каждого экспортируемого description.
  • Применение одинакового форматирования названия ко всем товарам в экспорте.

Перед заменой атрибута убедитесь, что другому экспорту или шаблону не требуется сопоставленное значение под исходным именем. Если для разных каналов нужны разные результаты, отдельные производные атрибуты обычно проще использовать и поддерживать.

Когда безопаснее создать новый атрибут

Новый атрибут безопаснее, если замена существующего значения может сделать его назначение непонятным или помешать другому экспорту использовать другую версию.

Это особенно полезно для:

  • Цен и маржинальности для конкретных каналов.
  • Названий с различными требованиями к длине или форматированию.
  • Описаний, подготовленных на разных языках.
  • Текстовой и HTML-версий одного описания.
  • Значений остатков, скорректированных для конкретного направления.
  • Промежуточных значений, используемых в более крупном расчёте.

Например, сохраните title как сопоставленное название поставщика и создайте title_marketplace для сокращённой или отформатированной версии. Так будет понятно, какое значение относится к какому рабочему процессу.

Как называть атрибуты для конкретных каналов

При создании собственного шаблона экспорта можно выбрать имена атрибутов, соответствующие вашему рабочему процессу. Используйте названия, которые ясно описывают и значение, и его назначение.

Практические примеры:

  • price_for_website
  • price_marketplace
  • stock_marketplace
  • title_marketplace
  • description_plain_text
  • description_lt

Последовательно используйте один шаблон именования. Избегайте расплывчатых названий, таких как new_price, value2 или final_data, поскольку при добавлении новых правил и экспортов их назначение может стать непонятным.

При использовании подготовленного шаблона экспорта следуйте сопоставлениям атрибутов, предусмотренным этим шаблоном, и не переименовывайте поля, не проверив, как они используются.

Создание правила преобразования

Чтобы создать или проверить производный атрибут, откройте Правила преобразования данных в своём аккаунте. Чтобы узнать о доступных полях и вариантах преобразования, прочитайте материал Правила преобразования данных.

При создании правила:

  1. Дайте правилу название, объясняющее его назначение и направление.
  2. Добавляйте условия фильтра только в том случае, если преобразование должно применяться к выбранным товарам.
  3. Выберите существующие атрибуты, используемые в расчёте или текстовом преобразовании.
  4. Укажите имя нового производного атрибута.
  5. Задайте приоритет правила относительно других правил, используемых экспортом.
  6. Сохраните правило и назначьте его нужной проекции экспорта.
Страница создания правил преобразования данных с названием правила, условиями фильтра, полями преобразования атрибутов и кнопкой Create rule
В форме правила преобразования задаются его условия и атрибут, который необходимо создать или изменить.

Использование нескольких правил и их приоритетов

Правила преобразования применяются в соответствии с настроенным приоритетом. Это позволяет управлять тем, какие правила будут обработаны раньше или позже в рабочем процессе экспорта.

На один и тот же атрибут может влиять несколько правил, но использовать такую схему следует осторожно. Итоговый результат может зависеть от приоритета каждого правила, условий фильтра и настроенного преобразования. Сам по себе приоритет не объединяет автоматически несколько значений в один расчёт.

Для удобной поддержки настройки:

  • Используйте одно правило или одно понятное выражение, если расчёт можно выполнить в одном месте.
  • Используйте отдельные правила, если для разных групп товаров нужны разные условия.
  • Давайте каждому правилу понятное название.
  • Избегайте нескольких несвязанных правил, записывающих данные в один и тот же производный атрибут, если такое поведение не является намеренным.
  • После изменения приоритетов проверяйте результат на репрезентативных товарах.

Повторное использование одного атрибута в нескольких экспортах

Правило преобразования можно выбрать более чем для одной проекции экспорта. Не нужно создавать отдельную копию одного и того же расчёта для каждого экспорта, если требуемая логика не отличается.

Откройте Экспорты в своём аккаунте и отредактируйте каждый экспорт, в котором должно использоваться правило. Включите нужное правило преобразования и сопоставьте его производный атрибут в шаблоне экспорта. Подробные инструкции по настройке экспорта приведены в материале Экспорты: создание и настройка проекций экспорта XML.

Например, один и тот же price_for_website могут использовать полный экспорт для сайта и небольшой рекламный экспорт. Это правило можно включить в обоих экспортах, а оба шаблона могут сопоставить этот атрибут с нужным элементом XML.

Что проверить в настройках экспорта

  • Убедитесь, что нужное правило преобразования включено для экспорта.
  • Проверьте приоритет правила относительно других включённых правил.
  • Проверьте, не записывает ли другое правило данные в тот же атрибут.
  • Убедитесь, что шаблон экспорта сопоставляет производный атрибут, а не исходный атрибут по ошибке.
  • Проверьте, что фильтры правила включают нужные товары.
  • Убедитесь, что имя атрибута одинаково записано в правиле и шаблоне.

Пример: отдельные цены для сайта и маркетплейса

Предположим, что сопоставленная цена поставщика price составляет €100. Цена на сайте должна включать маржу 20%, а цена на маркетплейсе — маржу 25%.

Можно создать:

  • price_for_website со значением €120.
  • price_marketplace со значением €125.

В шаблоне экспорта для сайта используется price_for_website. В шаблоне экспорта для маркетплейса используется price_marketplace. Сопоставленный price остаётся доступным для проверки и для любого экспорта, которому он по-прежнему нужен.

Проверка промежуточных и итоговых значений

Используйте Export Checker, чтобы проверить обработку конкретного товара. Введите EAN товара, выберите нужный экспорт и изучите исходные данные, применённые преобразования, рассчитанные значения и сформированный XML.

Откройте Export Checker в своём аккаунте. Инструкции приведены в материале Exports Checker: проверка данных товара и результатов экспорта.

Отчёт Exports Checker с исходными данными, выбранным поставщиком и экспортированным XML
Export Checker показывает данные товара, использованные при обработке, и итоговый пример XML, помогая убедиться, что экспортирован правильный производный атрибут.

Распространённые причины неожиданного результата

  • Правило не включено для экспорта: Сохранённое правило преобразования не влияет на экспорт, пока оно не выбрано в настройках этого экспорта.
  • В шаблоне используется неправильный атрибут: Правило может правильно создавать price_for_website, в то время как шаблон по-прежнему экспортирует price.
  • Фильтр не подходит: Поставщик, категория, производитель, цена, остаток или другое условие могут исключать товар из правила.
  • Другое правило изменяет то же значение: Проверьте все включённые правила и их приоритеты.
  • Имя атрибута указано по-разному: Проверьте написание и именование в правиле преобразования и шаблоне экспорта.
  • Экспорт не был сформирован заново: Во внешнем XML-файле всё ещё может содержаться результат предыдущего выполнения экспорта.
  • В направлении используется другой элемент XML: Проверьте, соответствует ли структура сформированного XML требованиям принимающей платформы.

Что делать дальше

  1. Определите, должен ли исходный сопоставленный атрибут оставаться доступным для другого канала или расчёта.
  2. Создайте производный атрибут с понятным названием, если требуются разные результаты.
  3. Назначьте правило преобразования только тем экспортам, которым оно необходимо.
  4. Сопоставьте производный атрибут в каждом соответствующем шаблоне XML.
  5. Проверьте небольшой набор репрезентативных товаров по EAN в Export Checker.
  6. Проверьте сформированный XML до того, как экспорт будет использован работающим направлением.

B2BLIX формирует настроенный XML-результат, но внешний сайт, маркетплейс или другое направление определяет, как этот файл будет импортирован и будут ли его значения приняты.