> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Почему мой checkout-апселл не отображается?
> Полный разбор всех причин, по которым ваш checkout-апселл может не отображаться, включая проблемы настройки, размещения, триггеров и товаров/предложений.
Checkout-апселлы могут не отображаться по нескольким разным причинам. Пройдите по шагам ниже по порядку, чтобы определить причину.
Checkout-апселлы доступны только продавцам на Shopify Plus, поскольку API Checkout Extensibility от Shopify доступен только на Plus. Если вы не на Shopify Plus, checkout-апселлы не появятся независимо от вашей конфигурации. См. [Почему я не вижу вкладку Checkout?](/ru/aftersell/why_cant_i_see_the_checkout_tab)
Если апселл не отображается, опыт оформления заказа у покупателя не страдает — со стороны покупателя ничего не ломается.
***
## С чего начать
Большинство проблем с отображением сводятся к одной из четырёх причин: виджет не включён, блок приложения не добавлен/не сохранён в Shopify, размещение не совпадает или условия триггеров не выполнены. Сначала проверьте базовые вещи:
* Вы находитесь на плане **Shopify Plus**
* Виджет **включён** в редакторе Checkout в Aftersell (переключатель **Enable** в правом верхнем углу настроек виджета включён)
* Блок приложения **добавлен и сохранён** в Shopify Checkout Editor
* Размещение, выбранное в Shopify, **совпадает** с размещением, заданным в Aftersell
Если всё это в порядке, а апселл всё ещё не отображается, пройдите по детальным причинам ниже.
* [Виджет не включён или не добавлен в checkout](#widget-is-not-enabled-or-not-added-to-checkout)
* [Несовпадение размещения между Aftersell и Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [Условия триггеров не выполняются](#trigger-conditions-are-not-being-met)
* [Проблема с товаром или предложением](#there-is-a-product-or-offer-issue)
* [Виджеты Shop Pay не отображаются](#shop-pay-widgets-not-showing)
* [Тестирование в предпросмотре Shopify](#testing-in-the-shopify-preview)
* [Ничего из перечисленного не подходит](#nothing-above-applies)
***
## Виджет не включён или не добавлен в checkout
Чтобы checkout-апселл отображался, одновременно должны выполняться два условия:
1. Виджет должен быть **включён** в редакторе Checkout в Aftersell
2. Блок приложения должен быть **добавлен и сохранён** в Shopify Checkout Editor
Если чего-то из этого не хватает, виджет не появится.
**Чтобы включить виджет в Aftersell:**
1. Перейдите в **Apps → Aftersell → Checkout**
2. Откройте виджет апселла, который вы хотите отображать
3. Убедитесь, что виджет включён — в заголовке отображается переключатель рядом со значком **Active** / **Inactive**. (В более раннем редакторе Checkout это пара кнопок **Enable** / **Disable** в заголовке карточки виджета.)
**Чтобы добавить блок приложения в Shopify:**
1. Перейдите в **Settings → Checkout** в админ-панели Shopify
2. Нажмите **Customize** рядом с вашим профилем checkout
3. Нажмите **Add app block** и выберите виджет апселла Aftersell
4. Расположите его там, где он должен появляться
5. Нажмите **Save** — изменения не применяются, пока не сохранены
***
## Несовпадение размещения между Aftersell и Shopify
Несовпадение размещения — одна из самых частых причин, по которым checkout-апселл не отображается.
Aftersell поддерживает несколько размещений, чтобы вы могли запускать более одного виджета одного типа на одной странице checkout. Каждое размещение соответствует **отдельному блоку приложения** в Shopify Checkout Editor, и размещение, выбранное в Shopify, должно совпадать с настроенным в Aftersell.
Выпадающий список **Placement** блока приложения Upsell Widget предлагает восемь значений: **Default placement (Upsell Widget 1)**, **Additional placement 1 (Upsell Widget 2)**, **Additional placement 2 (Upsell Widget 3)** и пять слотов страничных виджетов от **page-upsell-001** до **page-upsell-005**.
Если размещения не совпадают, виджет не появится или может отображаться в неправильном месте.
**Чтобы исправить несовпадение размещения:**
1. В редакторе Checkout в Aftersell откройте виджет апселла и запомните, какое размещение выбрано (например, **Additional placement 1**)
2. В Shopify Checkout Editor удалите существующий блок приложения для этого виджета
3. Нажмите **Add app block**, выберите виджет апселла Aftersell и выберите **то же размещение**, что настроено в Aftersell
4. Сохраните изменения
[Подробнее о согласовании размещений →](/ru/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)
***
## Условия триггеров не выполняются
Если у вашего виджета апселла настроены триггеры, он будет отображаться только тогда, когда корзина удовлетворяет этим условиям. Если корзина не соответствует условиям триггеров, виджет не появится — это ожидаемое поведение.
Доступные типы триггеров включают:
* **Конкретные товары / коллекции:** выбранный товар, вариант или коллекция присутствует (или отсутствует) в корзине
* **Количество конкретного товара:** например, 2 или более единиц товара
* **Тег товара / тип товара / название варианта:** любой товар в корзине соответствует тегу Shopify, типу товара или названию варианта (без учёта регистра)
* **Метаполе товара / метаполе варианта:** товар или вариант в корзине имеет соответствующее значение метаполя
* **Промежуточная сумма корзины:** промежуточная сумма достигает порога (см. примечание ниже о том, как она рассчитывается)
* **Количество товаров в корзине:** общее число позиций в корзине
* **Подписка в корзине:** является ли какой-либо товар в корзине подпиской
* **Атрибут корзины:** ключ/значение атрибута на уровне корзины совпадает (полезно для данных, задаваемых другими приложениями)
* **Применённая скидка / размер скидки:** применён конкретный промокод, или общая скидка достигает порога
* **Страна доставки:** страна доставки покупателя (и, при необходимости, регион) совпадает
* **Язык покупателя:** язык checkout совпадает (например, показывать французский контент только во французских checkout)
* **Теги покупателя:** у вошедшего в систему покупателя есть требуемые теги
* **Тип устройства:** покупатель использует заданное устройство (десктоп или мобильное)
**Промежуточная сумма корзины**, используемая для оценки триггеров, исключает любые позиции, уже добавленные принятыми апселлами (помеченные атрибутом корзины `__as_offer_id`). Таким образом, принятие одного апселла само по себе не поднимет промежуточную сумму выше порога, открывающего другой виджет.
**Комбинирование условий:** когда у виджета несколько условий, они объединяются оператором **И** или **ИЛИ** (по вашему выбору), и условия можно вкладывать в группы для более сложной логики. При объединении через **И** каждое условие должно быть выполнено — одно несовпавшее условие незаметно блокирует виджет. При объединении через **ИЛИ** достаточно любого одного совпадения. Проверьте каждое условие по отдельности относительно вашей тестовой корзины.
**Для отладки триггеров:**
1. Откройте виджет в редакторе Checkout в Aftersell и проверьте его условия триггеров
2. Временно установите триггер на **Show for all customers**, чтобы убедиться, что сам виджет работает, затем снова включите свои конкретные триггеры
3. Убедитесь, что хотя бы один виджет использует триггер **Show for all customers** с самым низким приоритетом в качестве универсального, чтобы какое-либо предложение всегда отображалось, даже когда ни один целевой виджет не совпал
[Подробнее о триггерах checkout →](/ru/aftersell/checkout_triggers)
***
## Проблема с товаром или предложением
Даже когда виджет включён, правильно размещён и его триггеры совпадают, само предложение может быть отфильтровано до отображения.
Если у товара отслеживаются запасы и ни один вариант не доступен для продажи, предложение не отобразится. Убедитесь, что хотя бы один вариант апселл-товара есть в наличии, или используйте товар без отслеживания запасов.
Апселл-товар должен быть активным, продаваемым товаром. Товары со статусом **Draft** или **Archived** в Shopify отфильтровываются и не появятся в качестве предложений. Откройте товар в админ-панели Shopify и убедитесь, что его статус — **Active**.
Настройка **Hide offer if product already in cart** скрывает предложение, когда этот товар уже находится в корзине покупателя. Для стандартных товарных предложений она включена по умолчанию. Если вы хотите, чтобы апселл отображался в любом случае, отключите эту настройку в конфигурации предложения.
Если **Subscription purchase option** установлен на **Subscription**, но у товара в Shopify не настроены планы продаж, предложение отфильтровывается. Убедитесь, что у товара есть хотя бы один активный план продаж, или измените **Subscription purchase option** на **One-time product** (другие варианты — **Subscription** и **Subscription and a one-time product**).
Если предложение настроено как апселл с заменой, оно отображается только тогда, когда товар, который оно должно заменить, присутствует в корзине. Убедитесь, что в конфигурации апселла с заменой выбран правильный целевой товар.
Предложение с заменой также пропускается, когда к целевой позиции **уже применена скидка** — если вы не отметили **Allow replacement if product has discount applied** — или когда **количество** целевой позиции **больше одного**, если вы не отметили **Allow replacement if product quantity greater than 1**.
Если для виджета задано **Max number of accepted offers**, апселл перестаёт отображаться после того, как покупатель принял указанное число предложений от этого виджета в текущем checkout. Это сделано намеренно — по достижении лимита виджет скрывается. Поле применяется только к апселлам Single product и Multi product; у Checkmark-апселлов такого лимита нет.
Для **одиночных** и **мультитоварных** апселлов, как только покупатель добавляет товар предложения в корзину, предложение скрывается (товар уже в корзине). **Checkmark**-апселлы ведут себя иначе — после принятия они остаются видимыми с отмеченным чекбоксом.
***
## Виджеты Shop Pay не отображаются
Виджеты checkout по умолчанию не отображаются в Shop Pay. Чтобы показывать апселл в Shop Pay, вы должны явно включить это:
1. Откройте блок приложения апселла Aftersell в Shopify Checkout Editor
2. В настройках блока найдите раздел **Checkout behaviour**
3. Отметьте опцию **Include app block in Shop Pay**
4. Сохраните изменения
[Подробнее о виджетах Shop Pay →](/ru/aftersell/show_checkout_widgets_in_shop_pay)
***
## Тестирование в предпросмотре Shopify
Предпросмотр в Shopify Checkout Editor ненадёжно отображает виджеты. Виджет может быть настроен правильно и всё равно не появляться в предпросмотре редактора, поскольку предпросмотр не может имитировать тегирование страниц и условия триггеров. Не полагайтесь на предпросмотр редактора для проверки работоспособности виджета.
**Чтобы точно протестировать апселл:**
1. Временно установите триггер виджета на **Show for all customers**
2. Разместите реальный тестовый заказ, используя тестовый платёжный шлюз Shopify (или промокод, делающий заказ бесплатным)
3. Убедитесь, что виджет появляется в реальном потоке оформления заказа
4. Верните свои триггеры после тестирования
***
## Ничего из перечисленного не подходит
Если вы прошли по всем пунктам выше, а апселл всё ещё не отображается, проверьте следующее:
* Виджет **включён** в Aftersell, а блок приложения **добавлен и сохранён** в Shopify Checkout Editor
* **Размещение** в Aftersell совпадает с размещением, выбранным в Shopify
* Условия триггеров соответствуют вашей тестовой корзине — помните, что при объединении через **И** каждое условие должно быть выполнено
* Существует хотя бы один виджет с триггером **Show for all customers** с самым низким приоритетом в качестве универсального
* Апселл-товар имеет статус **Active**, есть в наличии и (для предложений с подпиской) имеет активные планы продаж
* Вы тестируете в **реальном потоке оформления заказа**, а не в предпросмотре редактора Shopify
* Попробуйте очистить кэш браузера или протестировать в режиме инкогнито — изменениям может понадобиться несколько минут для применения
Проблема всё ещё не решена? Свяжитесь с нами через чат или напишите на [support@aftersell.app](mailto:support@aftersell.app), приложив описание настройки виджета и данные тестового заказа.