Skip to main content
Ta strona opisuje wszystko, co dotyczy korzystania z Loop z ulepszeniami subskrypcji (Subscription Upgrades), w tym jego unikalne ograniczenia. Pełny przegląd działania ulepszeń subskrypcji znajdziesz w artykule Ulepszenia subskrypcji.

​
Obsługiwane funkcje

Loop obsługuje wszystkie typy ulepszeń subskrypcji:
  • Zmiana częstotliwości dostaw lub rozliczeń
  • Zamiana na inny produkt
  • Oba – zmiana częstotliwości i zamiana produktu
  • Dodanie kolejnego produktu subskrybowalnego do subskrypcji (zobacz Dodawanie produktu)
  • Wyłącznie częstotliwości postpaid (prepaid nie jest obsługiwany — zobacz Ograniczenia poniżej)

​
Ograniczenia specyficzne dla Loop

  • Częstotliwość rozliczeń musi być równa częstotliwości dostaw. Loop nie obsługuje subskrypcji prepaid przez tę integrację. Pole częstotliwości rozliczeń jest wyłączone i automatycznie synchronizowane z częstotliwością dostaw. To największe ograniczenie, o którym warto pamiętać, jeśli Twój sklep opiera się na planach prepaid.
  • Subskrypcje wielopozycyjne są obsługiwane w dwóch krokach: docelowa pozycja produktowa jest wydzielana do nowej subskrypcji z żądaną częstotliwością, a następnie usuwana z pierwotnej. Wiąże się to z wieloma wywołaniami API i w oknie synchronizacji w panelu Loop mogą pojawić się tymczasowe pozycje w trakcie przetwarzania.
  • Niestandardowa częstotliwość nie jest obsługiwana dla subskrypcji wielopozycyjnych. Gdy ustawisz częstotliwość ręcznie (bez wybierania planu sprzedaży), ulepszenie działa dla klientów, których subskrypcja zawiera jedną pozycję produktową. U klientów z subskrypcją wieloproduktową lub pakietową (dwie lub więcej aktywnych pozycji) ulepszenie nie powiedzie się, jeśli nie istnieje pasujący plan sprzedaży dla docelowej częstotliwości. Aby obsłużyć tych klientów, utwórz odpowiedni plan sprzedaży w panelu Loop.

​
Generowanie tokenu API Loop

  1. Otwórz aplikację Loop i przejdź do Settings w lewym dolnym rogu.
  2. W sekcji Admin kliknij API Tokens.
  3. Ustaw uprawnienia, których potrzebuje Aftersell: Read and Write dla Subscription contracts oraz Read dla Orders i Selling plans. Dostęp do zapisu jest wymagany tylko dla subskrypcji.
  4. Kliknij Generate New Token.
  5. Podaj nazwę, wybierz odpowiednie zakresy uprawnień i kliknij Generate Token.
  6. Kliknij Show Token, aby wyświetlić i skopiować klucz. Traktuj go jak hasło i przechowuj w bezpiecznym miejscu.
Więcej szczegółów znajdziesz w dokumentacji API Loop.

​
Łączenie Loop w kreatorze konfiguracji

Gdy dotrzesz do Kroku 1: Połącz dostawcę w kreatorze ulepszeń subskrypcji:
  1. Wybierz Loop z listy rozwijanej Subscription provider.
  2. Wklej swój token API w pole API token.
  3. Kliknij Test API key. Aftersell zweryfikuje token, sprawdzając, czy uwierzytelnia się poprawnie, posiada wszystkie wymagane zakresy uprawnień i należy do Twojego sklepu.
  4. Gdy test zakończy się pomyślnie (zielony znacznik), kliknij Continue, aby przejść do Kroku 2.
Wynik testu pokazuje jeden z dwóch stanów:
  • Zielony znacznik — „API key verified”. Token został uwierzytelniony, wszystkie wymagane zakresy uprawnień są obecne, a token należy do Twojego sklepu. Przycisk Continue jest teraz aktywny.
  • Czerwona ikona anulowania. Weryfikacja nie przebiegła pomyślnie. Przeczytaj komunikat obok ikony: albo token został odrzucony lub brakuje mu wymaganych zakresów uprawnień — komunikat wymienia konkretne brakujące zakresy; popraw token w Loop i przetestuj ponownie. Albo Aftersell nie mógł ukończyć weryfikacji („Could not verify the API key. Please try again.”), co oznacza nieudane wywołanie, a nie zły token — w takim przypadku po prostu przetestuj ponownie.
Wynik „nie można zweryfikować” wygląda dokładnie jak odrzucenie, więc kieruj się komunikatem, a nie ikoną. Przycisk Continue pozostaje nieaktywny, dopóki weryfikacja nie zakończy się na zielono, a edycja dostawcy lub tokenu czyści poprzedni wynik.

​
Zanim skonfigurujesz ulepszenie (Krok 3)

