Skip to main content
На этой странице описано всё, что касается использования Loop с обновлениями подписок (Subscription Upgrades), включая его уникальные ограничения. Полный обзор работы обновлений подписок см. в разделе Обновления подписок.

​
Поддерживаемые функции

Loop поддерживает все типы обновлений подписок:
  • Изменение частоты доставки или списания
  • Замена на другой товар
  • Оба варианта — изменение частоты и замена товара
  • Добавление ещё одного товара с подпиской в подписку (см. Добавление товара)
  • Только частоты с постоплатой (предоплата не поддерживается — см. Ограничения ниже)

​
Ограничения, специфичные для Loop

  • Частота списания должна совпадать с частотой доставки. Loop не поддерживает предоплаченные подписки через эту интеграцию. Поле частоты списания отключено и автоматически синхронизируется с частотой доставки. Это самое серьёзное ограничение, о котором нужно знать, если ваш магазин использует предоплаченные планы.

​
Создание API-токена Loop

  1. Откройте приложение Loop и перейдите в Settings в левом нижнем углу.
  2. В разделе Admin нажмите API Tokens.
  3. Задайте разрешения, необходимые Aftersell: Read and Write для Subscription contracts и Read для Orders и Selling plans. Доступ на запись требуется только для подписок.
  4. Нажмите Generate New Token.
  5. Укажите название, выберите нужные области доступа и нажмите Generate Token.
  6. Нажмите Show Token, чтобы просмотреть и скопировать ключ. Обращайтесь с ним как с паролем и храните в надёжном месте.
Подробнее см. в документации по API Loop.

​
Подключение Loop в мастере настройки

Когда вы дойдёте до шага Step 1: Connect provider в мастере обновления подписки:
  1. Выберите Loop в раскрывающемся списке Subscription provider.
  2. Вставьте ваш API-токен в поле API token.
  3. Нажмите Test API key. Aftersell проверит токен: корректность аутентификации, наличие всех необходимых областей доступа и принадлежность токена вашему магазину.
  4. После успешной проверки (зелёная галочка) нажмите Continue, чтобы перейти к шагу 2.
Результат проверки отображается в одном из двух состояний:
  • Зелёная галочка — «API key verified». Токен прошёл аутентификацию, все необходимые области доступа присутствуют, и токен принадлежит вашему магазину. Кнопка Continue теперь доступна.
  • Красный значок отмены. Проверка не прошла успешно. Прочитайте сообщение рядом со значком: либо токен был отклонён, либо в нём отсутствуют необходимые области доступа. В сообщении указаны конкретные отсутствующие области. Исправьте токен в Loop и повторите проверку. Либо Aftersell не смог завершить проверку («Could not verify the API key. Please try again.») — это сбой вызова, а не неверный токен; в этом случае просто повторите проверку.
Результат «не удалось проверить» выглядит точно так же, как отклонение, поэтому ориентируйтесь на сообщение, а не на значок. Кнопка Continue остаётся неактивной, пока проверка не завершится успешно, а изменение провайдера или токена сбрасывает предыдущий результат.

​
Сохранение целостности подписок с несколькими товарами

По умолчанию, когда обновление частоты или частоты и товара применяется к клиенту с двумя или более активными позициями в его подписке Loop, Aftersell выделяет обновляемый товар в новую подписку. Это сохраняет остальные позиции на их исходной периодичности списаний. Если другие товары в подписке являются дополнениями к обновляемому товару (а не самостоятельными подписками), можно включить Don’t split multi-product subscriptions в предложении. Когда эта настройка включена, Aftersell перенастраивает весь контракт на новую частоту вместо его разделения. Чего ожидать при включённой настройке:
  • Другие товары подписки также переходят на новую частоту.
  • Эти товары сохраняют скидку из плана продаж их исходной частоты, но на новой периодичности.
  • Aftersell не гарантирует корректное ценообразование для сопутствующих позиций — если сопутствующий товар находится на плане с фиксированной ценой и нет подходящего плана для новой частоты, он сохраняет исходную абсолютную цену на новой периодичности.
Включайте эту настройку только тогда, когда другие товары являются дополнениями к обновляемому товару. Если это независимые подписки, используйте поведение разделения по умолчанию, чтобы каждый товар оставался на собственном графике списаний.
Эта настройка доступна для типов обновлений frequency и frequency + product только на Loop. Она отображается как флажок в панели настроек предложения.

