Идентификаторы товаров и варианты#
Целевой элемент на витрине должен указывать на тот же товар, что и каталог продавца. Большинство ошибок интеграции начинается с несовпадения этих двух значений.
Выбор стабильного идентификатора#
Используйте productCode, указанный у подготовленного товара. В руководстве Shopify это SKU варианта. Поля запроса Product Import API определены в справочнике по импорту; не заменяйте их именами атрибутов витрины.
Идентификаторы должны совпадать полностью, включая регистр. Не создавайте их из изменяемых отображаемых названий и не предполагайте, что внутренний идентификатор товара на платформе равен SKU.
Сопоставление выбранного варианта#
| Состояние витрины | Поведение целевого элемента |
|---|---|
| Выбран подготовленный вариант | Установите его точный productCode |
| Выбор изменился | Обновите целевой элемент и сбросьте прежнее состояние SDK согласно руководству по интеграции |
| Нет SKU или соответствующего товара | Оставьте созданную вручную кнопку скрытой или отключенной |
| Карточка товара указывает на вариант по умолчанию | Последовательно используйте идентификатор этого варианта |
Для Shopify подключите вспомогательную функцию синхронизации из руководства к фактическому обработчику смены варианта в вашей теме. Для других витрин следуйте разделу динамические страницы.
Проверка сопоставления#
Выберите два варианта с визуально различающимися товарами. Запишите их коды в каталоге, проверьте каждый выведенный data-product-code в инструментах разработчика браузера, затем откройте Viewer для каждого варианта. Повторите после перехода без полной перезагрузки страницы.
При изменении идентификатора в исходной системе согласуйте импорт каталога и выпуск витрины. Успешный HTTP-ответ импорта означает только принятие запроса; прежде чем использовать новый код, проверьте статус задачи и ошибки отдельных товаров.