Konfigurując zmianę częstotliwości, możesz wybrać istniejący plan sprzedaży lub ustawić częstotliwość ręcznie:
  • Użyj istniejącego planu sprzedaży. Wybierz z listy rozwijanej planów sprzedaży. Plan musi już istnieć i być aktywny w Twoim panelu Loop.
  • Ustaw częstotliwość ręcznie. Wprowadź częstotliwość dostaw samodzielnie. Loop akceptuje dowolny cykl bez wymagania pasującego planu sprzedaży. Przy częstotliwości ręcznej możesz też zastosować rabat cykliczny.
Jeśli ustawisz częstotliwość ręcznie, a subskrypcja klienta zawiera dwie lub więcej aktywnych pozycji produktowych (kontrakt wieloproduktowy lub pakietowy), ulepszenie nie powiedzie się, chyba że istnieje pasujący plan sprzedaży dla docelowej częstotliwości. Szczegóły znajdziesz w sekcji Ograniczenia.

​
Wybór progu rabatu cyklicznego

Niektóre plany sprzedaży Loop stosują różne rabaty w różnych momentach subskrypcji — na przykład $20 zniżki na pierwsze obciążenie i $10 zniżki od drugiego obciążenia wzwyż. Gdy wybierzesz taki plan, pole Recurring discount zostaje zastąpione listą przycisków opcji pokazujących poszczególne progi rabatowe planu wraz z zakresem obciążeń (na przykład „Charge 1” lub „Charge 2 onward”). Wybierz próg, który ma być stosowany do każdego przyszłego odnowienia ulepszonej subskrypcji. Wybrany próg jest zapisywany z ofertą i stosowany, gdy klient zaakceptuje ulepszenie. Jeśli wybrany plan nie ma progów rabatowych albo ustawiasz częstotliwość ręcznie, zamiast tego pojawia się standardowe pole rabatu z dowolną wartością.

​
Weryfikacja ulepszenia w Loop

Po złożeniu zamówienia testowego i zaakceptowaniu oferty ulepszenia: Przejdź do Subscriptions w panelu Loop i znajdź subskrypcję klienta. Wywołania ulepszeń w Loop są synchroniczne, więc po stronie Aftersell nie ma opóźnienia przetwarzania — zmiana jest stosowana w Loop w momencie zwrócenia wywołania. Sama lista subskrypcji Loop może potrzebować chwili, aby się zaktualizować, więc jeśli zmiany jeszcze tam nie ma, odczekaj kilka minut i odśwież, zanim uznasz to za błąd. Jeśli zmiany tam nie ma, to znaczy, że nie została zastosowana — zobacz poniżej.

​
Rozwiązywanie problemów specyficznych dla Loop

Nie mogę zmienić częstotliwości rozliczeń To oczekiwane zachowanie. Loop nie obsługuje subskrypcji prepaid przez tę integrację. Pole częstotliwości rozliczeń jest wyłączone i automatycznie synchronizowane z częstotliwością dostaw. Ulepszenie zostało zaakceptowane, ale subskrypcja nie została zmodyfikowana Jeśli subskrypcja pozostała bez zmian, najczęstsze przyczyny to:
  • Częstotliwość została ustawiona ręcznie, a subskrypcja klienta zawiera dwie lub więcej aktywnych pozycji produktowych. W takim przypadku Loop wymaga pasującego planu sprzedaży dla docelowej częstotliwości. Utwórz plan sprzedaży w Loop lub przełącz się na opcję Use an existing selling plan w konfiguracji oferty.
  • Użyto opcji Use an existing selling plan, a wybrany plan sprzedaży już nie istnieje w panelu Loop. Utwórz plan sprzedaży w Loop i spróbuj ponownie.
  • Twój token API wygasł lub brakuje mu wymaganych uprawnień: write dla Subscription contracts, read dla Orders i Selling plans. Przejdź do Kroku 1: Połącz dostawcę, ponownie przetestuj klucz i sprawdź w komunikacie błędu konkretne brakujące zakresy.
  • Kwalifikujący się produkt w lejku nie odpowiada temu, co klient faktycznie subskrybował.
Aftersell automatycznie ponawia nieudane wywołania dostawcy w procesie działającym w tle. Jeśli wszystkie ponowienia się nie powiodą, skontaktuj się z pomocą techniczną, podając adres URL sklepu, identyfikator zamówienia Shopify, adres e-mail klienta, przybliżony czas zaakceptowania ulepszenia oraz używanego dostawcę. Lista rozwijana planów sprzedaży jest pusta Opcja „Use an existing selling plan” pobiera plany bezpośrednio z Loop. Jeśli lista jest pusta:
  • Potwierdź, że plany sprzedaży są skonfigurowane w panelu Loop.
  • Upewnij się, że Twój token API ma dostęp Read do Selling plans.
  • Wróć do Kroku 1: Połącz dostawcę, ponownie przetestuj token API i kontynuuj.
W moim panelu Loop pojawiają się tymczasowe pozycje w trakcie przetwarzania To oczekiwane zachowanie w przypadku subskrypcji wielopozycyjnych. Loop obsługuje je w dwóch krokach (podział, a następnie usunięcie), więc między nimi może pojawić się tymczasowa pozycja. Znika ona, gdy tylko drugi krok zostanie zakończony.
← Wróć do Przeglądu ulepszeń subskrypcji · Konfiguracja · Czym są integracje?