WooCommerce Google Product Feeds - Плагин WordPress

Руководство по настройке WooCommerce Google Product Feeds для Google Merchant Center

WooCommerce Google Product Feeds нужен не для красивого блока на странице товара, а для точной передачи товарных данных из WooCommerce в Google Merchant Center. В этом руководстве разберём, как подготовить магазин, какие поля включить, где задавать значения, как работать с вариациями, что проверять после первой отправки фида и как читать ошибки Merchant Center без паники.

Главная цель - получить не просто XML-ссылку, а управляемый фид: с корректными названиями, описаниями, изображениями, ценами, наличием, брендом, GTIN или MPN, категориями Google, промоакциями и, если нужно, отзывами. Плагин даёт много контроля, но именно из-за этого его не стоит настраивать вслепую. Сначала нужно понять, какие данные уже есть в товарах, какие можно подтянуть из атрибутов, а какие придётся задать на уровне категории или конкретного товара.

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

Как работает товарный фид и почему плагин требует аккуратной настройки

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

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

Эта логика важна. Если в магазине сотни товаров, не нужно вручную открывать каждую карточку только ради общей категории Google или бренда. Но если у одного товара есть исключение, плагин позволяет задать его точнее. Поэтому правильная настройка начинается не с кнопки Add New, а с понимания иерархии данных: где значение общее, где категорийное, где товарное, а где вариационное.

Что плагин делает сам

В базовом сценарии расширение формирует стандартный Google Product Feed, который покрывает все категории магазина. Ссылка на активный фид доступна в админ-панели WordPress в разделе WooCommerce -> Settings -> Product Feeds. Эту ссылку затем используют в Merchant Center как источник типа Scheduled fetch.

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

Что остаётся на стороне магазина

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

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

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

WooCommerce Google Product Feeds лучше всего раскрывается там, где магазин хочет контролировать фид, но не переносить каталог в отдельную внешнюю систему. Он особенно полезен для магазинов, которые уже ведут каталог в WooCommerce, используют атрибуты, категории, вариации, купоны и расширения WooCommerce для составных товаров, брендов, валют или минимального количества покупки.

Если вам нужно просто включить базовую синхронизацию с Google и рекламные кампании из админ-панели, официальное решение Google for WooCommerce может оказаться проще. Но если нужен контроль над полями фида, категориями, кастомными заголовками, дополнительными изображениями, исключениями и отдельными URL-фидами, Google Product Feed даёт более прямой подход.

Хорошие сценарии

• Магазин использует Google Merchant Center как основной источник товарных данных для бесплатных показов и товарной рекламы.
• Каталог содержит вариативные товары, где цвет, размер, GTIN, MPN или бренд нужно передавать на уровне вариации.
• Есть разные категории, для которых удобнее задавать Google Product Category или Product Type на уровне категории WooCommerce.
• Маркетолог хочет разделить фиды по категориям, валютам, странам или назначению, а не отправлять один общий файл для всех задач.
• Команде нужна возможность безопасно доработать отдельные элементы фида через документированные фильтры WordPress.

Когда лучше не начинать с этого плагина

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

Есть и ограничения по типам товаров. Документация совместимости прямо указывает, что WooCommerce Subscriptions не поддерживается для фида, потому что Google не разрешает листинг регулярных платёжных продуктов в Merchant Center. Для WooCommerce Bookings совместимость тоже не заявлена, так как большинство сценариев с услугами и билетами не подходит под правила Google Merchant Center. Такие ситуации нужно оценивать до установки, а не после получения ошибок.

Что проверить перед установкой и первой отправкой фида

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

Техническая база WordPress и WooCommerce

Официальная страница продукта указывает требования к WordPress, WooCommerce и PHP, а также совместимость с HPOS и cart/checkout blocks. Перед установкой проверьте, что сайт обновлён до поддерживаемого уровня, работает на стабильном PHP, а критичные расширения WooCommerce не конфликтуют с товарными данными. Если магазин большой, дополнительно проверьте работу WordPress cron, потому что он нужен для фоновых задач, связанных с кэшем фида.

