> ## 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.
# Dokumentacja konfiguracji ulepszeń subskrypcji
Ta strona zbiera szczegółowe zasady stojące za kreatorem konfiguracji Subscription Upgrade: jak wyliczane są ceny, jak działają opcje terminu i rabatu, wyzwalacz kwalifikacji oraz dlaczego produkt oferty jest produktem zastępczym. Instrukcję krok po kroku znajdziesz w artykule [Konfigurowanie ulepszeń subskrypcji](/pl/aftersell/subscription-upgrades-setup).
## Stany weryfikacji klucza API
W kroku 1 przycisk **Test API key** weryfikuje Twój token u dostawcy, sprawdzając, czy się uwierzytelnia, czy ma wszystkie wymagane zakresy uprawnień i czy należy do Twojego sklepu. Wynik pokazuje jeden z dwóch stanów:
* **Zielony znacznik, „API key verified”.** Token został uwierzytelniony, wszystkie wymagane zakresy są obecne, a token należy do Twojego sklepu. Przycisk **Continue** jest aktywny.
* **Czerwona ikona anulowania.** Sprawdzenie nie zakończyło się pomyślnie. Komunikat obok ikony informuje, która z dwóch sytuacji wystąpiła: Twój dostawca **odrzucił** token (unieważniony lub bez wymaganych zakresów, a komunikat wskazuje konkretny problem) albo Aftersell **nie mógł dokończyć sprawdzenia** („Could not verify the API key. Please try again.”), co oznacza nieudane wywołanie, a nie błędny token. Jeśli token został odrzucony, popraw go; w przeciwnym razie po prostu przetestuj ponownie.
Nie ma trzeciego, łagodniejszego stanu, a wynik „nie można zweryfikować” wygląda dokładnie tak samo jak odrzucenie, więc czytaj komunikat, a nie samą ikonę. Przycisk **Continue** pozostaje nieaktywny, dopóki sprawdzenie nie zakończy się na zielono. Edycja dostawcy lub tokenu czyści poprzedni wynik, więc po każdej zmianie przetestuj ponownie. Ta blokada istnieje, aby zapobiegać niepowodzeniom ulepszeń subskrypcji, które w przeciwnym razie ujawniłyby się dopiero po obciążeniu klienta.
## Wyzwalacz kwalifikacji: Variant on subscription
Kreator automatycznie ustawia za Ciebie jeden wyzwalacz; nie musisz konfigurować go ręcznie:
| Wyzwalacz | Ustawienie |
| - | - |
| **Variant on subscription** | Ustawiony na Twój kwalifikujący się (docelowy) wariant. Uruchamia się tylko wtedy, gdy ten wariant znajduje się w zamówieniu **w pozycji subskrypcyjnej**. |
Wszystkie włączone wyzwalacze używają logiki AND: każdy warunek musi być spełniony, aby lejek się wyświetlił. W kroku **Triggers** edytora lejka możesz dodać kolejne opcjonalne wyzwalacze (zgrupowane w zwijanej sekcji **Additional triggers**, która pokazuje ich liczbę i otwiera się automatycznie, gdy ustawiono opcjonalne wyzwalacze).
**Nie zastępuj go połączeniem wyzwalacza Product i wyzwalacza Subscription.** Ta starsza kombinacja to dwa niezależne warunki, więc zamówienie zawierające Twój produkt wyzwalający jako zakup *jednorazowy* obok *niepowiązanej* pozycji subskrypcyjnej spełnia oba: lejek się uruchamia, a ulepszenie kończy się niepowodzeniem w dalszym etapie, ponieważ nie ma pasującej subskrypcji do zmiany. **Variant on subscription** to pojedynczy warunek, którego nie da się w ten sposób rozdzielić, a kreator automatycznie migruje starsze lejki z tej kombinacji.
Bez wyzwalacza specyficznego dla produktu lejek może być pokazywany klientom, którzy nie mają w zamówieniu kwalifikującego się produktu subskrypcyjnego. Marnuje to wyświetlenia i powoduje modyfikację subskrypcji, która po cichu kończy się niepowodzeniem: produkt oferty jest dodawany do zamówienia, ale żadna subskrypcja nie zostaje zmieniona w Recharge, Skio ani Loop.
Jeśli włączona jest opcja **Show this funnel for all customers**, zastępuje ona wszystkie inne wyzwalacze, a lejek uruchamia się przy każdym checkoucie. Nie jest to zalecane dla lejków ulepszeń subskrypcji.
## Którą cenę pokazuje Recurring subtotal
**Recurring subtotal** w ofercie informuje klienta, ile będzie kosztować jego następne odnowienie. Z którego produktu pobierana jest ta cena, zależy od typu ulepszenia:
| Typ ulepszenia | Źródło ceny |
| - | - |
| Change delivery or billing frequency | Produkt **wyzwalający** |
| Replace with a different subscription product | Produkt **zastępczy** |
| Both, change frequency and replace subscription product | Produkt **zastępczy** |
| Add another subscribable item to subscription | **Dodana** pozycja |
To najczęstsze źródło nieporozumień. Ulepszenie wyłącznie częstotliwości z założenia zachowuje ten sam produkt, więc jego cykliczna suma częściowa może pokazywać wyłącznie cenę produktu wyzwalającego, niezależnie od ustawionej częstotliwości. Jeśli spodziewałeś się tam ceny innego produktu, najprawdopodobniej potrzebujesz zamiast tego typu **Both, change frequency and replace subscription product**.
Używana ilość pochodzi z pola **Override subscription quantity**, które pojawia się tylko w typach zastępczych. W ulepszeniu wyłącznie częstotliwości zawsze wynosi 1.
## Termin ulepszenia
Domyślnie ulepszenie obowiązuje od **następnego cyklu rozliczeniowego** klienta, z zachowaniem dotychczasowej daty odnowienia.
Jeśli opcja terminu jest włączona dla Twojego sklepu, pod polami częstotliwości pojawia się pole wyboru:
> **My fulfillment provider ships the upgraded item on the current order**
Zaznaczenie go powoduje, że nowy interwał rozliczeniowy zaczyna się natychmiast, a nie przy następnym odnowieniu, i odblokowuje pole **One-time upgrade price** w kroku 4.
Aftersell nie zmienia zamówienia, które klient właśnie złożył. To ustawienie przesuwa wyłącznie interwał rozliczeniowy. Zaznacz je tylko wtedy, gdy Twój dostawca realizacji zamówień jest skonfigurowany tak, aby rozpoznawał produkt zastępczy ulepszenia i wysyłał ulepszony produkt w ramach bieżącego zamówienia.
To pole wyboru jest domyślnie wyłączone i nie jest dostępne we wszystkich sklepach. Pojawia się tylko w typach ulepszeń **Change delivery or billing frequency** oraz **Both, change frequency and replace subscription product** i tylko po włączeniu tej opcji dla Twojego sklepu. Jeśli jej potrzebujesz, skontaktuj się z pomocą techniczną przez czat w aplikacji.
## Rabat cykliczny
Opcjonalna zachęta stosowana do **każdego przyszłego odnowienia** ulepszonej subskrypcji (nie tylko do pierwszego cyklu). Niedostępna dla typu dodawania pozycji. Sposób wyświetlania pola zależy od tego, czy wybrany plan sprzedaży ma stopniowane zasady cenowe:
* **Gdy wybrano plan sprzedaży z progami rabatowymi** (na przykład plan Loop, który stosuje \$20 zniżki przy pierwszym obciążeniu i \$10 zniżki od drugiego obciążenia), pole do swobodnego wpisu zostaje zastąpione listą przycisków opcji, po jednym na próg. Każda opcja pokazuje kwotę rabatu i zakres obciążeń, do których się odnosi (na przykład „Charge 1” lub „Charge 2 onward”). Wybierz próg, który ma być stosowany do każdego przyszłego odnowienia.
* **Gdy nie wybrano planu sprzedaży lub wybrany plan nie ma progów rabatowych**, pojawia się standardowe pole do swobodnego wpisu. Wpisz kwotę i wybierz **Percentage** lub **Fixed amount**.
## Jednorazowa cena ulepszenia według typu ulepszenia
**One-time upgrade price** to kwota, którą klient płaci w ramach tego zamówienia Shopify po akceptacji.
* W typach **Change delivery or billing frequency** i **Both** jest domyślnie zablokowana na `0`, ponieważ Twój dostawca subskrypcji pobiera opłatę na koniec bieżącego cyklu rozliczeniowego, a produkt zastępczy pojawia się w zamówieniu Shopify z ceną \$0.00. Staje się edytowalna dopiero po zaznaczeniu [pola wyboru terminu ulepszenia](#upgrade-timing) w kroku 3.
* W typach **Replace with a different subscription product** i **Add another subscribable item to subscription** pole wyboru terminu nie ma zastosowania, więc pole ceny jest zawsze edytowalne.
Co w nim wpisać, zależy od typu ulepszenia:
* **Częstotliwość, zamiana lub oba:** *różnicę* cen między pierwotną a ulepszoną subskrypcją. Klient zachowuje swoją subskrypcję, a to obciążenie pokrywa różnicę.
* **Dodanie kolejnej pozycji subskrypcyjnej:** opłatę za dodaną pozycję w tym zamówieniu. Nic nie jest zamieniane, więc nie ma różnicy do obliczenia: to po prostu kwota, którą klient płaci teraz za nową pozycję, która następnie odnawia się wraz z jego subskrypcją. Zobacz [Dodawanie pozycji do istniejącej subskrypcji](/pl/aftersell/subscription-upgrades-add-item).
**First-order discount.** Opcjonalny rabat stosowany wyłącznie do tego zakupu ulepszenia, wprowadzany jako procent (`%`) lub stała kwota. Znajduje się obok **One-time upgrade price** i pojawia się zawsze, gdy to pole jest edytowalne, zarówno na karcie **Create new**, jak i **Pick existing**. W typie dodawania pozycji pole nadal się pojawia, ale zawsze jest zapisywane jako `0`; oferty dodawania pozycji nigdy nie zawierają rabatu, więc zamiast tego ustaw żądaną cenę w produkcie oferty.
## Dlaczego produkt oferty jest produktem zastępczym
Produkt oferty jest **wyłącznie wizualnym elementem zastępczym**, a nie prawdziwym produktem kupowanym przez klienta. Shopify nie pozwala na pokazanie produktu subskrypcyjnego jako upsellu post-purchase po zamówieniu, które już zawiera subskrypcję, więc Aftersell rejestruje cenę między ulepszeniami za pomocą niesubskrypcyjnego zastępczego SKU.
* Ustawione przez Ciebie zdjęcie, tytuł i cena pojawiają się na karcie oferty.
* Po akceptacji wyświetlana cena jest pobierana w zamówieniu Shopify, a Recharge, Skio lub Loop stosuje faktyczne ulepszenie subskrypcji w jej następnym cyklu.
* Jeśli zamiast tworzyć produkt, użyjesz opcji **Pick existing**, produkt musi obsługiwać zakup jednorazowy; produkty dostępne wyłącznie w subskrypcji są odfiltrowywane z selektora.