> ## 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.
# Dlaczego mój upsell w checkout się nie wyświetla?
> Pełne zestawienie wszystkich powodów, dla których Twój upsell w checkout może się nie wyświetlać, w tym problemy z konfiguracją, umiejscowieniem, wyzwalaczami oraz produktem/ofertą.
Upselle w checkout mogą nie wyświetlać się z kilku różnych powodów. Przejdź po kolei przez poniższe kroki, aby zidentyfikować przyczynę.
Upselle w checkout są dostępne wyłącznie dla sprzedawców Shopify Plus, ponieważ API Checkout Extensibility Shopify jest dostępne tylko dla planu Plus. Jeśli nie masz Shopify Plus, upselle w checkout nie pojawią się niezależnie od konfiguracji. Zobacz [Dlaczego nie widzę zakładki Checkout?](/pl/aftersell/why_cant_i_see_the_checkout_tab)
Jeśli upsell się nie wyświetli, doświadczenie klienta w checkout nie ulega zmianie — po stronie klienta nic się nie psuje.
***
## Od czego zacząć
Większość problemów z wyświetlaniem sprowadza się do jednej z czterech rzeczy: widżet nie jest włączony, blok aplikacji nie został dodany/zapisany w Shopify, umiejscowienie się nie zgadza lub warunki wyzwalaczy nie są spełnione. Najpierw potwierdź podstawy:
* Masz plan **Shopify Plus**
* Widżet jest **włączony** w edytorze Checkout Aftersell (przełącznik **Enable** w prawym górnym rogu ustawień widżetu jest aktywny)
* Blok aplikacji został **dodany i zapisany** w edytorze checkoutu Shopify
* Umiejscowienie wybrane w Shopify **zgadza się** z umiejscowieniem ustawionym w Aftersell
Jeśli wszystko powyższe się zgadza, a upsell nadal się nie wyświetla, przejdź przez szczegółowe przyczyny poniżej.
* [Widżet nie jest włączony lub nie został dodany do checkoutu](#widget-is-not-enabled-or-not-added-to-checkout)
* [Niezgodność umiejscowienia między Aftersell a Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [Warunki wyzwalaczy nie są spełnione](#trigger-conditions-are-not-being-met)
* [Występuje problem z produktem lub ofertą](#there-is-a-product-or-offer-issue)
* [Widżety Shop Pay się nie wyświetlają](#shop-pay-widgets-not-showing)
* [Testowanie w podglądzie Shopify](#testing-in-the-shopify-preview)
* [Żadne z powyższych nie ma zastosowania](#nothing-above-applies)
***
## Widżet nie jest włączony lub nie został dodany do checkoutu
Aby upsell w checkout się wyświetlał, dwie rzeczy muszą być spełnione jednocześnie:
1. Widżet musi być **włączony** w edytorze Checkout Aftersell
2. Blok aplikacji musi być **dodany i zapisany** w edytorze checkoutu Shopify
Jeśli brakuje któregokolwiek z nich, widżet się nie pojawi.
**Aby włączyć widżet w Aftersell:**
1. Przejdź do **Apps → Aftersell → Checkout**
2. Otwórz widżet upsellu, który chcesz wyświetlać
3. Potwierdź, że widżet jest włączony — nagłówek pokazuje przełącznik obok plakietki **Active** / **Inactive**. (We wcześniejszym edytorze Checkout jest to para przycisków **Enable** / **Disable** w nagłówku karty widżetu.)
**Aby dodać blok aplikacji w Shopify:**
1. Przejdź do **Settings → Checkout** w panelu Shopify
2. Kliknij **Customize** obok swojego profilu checkoutu
3. Kliknij **Add app block** i wybierz widżet upsellu Aftersell
4. Umieść go tam, gdzie ma się pojawiać
5. Kliknij **Save** — zmiany nie zostaną zastosowane, dopóki ich nie zapiszesz
***
## Niezgodność umiejscowienia między Aftersell a Shopify
Niezgodność umiejscowienia to jedna z najczęstszych przyczyn braku wyświetlania upsellu w checkout.
Aftersell obsługuje wiele umiejscowień, dzięki czemu możesz uruchomić więcej niż jeden widżet tego samego typu na tej samej stronie checkoutu. Każde umiejscowienie odpowiada **osobnemu blokowi aplikacji** w edytorze checkoutu Shopify, a umiejscowienie wybrane w Shopify musi zgadzać się z tym skonfigurowanym w Aftersell.
Lista rozwijana **Placement** bloku aplikacji Upsell Widget oferuje osiem wartości: **Default placement (Upsell Widget 1)**, **Additional placement 1 (Upsell Widget 2)**, **Additional placement 2 (Upsell Widget 3)** oraz pięć slotów widżetów stron: od **page-upsell-001** do **page-upsell-005**.
Jeśli umiejscowienia się nie zgadzają, widżet się nie pojawi lub może wyświetlić się w niewłaściwym miejscu.
**Aby naprawić niezgodność umiejscowienia:**
1. W edytorze Checkout Aftersell otwórz widżet upsellu i zanotuj, które umiejscowienie jest wybrane (na przykład **Additional placement 1**)
2. W edytorze checkoutu Shopify usuń istniejący blok aplikacji dla tego widżetu
3. Kliknij **Add app block**, wybierz widżet upsellu Aftersell i wybierz **to samo umiejscowienie**, które skonfigurowano w Aftersell
4. Zapisz zmiany
[Dowiedz się więcej o dopasowywaniu umiejscowień →](/pl/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)
***
## Warunki wyzwalaczy nie są spełnione
Jeśli Twój widżet upsellu ma skonfigurowane wyzwalacze, wyświetli się tylko wtedy, gdy koszyk spełnia te warunki. Jeśli koszyk nie spełnia warunków wyzwalaczy, widżet się nie pojawi — to oczekiwane zachowanie.
Dostępne typy wyzwalaczy obejmują:
* **Konkretne produkty / kolekcje:** wybrany produkt, wariant lub kolekcja jest (lub nie jest) w koszyku
* **Ilość konkretnego produktu:** np. 2 lub więcej sztuk produktu
* **Tag produktu / typ produktu / nazwa wariantu:** dowolna pozycja koszyka pasuje do tagu Shopify, typu produktu lub tytułu wariantu (bez rozróżniania wielkości liter)
* **Metafield produktu / metafield wariantu:** produkt lub wariant w koszyku ma pasującą wartość metafielda
* **Suma częściowa koszyka:** suma częściowa osiąga próg (zobacz uwagę poniżej o sposobie jej obliczania)
* **Liczba pozycji w koszyku:** łączna liczba produktów w koszyku
* **Subskrypcja w koszyku:** czy dowolna pozycja koszyka jest subskrypcją
* **Atrybut koszyka:** klucz/wartość atrybutu na poziomie koszyka pasuje (przydatne dla danych ustawianych przez inne aplikacje)
* **Zastosowany rabat / wartość rabatu:** zastosowano konkretny kod rabatowy lub łączny rabat osiąga próg
* **Kraj wysyłki:** kraj wysyłki klienta (i opcjonalnie prowincja) pasuje
* **Język klienta:** język checkoutu pasuje (na przykład pokazuj treści po francusku tylko we francuskich checkoutach)
* **Tagi klienta:** zalogowany klient ma wymagane tagi
* **Typ urządzenia:** klient korzysta ze skonfigurowanego urządzenia (komputer lub telefon)
**Suma częściowa koszyka** używana do oceny wyzwalaczy nie uwzględnia pozycji dodanych już przez zaakceptowane upselle (oznaczonych atrybutem koszyka `__as_offer_id`). Zaakceptowanie jednego upsellu nie spowoduje więc samo w sobie przekroczenia progu sumy częściowej, który warunkuje inny widżet.
**Łączenie warunków:** gdy widżet ma wiele warunków, są one łączone operatorem **AND** albo **OR** (do wyboru), a warunki można zagnieżdżać w grupy dla bardziej złożonej logiki. Przy łączeniu **AND** każdy warunek musi być spełniony — jeden niedopasowany warunek po cichu blokuje widżet. Przy łączeniu **OR** wystarczy jedno dopasowanie. Przejrzyj każdy warunek osobno względem swojego koszyka testowego.
**Aby rozwiązać problemy z wyzwalaczami:**
1. Otwórz widżet w edytorze Checkout Aftersell i przejrzyj jego warunki wyzwalaczy
2. Tymczasowo ustaw wyzwalacz na **Show for all customers**, aby potwierdzić, że sam widżet działa, a następnie ponownie włącz swoje konkretne wyzwalacze
3. Upewnij się, że co najmniej jeden widżet używa wyzwalacza **Show for all customers** z najniższym priorytetem jako catch-all, aby jakaś oferta zawsze się wyświetlała, nawet gdy żaden ukierunkowany widżet nie pasuje
[Dowiedz się więcej o wyzwalaczach checkout →](/pl/aftersell/checkout_triggers)
***
## Występuje problem z produktem lub ofertą
Nawet gdy widżet jest włączony, poprawnie umiejscowiony, a jego wyzwalacze pasują, sama oferta może zostać odfiltrowana przed wyświetleniem.
Jeśli stan magazynowy produktu jest śledzony i żaden wariant nie jest dostępny do sprzedaży, oferta się nie wyświetli. Upewnij się, że co najmniej jeden wariant produktu upsellowego ma dostępne zapasy, lub użyj produktu, który nie śledzi stanów magazynowych.
Produkt upsellowy musi być aktywnym produktem dostępnym do sprzedaży. Produkty ze statusem **Draft** lub **Archived** w Shopify są odfiltrowywane i nie pojawią się jako oferty. Otwórz produkt w panelu Shopify i potwierdź, że jego status to **Active**.
Ustawienie **Hide offer if product already in cart** ukrywa ofertę, gdy dany produkt jest już w koszyku klienta. Jest domyślnie włączone dla standardowych ofert produktowych. Jeśli chcesz, aby upsell wyświetlał się mimo to, wyłącz to ustawienie w konfiguracji oferty.
Jeśli **Subscription purchase option** jest ustawione na **Subscription**, a produkt nie ma skonfigurowanych planów sprzedaży w Shopify, oferta jest odfiltrowywana. Potwierdź, że produkt ma co najmniej jeden aktywny plan sprzedaży, lub zmień **Subscription purchase option** na **One-time product** (pozostałe opcje to **Subscription** oraz **Subscription and a one-time product**).
Jeśli oferta jest skonfigurowana jako upsell zastępujący, wyświetla się tylko wtedy, gdy produkt, który ma zastąpić, znajduje się w koszyku. Potwierdź, że w konfiguracji upsellu zastępującego wybrano właściwy produkt docelowy.
Oferta zastępująca jest również pomijana, gdy pozycja docelowa **ma już zastosowany rabat** — chyba że zaznaczysz **Allow replacement if product has discount applied** — lub gdy **ilość** pozycji docelowej **jest większa niż jeden**, chyba że zaznaczysz **Allow replacement if product quantity greater than 1**.
Jeśli w widżecie ustawiono **Max number of accepted offers**, upsell przestaje się wyświetlać, gdy klient zaakceptuje tyle ofert z tego widżetu w bieżącym checkout. Jest to zamierzone — po osiągnięciu limitu widżet się ukrywa. Pole dotyczy tylko upselli Single product i Multi product; upselle Checkmark nie mają takiego limitu.
W przypadku upselli **single** i **multi-product**, gdy klient doda produkt z oferty do koszyka, oferta zostaje ukryta (produkt jest już w koszyku). Upselle **Checkmark** zachowują się inaczej — pozostają widoczne z zaznaczonym polem wyboru po zaakceptowaniu.
***
## Widżety Shop Pay się nie wyświetlają
Widżety checkout domyślnie nie wyświetlają się w Shop Pay. Aby pokazać upsell w Shop Pay, musisz go jawnie włączyć:
1. Otwórz blok aplikacji upsellu Aftersell w edytorze checkoutu Shopify
2. W ustawieniach bloku znajdź sekcję **Checkout behaviour**
3. Zaznacz opcję **Include app block in Shop Pay**
4. Zapisz zmiany
[Dowiedz się więcej o widżetach Shop Pay →](/pl/aftersell/show_checkout_widgets_in_shop_pay)
***
## Testowanie w podglądzie Shopify
Podgląd edytora checkoutu Shopify nie renderuje widżetów w sposób niezawodny. Widżet może być skonfigurowany poprawnie, a mimo to nie pojawić się w podglądzie edytora, ponieważ podgląd nie potrafi symulować tagowania stron i warunków wyzwalaczy. Nie polegaj na podglądzie edytora, aby potwierdzić, czy widżet działa.
**Aby dokładnie przetestować upsell:**
1. Tymczasowo ustaw wyzwalacz widżetu na **Show for all customers**
2. Złóż prawdziwe zamówienie testowe, używając testowej bramki płatności Shopify (lub kodu rabatowego czyniącego zamówienie darmowym)
3. Potwierdź, że widżet pojawia się podczas rzeczywistego przepływu checkoutu
4. Po testach przywróć swoje wyzwalacze
***
## Żadne z powyższych nie ma zastosowania
Jeśli wszystko powyżej zostało sprawdzone, a upsell nadal się nie wyświetla, potwierdź następujące kwestie:
* Widżet jest **włączony** w Aftersell, a blok aplikacji jest **dodany i zapisany** w edytorze checkoutu Shopify
* **Umiejscowienie** w Aftersell zgadza się z umiejscowieniem wybranym w Shopify
* Warunki wyzwalaczy pasują do Twojego koszyka testowego — pamiętaj, że przy łączeniu **AND** każdy warunek musi być spełniony
* Istnieje co najmniej jeden widżet z wyzwalaczem **Show for all customers** z najniższym priorytetem jako catch-all
* Produkt upsellowy ma status **Active**, jest dostępny w magazynie i (dla ofert subskrypcyjnych) ma aktywne plany sprzedaży
* Testujesz w **prawdziwym przepływie checkoutu**, a nie w podglądzie edytora Shopify
* Spróbuj wyczyścić pamięć podręczną przeglądarki lub przetestować w oknie incognito — propagacja zmian może zająć kilka minut
Nadal nie rozwiązano problemu? Skontaktuj się przez czat lub napisz do nas na [support@aftersell.app](mailto:support@aftersell.app), dołączając opis konfiguracji widżetu i szczegóły zamówienia testowego.