Перейти к содержимому

База знанийShopify

Что такое Shopify Checkout Extensibility?

Определение

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
  1. На практике

    Что пришло на смену checkout.liquid и Additional Scripts?

    Shopify отключил checkout.liquid и Additional Scripts. Настройка чекаута теперь использует расширения: checkout UI extensions, Shopify Functions, web pixel extensions и payments extensions. Shopify размещает их и сохраняет работу при обновлениях. Одновременно отключены script-теги на страницах «Спасибо» и статуса заказа.

    Изменился сам способ настройки. checkout.liquid был частью темы и выполнял код продавца в её контексте. Расширения изолированы в песочницах Shopify. Их устанавливают и обновляют через приложения или редактор чекаута, без правок темы.

  2. На практике

    Где теперь живёт трекинг чекаута?

    Трекинг чекаута и событий после покупки идёт через Customer Events. Web pixel подписывается на стандартные события, которые публикует Shopify (в том числе checkout_started, шаги ввода данных в чекауте и checkout_completed), и пересылает их в аналитику или рекламные платформы.

    Скрипт темы, который отправляет событие покупки, больше не может прочитать страницу чекаута. Поддерживаемый источник данных: поток событий, который Shopify отдаёт пикселям и который настраивается в Customer Events.

  3. На практике

    Почему скрипты темы не видят чекаут и страницу «Спасибо»?

    Чекаут, страницу «Спасибо» и страницу статуса заказа Shopify отрисовывает отдельно, кода темы там нет. У скрипта витрины нет DOM чекаута, который можно прочитать, а dataLayer, в который он пишет, находится не на той странице, где покупатель завершает заказ.

    У пикселей тоже нет свободного доступа к странице. Web pixels не имеют доступа к DOM, а custom pixels не видят верхний фрейм. Данные заказа нужно получать из payload события.

  4. Не путать с

    Не путать с
    Это неЭто
    замена скриптов с переносом один в одинмодель приложений и расширений Shopify для настройки чекаута, страниц «Спасибо» и статуса заказа

    Checkout Extensibility не предполагает перенос старого кода без изменений. Это не замена скриптов с переносом один в один. Скрипт темы не выполняется в чекауте. Трекинг из Additional Scripts нужно пересобрать как пиксель или перенести на сервер.

    Custom pixel работает в песочнице Shopify и соблюдает её правила согласия. Он получает события, но не выполняется внутри страницы чекаута, как прежние Additional Scripts.

  5. Где проверить

    Как проверить, что ещё нужно обновить?

    В админке Shopify откройте настройки чекаута и Customer events. Отчёт о переходе на расширения покажет настройки, которые ещё зависят от отключённого механизма.

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

Daniil Maximkin

Здравствуйте, я Даниил.

Я сам разбираюсь в задаче, выполняю работу и передаю результат. Все вопросы вы обсуждаете напрямую со мной. Общаюсь на русском и английском. На испанском могу переписываться с помощью переводчика.

Что нужно сделать?

Опишите задачу

Отвечу в течение одного рабочего дня. Первый ответ бесплатный. Или напишите напрямую: next@taskfordaniel.com

Обсудить задачу

Расскажите, что нужно разработать, исправить или подключить.

Описать задачу next@taskfordaniel.com