> ## 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.
# Справочник по апселлу подписок
На этой странице собраны механика и правила платформы, лежащие в основе Subscription Upsell: как добавляется подписка, как определяются планы и скидки, что видит клиент, фулфилмент, ограничения платформы Shopify и полный каталог по устранению неполадок. О том, как создать такое предложение, см. статью [Подписки в post-purchase предложениях](/ru/aftersell/subscriptions_in_post_purchase_offers).
## Как добавляется подписка
Subscription Upsell использует нативный post-purchase changeset Shopify `add_subscription`. В этом сценарии Aftersell не вызывает API вашего приложения подписок напрямую: подписку создает Shopify, а ваше приложение подписок подхватывает ее через собственную интеграцию с Shopify. Поэтому Subscription Upsell работает с любым приложением подписок, использующим нативный Subscription API Shopify.
Первый цикл подписки выполняется из **исходного заказа Shopify** как обычная позиция. Последующими продлениями управляет ваш провайдер подписок — так же, как любой подпиской, созданной при обычном оформлении заказа.
## Совместимые платформы подписок
На стороне Aftersell Subscription Upsell полностью не зависит от провайдера. Aftersell добавляет подписку через нативный changeset Shopify `add_subscription`, а Shopify направляет оформление в то приложение подписок, которое у вас установлено на Shopify Subscription API. Любое приложение подписок, использующее нативный Subscription API Shopify, работает без дополнительной настройки, включая Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (при работе на нативном API подписок Shopify) и нативные планы продаж Shopify.
Планы продаж, созданные в вашем приложении подписок, автоматически подтягиваются в Aftersell. (Совместимость Subscription Upgrade устроена иначе и зависит от провайдера; см. [Обновления подписок](/ru/aftersell/subscription-upgrades).)
## Как определяются планы продаж
### Разрешенные планы подписки
Настройка **Allowed subscription plans** — это список разрешенных планов, применяемый **к каждому варианту**. Для выбранного клиентом варианта он видит только разрешенные планы, доступные для этого варианта:
* Если подходит ровно один разрешенный план, его название отображается статическим текстом, и выбирать ничего не нужно.
* Если подходит несколько, клиент выбирает между ними в выпадающем списке **Purchase options**.
* Если не подходит ни один, для этого варианта отображаются все его собственные планы.
Благодаря такой привязке к вариантам один список разрешенных планов корректно работает для товара, варианты которого имеют разные планы продаж. Если ни один из разрешенных планов недоступен для варианта (потому что план был удален или отключен в Shopify), предложение показывает все доступные планы для этого варианта, чтобы клиенты все равно могли завершить покупку. Настройка разрешенных планов также автоматически очищается, если вы измените вариант покупки товара на только разовую покупку, что предотвращает ошибки конфигурации при удалении вариантов подписки.
### Какой план продаж показывается по умолчанию
Если в **Allowed subscription plans** не выбрано ни одного плана, предложение предварительно выбирает **первый план продаж**, настроенный для товара в Shopify. Если у варианта доступно больше одного плана, клиенты могут изменить его в выпадающем списке **Purchase options**. Чтобы управлять тем, какой план видят клиенты:
* **Ограничьте планы** (рекомендуется). Используйте мультивыбор **Allowed subscription plans**. Разрешите ровно один план, и клиенты будут видеть только его, без выпадающего списка.
* **Измените порядок планов продаж в Shopify.** Порядок планов продаж у товара определяет, какой из них показывается первым.
* **Удалите неиспользуемые планы продаж у товара.** Если у вас несколько периодичностей, а показывать нужно только одну, оставьте у товара только соответствующий план продаж.
Самый важный фактор удержания — соответствие периодичности фактическому использованию товара. Подписку на шампунь каждые 30 дней, когда флакона хватает на 60 дней, отменят; подписку каждые 60 дней, когда флакона хватает на 30 дней, будут пропускать. Изучите данные о повторных разовых заказах, чтобы найти естественную периодичность для каждого товара.
## Как отображаются скидки на подписку
Скидка в предложении Subscription Upsell применяется **только к первому платежному циклу**; последующие регулярные заказы списываются по обычной цене подписки. Post-purchase предложение показывает две разные цены:
* **Кнопка Accept Offer** и промежуточный итог позиции отражают **цену первого цикла**, включая скидку на первый цикл.
* Поле **Recurring subtotal** показывает, сколько с клиента будут списывать при **последующих продлениях** по обычной цене подписки.
Для типичных скидок на первый цикл (от 10 до 25 процентов на первую доставку) это выглядит понятно. При экстремальной скидке на первый цикл, например 100%, это может сбивать с толку, поскольку регулярная цена (а не цена первого цикла \$0) более заметна. Если вы задумали бесплатную первую доставку, укажите это явно в тексте предложения («Первая коробка бесплатно, затем \$59.99 каждые 30 дней»).
Скидки могут быть **процентными** (например, 15%) или **фиксированной суммой** (например, \$5). Скидка передается в changeset Shopify `add_subscription`, а не применяется через ваше приложение подписок, и затрагивает только подписку, созданную этим предложением.
Скидка применяется к подписке, только если вы отметите **Apply discount to subscriptions**. Без этого changeset `add_subscription` не содержит скидки, и подписка оплачивается по полной цене; скидка предложения тогда применяется только к разовой позиции.
## Что видит клиент
Когда клиент принимает Subscription Upsell, в двух системах происходят три вещи.
**В заказе Shopify.** Подтверждение заказа включает и **исходную разовую позицию**, и **новую подписочную позицию** (оплачиваемую по цене первого цикла со скидкой). Клиент оплачивает обе позиции в исходном заказе, а первая отгрузка по подписке отправляется из этого заказа как обычная позиция.
**В письмах-подтверждениях.** Shopify отправляет стандартное подтверждение заказа с обеими позициями. Ваш провайдер подписок обычно отправляет собственное приветственное письмо о подписке с объяснением регулярного графика. Настройте это приветственное письмо так, чтобы оно отправлялось в течение нескольких минут после принятия и содержало имя клиента и товар, периодичность, дату следующего списания и прямую ссылку на клиентский портал.
**В портале провайдера подписок.** Клиент управляет новой подпиской в портале вашего провайдера, где обычно можно приостановить или пропустить доставку, изменить периодичность, заменить товары или отменить подписку. Портал принадлежит вашему провайдеру, а не Aftersell; убедитесь, что он доступен из личного кабинета вашего магазина или из приветственного письма, иначе клиенты будут обращаться в поддержку для отмены.
## Фулфилмент подписок
* **Первый цикл.** Первый заказ по подписке входит в исходный заказ Shopify, поэтому он проходит через тот же процесс фулфилмента, что и разовые заказы (3PL, собственный склад, дропшиппинг). Подписочная позиция отправляется вместе с исходной разовой покупкой.
* **Последующие продления.** Будущие циклы создаются вашим провайдером подписок с периодичностью продления. Каждое продление становится новым заказом Shopify и выполняется так же, как любой другой заказ.
Если ваш 3PL напрямую интегрирован с провайдером подписок, продления обычно проходят автоматически. Если ваш 3PL синхронизируется только с заказами Shopify, дополнительная настройка не требуется, поскольку каждое продление создает заказ Shopify.
## Ограничения платформы Shopify
Несколько правил платформы Shopify применяются к post-purchase предложениям, связанным с подписками, независимо от того, какую функцию Aftersell вы используете.
### Одна подписка на заказ
Shopify не позволяет post-purchase апселлу добавлять подписку в заказ, который уже содержит подписку. Это ограничение установлено Shopify и распространяется на все post-purchase приложения.
**Подключение провайдера подписок снимает это ограничение для Subscription Upsell.** Когда подключен Recharge, Skio или Loop, Aftersell создает новую подписку у вашего провайдера, а не просит Shopify добавить ее, поэтому подписочные предложения доходят до клиентов, чей заказ уже содержит подписку. См. [апселл существующим подписчикам](/ru/aftersell/subscription-upsell-existing-subscribers).
Если **провайдер не подключен**, Aftersell автоматически обрабатывает случай «подписка уже в корзине»:
* **Товары, доступные только по подписке**, в предложении исключаются из воронки для этого клиента.
* **Товары с двумя режимами** (разовая покупка и подписка) автоматически переводятся в режим только разовой покупки, поэтому предложение все равно показывается, но без варианта подписки.
В любом случае вы можете оставить предложение Subscription Upsell в воронке, не беспокоясь, что оно неправильно сработает на заказах, где подписка уже есть. Чтобы изменить уже имеющуюся у клиента подписку, а не добавлять вторую, используйте [Subscription Upgrade](/ru/aftersell/subscription-upgrades).
### Товары, доступные только по подписке
Если товар в вашем предложении настроен на продажу только по подписке, а провайдер не подключен, предложение пропускается всякий раз, когда заказ клиента уже содержит подписочный товар. Что показывает редактор воронки, зависит от вашей настройки:
* **Провайдер подключен.** Баннера нет; ограничение не действует.
* **Провайдер не подключен.** Баннер **Unlock more reach** с действием **Connect a provider**, объясняющий, что клиенты, чей заказ уже содержит подписку, не видят вариант подписки в этом предложении.
* **Воронка уже исключает заказы с подпиской.** Баннера нет, поскольку предложение никогда не доходит до таких клиентов.
Там, где появляется более старый предупреждающий баннер **Subscription limitations**, он перечисляет затронутые товары и предлагает установить **Subscription trigger** в значение **do not include a subscription**.
### Несколько предложений подписки в одной воронке
Если в вашей воронке более одного предложения содержит подписочный товар, в заказ добавляется только первая принятая подписка; последующие предложения подписки пропускаются. Редактор воронки предупреждает вас при обнаружении такого конфликта и перечисляет другие предложения, также содержащие подписочные товары. Чтобы избежать пропуска предложений, ограничьте воронку одним предложением подписки или используйте **Subscription trigger**, чтобы исключить заказы, которые уже содержат подписку.
## Устранение неполадок
Чтобы элементы управления подпиской появились, у выбранного вами товара должен быть хотя бы один активный план продаж в Shopify. Проверьте, что ваше приложение подписок создало планы продаж для этого товара и что они активны и назначены товару.
Предложение предварительно выбирает первый план продаж, настроенный для товара в Shopify, а клиенты могут изменить его в выпадающем списке **Purchase options**, когда к их варианту применимо более одного плана. Чтобы контролировать, какой план они видят, ограничьте предложение мультивыбором **Allowed subscription plans**, измените порядок планов продаж у товара в Shopify, чтобы нужный был первым, или полностью удалите неиспользуемые планы продаж у товара. Разрешение ровно одного плана убирает выпадающий список.
Да, когда к выбранному им варианту применимо более одного плана, предложение показывает выпадающий список **Purchase options**. Чтобы это предотвратить, используйте **Allowed subscription plans** и разрешите один план; периодичность тогда отображается как статический текст. Клиенты по-прежнему могут изменить периодичность позже в портале вашего провайдера подписок.
Используйте режим **One-time purchase only** в настройке варианта покупки предложения. В Aftersell три режима для товаров с включенной подпиской: **One-time purchase only**, **Subscription only** и **One-time purchase and subscription**. Выбор **One-time purchase only** полностью скрывает вариант подписки, даже когда у товара есть активные планы продаж.
Это один из самых разрушительных сценариев сбоя, потому что с клиента списали деньги, но подписка так и не была создана у вашего провайдера. Самая частая причина, с большим отрывом, — **план продаж, деактивированный между отображением предложения и принятием клиентом**. Shopify принимает changeset, потому что на момент отображения у него есть действительный ID плана продаж, но если план деактивирован до принятия клиентом, подписка дальше не оформляется и ошибка не выводится.
Другие частые причины:
* **Сбоит вебхук приложения подписок.** Любое приложение подписок, подхватывающее новые подписки из Shopify, полагается на вебхуки Shopify. Проверьте состояние доставки вебхуков в логах вашего приложения подписок.
* **План продаж был отвязан от товара**, но у него все еще активный ID. Shopify принимает changeset, и позиция попадает в заказ, но у провайдера подписок нет записи, с которой можно работать.
**Важно:** на нативном пути `add_subscription` нет автоматических повторов — оформлением там владеет Shopify, поэтому Aftersell нечего повторять. (Отдельный путь через провайдера, используемый, когда заказ уже содержит подписку, *покрывается* [рабочим процессом повторов subscription-upgrade](/ru/aftersell/subscription-upgrades-troubleshooting).) Если это случилось:
1. Убедитесь, что план продаж все еще активен в Shopify и назначен товару.
2. Проверьте логи импорта заказов / вебхуков вашего приложения подписок по затронутому заказу.
3. Если подписка действительно отсутствует, команда поддержки вашего приложения подписок обычно может вручную оформить клиента по ID заказа.
Если затронуто несколько клиентов, обратитесь в поддержку Aftersell с ID заказов и названием вашего провайдера подписок, но ожидайте, что исправление произойдет на стороне провайдера подписок, а не в Aftersell.
Обычно это проявляется при экстремальной скидке на первый цикл (например, 100% на первый цикл). Кнопка Accept отражает цену первого цикла, но если эта цена выглядит идентично регулярной, может показаться, что скидка не применена. Убедитесь в предпросмотре предложения, что скидка настроена правильно, и опирайтесь на текст предложения («Первая коробка бесплатно, затем \$X каждые Y дней»), чтобы условия были однозначными.
Скидки по умолчанию применяются **только к первому платежному циклу**. Если клиент спрашивает, почему на его втором или третьем заказе нет скидки, — это ожидаемое поведение. Регулярные заказы списываются по обычной цене подписки, которую клиент видел в поле **Recurring subtotal** в предложении.
Если у вас подключен Recharge, Skio или Loop, это ожидаемо, и предложение работает: Aftersell создает новую подписку у вашего провайдера. См. [апселл существующим подписчикам](/ru/aftersell/subscription-upsell-existing-subscribers).
Если провайдер не подключен, Shopify блокирует добавление второй подписки, и предложение незаметно пропускается во время выполнения. Либо подключите провайдера, либо запретите показ предложения таким клиентам, установив **Subscription trigger** в значение **do not include a subscription**.
Shopify допускает только одну подписку на заказ. Если у вас несколько предложений подписки в одной воронке, побеждает первое принятое, а остальные пропускаются. Либо ограничьте воронку одним предложением подписки, либо используйте Subscription trigger, чтобы исключить заказы, в которых уже есть подписка.
Новой подпиской управляют в клиентском портале вашего провайдера подписок, а не напрямую в Shopify. Убедитесь, что портал доступен по ссылке из личного кабинета вашего магазина, и проверьте, что приветственное письмо вашего провайдера настроено на отправку сразу после принятия.
Первый цикл был оплачен в составе заказа Shopify, поэтому возвраты работают так же, как для любой другой позиции. Отмена будущих циклов происходит у вашего провайдера подписок, а не в Aftersell. Возврат по позиции в Shopify не отменяет подписку автоматически — ее нужно также отменить в портале провайдера.