Skip to main content

Przegląd

Oto odpowiedzi na najczęstsze pytania dotyczące korzystania z API Upcart.

Gdzie dodawać skrypty API Upcart?

Skrypty możesz dodawać w ustawieniach Custom HTML w Upcart lub bezpośrednio w kodzie motywu Shopify. Najlepsza opcja zależy od Twoich potrzeb personalizacji.

Jak korzystać z Custom HTML w Upcart?

  1. Przejdź do Upcart → Settings → Custom HTML
  2. Używaj skryptów API, aby modyfikować zachowanie koszyka, np. moment otwarcia czy wyświetlanie upselli
  3. Dostosowuj elementy poza Upcart, np. ukrywanie przycisków na stronie produktu

💡 Przykład: Ukryj przyklejony przycisk koszyka, gdy koszyk jest pusty

Uwaga dotycząca starszych wersji: wywołania zwrotne window.upcartOnCartLoaded nadal działają, ale są przestarzałe i wyświetlają ostrzeżenia w konsoli. We wszystkich nowych skryptach używaj upcartSubscribeCartLoaded. Pamiętaj, że event.cart nie ma właściwości item_count — użyj event.cart.items.reduce((total, item) => total + item.quantity, 0), aby obliczyć łączną liczbę produktów.

Czy muszę być programistą, aby korzystać z API Upcart?

Nie! API Upcart jest łatwe w użyciu, nawet bez umiejętności programowania. Wiele funkcji jest wbudowanych, a nasza dokumentacja personalizacji zawiera gotowe skrypty, które możesz skopiować do ustawień Custom HTML w Upcart — bez kodowania! Jeśli chcesz pisać własne skrypty, przyda się podstawowa znajomość JavaScript. Jeśli dopiero zaczynasz z JavaScript, nie martw się! Te przyjazne dla początkujących zasoby — W3Schools i MDN Web Docs — pomogą Ci wystartować.

Czy API Upcart może integrować się z innymi aplikacjami firm trzecich?

Tak! API Upcart współpracuje z aplikacjami do tłumaczeń, analityki, upselli i nie tylko. Niektóre integrują się automatycznie, inne mogą wymagać krótkiego skryptu. Na przykład, jeśli używasz TripleWhale do śledzenia, musisz dodać poniższy skrypt, aby aktywność koszyka była rejestrowana poprawnie:
Uwaga dotycząca starszych wersji: wywołania zwrotne window.upcartOnAddToCart nadal działają, ale są przestarzałe i wyświetlają ostrzeżenia w konsoli. We wszystkich nowych skryptach używaj upcartSubscribeAddedToCart. Pamiętaj, że właściwości zdarzenia znajdują się w event.item (z variantId i quantityAdded), a nie są przekazywane jako osobne parametry.
Ponieważ każda aplikacja jest inna, skonsultuj się z zespołem wsparcia swojej aplikacji, aby sprawdzić, czy potrzebny jest dodatkowy kod. Upcart nie oferuje wsparcia dla skryptów aplikacji firm trzecich, ale dostawca Twojej aplikacji może mieć przewodnik integracji.

Jak sprawdzić, czy moje zmiany w API działają?

Po dodaniu skryptu w ustawieniach Custom HTML w Upcart wykonaj poniższe kroki, aby upewnić się, że działa:
  1. Odśwież swój sklep i dodaj produkt do koszyka.
  2. Wyczyść pamięć podręczną i spróbuj ponownie, aby zobaczyć najnowsze zmiany.
  3. Dodaj komunikat testowy: Wstaw console.log("The script works!"); przed </script>, aby sprawdzić, czy skrypt się uruchamia.
  4. Sprawdź konsolę przeglądarki:
    • Otwórz Dev Tools (F12 lub Ctrl + Shift + J w Windows, Cmd + Option + J na Macu).
    • Przejdź do karty Console i poszukaj komunikatu „The script works!”
    • Jeśli widzisz komunikat, Twój skrypt działa! Jeśli nie, skrypt może nie wykonywać się poprawnie.
  5. Przetestuj różne działania (np. usunięcie produktu), aby upewnić się, że zachowanie jest zgodne z oczekiwaniami.
Rozwiązuj problemy, sprawdzając literówki lub błędy w konsoli i w razie potrzeby poprawiając kod.

Co zrobić, jeśli skrypt API nie działa?

Jeśli Twój skrypt API nie działa, wypróbuj te kroki rozwiązywania problemów:
  • Sprawdź literówki – Nawet drobne błędy mogą zepsuć skrypt. Poszukaj brakujących znaków lub nieprawidłowej składni.
  • Zweryfikuj umiejscowienie skryptu – Upewnij się, że skrypt znajduje się we właściwej sekcji w Upcart → Settings → Custom HTML. Upcart ma dziesięć sekcji skryptów (dziewięć punktów wstrzykiwania HTML plus jedną sekcję Scripts-before-load) — Przejrzyj te sekcje tutaj.
  • Sprawdź konsolę przeglądarki – Wykonaj powyższe kroki, aby poszukać błędów.
  • Przetestuj inny skrypt – Wypróbuj inny gotowy skrypt API Upcart, aby sprawdzić, czy problem leży w Twoim kodzie.
  • Nadal utknęło? – Jeśli modyfikujesz motyw Shopify lub integrujesz aplikacje firm trzecich, pomóc może ekspert Shopify z katalogu partnerów Shopify.
Te kroki powinny pomóc Ci zidentyfikować i rozwiązać większość problemów ze skryptami!

Jak cofnąć zmiany, jeśli dodam skrypt, który coś psuje?

Jeśli dodasz skrypt, który nie działa zgodnie z oczekiwaniami, możesz go łatwo usunąć lub wyłączyć:
  • Przejdź do ustawień Custom HTML w Upcart, gdzie skrypt został dodany.
  • Usuń skrypt lub tymczasowo go wyłącz, dodając // na początku każdej linii (zamienia to linię w komentarz, co zapobiega jej wykonaniu).
  • Zapisz zmiany i odśwież sklep, aby sprawdzić, czy problem został rozwiązany.
Jeśli problem się utrzymuje, spróbuj wyczyścić pamięć podręczną lub cofnąć ostatnie zmiany w motywie — to często rozwiązuje ukryte konflikty.
🚧 Szukasz zaawansowanych personalizacji? Potrzebujesz personalizacji obejmującej cały sklep lub integracji z aplikacjami firm trzecich? Możesz potrzebować programisty, który doda API Upcart do Twojego motywu Shopify. Rozważ zatrudnienie eksperta Shopify przez katalog partnerów Shopify i udostępnij mu naszą dokumentację API, aby uzyskać pomoc