> ## 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 upselli subskrypcyjnych
Ta strona zawiera mechanikę i zasady platformy stojące za Subscription Upsell: jak dodawana jest subskrypcja, jak rozstrzygane są plany i rabaty, co widzi klient, realizacja zamówień, ograniczenia platformy Shopify oraz pełny katalog rozwiązywania problemów. Informacje o tym, jak go zbudować, znajdziesz w artykule [Subskrypcje w ofertach post-purchase](/pl/aftersell/subscriptions_in_post_purchase_offers).
## Jak dodawana jest subskrypcja
Subscription Upsell korzysta z natywnego zestawu zmian post-purchase Shopify `add_subscription`. W tym przepływie Aftersell nie wywołuje bezpośrednio API Twojej aplikacji subskrypcyjnej: subskrypcja jest tworzona przez Shopify, a Twoja aplikacja subskrypcyjna przejmuje ją przez własną integrację z Shopify. Dlatego Subscription Upsell działa z każdą aplikacją subskrypcyjną korzystającą z natywnego Subscription API Shopify.
Pierwszy cykl subskrypcji jest realizowany w ramach **pierwotnego zamówienia Shopify** jako zwykła pozycja. Kolejnymi odnowieniami zarządza Twój dostawca subskrypcji, tak samo jak każdą subskrypcją utworzoną podczas zwykłego checkoutu.
## Zgodne platformy subskrypcyjne
Po stronie Aftersell Subscription Upsell jest w pełni niezależny od dostawcy. Aftersell dodaje subskrypcję za pomocą natywnego zestawu zmian `add_subscription` Shopify, a Shopify kieruje zapis do aplikacji subskrypcyjnej zainstalowanej na Shopify Subscription API. Każda aplikacja subskrypcyjna korzystająca z natywnego Subscription API Shopify działa bez dodatkowej konfiguracji, w tym Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (gdy działa na natywnym API subskrypcji Shopify) oraz natywne plany sprzedaży Shopify.
Plany sprzedaży utworzone w Twojej aplikacji subskrypcyjnej są automatycznie pobierane do Aftersell. (Zgodność Subscription Upgrade wygląda inaczej i zależy od dostawcy; zobacz [Ulepszenia subskrypcji](/pl/aftersell/subscription-upgrades).)
## Jak rozstrzygane są plany sprzedaży
### Allowed subscription plans
Ustawienie **Allowed subscription plans** to lista dozwolonych planów, stosowana **dla każdego wariantu osobno**. Dla wariantu wybranego przez klienta widoczne są tylko dozwolone plany dostępne dla tego wariantu:
* Jeśli ma zastosowanie dokładnie jeden dozwolony plan, jego nazwa jest wyświetlana jako tekst statyczny i nie ma wyboru do dokonania.
* Jeśli ma zastosowanie kilka planów, klient wybiera spośród nich na liście rozwijanej **Purchase options**.
* Jeśli nie ma zastosowania żaden, dany wariant wraca do wyświetlania wszystkich swoich planów.
Takie zawężanie do wariantu oznacza, że jedna lista dozwolonych planów może poprawnie obsłużyć produkt, którego warianty mają różne plany sprzedaży. Jeśli żaden z dozwolonych planów nie jest dostępny dla wariantu (ponieważ plan został usunięty lub wyłączony w Shopify), oferta wraca do wyświetlania wszystkich dostępnych planów dla tego wariantu, dzięki czemu klienci nadal mogą sfinalizować zakup. Ustawienie dozwolonych planów jest też automatycznie czyszczone, jeśli zmienisz opcję zakupu produktu na wyłącznie zakup jednorazowy, co zapobiega błędom konfiguracji po usunięciu opcji subskrypcji.
### Który plan sprzedaży jest wyświetlany domyślnie
Gdy w **Allowed subscription plans** nie wybrano żadnych planów, oferta wstępnie wybiera **pierwszy plan sprzedaży** skonfigurowany dla produktu w Shopify. Jeśli dany wariant ma dostępnych więcej planów, klienci mogą go zmienić na liście rozwijanej **Purchase options**. Aby kontrolować, który plan widzą klienci:
* **Ogranicz plany** (zalecane). Użyj listy wielokrotnego wyboru **Allowed subscription plans**. Zezwól na dokładnie jeden, a klienci zobaczą tylko ten plan, bez listy rozwijanej.
* **Zmień kolejność planów sprzedaży w Shopify.** Kolejność planów sprzedaży w produkcie określa, który jest wyświetlany jako pierwszy.
* **Usuń nieużywane plany sprzedaży z produktu.** Jeśli masz kilka częstotliwości, a chcesz pokazywać tylko jedną, pozostaw w produkcie wyłącznie odpowiedni plan sprzedaży.
Najważniejszym czynnikiem wpływającym na retencję jest dopasowanie częstotliwości do faktycznego zużycia produktu. 30-dniowa subskrypcja szamponu, którego butelka wystarcza na 60 dni, zostanie anulowana; 60-dniowa subskrypcja, gdy butelka wystarcza na 30 dni, będzie pomijana. Przejrzyj dane o ponownych zakupach jednorazowych, aby znaleźć naturalną częstotliwość dla każdego produktu.
## Jak wyświetlane są rabaty na subskrypcje
Rabat w ofercie Subscription Upsell dotyczy **wyłącznie pierwszego cyklu rozliczeniowego**; kolejne cykliczne zamówienia są obciążane standardową ceną subskrypcji. Oferta post-purchase pokazuje dwie różne ceny:
* **Przycisk Accept Offer** i suma częściowa pozycji odzwierciedlają **cenę pierwszego cyklu**, z uwzględnieniem rabatu na pierwszy cykl.
* Pole **Recurring subtotal** pokazuje, ile klient zapłaci przy **kolejnych odnowieniach** według standardowej ceny subskrypcji.
Przy typowych rabatach na pierwszy cykl (10–25 procent zniżki na pierwszą dostawę) jest to czytelne. Przy skrajnym rabacie na pierwszy cykl, na przykład 100% zniżki, może być mylące, ponieważ bardziej widoczna jest cena cykliczna (a nie cena \$0 za pierwszy cykl). Jeśli zamierzasz zaoferować darmową pierwszą dostawę, napisz to wprost w treści oferty („Pierwsze pudełko gratis, potem \$59.99 co 30 dni”).
Rabaty mogą być **procentowe** (na przykład 15% zniżki) lub **kwotowe** (na przykład \$5 zniżki). Rabat jest przekazywany w zestawie zmian `add_subscription` Shopify, a nie stosowany przez Twoją aplikację subskrypcyjną, i dotyczy wyłącznie subskrypcji utworzonej przez tę ofertę.
Rabat trafia do subskrypcji tylko wtedy, gdy zaznaczysz **Apply discount to subscriptions**. Bez tego zestaw zmian `add_subscription` nie zawiera rabatu, a subskrypcja jest rozliczana według pełnej ceny; rabat oferty dotyczy wtedy wyłącznie pozycji jednorazowej.
## Co widzi klient
Gdy klient zaakceptuje Subscription Upsell, w dwóch systemach dzieją się trzy rzeczy.
**W zamówieniu Shopify.** Potwierdzenie zamówienia zawiera zarówno **pierwotną pozycję jednorazową**, jak i **nową pozycję subskrypcyjną** (rozliczaną według obniżonej ceny pierwszego cyklu). Klient płaci za obie pozycje w ramach pierwotnego zamówienia, a pierwsza dostawa subskrypcji jest wysyłana z tego zamówienia jako zwykła pozycja.
**W potwierdzeniach e-mail.** Shopify wysyła standardowe potwierdzenie zamówienia z obiema pozycjami. Twój dostawca subskrypcji zazwyczaj wysyła własny powitalny e-mail subskrypcyjny wyjaśniający harmonogram cykliczny. Skonfiguruj ten e-mail tak, aby był wysyłany w ciągu kilku minut od akceptacji i zawierał imię klienta i produkt, częstotliwość, datę następnego obciążenia oraz bezpośredni link do portalu klienta.
**W portalu dostawcy subskrypcji.** Klient zarządza nową subskrypcją w portalu Twojego dostawcy, gdzie zwykle może wstrzymać lub pominąć dostawę, zmienić częstotliwość, wymienić produkty lub anulować subskrypcję. Portal należy do Twojego dostawcy, a nie do Aftersell; upewnij się, że jest dostępny z poziomu sekcji konta w Twoim sklepie lub z powitalnego e-maila, w przeciwnym razie klienci będą zgłaszać się do pomocy technicznej, aby anulować.
## Realizacja zamówień subskrypcyjnych
* **Pierwszy cykl.** Pierwsze zamówienie subskrypcyjne jest częścią pierwotnego zamówienia Shopify, więc przechodzi przez ten sam proces realizacji, którego używasz dla zamówień jednorazowych (3PL, we własnym zakresie, dropshipping). Pozycja subskrypcyjna jest wysyłana razem z pierwotnym zakupem jednorazowym.
* **Kolejne odnowienia.** Przyszłe cykle są tworzone przez Twojego dostawcę subskrypcji zgodnie z częstotliwością odnowień. Każde odnowienie staje się nowym zamówieniem Shopify, realizowanym tak samo jak każde inne zamówienie.
Jeśli Twój 3PL integruje się bezpośrednio z Twoim dostawcą subskrypcji, odnowienia zazwyczaj przepływają automatycznie. Jeśli Twój 3PL synchronizuje się wyłącznie z zamówieniami Shopify, nie jest potrzebna żadna dodatkowa konfiguracja, ponieważ każde odnowienie tworzy zamówienie Shopify.
## Ograniczenia platformy Shopify
Kilka zasad platformy Shopify dotyczy ofert post-purchase związanych z subskrypcjami niezależnie od tego, z której funkcji Aftersell korzystasz.
### Jedna subskrypcja na zamówienie
Shopify nie pozwala, aby upsell post-purchase dodawał subskrypcję do zamówienia, które już ją zawiera. To ograniczenie jest ustalone przez Shopify i dotyczy wszystkich aplikacji post-purchase.
**Podłączenie dostawcy subskrypcji usuwa to ograniczenie dla Subscription Upsell.** Gdy podłączony jest Recharge, Skio lub Loop, Aftersell tworzy nową subskrypcję u Twojego dostawcy, zamiast prosić Shopify o jej dodanie, dzięki czemu oferty subskrypcyjne docierają do klientów, których zamówienie już zawiera subskrypcję. Zobacz [upselle dla obecnych subskrybentów](/pl/aftersell/subscription-upsell-existing-subscribers).
Jeśli **nie podłączono żadnego dostawcy**, Aftersell automatycznie obsługuje przypadek „subskrypcja już w koszyku”:
* **Produkty dostępne wyłącznie w subskrypcji** w ofercie są usuwane z lejka dla tego klienta.
* **Produkty dwutrybowe** (jednorazowe i subskrypcyjne) są automatycznie ograniczane do trybu wyłącznie jednorazowego, więc oferta nadal się wyświetla, ale bez opcji subskrypcji.
Tak czy inaczej, możesz pozostawić ofertę Subscription Upsell w lejku bez obaw, że uruchomi się nieprawidłowo w zamówieniach, które już zawierają subskrypcję. Aby zmodyfikować subskrypcję, którą klient już ma, zamiast dodawać drugą, użyj [Subscription Upgrade](/pl/aftersell/subscription-upgrades).
### Produkty dostępne wyłącznie w subskrypcji
Jeśli produkt w Twojej ofercie jest skonfigurowany do sprzedaży wyłącznie w subskrypcji, a nie podłączono żadnego dostawcy, oferta jest pomijana zawsze, gdy zamówienie klienta już zawiera produkt subskrypcyjny. To, co pokazuje edytor lejka, zależy od Twojej konfiguracji:
* **Dostawca jest podłączony.** Brak banera; ograniczenie nie ma zastosowania.
* **Żaden dostawca nie jest podłączony.** Baner **Unlock more reach** z akcją **Connect a provider**, wyjaśniający, że klienci, których zamówienie już zawiera subskrypcję, nie widzą opcji subskrypcji w tej ofercie.
* **Lejek już wyklucza zamówienia z subskrypcją.** Brak banera, ponieważ oferta nigdy nie dociera do tych klientów.
Tam, gdzie pojawia się starszy baner ostrzegawczy **Subscription limitations**, wymienia on produkty, których dotyczy problem, i sugeruje ustawienie **Subscription trigger** na **do not include a subscription**.
### Wiele ofert subskrypcyjnych w tym samym lejku
Jeśli więcej niż jedna oferta w lejku zawiera produkt subskrypcyjny, do zamówienia dodawana jest tylko pierwsza zaakceptowana subskrypcja; kolejne oferty subskrypcyjne są pomijane. Edytor lejka ostrzega Cię, gdy wykryje ten konflikt, wymieniając pozostałe oferty, które również zawierają produkty subskrypcyjne. Aby uniknąć pomijania ofert, ogranicz lejek do jednej oferty subskrypcyjnej lub użyj **Subscription trigger**, aby wykluczyć zamówienia, które już zawierają subskrypcję.
## Rozwiązywanie problemów
Aby pojawiły się kontrolki subskrypcji, wybrany produkt musi mieć w Shopify co najmniej jeden aktywny plan sprzedaży. Sprawdź, czy Twoja aplikacja subskrypcyjna utworzyła plany sprzedaży dla tego produktu oraz czy są one aktywne i przypisane do produktu.
Oferta wstępnie wybiera pierwszy plan sprzedaży skonfigurowany dla produktu w Shopify, a klienci mogą go zmienić na liście rozwijanej **Purchase options**, gdy do ich wariantu ma zastosowanie więcej niż jeden plan. Aby kontrolować, który plan widzą, ogranicz ofertę za pomocą listy wielokrotnego wyboru **Allowed subscription plans**, zmień kolejność planów sprzedaży w produkcie w Shopify tak, aby żądany był pierwszy, lub całkowicie usuń nieużywane plany sprzedaży z produktu. Zezwolenie na dokładnie jeden plan usuwa listę rozwijaną.
Tak, gdy do wybranego wariantu ma zastosowanie więcej niż jeden plan, oferta pokazuje listę rozwijaną **Purchase options**. Aby temu zapobiec, użyj **Allowed subscription plans**, aby zezwolić na jeden plan; częstotliwość jest wtedy wyświetlana jako tekst statyczny. Klienci nadal mogą później zmienić częstotliwość w portalu Twojego dostawcy subskrypcji.
Użyj trybu **One-time purchase only** w ustawieniu opcji zakupu oferty. Aftersell ma trzy tryby dla produktów z obsługą subskrypcji: **One-time purchase only**, **Subscription only** oraz **One-time purchase and subscription**. Wybranie **One-time purchase only** całkowicie ukrywa opcję subskrypcji, nawet jeśli produkt ma aktywne plany sprzedaży.
To jeden z najbardziej uciążliwych rodzajów awarii, ponieważ klient został obciążony, ale subskrypcja nigdy nie została utworzona u Twojego dostawcy. Zdecydowanie najczęstszą przyczyną źródłową jest **plan sprzedaży, który został dezaktywowany między wyrenderowaniem oferty a akceptacją przez klienta**. Shopify akceptuje zestaw zmian, ponieważ w momencie renderowania ma prawidłowe ID planu sprzedaży, ale jeśli plan zostanie dezaktywowany, zanim klient zaakceptuje, subskrypcja nie zostaje zarejestrowana w dalszych systemach i nie pojawia się żaden błąd.
Inne częste przyczyny:
* **Webhook aplikacji subskrypcyjnej nie działa.** Każda aplikacja subskrypcyjna, która przejmuje nowe subskrypcje z Shopify, opiera się na webhookach Shopify. Sprawdź stan dostarczania webhooków w logach swojej aplikacji subskrypcyjnej.
* **Plan sprzedaży został odłączony od produktu**, ale nadal ma aktywne ID. Shopify akceptuje zestaw zmian i pozycja trafia do zamówienia, ale dostawca subskrypcji nie ma rekordu, na którym mógłby działać.
**Ważne:** na natywnej ścieżce `add_subscription` nie ma automatycznego ponawiania; tam zapisem zarządza Shopify, więc Aftersell nie ma czego powtórzyć. (Osobna ścieżka dostawcy, używana, gdy zamówienie już zawiera subskrypcję, *jest* objęta [procesem ponawiania ulepszeń subskrypcji](/pl/aftersell/subscription-upgrades-troubleshooting).) Jeśli tak się stanie:
1. Upewnij się, że plan sprzedaży jest nadal aktywny w Shopify i przypisany do produktu.
2. Sprawdź logi importu zamówień / webhooków w swojej aplikacji subskrypcyjnej dla danego zamówienia.
3. Jeśli subskrypcji rzeczywiście brakuje, zespół wsparcia Twojej aplikacji subskrypcyjnej zwykle może ręcznie zapisać klienta na podstawie ID zamówienia.
Jeśli problem dotyczy wielu klientów, skontaktuj się z pomocą techniczną Aftersell, podając ID zamówień i swojego dostawcę subskrypcji, ale spodziewaj się, że rozwiązanie nastąpi po stronie dostawcy subskrypcji, a nie w Aftersell.
Zwykle zdarza się to, gdy rabat na pierwszy cykl jest skrajny (na przykład 100% zniżki na pierwszy cykl). Przycisk Accept odzwierciedla cenę pierwszego cyklu, ale jeśli ta cena wygląda tak samo jak cena cykliczna, może się wydawać, że rabat nie został zastosowany. Sprawdź w podglądzie oferty, czy rabat jest skonfigurowany poprawnie, i zadbaj o to, by treść oferty („Pierwsze pudełko gratis, potem \$X co Y dni”) jednoznacznie przedstawiała warunki.
Rabaty domyślnie dotyczą **wyłącznie pierwszego cyklu rozliczeniowego**. Jeśli klient pyta, dlaczego jego drugie lub trzecie zamówienie nie ma rabatu, jest to oczekiwane. Zamówienia cykliczne są obciążane standardową ceną subskrypcji, którą klient widział w ofercie jako **Recurring subtotal**.
Jeśli masz podłączony Recharge, Skio lub Loop, jest to oczekiwane i oferta działa: Aftersell tworzy nową subskrypcję u Twojego dostawcy. Zobacz [upselle dla obecnych subskrybentów](/pl/aftersell/subscription-upsell-existing-subscribers).
Jeśli żaden dostawca nie jest podłączony, Shopify blokuje dodanie drugiej subskrypcji, a oferta jest po cichu pomijana w czasie działania. Podłącz dostawcę albo zablokuj wyświetlanie oferty tym klientom, ustawiając **Subscription trigger** na **do not include a subscription**.
Shopify pozwala tylko na jedną subskrypcję na zamówienie. Jeśli masz wiele ofert subskrypcyjnych w tym samym lejku, wygrywa pierwsza zaakceptowana, a pozostałe są pomijane. Ogranicz lejek do jednej oferty subskrypcyjnej lub użyj Subscription trigger, aby wykluczyć zamówienia, które już mają subskrypcję.
Nowa subskrypcja jest zarządzana w portalu klienta Twojego dostawcy subskrypcji, a nie bezpośrednio w Shopify. Upewnij się, że portal jest podlinkowany w sekcji konta Twojego sklepu, i sprawdź, czy powitalny e-mail Twojego dostawcy jest skonfigurowany do wysyłki natychmiast po akceptacji.
Pierwszy cykl został opłacony w ramach zamówienia Shopify, więc zwroty działają tak samo jak w przypadku każdej innej pozycji. Anulowanie przyszłych cykli odbywa się u Twojego dostawcy subskrypcji, a nie w Aftersell. Zwrot pozycji w Shopify nie anuluje automatycznie subskrypcji; musisz ją również anulować w portalu dostawcy.