Как писать значения product_detail и product_highlight, которые примет Google: разбор на реальных строках фида

Атрибут Google product_detail принимает до 100 записей на товар, каждая длиной от 1 до 150 символов, а product_highlight требует минимум 2 и рекомендует от 4 до 6 коротких утверждений о преимуществах на каждый товар. Это следует из официальных спецификаций Google: product detail и product highlight. Оба атрибута необязательны, поэтому в большинстве фидов их либо пропускают, либо вставляют таблицу характеристик, которую Merchant Center помечает как неверно отформатированную.

Google сообщает, что product_detail помогает показывать товары на AI-поверхностях, например в AI Mode, а в мае 2026 года компания добавила ещё несколько разговорных атрибутов на той же идее.

Этот справочник предназначен для фид-менеджеров и агентств, которые передают данные о товарах в Google Merchant Center. Прочитав его, вы сможете писать оба атрибута в TSV и XML, экранировать символы, которые их ломают, не допускать запрещённого контента и оценивать строку перед отправкой.

Для чего нужны product_detail и product_highlight

Эти два атрибута выглядят похоже и часто заполняются из одного источника, но у Google для них разные задачи. product_detail содержит технические, проверяемые характеристики, которые не покрываются другим атрибутом: комплектацию, способы подключения, состав, требования к питанию, отделку, аромат и подобные факты. product_highlight содержит короткие продающие преимущества, записанные простыми предложениями.

Наш быстрый тест: если строка подходит для таблицы характеристик с названием и значением, это product_detail. Если она звучит как фраза, которую сказал бы консультант в магазине, это product_highlight. Спецификация highlight у Google проводит то же разделение и просит не повторять одно в другом.

Спецификация в двух словах

Ниже приведены лимиты в том виде, в каком Google публикует их сейчас. Для product_detail Google не указывает свойство schema.org, поэтому атрибут не подтягивается из микроразметки структурированных данных: он должен быть в фиде.

Источники: Справка Google Merchant Center, Product detail [product_detail] и Product highlight [product_highlight].

Как писать product_detail в TSV, XML и Merchant API

Больше всего строк проваливается именно на формате. Каждая характеристика — это три значения, соединённые двумя двоеточиями, в порядке: название раздела, название атрибута, значение атрибута. Google прямо указывает, что в текстовых фидах в каждой характеристике должно быть два двоеточия, а если число переданных податрибутов не совпадает с объявленным в заголовке, в разделе «Needs attention» появится ошибка «invalid sub-attribute format».

Заголовок TSV и одна ячейка

Объявите податрибуты в заголовке столбца: в скобках, через двоеточия. Когда они названы в заголовке, значения могут идти в любом объявленном вами порядке. Без объявления Google предполагает порядок «раздел, название, значение».

product_detail(section_name:attribute_name:attribute_value)

Ячейка с тремя характеристиками тогда выглядит так:

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

Если у характеристики нет раздела, сохраните начальное двоеточие и оставьте первое поле пустым:

:What's in the box?:"Machine,Measuring spoon,User manual"

Экранирование двоеточий, запятых и кавычек

К групповым атрибутам вроде этого применяются правила Google о значениях в кавычках:

• Берите в прямые двойные кавычки любое значение податрибута, содержащее запятую или двоеточие. Кавычки ставятся вокруг отдельного значения, а не вокруг всей группы.
• Буквальную двойную кавычку записывайте как две двойные кавычки. Пример из документации Google: "APS-C max. 12""" для значения, оканчивающегося знаком дюйма.
• Не используйте экранирование обратным слэшем. Google воспринимает обратный слэш как обычный символ.
• Поля в кавычках не поддерживаются для источников данных Google Sheets. Для существующих файловых источников поддержку полей в кавычках нужно включить в настройках источника данных.

XML

В XML каждая характеристика — отдельный элемент с тремя дочерними, поэтому экранировать двоеточия и запятые не нужно:

<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>

Для категорий с большим числом характеристик XML — более надёжный формат: естественные запятые и двоеточия перестают быть риском при разборе.

Merchant API

В Merchant API каждая характеристика — это объект ProductDetail с полями sectionName, attributeName и attributeValue, как указано в справочнике API-клиента.

Как писать product_highlight

Здесь всё проще: одна строка на одно преимущество. В текстовом фиде разделяйте преимущества запятыми и берите в двойные кавычки любое преимущество, содержащее запятую или двоеточие. В XML для каждого преимущества используйте отдельный элемент <g:product_highlight>.

"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"

Пишите по одному преимуществу в каждой строке. Google просит профессиональный, грамматически правильный язык без выделения ЗАГЛАВНЫМИ буквами, без символов и без рекламных формулировок.

Какой контент Google не допускает ни в одном из атрибутов

Ошибки форматирования порождают заметные сообщения об ошибках. Ошибки содержания менее заметны: строка может быть принята и всё равно нарушать правила. Эта таблица объединяет запреты из обеих спецификаций.

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

Разбор на примере: таблица характеристик, превращённая в принятые строки

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

До

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

Пять проблем в одной ячейке. Разделители перемешаны, поэтому число двоеточий не совпадает с заголовком. Значение «Stainless Steel, Plastic» не заключено в кавычки, и его запятая разрывает характеристику. Brand дублирует атрибут brand. «FREE SHIPPING» — текст о доставке, набранный заглавными буквами. Последний фрагмент — строка ключевых слов.

После, английский фид

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"