Не ставьте плагин сразу на рабочий магазин в разгар рекламной кампании. Безопаснее сначала подключить его на копии сайта или хотя бы включить в период, когда можно спокойно проверить фид, логи и Merchant Center. Сам фид не меняет публичный дизайн магазина, но ошибки в данных могут повлиять на статус товаров в Google.

Данные каталога

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

Мини-аудит перед включением полей

• Убедитесь, что основные товары и вариации имеют уникальные SKU или другие стабильные идентификаторы.
• Проверьте, что цена и наличие на странице товара совпадают с тем, что должно уйти в Google.
• Посмотрите, есть ли у категорий единая логика Google Product Category и Product Type.
• Отделите рекламные фразы от технических описаний, если описание товара собирается конструктором страниц.
• Проверьте, не скрывают ли плагины кэша или защиты URL фида от внешнего запроса Google.

Merchant Center до импорта

Перед первой отправкой настройте доставку и налоги в Merchant Center. Документация WooCommerce отдельно предупреждает, что отсутствие этих настроек может привести к ошибкам при импорте. Для фида это не поле в карточке товара, а внешняя настройка аккаунта Google, поэтому исправлять её нужно не в WordPress, а в Merchant Center.

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

Установка и первый запуск без лишнего риска

Установка WooCommerce Google Product Feeds не отличается от обычного коммерческого расширения WooCommerce. После подключения продукта к магазину или загрузки ZIP-архива через Plugins -> Add New -> Upload Plugin активируйте расширение и переходите к настройкам. Основная точка управления находится в WooCommerce -> Settings -> Product Feeds.

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

Где взять URL фида

На странице настроек есть список активных фидов. Для стандартного Google Product Feed плагин показывает URL, который можно отправить в Merchant Center. В большинстве случаев это URL вида ?woocommerce_gpf=google или permalink-style вариант. Если хостинг блокирует запросы с параметрами, как описано в официальном troubleshooting-разделе для отдельных хостингов, используйте permalink-style URL.

После получения ссылки откройте её в браузере как обычный внешний пользователь. Вам не нужно читать весь XML, но нужно убедиться, что вместо HTML-страницы, страницы входа или ошибки кэша отдаётся фид. Если вы видите страницу сайта, форму авторизации или сообщение защиты, Google увидит то же самое.

Добавление фида в Merchant Center

В Merchant Center используйте источник данных с регулярной загрузкой по URL. Для классического интерфейса документация описывает путь через Products -> Feeds, выбор типа Products, целевой страны, языка, имени файла и режима Scheduled fetch. После создания источника выполните первый fetch вручную и дождитесь отчёта о количестве импортированных товаров и предупреждениях.

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

Настройка полей фида: от общих значений к товарным исключениям

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

Feed fields to enable

На странице WooCommerce -> Settings -> Product Feeds есть блок Feed fields to enable. Здесь выбирают, какие элементы будут доступны для заполнения и вывода в фиде. Для типового магазина стоит начать с тех полей, по которым Merchant Center уже даёт предупреждения или которые точно нужны категории: brand, gtin, mpn, google_product_category, product_type, color, size, gender, age_group, material, pattern.

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

Store default

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

Store default также полезен для общих характеристик, которые редко меняются. Но он должен быть именно запасным значением, а не способом замаскировать отсутствие данных. Если у товаров разные GTIN, MPN, размеры или материалы, их нельзя заменять общим текстом.

Use value from existing product field

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

Перед тем как назначить источник, проверьте, что атрибуты заполнены одинаково. Например, если часть товаров имеет бренд Nike, часть NIKE, а часть Nike official, фид будет выглядеть неряшливо. Лучше нормализовать атрибуты до подключения, чем потом искать странные группы товаров в Merchant Center.

Категорийные значения

Google Product Category и Product Type часто удобнее задавать на уровне категории WooCommerce. Если все товары в категории относятся к одному типу, это экономит время и уменьшает риск ошибки. Документация прямо показывает, что некоторые значения можно задавать на категории, а затем переопределять на конкретном товаре, если есть исключение.

