Определение
Checkout Extensibility: модель приложений и расширений Shopify для настройки чекаута, страниц «Спасибо» и статуса заказа.
Она заменила checkout.liquid и Additional Scripts. Вместо правки Liquid-шаблона продавцы и приложения используют checkout UI extensions, Shopify Functions и web pixel extensions. Shopify размещает расширения и сохраняет их работу при обновлениях. Трекинг чекаута и событий после покупки нужно перенести в Customer Events. Этот механизм заменяет прежний код в checkout.liquid и Additional Scripts.
- настройка чекаута
- checkout UI extensionsShopify Functionsweb pixel extensionspayments extensions
- Трекинг чекаута и событий после покупки
- Customer Events
- На практике
Что пришло на смену checkout.liquid и Additional Scripts?
Shopify отключил checkout.liquid и Additional Scripts. Настройка чекаута теперь использует расширения: checkout UI extensions, Shopify Functions, web pixel extensions и payments extensions. Shopify размещает их и сохраняет работу при обновлениях. Одновременно отключены script-теги на страницах «Спасибо» и статуса заказа.
Изменился сам способ настройки. checkout.liquid был частью темы и выполнял код продавца в её контексте. Расширения изолированы в песочницах Shopify. Их устанавливают и обновляют через приложения или редактор чекаута, без правок темы.
- На практике
Где теперь живёт трекинг чекаута?
Трекинг чекаута и событий после покупки идёт через Customer Events. Web pixel подписывается на стандартные события, которые публикует Shopify (в том числе checkout_started, шаги ввода данных в чекауте и checkout_completed), и пересылает их в аналитику или рекламные платформы.
Скрипт темы, который отправляет событие покупки, больше не может прочитать страницу чекаута. Поддерживаемый источник данных: поток событий, который Shopify отдаёт пикселям и который настраивается в Customer Events.
- На практике
Почему скрипты темы не видят чекаут и страницу «Спасибо»?
Чекаут, страницу «Спасибо» и страницу статуса заказа Shopify отрисовывает отдельно, кода темы там нет. У скрипта витрины нет DOM чекаута, который можно прочитать, а dataLayer, в который он пишет, находится не на той странице, где покупатель завершает заказ.
У пикселей тоже нет свободного доступа к странице. Web pixels не имеют доступа к DOM, а custom pixels не видят верхний фрейм. Данные заказа нужно получать из payload события.
Не путать с
Не путать с Это не Это замена скриптов с переносом один в один модель приложений и расширений Shopify для настройки чекаута, страниц «Спасибо» и статуса заказа Checkout Extensibility не предполагает перенос старого кода без изменений. Это не замена скриптов с переносом один в один. Скрипт темы не выполняется в чекауте. Трекинг из Additional Scripts нужно пересобрать как пиксель или перенести на сервер.
Custom pixel работает в песочнице Shopify и соблюдает её правила согласия. Он получает события, но не выполняется внутри страницы чекаута, как прежние Additional Scripts.
- Где проверить
Как проверить, что ещё нужно обновить?
В админке Shopify откройте настройки чекаута и Customer events. Отчёт о переходе на расширения покажет настройки, которые ещё зависят от отключённого механизма.
Затем проверьте результат на стороне получателя: оформите тестовый заказ и посмотрите, пришло ли событие покупки с ожидаемыми значениями. Сверка заказов на практике показывает, сохранила ли миграция трекинг покупок.