Skip to main content

Czym są strategie?

Strategie to oparty na regułach silnik doświadczeń i rekomendacji produktów w Aftersell. Pojedyncza strategia to zbiór reguł targetowania, które ewaluują kontekst kupującego (produkty w koszyku, atrybuty klienta, parametry UTM i więcej) i zwracają w czasie rzeczywistym w pełni wzbogacone rekomendacje produktów. W przeciwieństwie do statycznych widżetów rekomendacji strategie dają ci pełną kontrolę nad tym, które produkty są pokazywane którym kupującym i kiedy. Możesz ich używać do zasilania karuzel upsellowych, bloków cross-sell, ofert post-purchase lub dowolnego niestandardowego doświadczenia w sklepie Shopify.

Jak to działa

  1. Tworzysz strategię — strategię zawierającą jedną lub więcej reguł, każdą z wyzwalaczami (predykatami) i zestawem produktów do rekomendowania, gdy te wyzwalacze pasują.
  2. Twój storefront wysyła kontekst — gdy strona się ładuje lub koszyk się aktualizuje, twój storefront wysyła bieżące dane o produkcie, koszyku, kliencie i sesji do API strategii.
  3. Silnik ewaluuje — silnik reguł Aftersell ewaluuje każdą regułę w strategii względem dostarczonego kontekstu i zwraca w pełni wzbogacone produkty z tytułami, cenami, obrazami, wariantami i dostępnością.
  4. Renderujesz wyniki — odpowiedź API zawiera wszystko, czego potrzebujesz, aby bezpośrednio wyświetlić rekomendacje. Nie są wymagane żadne dodatkowe wywołania API Shopify.

Kluczowe pojęcia

Strategia — nazwany zbiór reguł ewaluowanych razem. Każda strategia ma unikalne ID (24-znakowy ciąg szesnastkowy), do którego odwołujesz się przy wywoływaniu API. Krok — hierarchiczna sekwencja ewaluacji w ramach strategii. Reguły są ewaluowane w kolejności kroków, więc akcje w kroku 1 mają priorytet nad tymi w kroku 2. Reguła — pojedyncza para wyzwalacz-akcja w ramach strategii. Reguła definiuje, kiedy powinna pasować (np. „koszyk zawiera produkt z tagiem summer”), a następnie odpowiadające jej doświadczenie do wyrenderowania. Wyzwalacz — predykat dołączony do reguły. Wyzwalacze mogą targetować atrybuty produktów, właściwości koszyka, dane klienta, parametry sesji/UTM i metapola produktów. Akcja — wynik dołączony do reguły. Akcje zwracają wybór wzbogaconych produktów, opcje sortowania i filtrowania oraz metadane. Catch all — specjalna reguła, która uruchamia się automatycznie, gdy żadna inna reguła w strategii nie pasuje. Nie ma wyzwalaczy i jest zawsze ostatnim krokiem ewaluacji. Gdy jest włączona, gwarantuje, że slot rekomendacji nigdy nie będzie pusty, i można ją skonfigurować z dowolnym typem akcji dostępnym dla zwykłych reguł.

Pierwsze kroki

Wymagania wstępne

  • Aktywny sklep Shopify z zainstalowaną aplikacją Aftersell.
  • Dostęp do panelu Aftersell (to tutaj utworzysz strategie i wygenerujesz klucze API).
  • Włączone strategie w twoim sklepie. Strategie nie są włączone w każdym sklepie — jeśli nie widzisz w panelu Settings → Product Strategy, skontaktuj się ze wsparciem lub swoim opiekunem konta, aby je włączyć.

Krok 1: Wygeneruj klucz API

Klucze API są przypisane do pojedynczego sklepu i są wymagane przy wszystkich żądaniach API strategii. W panelu klucz jest oznaczony jako Security Token — to wartość, którą wysyłasz w nagłówku X-Strategy-Api-Key.
  1. Zaloguj się do panelu Aftersell.
  2. Przejdź do Settings na lewym pasku bocznym.
  3. Otwórz Product Strategy.
  4. Na karcie Security Token kliknij Generate Token.
  5. Skopiuj klucz natychmiast — jest pokazywany tylko raz i nie można go później odzyskać. Przechowywany jest tylko jednokierunkowy hash.
Przechowuj swój klucz API w bezpiecznym miejscu. Klucz w postaci jawnej jest zwracany raz, w momencie generowania. Jeśli go zgubisz, musisz wygenerować nowy. Wygenerowanie nowego klucza automatycznie unieważnia poprzedni — w danym momencie aktywny może być tylko jeden klucz API na sklep. Wszystkie integracje używające starego klucza natychmiast przestaną działać.

Krok 2: Utwórz swoją pierwszą strategię

Strategie możesz budować w całości przez interfejs Aftersell — bez pisania kodu. Zobacz przewodnik Budowanie strategii w aplikacji.

Krok 3: Zintegruj ze swoim storefrontem

Gdy masz już strategię i klucz API, możesz wywoływać endpoint Evaluate ze swojego storefrontu, aby pobierać rekomendacje.