Monitorowanie nieudanych ulepszeń
Nie mogę przejść dalej niż Krok 1: Połącz dostawcę
Nie mogę przejść dalej niż Krok 1: Połącz dostawcę
Szablon Subscription Upgrade nigdy nie jest ukryty — jest zawsze widoczny w sekcji Add Funnel, niezależnie od konfiguracji dostawcy. Blokuje Cię weryfikacja połączenia w Kroku 1: przycisk Continue pozostaje nieaktywny, dopóki Test API key nie zwróci API key verified z zielonym znacznikiem.Dwa różne wyniki wyświetlają tę samą czerwoną ikonę anulowania, więc przeczytaj komunikat obok niej:
- Twój dostawca odrzucił klucz. Tokenowi brakuje wymaganych zakresów uprawnień lub został unieważniony, a komunikat wskazuje konkretny problem. Wydaj nowy token w panelu dostawcy z zakresami wymienionymi w artykule Konfiguracja, wklej go i przetestuj ponownie.
- Aftersell nie mógł połączyć się z dostawcą — „Could not verify the API key. Please try again.” Z tokenem niekoniecznie jest coś nie tak; samo wywołanie się nie powiodło. Kliknij ponownie Test API key.
Mój klient widzi nieoczekiwany produkt w swoim zamówieniu
Mój klient widzi nieoczekiwany produkt w swoim zamówieniu
To oczekiwane zachowanie. Ten produkt to produkt oferty — pozycja zastępcza dodana do zamówienia Shopify jako zapis zaakceptowanego ulepszenia. Aby ograniczyć nieporozumienia, zmień nazwę produktu oferty na coś jasnego i dodaj w Shopify Admin opis wyjaśniający, co on reprezentuje. Zobacz Co widzi klient.
Ulepszenie zostało zaakceptowane, ale subskrypcja nie została zmodyfikowana
Ulepszenie zostało zaakceptowane, ale subskrypcja nie została zmodyfikowana
Zestaw zmian w Shopify i wywołanie API dostawcy są od siebie niezależne. Jeśli produkt oferty został dodany do zamówienia, ale subskrypcja nie została zmieniona, najczęstsze przyczyny to:
- Twój token API dostawcy wygasł lub brakuje mu wymaganych uprawnień. W przypadku Recharge token musi mieć zakresy
read_orders,read_subscriptions,write_subscriptionsiread_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ł.
- W przypadku Loop docelowy plan sprzedaży nie istnieje w Twoim panelu Loop dla skonfigurowanej częstotliwości.
- Proces ponawiania może wciąż realizować swój harmonogram: po nieudanym wywołaniu próbuje ponownie po +1 godzinie, a następnie po +24 godzinach. Dotyczy to każdego dostawcy — również Loop, którego wywołania ulepszeń są synchroniczne i po powodzeniu od razu widoczne w panelu.
Lista rozwijana planów sprzedaży jest pusta
Lista rozwijana planów sprzedaży jest pusta
Opcja „Use an existing selling plan” pobiera plany bezpośrednio z Recharge, Skio lub Loop. Jeśli lista jest pusta:
- Potwierdź, że plany sprzedaży są skonfigurowane w panelu dostawcy.
- Upewnij się, że Twój token API ma dostęp do odczytu Plans (Recharge: zakres
read_plans) lub odpowiednie zakresy (Skio, Loop). - Wróć do Kroku 1: Połącz dostawcę, ponownie przetestuj klucz API i kontynuuj.
Używam Loop i nie ma pola częstotliwości rozliczeń
Używam Loop i nie ma pola częstotliwości rozliczeń
To oczekiwane zachowanie. W Loop pole Billing frequency w ogóle nie jest wyświetlane — tylko Delivery frequency, z adnotacją „Loop syncs billing to delivery — customers are charged on each renewal”. Cokolwiek ustawisz jako częstotliwość dostaw, jest też częstotliwością rozliczeń.Właśnie dlatego subskrypcje prepaid — z częstotliwością rozliczeń dłuższą niż częstotliwość dostaw — nie są obsługiwane w Loop: integracja odrzuca je wprost, zamiast oferować pole, którego nie możesz użyć. Pozostali dostawcy pokazują oba pola.
Przeglądarka zamówień pokazuje oznaczenie Subscription conflict
Przeglądarka zamówień pokazuje oznaczenie Subscription conflict
Produkt oferty jest dostępny wyłącznie w subskrypcji — sam produkt lub wszystkie jego warianty — a checkout klienta zawierał już subskrypcję. Shopify nie pozwala na drugą subskrypcję w tym samym zamówieniu, więc oferta została pominięta.Panel szczegółów zamówienia precyzuje, który to był przypadek: „The customer’s checkout already has a subscription, and the offer product is subscription-only” albo „All variants of the offer product are subscriptions, and the customer’s checkout already has one.” Oba naprawia się tak samo — edytuj wybór produktu w ofercie i podmień na produkt do zakupu jednorazowego, albo użyj opcji Create new w Kroku 4: Produkt oferty, aby wygenerować produkt zastępczy.
Moja oferta ulepszenia wyświetla się klientom, którzy nie są subskrybentami
Moja oferta ulepszenia wyświetla się klientom, którzy nie są subskrybentami
- Sprawdź, czy opcja Show this funnel for all customers nie jest włączona. Nadpisuje ona wszystkie inne wyzwalacze.
- Sprawdź wyzwalacz Variant on subscription. Wyświetla on lejek tylko wtedy, gdy zamówienie zawiera jeden z wybranych produktów kupionych w subskrypcji. W lejku z ofertą ulepszenia subskrypcji kreator zarządza tym wyzwalaczem i utrzymuje go w synchronizacji z ulepszanym produktem, więc jest on tylko do odczytu — panel wyświetla „Managed by this funnel’s subscription upgrade offer.” Jeśli celuje w niewłaściwe produkty, popraw produkt wyzwalający oferty ulepszenia, a nie sam wyzwalacz.
- Sprawdź priorytet lejków. Lejek o wyższym priorytecie z szerszymi wyzwalaczami może uruchamiać się jako pierwszy.