Хорошая практика - сначала настроить 5-10 ключевых категорий, сделать первый импорт и посмотреть, какие предупреждения останутся. После этого уже переходить к более мелким категориям и исключениям. Так вы не тратите часы на идеальную карту, пока не понятно, какие требования Google предъявляет именно к вашему рынку.

Значения на товаре и вариации

Для точного контроля используйте метабокс Product Feed Information на странице товара. Именно там можно указать данные, которые отличаются от общих правил. У вариативных товаров поля доступны и у отдельных вариаций, если раскрыть variation и блок feed information. Это важно для размеров, цветов, GTIN, MPN и любых значений, которые не должны наследоваться от родителя.

Не используйте товарный override как основной метод заполнения всего каталога. Он нужен для исключений. Если все товары требуют ручного значения, значит, в структуре каталога не хватает атрибутов, категорийных значений или CSV-импорта.

Вариации, изображения и идентификаторы: где чаще всего ломается фид

Вариативные товары - главный источник ошибок в Google-фидах. С точки зрения покупателя это один товар с выбором размера или цвета. С точки зрения Merchant Center каждая вариация часто должна выглядеть как отдельный item с корректной ценой, наличием, изображением, идентификатором и группировкой. WooCommerce Google Product Feeds поддерживает вариации и может выводить каждую вариацию отдельной строкой, но качество результата зависит от того, как заполнены сами вариации.

Почему вариации лучше не отключать без причины

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

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

Изображения в фиде

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

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

GTIN, MPN и бренд

Предупреждение о недостаточных идентификаторах обычно связано не с ошибкой плагина, а с отсутствием данных в магазине. Google требует идентификаторы для многих классов товаров. Плагин поддерживает нужные элементы, но вам нужно решить, где они хранятся: в отдельном поле, в SKU, в атрибуте, в CSV-импорте или в ручном поле feed information.

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

Дополнительные фиды: категории, валюты, локальный инвентарь, отзывы и промоакции

Стандартный фид подходит для первого запуска, но не закрывает все сценарии. WooCommerce Google Product Feeds поддерживает несколько типов фидов и режимов ограничения товаров. Это особенно полезно, когда магазин работает в нескольких странах, использует разные валюты, хочет отправлять промоакции или участвует в программе product reviews.

Фиды по категориям и частичные фиды

Если фид слишком большой или у разных категорий разные требования, можно создать фид для конкретных категорий или исключить отдельные категории. Это делается через управление фидами в WooCommerce -> Product Feeds. Для больших каталогов это часто удобнее, чем пытаться отправить всё одним URL, особенно если часть товаров не предназначена для Google.

Документация также описывает параметры gpf_start и gpf_limit для частичных фидов. Но этот подход стоит рассматривать осторожно: он сложнее в сопровождении и может привести к путанице, если товары попадают в несколько частей. Официальная рекомендация для проблем генерации полного фида - сначала рассмотреть feed item caching.

Фиды в разных валютах

Если магазин использует совместимые multi-currency расширения, плагин может создавать фид в конкретной валюте через параметр currency. Это важно, потому что Google сверяет цену в фиде с ценой на посадочной странице. Если пользователь попадает на страницу в другой валюте, Merchant Center может увидеть несоответствие.

Для международного магазина продумайте отдельные фиды под страны и валюты, а не один общий фид. Проверьте, что выбранный currency switcher действительно меняет публичную страницу так, как ожидает Google, и что Google получает URL с корректной валютой.

Product Review Feed

Плагин поддерживает отдельный фид отзывов товаров, который связан с программой Google Product Ratings. По документации, перед настройкой такого фида нужно подать заявку в программу Google Product Review Feed. На стороне WooCommerce настройка минимальна: создать новый фид типа Google merchant centre product review feed, сохранить его и использовать полученный URL в Merchant Center.

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

Promotion Feed

