Автодобавление бесплатного подарка при достижении порога

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

Для настраиваемой мерчантом версии с уровнями, правилами по рынкам и прогресс-баром используйте блок Rewards — без кода. Этот вариант нужен, когда ваше правило не выражается блоком.

Фрагмент кода

Вставьте в Cart settings → Custom script → Initialization и задайте две константы:

const FREE_GIFT_VARIANT_ID = 1234567890; // the gift product's variant id
const THRESHOLD_CENTS = 5000;            // $50.00, since totals are in cents

function reconcileGift(state) {
  const gift = state.items.find((line) => line.variantId === FREE_GIFT_VARIANT_ID);
  const qualifies = state.totalPrice >= THRESHOLD_CENTS;

  if (qualifies && !gift) {
    window.aftersell.cart.actions.addItem(FREE_GIFT_VARIANT_ID, 1);
  } else if (!qualifies && gift) {
    window.aftersell.cart.actions.removeItem(gift.key);
  }
}

window.aftersell.cart.events.on('cart_loaded', reconcileGift);
window.aftersell.cart.events.on('cart_updated', reconcileGift);

Как это работает

reconcileGift описывает состояние, в котором корзина должна находиться, а затем вносит не более одного изменения, чтобы достичь его:

Условие выполнено, а подарка нет → addItem добавляет его.
Условие не выполнено, а подарок есть → removeItem удаляет его по key строки.
Иначе → ничего не делать.

Функция выполняется и на cart_loaded (чтобы корзина, уже соответствующая условию при загрузке страницы, получила подарок), и на cart_updated (чтобы реагировать на каждое последующее изменение). Поскольку cart_loaded воспроизводится для поздних подписчиков, это работает независимо от того, когда запускается ваш скрипт.

Проверки !gift / gift — именно то, что предотвращает зацикливание. Добавление подарка вызывает cart_updated, которое снова запускает reconcileGift, и второй проход обнаруживает, что подарок уже есть, поэтому ничего не делает. Уберите проверки — и получите бесконечный цикл. См. два правила.

Обратите внимание, что добавление подарка увеличивает сумму корзины, поэтому порог, близкий к цене товара, может колебаться: добавление подарка за $0 безопасно, но подарок с ценой сам по себе может поднять корзину выше порога. Делайте подарок бесплатным или сравнивайте с суммой, которая его исключает.

Адаптация

Условие по количеству товаров вместо суммы:

const qualifies = state.itemCount >= 3;

Условие по наличию конкретного товара в корзине:

const qualifies = state.items.some((line) => line.productId === TRIGGER_PRODUCT_ID);

Только в определённых странах. Читайте context, доступный до загрузки корзины:

const ELIGIBLE = ['US', 'CA'];

// Only register the handlers for eligible countries.
if (ELIGIBLE.includes(window.aftersell.cart.context.customer_country)) {
  window.aftersell.cart.events.on('cart_loaded', reconcileGift);
  window.aftersell.cart.events.on('cart_updated', reconcileGift);
}

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

const subtotalWithoutGift = state.items.reduce(
  (sum, line) => (line.variantId === FREE_GIFT_VARIANT_ID ? sum : sum + line.finalLinePrice),
  0
);
const qualifies = subtotalWithoutGift >= THRESHOLD_CENTS;

Пометьте подарок, чтобы он читался как подарок. Line transform может изменить заголовок строки, заголовок варианта, состояние скрытия и внутренние свойства — переименуйте его:

window.aftersell.cart.hooks.registerLineTransform((line) => {
  if (line.variantId === FREE_GIFT_VARIANT_ID) {
    line.setTitle('Free gift 🎁');
  }
});

Line transform не может скрыть элементы управления количеством строки — его единственные сеттеры: setTitle, setVariantTitle, setHidden и setInternalProperties. Если покупатель изменит количество подарка, корректируйте его из обработчика cart_updated.

Что дальше

Блок Rewards: версия без кода, с уровнями.
Действия: addItem, removeItem и остальные.
События: почему важны проверки.

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

Главная страница

Лучшие практики

Апселлы после покупки

Корзина

Апселлы на странице оформления заказа (Shopify Plus)

Страница благодарности

Апселлы на странице товара

Rokt Thanks

Стратегии

Аналитика и отслеживание

Интеграции

Aftersell MCP

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

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

Автодобавление бесплатного подарка при достижении порога

Фрагмент кода

Как это работает

Адаптация

Что дальше

​Фрагмент кода

​Как это работает

​Адаптация

​Что дальше

Фрагмент кода

Как это работает

Адаптация

Что дальше