Бренд перенесён в собственный атрибут, доставка — в shipping, ключевые слова удалены, значения записаны с заглавной буквы только в начале предложения, как рекомендует Google, а каждое значение с запятой взято в кавычки. Значение «Automatic shut-off: Yes» остаётся, потому что его подтверждает производитель; поле, которое ваша платформа по умолчанию ставит в «No», не остались бы.

После, турецкий фид

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

Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"

Два региональных замечания для команд за пределами Турции. Во-первых, сохраняйте турецкие буквы. Рекомендация Google использовать ASCII — это пожелание, а не требование, а спецификация highlight прямо допускает буквы с диакритикой; транслитерация «Paslanmaz çelik» в «Paslanmaz celik» даёт орфографическую ошибку, что противоречит рекомендациям Google по грамматике и правописанию. Во-вторых, если какое-то правило переводит эти значения в нижний регистр или приводит к виду «как в предложении», ему нужна регистровая обработка с учётом локали, чтобы «İ» и «I» не превращались в неверные буквы. Эту проблему мы разбирали в нашем руководстве по регистру заголовков на турецком.

Как собрать значения из вашего каталога

Мы заполняем эти атрибуты в четыре прохода, в таком порядке.

1. Сначала сопоставьте структурированные источники. Составьте список всех характеристик, которые ваша платформа уже хранит как пары «название — значение»: вкладка спецификаций, метаполе или атрибут ERP. Каждая пара становится одной характеристикой product_detail, а исходная группа — значением section_name. Используйте слой фида, например правила фида или дополнительный фид, чтобы исходный каталог остался нетронутым, а выгрузка для Google могла отличаться от других каналов.
2. Уберите всё, что принадлежит другому атрибуту. Удалите строки о бренде, цвете, размере, материале, цене и доставке, если они уже есть в своих специальных атрибутах. Затем удалите любую характеристику, текст которой уже встречается в заголовке или описании.
3. Пишите преимущества вручную или по проверенным черновикам от AI. Преимущества — то место, где AI-обогащение помогает больше всего и чаще всего ошибается. Модель охотно напишет «Идеальный подарок для любителей кофе» — а это рекламная формулировка — или выдумает функцию, которой у товара нет. Генерируйте черновики только на основе подтверждённых характеристик и проверяйте их по таблице запретов выше.
4. Проверьте длину и синтаксис до экспорта. Убедитесь, что каждая характеристика и каждое преимущество не длиннее 150 символов, что в каждой характеристике ровно два двоеточия вне кавычек и что у каждого товара не менее 2 преимуществ.

Оценочная шкала для проверки перед отправкой

Оцените выборку из 20 строк на категорию. Каждая проверка — «пройдено» (1) или «не пройдено» (0), максимум — 10 баллов на строку. Мы считаем 9 или 10 баллов готовностью к отправке, 7 или 8 — «исправить, затем отправлять», а всё, что ниже, — признаком того, что исходные данные нужно доработать, прежде чем отправлять эти атрибуты имеет смысл.

Где это руководство даёт сбой

Мы не знаем, насколько эти атрибуты влияют на ранжирование или кликабельность. Google говорит, что product_detail помогает показывать товары по релевантным запросам, в том числе в AI Mode, но не публикует никаких цифр, и мы не видели контролируемого публичного исследования. Относитесь к процентам от вендоров с осторожностью, пока они не подкреплены описанием методики.

Это справочник по Google. В спецификации товарного фида OpenAI нет универсального поля «ключ — значение» для характеристик и нет поля для преимуществ; там используются плоские поля, такие как material, dimensions и weight, а также описание до 5 000 символов. Если вы отправляете и этот фид, ваши характеристики придётся сопоставлять с этими полями или с описанием. Аналоги для Meta и TikTok мы для этого руководства не проверяли.

Здесь также не рассматриваются новые разговорные атрибуты, такие как question_and_answer и document_link, за исключением приведённого выше правила о пересечении. Несколько вендоров фидов, включая Channable и Productsup, опубликовали руководства по сопоставлению для них раньше нас, и их стоит прочитать, если этот набор нужен вам уже сейчас.

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

Часто задаваемые вопросы

Обязателен ли product_detail в Google Merchant Center?

Нет. Google указывает его как необязательный для любого товара. Его стоит добавлять там, где у вас есть проверенные характеристики, не покрываемые другими атрибутами, ведь, по словам Google, он помогает товарам появляться по релевантным запросам, в том числе в AI Mode.

Сколько преимуществ product_highlight нужно отправлять?

Google требует минимум 2 и допускает до 100, а рекомендует от 4 до 6 на товар. Каждое преимущество может содержать до 150 символов.

Почему Merchant Center сообщает о неверном формате податрибутов в моём product_detail?

Число податрибутов в значении не совпадает с заголовком — обычно из-за того, что в характеристике пропущено двоеточие или её разорвала запятая либо двоеточие внутри значения без кавычек. Берите в кавычки любое значение с такими символами и сохраняйте два двоеточия в каждой характеристике.

Нужно ли использовать турецкие буквы в турецком фиде?

Да. Google принимает Unicode и рекомендует ASCII лишь как предпочтение, а его руководство по highlight допускает буквы с диакритикой и требует правильного написания. Если убрать турецкие буквы, получатся слова с ошибками.

Может ли AI писать мои product highlight?

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

Поддерживает ли Google Sheets значения product_detail в кавычках?

Нет. В руководстве Google по значениям в кавычках сказано, что поля в кавычках не поддерживаются для источников данных Google Sheets, поэтому значения характеристик с запятыми или двоеточиями лучше отправлять через файл TSV, XML или Merchant API.

Проверьте фид, прежде чем добавлять эти атрибуты

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