Обзор

Здесь собраны ответы на самые распространённые вопросы об использовании API Upcart.

Куда добавлять API-скрипты Upcart?
Нужно ли быть разработчиком, чтобы использовать API Upcart?
Может ли API Upcart интегрироваться с другими сторонними приложениями?
Как проверить, что мои изменения в API работают?
Что делать, если API-скрипт не работает?
Как отменить изменения, если добавленный скрипт что-то сломал?

Куда добавлять API-скрипты Upcart?

Вы можете добавлять скрипты в настройках Custom HTML в Upcart или непосредственно в код темы Shopify. Лучший вариант зависит от ваших потребностей в кастомизации.

Как использовать Custom HTML в Upcart?

Перейдите в Upcart → Settings → Custom HTML
Используйте API-скрипты для изменения поведения корзины, например момента открытия или отображения upsell-предложений
Настраивайте элементы за пределами Upcart, например скрывайте кнопки на странице товара

💡 Пример: скрыть закреплённую кнопку корзины, когда корзина пуста

<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>

Примечание об устаревших методах: обратные вызовы window.upcartOnCartLoaded по-прежнему работают, но признаны устаревшими и выводят предупреждения в консоль. Используйте upcartSubscribeCartLoaded во всех новых скриптах. Обратите внимание, что у event.cart нет свойства item_count — используйте event.cart.items.reduce((total, item) => total + item.quantity, 0) для подсчёта общего количества товаров.

Нужно ли быть разработчиком, чтобы использовать API Upcart?

Нет! API Upcart прост в использовании даже без навыков программирования. Многие функции встроены, а наша документация по кастомизации содержит готовые скрипты, которые можно скопировать в настройки Custom HTML в Upcart — программирование не требуется! Если вы хотите писать собственные скрипты, пригодятся базовые знания JavaScript. Если вы новичок в JavaScript, не переживайте! Эти дружелюбные к новичкам ресурсы — W3Schools и MDN Web Docs — помогут вам начать.

Может ли API Upcart интегрироваться с другими сторонними приложениями?

Да! API Upcart работает с приложениями для переводов, аналитики, upsell-предложений и не только. Некоторые интегрируются автоматически, а другим может понадобиться небольшой скрипт. Например, если вы используете TripleWhale для отслеживания, вам нужно добавить следующий скрипт, чтобы он корректно фиксировал активность в корзине:

<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>

Примечание об устаревших методах: обратные вызовы window.upcartOnAddToCart по-прежнему работают, но признаны устаревшими и выводят предупреждения в консоль. Используйте upcartSubscribeAddedToCart во всех новых скриптах. Обратите внимание, что свойства события находятся в event.item (с variantId и quantityAdded), а не передаются отдельными параметрами.

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

Как проверить, что мои изменения в API работают?

После добавления скрипта в настройки Custom HTML в Upcart выполните следующие шаги, чтобы убедиться, что он работает:

Обновите магазин и добавьте товар в корзину.
Очистите кеш и попробуйте снова, чтобы увидеть последние изменения.
Добавьте тестовое сообщение: вставьте console.log("The script works!"); перед </script>, чтобы проверить, выполняется ли ваш скрипт.
Проверьте консоль браузера:
- Откройте Dev Tools (F12 или Ctrl + Shift + J в Windows, Cmd + Option + J на Mac).
- Перейдите на вкладку Console и найдите «The script works!»
- Если вы видите сообщение, ваш скрипт работает! Если нет, скрипт может выполняться некорректно.
Протестируйте разные действия (например, удаление товара), чтобы убедиться в ожидаемом поведении.

Устраняйте проблемы, проверяя опечатки или ошибки в консоли и корректируя код по мере необходимости.

Что делать, если API-скрипт не работает?

Если ваш API-скрипт не работает, попробуйте следующие шаги устранения неполадок:

Проверьте опечатки — даже небольшие ошибки могут сломать скрипт. Ищите пропущенные символы или неправильный синтаксис.
Проверьте размещение скрипта — убедитесь, что скрипт находится в правильном разделе в Upcart → Settings → Custom HTML. В Upcart десять разделов для скриптов (девять точек вставки HTML плюс один раздел Scripts-before-load) — ознакомьтесь с этими разделами здесь.
Проверьте консоль браузера — выполните описанные выше шаги для поиска ошибок.
Протестируйте другой скрипт — попробуйте другой готовый API-скрипт Upcart, чтобы понять, в вашем ли коде проблема.
Всё ещё не получается? — если вы изменяете тему Shopify или интегрируете сторонние приложения, эксперт Shopify из каталога партнёров Shopify может помочь.

Эти шаги должны помочь вам выявить и устранить большинство проблем со скриптами!

Как отменить изменения, если добавленный скрипт что-то сломал?

Если вы добавили скрипт, который работает не так, как ожидалось, вы можете легко удалить или отключить его:

Перейдите в настройки Custom HTML в Upcart, где был добавлен скрипт.
Удалите скрипт или временно отключите его, добавив // в начало каждой строки (это превращает её в комментарий и предотвращает выполнение).
Сохраните изменения и обновите магазин, чтобы проверить, решена ли проблема.

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

🚧 Ищете расширенные кастомизации? Нужны кастомизации для всего магазина или интеграции со сторонними приложениями? Возможно, вам понадобится разработчик, чтобы добавить API Upcart в вашу тему Shopify. Рассмотрите возможность нанять эксперта Shopify через каталог партнёров Shopify и поделитесь с ним нашей документацией по API для помощи

Начало работы

Модули корзины

Настройки корзины

Закреплённая кнопка корзины

Multicart

Кастомизации

Аналитика

Интеграции и совместимость

Оплата и аккаунт

Устранение неполадок

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

Обзор

Куда добавлять API-скрипты Upcart?

Как использовать Custom HTML в Upcart?

💡 Пример: скрыть закреплённую кнопку корзины, когда корзина пуста

Нужно ли быть разработчиком, чтобы использовать API Upcart?

Может ли API Upcart интегрироваться с другими сторонними приложениями?

Как проверить, что мои изменения в API работают?

Что делать, если API-скрипт не работает?

Как отменить изменения, если добавленный скрипт что-то сломал?

​Обзор

​Куда добавлять API-скрипты Upcart?

​Как использовать Custom HTML в Upcart?

​💡 Пример: скрыть закреплённую кнопку корзины, когда корзина пуста

​Нужно ли быть разработчиком, чтобы использовать API Upcart?

​Может ли API Upcart интегрироваться с другими сторонними приложениями?

​Как проверить, что мои изменения в API работают?

​Что делать, если API-скрипт не работает?

​Как отменить изменения, если добавленный скрипт что-то сломал?

Обзор

Куда добавлять API-скрипты Upcart?

Как использовать Custom HTML в Upcart?

💡 Пример: скрыть закреплённую кнопку корзины, когда корзина пуста

Нужно ли быть разработчиком, чтобы использовать API Upcart?

Может ли API Upcart интегрироваться с другими сторонними приложениями?

Как проверить, что мои изменения в API работают?

Что делать, если API-скрипт не работает?

Как отменить изменения, если добавленный скрипт что-то сломал?