Skip to main content

Przegląd

Upcart to osobna aplikacja od Aftersell, więc Strategie nie są wbudowane w moduł Upsells w taki sposób, jak w przepływach post-purchase i checkoutu Aftersell. Zamiast tego łączysz obie aplikacje niewielkim skryptem, który wywołuje bezpośrednio Strategies API i przekazuje wynik do istniejącego modułu Upsells Upcart za pośrednictwem publicznego API Upcart. Skrypt jest gotowy do wklejenia — wklej go raz do niestandardowego HTML Upcart, zastąp dwie wartości (swój klucz API Strategii i ID Strategii), a moduł Upsells zacznie pokazywać produkty zwracane przez Strategię.

Czego potrzebujesz

  1. Twój klucz API Strategii. W Aftersell przejdź do Settings → Product Strategy i na karcie Security Token skopiuj swój token (to jest Twój klucz API Strategii).
  2. ID Strategii. Otwórz Strategię, którą chcesz uruchomić, w edytorze Strategii Aftersell i skopiuj jej ID.
  3. Włączony moduł Upsells w Upcart. Skrypt nadpisuje listę produktów pokazywanych w istniejącym bloku upsell, więc moduł musi być włączony, aby cokolwiek się wyrenderowało.

Dodawanie skryptu

W Upcart przejdź do Settings → Custom HTML → Scripts (before load) i wklej poniższy skrypt. Zastąp STRATEGY_ID i STRATEGY_API_KEY wartościami z Aftersell, a następnie zapisz.
Twój klucz API Strategii autoryzuje wywołania Strategii Twojego sklepu. Powyższy skrypt umieszcza go w kodzie po stronie klienta, co jest jedynym praktycznym sposobem wywołania API z poziomu cart drawer. Traktuj klucz tak, jak każde inne publiczne dane uwierzytelniające witryny sklepu, i zrotuj go w Aftersell w Settings → Product Strategy, jeśli kiedykolwiek zostanie ujawniony w sposób, którego nie planowałeś.

Co widzi Strategia

Ponieważ działa to z poziomu koszyka w witrynie sklepu, kontekst jest okrojonym podzbiorem tego, co jest dostępne na natywnych powierzchniach Aftersell:

Kontekst produktu

Pozycje znajdujące się aktualnie w koszyku Upcart są wysyłane jako produkty wejściowe. Wyzwalacze takie jak typ produktu, dostawca, handle produktu, tytuł produktu oraz wszelkie wyzwalacze oparte na ID produktu / ID wariantu są oceniane względem tych pozycji.

Kontekst koszyka

  • Suma częściowa — suma częściowa koszyka w głównych jednostkach waluty sklepu (np. w dolarach). total_price w Upcart jest wyrażone w jednostkach podrzędnych (centach), więc skrypt dzieli je przez 100, aby dopasować jednostki używane przez resztę Strategies API — i jednostki, w których tworzone są Twoje reguły cart_subtotal.
  • Liczba sztuk — łączna liczba sztuk we wszystkich pozycjach.
  • Liczba pozycji — liczba odrębnych pozycji.

Kontekst sesji

  • Kod waluty — pobierany z window.Shopify.currency.active.
Wyzwalacze klienta i wyzwalacze UTM nie zostaną dopasowane. Domyślny skrypt nie wysyła tagów klienta, liczby zamówień, lokalizacji ani parametrów UTM — więc żadna reguła używająca tych wyzwalaczy nigdy nie zadziała. Używaj wyzwalaczy produktowych, koszykowych i walutowych albo Catch all, aby zawsze coś było zwracane.

Co się dzieje, gdy Strategia zwraca wynik

Produkty zwrócone przez Strategię całkowicie zastępują listę, którą Upcart w przeciwnym razie pokazałby w module Upsells. Lista upselli zdefiniowana przez sprzedawcę jest nadpisywana na czas trwania tego koszyka — nie jest scalana. Każdy produkt Strategii jest mapowany na oczekiwany przez Upcart kształt produktu (warianty, obrazy, opcje, metapola itd.), dzięki czemu renderuje się w bloku upsell dokładnie tak, jak każdy inny produkt.

Gdy żaden produkt nie zostanie zwrócony

Jeśli Strategia nie zwraca produktów, moduł Upsells renderuje się pusty — żadne upselle nie są pokazywane. Aby tego uniknąć, skonfiguruj w Strategii regułę Catch all, dzięki której zawsze będzie istniał zapasowy produkt do zwrócenia. Zobacz stronę Budowanie Strategii, aby dowiedzieć się, jak skonfigurować Catch all.

Ponowna ocena przy zmianach koszyka

W przeciwieństwie do upselli w checkoucie implementacja Upcart ponownie ocenia Strategię za każdym razem, gdy koszyk się zmienia — po dodaniu, usunięciu lub zmianie ilości produktów. Skrypt subskrybuje zdarzenie cartUpdated Upcart, wysyła nowy koszyk do Strategies API i odświeża cart drawer z nową listą upselli. Kontrola sygnatury koszyka pomija zbędne wywołania, jeśli pozycje i ilości faktycznie się nie zmieniły, więc następujące po sobie zdarzenia koszyka, które nie zmieniają go w istotny sposób, nie odpytają API ponownie.

Wskazówki dotyczące Strategii Upcart

  • Projektuj wokół koszyka. Wyzwalacze oparte na kształcie koszyka i produktach to najsilniejsze sygnały, jakie masz w tym miejscu. Historia klienta i targetowanie oparte na UTM nie są wysyłane przez domyślny skrypt.
  • Używaj Catch all jako zabezpieczenia. Bez niego moduł Upsells nie pokaże nic, gdy żadna reguła nie zostanie dopasowana.
  • Domyślnie przyjazny dla pamięci podręcznej. Ochrona sygnaturą koszyka zapobiega ponownemu wywoływaniu API, jeśli koszyk nie zmienił się w istotny sposób — to dobre dla kupujących, którzy otwierają i zamykają koszyk bez jego edytowania.