Promotion feed помогает передавать купоны и промоакции в Google, если магазин имеет доступ к соответствующей программе Merchant Center. После создания фида типа Google Merchant Centre Promotion Feed отдельные купоны можно помечать для отправки в Google через вкладку Promotion feed visibility. Там же можно управлять назначением промоакции: например, отправлять её для бесплатных показов, но не для рекламных объявлений.

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

Feed item caching и производительность на большом каталоге

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

Feed item caching решает эту проблему иначе: выходной фрагмент для товара предварительно сохраняется в кэше и используется при формировании полного фида. Когда товар, категория или настройки меняются, связанный кэш сбрасывается и перестраивается фоновыми задачами. Так плагин сохраняет актуальность, но не пересчитывает весь каталог с нуля при каждом запросе.

Когда включать кэш

Кэш нужен, если полный фид не успевает генерироваться, Merchant Center получает неполный XML, хостинг показывает лимиты CPU или памяти, либо каталог содержит много вариаций. Для маленького магазина кэш не обязателен, но его можно протестировать, если вы видите нестабильное время ответа фида.

Официальная документация описывает включение через маленький отдельный плагин с фильтром woocommerce_gpf_render_cache_enabled. Это именно plugin-файл в папке wp-content/plugins, а не вставка в functions.php. Причина понятна: кэш фида относится к инфраструктуре фида, а не к теме оформления.

Если вы не разработчик, не добавляйте этот файл самостоятельно без понимания структуры WordPress. Лучше передать задачу техническому специалисту или обратиться в поддержку. Ошибка в маленьком PHP-файле может сломать админ-панель, хотя сама идея кэша безопасна при корректной установке.

Как понять, что кэш работает

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

Если сайт закрыт maintenance-плагином, IP-ограничениями или WordPress cron не запускается, фоновые задачи могут не выполняться. В таком случае кэш всё равно может наполняться при запросе фида, но процесс будет менее предсказуемым. Для крупного магазина cron лучше проверять заранее.

Практический пример: подготовить фид для магазина одежды с вариациями

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

Цель

Нужно получить стандартный Google Product Feed для всех товаров категории Clothing, отправить каждую вариацию как отдельный item, передать бренд из атрибута, цвет и размер из вариаций, Google Product Category на уровне категории и проверить sale price в карточке товара Merchant Center.

Подготовка

1. Откройте несколько товаров в WooCommerce и убедитесь, что вариации имеют отдельные значения color и size.
2. Проверьте, что бренд хранится единообразно: например, как product attribute Brand, а не как произвольный текст в описании.
3. Убедитесь, что у вариаций есть актуальная цена, наличие и изображение, если цвет должен отличаться визуально.
4. В Merchant Center заранее настройте доставку и налоги для целевого рынка.

Шаги настройки

1. Перейдите в WooCommerce -> Settings -> Product Feeds и включите поля brand, color, size, google_product_category и другие поля, которые нужны вашей категории.
2. Для brand выберите предзаполнение из атрибута товара, если он уже есть в каталоге.
3. Для color и size используйте атрибуты вариаций. После этого проверьте 2-3 вариации в карточке товара.
4. На уровне категории WooCommerce задайте Google Product Category для одежды, если все товары категории попадают в один логичный раздел.
5. Откройте URL фида в браузере и убедитесь, что вариации выводятся отдельными строками, а не исчезают.
6. Добавьте URL в Merchant Center как Scheduled fetch, выполните Fetch Now и дождитесь отчёта.

Ожидаемый результат

В Merchant Center товары должны импортироваться без критических ошибок по отсутствию базовых полей. У отдельных товаров могут остаться предупреждения по идентификаторам или категории. Это нормально для первого цикла: важнее, чтобы структура фида была правильной, а количество импортированных вариаций совпадало с ожиданиями.

Нюанс, который часто мешает

Если Google показывает, что sale price отсутствует, не спешите менять фид. Документация troubleshooting объясняет, что Merchant Center в большинстве мест показывает стандартную цену, а sale price нужно смотреть в деталях конкретного товара в секции final attributes. То есть проблема может быть не в передаче данных, а в том, где вы проверяете результат.