​
Перед настройкой обновления (шаг 3)

При настройке изменения частоты вы можете либо выбрать существующий план продаж, либо задать частоту вручную:
  • Использовать существующий план продаж. Выберите его в раскрывающемся списке планов продаж. План должен уже существовать и быть активным в вашей панели Loop.
  • Задать частоту вручную. Введите частоту доставки самостоятельно. Loop принимает любую периодичность без необходимости в подходящем плане продаж. При использовании ручной частоты вы также можете применить повторяющуюся скидку.
Если вы задаёте частоту вручную, а подписка клиента содержит две или более активных товарных позиций (контракт на несколько товаров или комплект), обновление завершится ошибкой, если для целевой частоты не существует подходящего плана продаж. Подробности см. в разделе Ограничения.

​
Выбор уровня повторяющейся скидки

Некоторые планы продаж Loop применяют разные скидки на разных этапах подписки — например, скидка $20 на первое списание и $10 начиная со второго списания. Когда вы выбираете такой план, поле Recurring discount заменяется списком переключателей, показывающих каждый уровень скидки плана с его диапазоном списаний (например, «Charge 1» или «Charge 2 onward»). Выберите уровень, который должен применяться к каждому будущему продлению обновлённой подписки. Выбранный уровень сохраняется вместе с предложением и применяется, когда клиент принимает обновление. Если у выбранного плана нет уровней скидок или вы задаёте частоту вручную, вместо этого отображается стандартное поле свободного ввода скидки.

​
Проверка обновления в Loop

После размещения тестового заказа и принятия предложения об обновлении: Перейдите в раздел Subscriptions в панели Loop и найдите подписку клиента. Вызовы обновления в Loop синхронны, поэтому на стороне Aftersell нет задержки обработки — изменение применяется в Loop в момент возврата вызова. Собственный список подписок Loop может обновляться чуть дольше, поэтому если изменения ещё нет, подождите несколько минут и обновите страницу, прежде чем считать это сбоем. Если изменения нет, значит оно не применилось — см. ниже.

​
Устранение проблем, специфичных для Loop

Я не могу изменить частоту списания Это ожидаемое поведение. Loop не поддерживает предоплаченные подписки через эту интеграцию. Поле частоты списания отключено и автоматически синхронизируется с частотой доставки. Обновление было принято, но подписка не изменилась Если подписка осталась без изменений, наиболее частые причины:
  • Вы задали частоту вручную, а подписка клиента содержит две или более активных товарных позиций. В этом случае Loop требует наличия подходящего плана продаж для целевой частоты. Создайте план продаж в Loop или переключитесь на вариант Use an existing selling plan в настройках предложения.
  • Вы использовали Use an existing selling plan, а выбранный план продаж больше не существует в вашей панели Loop. Создайте план продаж в Loop и повторите попытку.
  • Срок действия вашего API-токена истёк или у него нет необходимых разрешений: write для Subscription contracts, read для Orders и Selling plans. Перейдите к шагу Step 1: Connect provider, повторно проверьте ключ и посмотрите в сообщении об ошибке, каких именно областей доступа не хватает.
  • Подходящий товар в воронке не совпадает с тем, на что клиент фактически подписан.
Aftersell автоматически повторяет неудачные вызовы провайдера в фоновом процессе. Если все повторы завершились неудачей, обратитесь в поддержку, указав URL вашего магазина, идентификатор заказа Shopify, адрес электронной почты клиента, приблизительное время принятия обновления и используемого провайдера. Раскрывающийся список планов продаж пуст Вариант «Use an existing selling plan» получает планы напрямую из Loop. Если список пуст:
  • Убедитесь, что планы продаж настроены в вашей панели Loop.
  • Убедитесь, что у вашего API-токена есть доступ Read к Selling plans.
  • Вернитесь к шагу Step 1: Connect provider, повторно проверьте API-ключ и продолжите.
В моей панели Loop появляются временные промежуточные позиции Это ожидаемо, когда обновление подписки с несколькими позициями использует поведение разделения по умолчанию. Loop обрабатывает их в два этапа (разделение, затем удаление), из-за чего временные позиции могут появляться в течение 24-часового окна синхронизации. Они исчезают автоматически после завершения синхронизации. Если вы хотите полностью избежать разделения, см. Сохранение целостности подписок с несколькими товарами.
← Назад к Обзору обновлений подписок · Настройка и конфигурация · Что такое интеграции?