Pomoc
Zaloguj

Rozwiązywanie problemów z treścią Checkout Blocks

Treść z Checkout Blocks może nie wyświetlać się zgodnie z oczekiwaniami z różnych powodów, co powoduje, że elementy znikają lub nie działają prawidłowo. Do częstych problemów należą: niespełnienie reguł wyświetlania, błędne konfiguracje uprawnień lub różnice między ustawieniami w samym bloku a sposobem jego dodania do edytora realizacji zakupu i kont.

Ten przewodnik pomoże Ci samodzielnie rozwiązać typowe problemy z aplikacją Checkout Blocks. Jeśli po zapoznaniu się z krokami opisanymi w tym przewodniku problemy nadal będą występować, skontaktuj się z Pomocą techniczną Shopify, aby uzyskać pomoc.

Na tej stronie

Rozwiązywanie problemów z blokami

Bloki to elementy dostosowywania, które wyświetlają treść w realizacji zakupu, takie jak pola niestandardowe, treść dynamiczna i banery. Jeśli blok nie działa zgodnie z oczekiwaniami, skorzystaj z poniższych sekcji, aby zidentyfikować i rozwiązać problem.

Blok nie wyświetla się w realizacji zakupu

Blok nie został dodany do edytora

Utworzenie bloku w aplikacji Checkout Blocks nie powoduje automatycznego dodania go do strony realizacji zakupu. Musisz dodać blok do konfiguracji realizacji zakupu, korzystając z edytora stron realizacji zakupu i kont.