Проверка результата после настройки

Проверка не заканчивается на успешном fetch. Merchant Center может принять фид, но пометить часть товаров предупреждениями, отправить их на дополнительную проверку или скрыть из показов из-за качества данных. Хорошая проверка идёт в три слоя: доступность URL, содержимое фида и статус товаров в Google.

Проверьте URL фида как внешний пользователь

Откройте URL в режиме без авторизации. Если сайт возвращает XML, это базовая техническая проверка. Если возвращается HTML, страница кэша, redirect, ошибка безопасности или форма входа, Merchant Center не сможет обработать источник. Для хостингов, которые блокируют URL с query arguments, используйте permalink-style вариант /woocommerce_gpf/google, если он доступен.

Сверьте несколько товаров вручную

Выберите 3-5 товаров разных типов: простой товар, вариация, товар со скидкой, товар из категории с default-значением и товар с ручным override. Откройте их в фиде и на сайте. Сравните название, URL, цену, наличие, изображение, бренд, GTIN или MPN, цвет, размер и категорию. Не нужно проверять весь XML вручную, но выборочная сверка быстро показывает системную ошибку.

Читайте отчёт Merchant Center

Если есть ошибки, откройте конкретный item ID и посмотрите, какой атрибут отсутствует или не совпадает. В официальной документации WooCommerce советует при обращении в поддержку передавать полный текст ошибки и конкретный item ID. Это хороший подход и для внутренней работы: не обсуждайте "фид не работает", обсуждайте "у item ID X отсутствует brand, значение должно браться из атрибута Brand".

Безопасные доработки через фильтры и когда лучше не писать код

У WooCommerce Google Product Feeds есть набор фильтров WordPress для тонкой настройки. Официальная документация customizations показывает примеры изменения описания, заполнения brand из custom field, программного исключения товаров, изменения размера изображения, URL товара и других элементов. Это полезно, но такие доработки должны быть точечными и понятными.

Самое важное правило: не правьте код плагина. Используйте отдельный маленький plugin-файл, дочернюю тему или Code Snippets, если в вашей команде такой способ принят и контролируется. Любая доработка должна иметь цель, проверку результата и простой откат.

Пример: заполнить brand из пользовательского поля

Если бренд уже хранится в custom field, но не оформлен как атрибут WooCommerce, его можно передать через документированный фильтр woocommerce_gpf_elements. Ниже пример в духе официальной документации. Его нужно адаптировать под реальное имя вашего поля и протестировать на копии сайта.

<?php
function site_gpf_add_brand_from_meta( $elements, $product_id, $variation_id = null ) {
    $id = $variation_id ? $variation_id : $product_id;
    $product = wc_get_product( $id );

    if ( ! $product ) {
        return $elements;
    }

    $brand = $product->get_meta( 'supplier_brand_name' );

    if ( ! empty( $brand ) ) {
        $elements['brand'] = array( $brand );
    }

    return $elements;
}
add_filter( 'woocommerce_gpf_elements', 'site_gpf_add_brand_from_meta', 11, 3 );

Проверка простая: откройте один товар с заполненным custom field, найдите его в фиде и убедитесь, что brand появился. Затем проверьте товар без этого поля: он не должен получать чужой бренд. Откат - удалить snippet или отключить отдельный plugin-файл.

Когда код не нужен

Если задачу можно решить через атрибуты товара, category-level values, store defaults или CSV-импорт, лучше не писать код. Фильтры нужны для реальных исключений: нестандартного источника данных, особого правила исключения, специфического URL или контролируемого изменения описания. Код ради "красоты" фида почти всегда усложняет сопровождение.

Осторожный ориентир: если вы не можете объяснить, какой конкретный Merchant Center warning закрывает snippet, не добавляйте snippet.

Ошибки WooCommerce Google Product Feeds и понятная диагностика

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

Merchant Center сообщает о missing tax или missing shipping

