Skip to main content

Omówienie

Domyślnie Upcart przejmuje funkcjonalność koszyka Shopify, co może uniemożliwiać aplikacjom zewnętrznym, takim jak Klaviyo, wykrywanie aktualizacji koszyka. Na szczęście istnieją dwa niezawodne sposoby przywrócenia śledzenia Add to Cart (ATC) w Klaviyo przy zachowaniu aktywnego Upcart. Zanim zaczniesz, upewnij się, że Klaviyo Onsite Tracking jest poprawnie skonfigurowane. Możesz skorzystać z ich przewodnika konfiguracji tutaj:
👉 Przewodnik konfiguracji Klaviyo Onsite Tracking

Opcja 1: użyj zgodności AJAX (najszybsza konfiguracja)

Upcart zawiera ustawienie, które przywraca zgodność z innymi aplikacjami, udostępniając natywne zachowanie aktualizacji koszyka Shopify. Gdy jest włączone, Klaviyo może ponownie nasłuchiwać zdarzeń Add to Cart.

Jak włączyć:

  1. Przejdź do Upcart > Cart Editor > Settings > Cart settings
  2. Przewiń do Advanced Settings i rozwiń tę sekcję
  3. Zaznacz Enhanced Ajax API compatibility
  4. Kliknij Save i przetestuj rezultat
⚠️ Ważne: kompromisy związane z Enhanced AJAX API Compatibility
To ustawienie jest domyślnie wyłączone dla większości sklepów. Włącz je TYLKO wtedy, gdy Twój sklep używa niestandardowego API koszyka AJAX i Upcart nie przechwytuje zdarzeń dodania do koszyka. Gdy jest włączone, inne aplikacje zyskują większą kontrolę nad zachowaniem koszyka, co może powodować pętle przekierowań lub kierować klientów na stronę koszyka Shopify zamiast otwierać drawer Upcart. Jeśli włączenie tego ustawienia powoduje przekierowania, wyłącz je i przejdź do opcji 2, używając ręcznego API Upcart (upcartRegisterAddToCart).
Pełne wskazówki dotyczące tego ustawienia znajdziesz w artykule Enhanced AJAX API Compatibility.
Ta metoda daje Ci to, co najlepsze z obu światów: Upcart zachowuje pełną kontrolę, a śledzenie Klaviyo nadal działa.

Kroki:

  1. Otwórz Upcart > Cart Editor > Settings
  2. Przewiń w dół do sekcji Custom HTML
  3. Z listy rozwijanej wybierz Scripts (Before Load)
  4. Wklej poniższy skrypt:
Nowoczesne API (zalecane):
Wklej cały blok, łącznie z funkcją TrackATC. Subskrybent ją wywołuje, więc fragment zawierający tylko dwie linie upcartSubscribe… rzuca Uncaught ReferenceError: TrackATC is not defined przy każdym dodaniu do koszyka i nie wysyła niczego do Klaviyo.
Starsze API (nadal działa, ale jest przestarzałe):

Co to robi:

  • Wysyła zdarzenie „Added to Cart” do Klaviyo za każdym razem, gdy produkt lub upsell zostaje dodany za pomocą Upcart
  • Dodaje komunikat potwierdzający (Klaviyo ATC) do konsoli przeglądarki, dzięki czemu wiesz, że wszystko działa

Jak przetestować konfigurację

Aby potwierdzić, że Twoja integracja z Klaviyo działa poprawnie: Jeśli nadal nie widzisz danych śledzenia, potwierdź, że skrypty onsite Klaviyo są zainstalowane i włączone. W razie potrzeby skontaktuj się z centrum pomocy Klaviyo.

Podsumowanie

Jeśli używasz Klaviyo razem z Upcart, ten przewodnik pomoże Ci płynnie śledzić zdarzenia, zachowując nienaruszone doświadczenie cart drawer.
Potrzebujesz dodatkowej pomocy? Skontaktuj się z nami za pośrednictwem wsparcia w aplikacji.