Kroki:

  1. W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Realizacja zakupu.
  • W sekcji Konfiguracje kliknij opcję Dostosuj obok konfiguracji, którą chcesz zmodyfikować.
  • Przejdź do strony realizacji zakupu, na której ma być wyświetlany blok.
  • Kliknij ⊕ Dodaj blok i wybierz odpowiedni typ bloku.
  • Skonfiguruj ID bloku tak, aby pasowało do ID bloku utworzonego w aplikacji Checkout Blocks.
  • Kliknij przycisk Zapisz.
    • Blok nie jest ustawiony jako aktywny

    Blok musi być ustawiony jako Aktywny, aby był wyświetlany w realizacji zakupu. Bloki w wersji roboczej nie są wyświetlane klientom.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Bloki.
  • Kliknij blok, który chcesz aktywować.
  • W sekcji Status wybierz opcję Aktywny.
  • Kliknij przycisk Zapisz.
    • Blok nie został opublikowany na rynku lub stronie

    Jeśli blok ma skonfigurowane ustawienia publikowania dla określonego rynku, jest on wyświetlany tylko na wybranych rynkach. Jeśli blok jest opublikowany tylko na określonych stronach realizacji zakupu, nie będzie wyświetlany na innych stronach.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Bloki.
  • Kliknij blok, który chcesz sprawdzić.
  • W sekcji Publikowanie sprawdź, czy blok jest opublikowany na wszystkich odpowiednich rynkach.
  • W sekcji Strony realizacji zakupu sprawdź, czy blok jest ustawiony do wyświetlania na wszystkich odpowiednich stronach realizacji zakupu.
  • Kliknij przycisk Zapisz.
    • Niespełnione reguły wyświetlania

    Reguły wyświetlania określają warunki, które muszą być spełnione, aby blok był wyświetlany na stronie realizacji zakupu. Jeśli te warunki nie zostaną spełnione podczas sesji realizacji zakupu klienta, blok nie zostanie wyświetlony.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Bloki.
  • Kliknij blok, który się nie wyświetla.
  • Sprawdź reguły wyświetlania skonfigurowane dla bloku.
  • Sprawdź, czy testowa realizacja zakupu spełnia wszystkie wymagane warunki, takie jak progi łącznej wartości koszyka, typy produktów lub status logowania klienta.
  • Jeśli wybrano opcję Pokaż tylko, gdy: Wszystkie reguły są spełnione, upewnij się, że każda reguła jest spełniona. Jeśli wybrano opcję Pokaż tylko, gdy: Dowolna reguła jest spełniona, upewnij się, że co najmniej jedna reguła jest spełniona.
    • Niezgodność ID bloku

    Każdy typ bloku w edytorze realizacji zakupu i kont ma ustawienie ID bloku. ID bloku w edytorze musi być zgodne z ID bloku utworzonego w aplikacji Checkout Blocks. Jeśli ID nie są zgodne, blok nie jest wyświetlany.

    Na przykład, jeśli blok ma ID bloku równe 4 w aplikacji Checkout Blocks, wówczas ID bloku w edytorze realizacji zakupu i kont również musi być ustawione na 4.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Bloki.
  • Kliknij blok, który się nie wyświetla, i zanotuj jego ID bloku.
  • Przejdź do opcji: Ustawienia > Realizacja zakupu.
  • W sekcji Konfiguracje kliknij opcję Dostosuj obok konfiguracji, którą chcesz sprawdzić.
  • Kliknij blok w edytorze, który powinien wyświetlać treść.
  • W Ustawieniach bloku sprawdź, czy ID bloku jest zgodne z ID z kroku 3.
  • Jeśli ID nie są zgodne, uaktualnij ID bloku, aby je dopasować.
  • Kliknij przycisk Zapisz.
    • Pole ID bloku podglądu zawiera wartość

    Pole ID bloku podglądu (do celów testowych) w edytorze realizacji zakupu i kont jest przeznaczone wyłącznie do celów testowych. Jeśli to pole zawiera wartość po zapisaniu realizacji zakupu, może ono zastąpić reguły wyświetlania bloku i spowodować nieoczekiwane zachowanie.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Realizacja zakupu.
  • W sekcji Konfiguracje kliknij opcję Dostosuj obok konfiguracji, którą chcesz sprawdzić.
  • Kliknij blok, który nie wyświetla się prawidłowo.
  • W polu ID bloku podglądu (do celów testowych) usuń dowolną wartość, aby pole było puste.
  • Kliknij przycisk Zapisz.
    • Wyświetlanie bloku o wyższym priorytecie

    Jeśli masz wiele bloków tego samego typu z nakładającymi się regułami wyświetlania, wyświetlany jest tylko blok o najwyższym priorytecie. Dowiedz się więcej o priorytetach bloków.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Bloki.
  • Kliknij ⇅ Edytuj priorytet.
  • Wybierz typ bloku, który nie jest wyświetlany.
  • Sprawdź kolejność priorytetów. Bloki o niższym numerze mają wyższy priorytet.
  • Dostosuj numery priorytetów, aby zmienić, który blok ma być wyświetlany jako pierwszy.
  • Kliknij przycisk Zapisz.
    • Rozwiązywanie problemów związanych z limitem aktywnych bloków

    Aplikacja Checkout Blocks obsługuje do 30 aktywnych bloków na typ bloku. Jeśli masz ponad 30 aktywnych bloków jednego typu, np. 35 aktywnych bloków pól niestandardowych, to w kasie może być wyświetlanych tylko pierwszych 30 bloków.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Bloki.
  • Filtruj według typu bloku, którego dotyczy problem.
  • Policz liczbę aktywnych bloków.
  • Jeśli masz ponad 30 aktywnych bloków, dezaktywuj lub usuń bloki, których już nie potrzebujesz.

    • Blok jest wyświetlany wielokrotnie w kasie

    Rozwiązywanie problemów: blok dodany do sekcji współdzielonej

    W zależności od tego, gdzie dodasz blok w edytorze realizacji zakupu i kont, może on być wyświetlany na każdym etapie realizacji zakupu. Sekcja Podsumowanie zamówienia oraz obszar dołączony do przycisku Kontynuuj lub Wróć są spójne na wszystkich stronach realizacji zakupu.

    Aby wyświetlić blok tylko na określonym etapie, dodaj go do głównego obszaru zawartości tego etapu.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Realizacja zakupu.
  • W sekcji Konfiguracje kliknij opcję Dostosuj obok konfiguracji, którą chcesz zmodyfikować.
  • Kliknij blok, który jest wyświetlany wielokrotnie.
  • Sprawdź, w której sekcji znajduje się blok. Jeśli znajduje się w sekcji Podsumowanie zamówienia lub jest dołączony do przycisku Kontynuuj lub Wróć, będzie wyświetlany na każdej stronie realizacji zakupu.
  • Aby wyświetlić blok tylko na określonej stronie, usuń go z bieżącej sekcji i dodaj do głównego obszaru zawartości wybranej strony realizacji zakupu.
  • Kliknij przycisk Zapisz.
    • Rozwiązywanie problemów: dodano wiele wystąpień bloku

    Niektóre typy bloków, takie jak bloki Edycja pozycji pojedynczej, zazwyczaj trzeba dodać do strony realizacji zakupu tylko raz. Blok wykorzystuje reguły wyświetlania do pokazywania różnych treści w różnych scenariuszach. Jeśli treść bloku jest zduplikowana, oznacza to, że blok mógł zostać przypadkowo dodany więcej razy, niż było to konieczne.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Realizacja zakupu.
  • W sekcji Konfiguracje kliknij opcję Dostosuj obok konfiguracji, którą chcesz sprawdzić.
  • Przejdź przez każdą stronę realizacji zakupu i sprawdź dodane bloki.
  • Jeśli znajdziesz zduplikowane bloki tego samego typu i o tym samym ID bloku, usuń nadmiarowe, klikając blok i wybierając opcję Usuń blok.
  • Kliknij przycisk Zapisz.

    • Rozwiązywanie problemów z błędami podczas tworzenia lub zapisywania bloków

    Jeśli podczas próby utworzenia lub zapisania bloku wystąpi błąd, zapoznaj się z poniższymi sekcjami.

    Rozwiązywanie problemów z błędem „Wystąpiły problemy z przesłaniem formularza”

    Ten błąd zazwyczaj wskazuje, że konto pracownika nie ma wymaganych uprawnień do tworzenia bloków w aplikacji Checkout Blocks.

    Wymagane uprawnienia:

    • Uprawnienia sklepu > Treść: Pracownicy muszą mieć uprawnienia do wyświetlania oraz tworzenia i edycji definicji metaobiektów, a także do wyświetlania oraz tworzenia i edycji wpisów.
    • Uprawnienia sklepu > Ustawienia sklepu: Pracownicy muszą mieć uprawnienie Zarządzaj ustawieniami.
    • Uprawnienia aplikacji: Pracownicy muszą mieć co najmniej uprawnienia do aplikacji Checkout Blocks.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Użytkownicy i uprawnienia.
    2. Kliknij konto pracownika, w przypadku którego występuje błąd.
    3. W sekcji Uprawnienia sklepu rozwiń sekcję Treść.
    4. Upewnij się, że w sekcji Definicje metaobiektów zaznaczone są uprawnienia Wyświetlanie oraz Tworzenie i edycja.
    5. Upewnij się, że w sekcji Wpisy zaznaczone są uprawnienia Wyświetlanie oraz Tworzenie i edycja.
    6. W sekcji Ustawienia sklepu upewnij się, że zaznaczona jest opcja Zarządzaj ustawieniami.
    7. W sekcji Uprawnienia aplikacji upewnij się, że zaznaczona jest aplikacja Checkout Blocks.
    8. Kliknij przycisk Zapisz.

    Jeśli nie masz uprawnień do modyfikowania uprawnień pracowników, skontaktuj się z właścicielem sklepu lub pracownikiem z uprawnieniami do zarządzania użytkownikami.

    Rozwiązywanie problemów z rabatami niestandardowymi

    Rabaty niestandardowe utworzone w aplikacji Checkout Blocks mogą nie być stosowane zgodnie z oczekiwaniami z kilku powodów.

    Rozwiązywanie problemów: Osiągnięto limit aktywnych rabatów automatycznych

    Platforma Shopify pozwala na maksymalnie 25 aktywnych rabatów automatycznych jednocześnie, wliczając w to rabaty ze wszystkich zainstalowanych aplikacji. Ten limit dotyczy całego sklepu, a nie tylko aplikacji Checkout Blocks.

    Jeśli spróbujesz aktywować 26. rabat automatyczny, nie zostanie on zastosowany w kasie.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji Rabaty.
    2. Filtruj, aby wyświetlić tylko rabaty automatyczne.
    3. Policz, ile rabatów automatycznych jest obecnie aktywnych.
    4. Jeśli masz 25 lub więcej aktywnych rabatów automatycznych, dezaktywuj lub usuń rabaty, których już nie potrzebujesz, przed aktywacją nowych.

    Dowiedz się więcej o ograniczeniach dotyczących łączenia rabatów.

    Rozwiązywanie problemów: rabat nie jest aktywny

    Aby rabat niestandardowy został zastosowany w kasie, musi mieć status Aktywny. Ponadto jego okres ważności, określony przez daty rozpoczęcia i zakończenia, nie może upłynąć.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Rabaty.
  • Kliknij rabat, który nie jest stosowany.
  • W sekcji Status upewnij się, że rabat ma status Aktywny.
  • W sekcji Aktywne daty upewnij się, że bieżąca data mieści się w skonfigurowanych datach rozpoczęcia i zakończenia.
  • Kliknij przycisk Zapisz.
    • Rozwiązywanie problemów: niespełnione reguły rabatu

    Rabaty niestandardowe w aplikacji Checkout Blocks mogą mieć szczegółowe reguły warunkowe, które określają, kiedy rabat jest stosowany. Jeśli te warunki nie zostaną spełnione podczas sesji realizacji zakupu klienta, rabat nie zostanie zastosowany.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Rabaty.
  • Kliknij rabat, który nie jest stosowany.
  • Sprawdź reguły i warunki skonfigurowane dla rabatu.
  • Sprawdź, czy Twoja testowa realizacja zakupu spełnia wszystkie wymagane warunki, takie jak minimalna wartość zamówienia, określone produkty lub kolekcje albo wymagania dotyczące uprawnień klienta.
  • W razie potrzeby dostosuj reguły rabatowe.
  • Kliknij przycisk Zapisz.

    • Rozwiązywanie problemów z dostosowaniami metod dostawy i płatności

    Jeśli ukrywanie, zmiana nazwy lub kolejności metod dostawy lub płatności nie działa zgodnie z oczekiwaniami, zapoznaj się z poniższymi sekcjami.

    Rozwiązywanie problemów z nieaktywnym dostosowaniem

    Dostosowanie metody dostawy lub płatności musi mieć status Aktywne, aby było stosowane podczas realizacji zakupu.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Functions.
  • Kliknij dostosowanie, które nie działa.
  • W sekcji Status upewnij się, że dostosowanie ma status Aktywne.
  • Kliknij przycisk Zapisz.
    • Rozwiązywanie problemów z osiągnięciem limitu aktywnych funkcji

    Platforma Shopify Functions ma limity liczby aktywnych funkcji danego typu. W każdym sklepie możesz aktywować maksymalnie 25 funkcji dostosowywania płatności. Jeśli przekroczysz ten limit, możesz otrzymać błąd: Nie udało się włączyć dostosowania. Spróbuj ponownie lub skontaktuj się z pomocą techniczną.

    Te limity pomagają zapewnić wysoką wydajność realizacji zakupu. Musisz scalić lub usunąć dostosowania, aby nie przekroczyć limitu.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Functions.
  • Policz, ile masz aktywnych dostosowań metod dostawy (jeśli rozwiązujesz problemy z dostawą) lub ile masz aktywnych dostosowań metod płatności (jeśli rozwiązujesz problemy z płatnością).
  • Jeśli osiągnięto limit dla danego typu, dezaktywuj lub usuń dostosowania, których już nie potrzebujesz.
  • Spróbuj ponownie aktywować nowe dostosowanie.
    • Rozwiązywanie problemów z niespełnianiem reguł dostosowania

    Dostosowania metod dostawy i płatności opierają się na regułach, które określają, kiedy dostosowanie ma być zastosowane. Jeśli te warunki nie zostaną spełnione podczas sesji realizacji zakupu klienta, dostosowanie nie zostanie zastosowane.

    Kroki:

    1. W panelu administracyjnym Shopify przejdź do opcji: Aplikacje > Checkout Blocks.
  • Kliknij opcję Functions.
  • Kliknij dostosowanie, które nie działa.
  • Przejrzyj reguły skonfigurowane dla dostosowania.
  • Sprawdź, czy Twoja testowa realizacja zakupu spełnia wszystkie wymagane warunki.
  • W razie potrzeby dostosuj reguły.
  • Kliknij przycisk Zapisz.

    • Sprawdzanie poprawności zmian za pomocą testowej realizacji zakupu

    Zanim zaczniesz polegać na dostosowaniach Checkout Blocks w środowisku produkcyjnym, sprawdź, czy działają zgodnie z oczekiwaniami, za pomocą testowej realizacji zakupu.

    Kroki:

    1. W swoim sklepie online dodaj do koszyka produkty, które spełniają warunki dla bloków, rabatów lub dostosowań, które chcesz przetestować.
    2. Przejdź do realizacji zakupu, ale nie sfinalizuj zakupu.
    3. Przejrzyj każdy krok realizacji zakupu i zweryfikuj następujące elementy:
      • Bloki wyświetlają się w prawidłowych lokalizacjach z prawidłową treścią.
      • Rabaty niestandardowe są stosowane po spełnieniu wymagań uprawniających.
      • Dostosowania metod dostawy i płatności działają zgodnie z oczekiwaniami.
    4. Jeśli testujesz reguły wyświetlania oparte na łącznej wartości koszyka, wypróbuj różne wartości koszyka, aby potwierdzić, że bloki pojawiają się i znikają przy prawidłowych progach.
    5. Jeśli testujesz reguły wyświetlania oparte na danych klienta, przetestuj scenariusze realizacji zakupu zarówno przez zalogowanego klienta, jak i gościa.

    Często zadawane pytania

    Ile bloków mogę mieć aktywnych jednocześnie?

    Możesz mieć do 30 aktywnych bloków na każdy typ bloku. Na przykład, możesz mieć jednocześnie 30 aktywnych pól niestandardowych, 30 aktywnych bloków treści dynamicznej i 30 aktywnych bloków edycji pozycji pojedynczych. Możesz utworzyć więcej niż 30 bloków danego typu, ale tylko pierwsze 30 aktywnych bloków może być wyświetlanych podczas realizacji zakupu.

    Dlaczego do korzystania z aplikacji Checkout Blocks potrzebne są specjalne uprawnienia dla pracowników?

    Aplikacja Checkout Blocks tworzy definicje metaobiektów w celu przechowywania konfiguracji bloków. Pracownicy potrzebują uprawnień do tworzenia i edytowania definicji metaobiektów i wpisów, aby móc zapisywać bloki w aplikacji. Ponadto pracownicy potrzebują uprawnienia Zarządzaj ustawieniami w sekcji Ustawienia sklepu i jawnych uprawnień do aplikacji dla aplikacji Checkout Blocks.

    Czy mogę korzystać z aplikacji Checkout Blocks, jeśli nie mam planu Shopify Plus?

    Sprzedawcy korzystający z planu Basic Shopify lub wyższego mogą używać bloków treści dynamicznej i treści statycznej tylko na stronie z podziękowaniem i na stronie statusu zamówienia. Wszystkie inne funkcje aplikacji Checkout Blocks, w tym pola niestandardowe, rabaty niestandardowe oraz dostosowania metod dostawy/płatności, wymagają planu Shopify Plus.

    Skąd mam wiedzieć, którego identyfikatora Block ID użyć?

    Gdy tworzysz blok w aplikacji Checkout Blocks, jest mu przypisywane ID bloku (domyślnie jest to 0). Gdy dodajesz ten typ bloku do strony realizacji zakupu w edytorze, musisz ustawić to samo ID bloku, aby edytor wiedział, który konkretny blok ma wyświetlić. Jeśli chcesz wyświetlać różne bloki tego samego typu w różnych lokalizacjach, przypisz każdemu blokowi unikalne ID bloku i dopasuj te ID w edytorze. Dowiedz się więcej na temat ID bloków.

    Czy mogę łączyć rabaty Checkout Blocks z innymi rabatami?

    Rabaty niestandardowe tworzone w aplikacji Checkout Blocks to rabaty automatyczne obsługiwane przez platformę Shopify Functions. Obowiązują je te same zasady łączenia rabatów, co inne rabaty automatyczne. W całym sklepie możesz mieć maksymalnie 25 aktywnych rabatów automatycznych, w tym rabaty utworzone w aplikacji Checkout Blocks i innych aplikacjach.

    Zanim skontaktujesz się z Pomocą techniczną Shopify w sprawie aplikacji Checkout Blocks

    Jeśli powyższe kroki rozwiązywania problemów nie przyniosły rezultatu i problem z aplikacją Checkout Blocks nadal występuje, możesz skontaktować się z Pomocą techniczną Shopify, aby uzyskać pomoc. Zanim skontaktujesz się z Pomocą techniczną Shopify, zbierz następujące informacje dotyczące aplikacji Checkout Blocks, aby przyspieszyć rozwiązanie problemu:

    • Szczegóły bloku: Nazwa, typ (np. pole niestandardowe, treść dynamiczna lub edycja pozycji pojedynczej) oraz identyfikator Block ID bloku, który nie działa
    • Zrzuty ekranu konfiguracji: Zrzuty ekranu ustawień bloku w aplikacji Checkout Blocks, w tym wszelkich reguł wyświetlania, ustawień publikowania i statusu
    • Zrzuty ekranu z edytora: zrzuty ekranu przedstawiające konfigurację bloku w edytorze realizacji zakupu i kont, w tym pola Block ID i Preview block ID
    • Komunikaty o błędach: Zrzuty ekranu lub dokładny tekst wszelkich komunikatów o błędach, które się pojawiają podczas tworzenia, zapisywania lub wyświetlania podglądu bloków
    • Adres URL testowej realizacji zakupu: Link do testowej lub przerwanej realizacji zakupu, w której można odtworzyć problem, wraz z zawartością koszyka użytą do uruchomienia reguł wyświetlania
    • Oczekiwane a rzeczywiste zachowanie: Jasny opis tego, co miało się wydarzyć, w porównaniu z tym, co faktycznie dzieje się podczas realizacji zakupu
    • Wykonane kroki rozwiązywania problemów: Informacje o tym, które sekcje tego przewodnika zostały już przejrzane i jakie kroki podjęto.
    • Uprawnienia pracownika: Potwierdzenie, że konto ma wymagane uprawnienia w zakresie Treści (definicje metaobiektów i wpisy), ustawień sklepu (zarządzanie ustawieniami) i uprawnień do aplikacji (Checkout Blocks)

    Przygotowanie tych informacji specyficznych dla aplikacji Checkout Blocks pomoże Pomocy technicznej Shopify sprawniej zdiagnozować i rozwiązać problem.