Симптом: фид импортируется, но Google пишет, что не хватает налоговой или доставочной информации. Возможная причина: соответствующие настройки не заданы в Merchant Center. Документация WooCommerce прямо указывает, что tax и shipping обычно настраиваются в аккаунте Google, а не передаются в самом фиде как основной способ.

Что проверить: разделы налогов, доставки и returns в Merchant Center, целевую страну фида и shipping labels, если они используются. Как исправить: настройте правила в Google, затем повторите fetch. Если доставка зависит от классов WooCommerce, используйте delivery label или shipping class mapping только после понимания схемы доставки.

Недостаточно идентификаторов GTIN, Brand, MPN

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

Что проверить: включены ли gtin, brand, mpn в настройках, есть ли значения у товара или вариации, не переопределяется ли правильное значение пустым ручным полем. Как исправить: для бренда используйте атрибут или category/default value, для GTIN и MPN - реальные значения на уровне товара или вариации. Не генерируйте фиктивные идентификаторы.

Фид отдаётся как HTML или содержит лишний текст

Симптом: Google говорит, что источник не является корректным фидом, либо XML содержит "extra content". Причина: URL блокируется хостингом, защита отдаёт HTML, фид обрывается из-за лимитов или в конце документа появляется ошибка PHP.

Что проверить: откройте URL без авторизации, посмотрите server logs, временно исключите URL фида из агрессивного кэша или защиты, если это безопасно. Как исправить: используйте permalink-style URL, увеличьте лимиты через хостинг, включите feed item caching или разделите фид по категориям. Если в логах видна конкретная ошибка плагина или темы, не маскируйте её настройками Merchant Center.

Полный фид не генерируется на большом каталоге

Симптом: запрос фида долгий, обрывается, возвращает неполный XML или Google импортирует только часть товаров. Причина: WordPress обрабатывает слишком много товаров и вариаций за один запрос. Документация называет это типичным ограничением по CPU, памяти или времени выполнения.

Что проверить: размер каталога, количество вариаций, логи таймаутов, работу WordPress cron, наличие feed item caching. Как исправить: предпочтительно включить кэш фида, затем проверить статус кэша. Если кэш не подходит, используйте category feeds или partial feeds, но фиксируйте структуру, чтобы не отправлять дубли.

Sale price не виден в Merchant Center

Симптом: в основном списке товаров Google показывает стандартную цену, хотя в WooCommerce активна скидка. Причина: sale price может быть передан, но не отображаться в том месте интерфейса, где вы смотрите. Документация советует проверять детали товара и секцию final attributes.

Что проверить: конкретный item, активность sale price в WooCommerce, дату действия скидки, final attributes в Merchant Center. Как исправить: если sale price есть в final attributes, не меняйте фид. Если его нет, проверьте товар, вариацию и настройку sale price в WooCommerce.

Когда WooCommerce Google Product Feeds будет удачным выбором

Этот продукт стоит использовать, если вам нужен управляемый фид Google Merchant Center прямо из WooCommerce: с вариациями, category-level настройками, ручными переопределениями, кастомными полями, review feed, promotion feed, локальными фидами и возможностью технической доработки через фильтры. Он особенно полезен магазинам, где качество товарных данных влияет на рекламу, а простой автоматической синхронизации недостаточно.

Перед рабочим запуском проверьте три вещи: исходные данные WooCommerce, доступность URL фида и отчёт Merchant Center после первого fetch. Если все три слоя понятны, дальше настройка превращается в управляемую работу: включить нужное поле, выбрать источник значения, повторить fetch, проверить item ID, исправить исключения.

Если после чтения вы понимаете, какие поля нужны вашему каталогу, где брать бренд и идентификаторы, как проверять sale price, когда включать кэш и какие ошибки смотреть в Merchant Center, можно переходить к установке и тестированию. Для локальной установки используйте блок скачивания на этой странице: скачать установочный файл и затем проверяйте фид сначала на небольшом наборе товаров, а уже потом на всём каталоге.