> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Przegląd strategii

> Dowiedz się, czym są strategie, jak działają i jak zacząć inteligentne tworzenie doświadczeń.

<div id="what-are-strategies">
  ## Czym są strategie?
</div>

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.

<div id="how-it-works">
  ### Jak to działa
</div>

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.

<div id="key-concepts">
  ### Kluczowe pojęcia
</div>

**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ł.

***

<div id="getting-started">
  ## Pierwsze kroki
</div>

<div id="prerequisites">
  ### Wymagania wstępne
</div>

* 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ć.

<div id="step-1-generate-your-api-key">
  ### Krok 1: Wygeneruj klucz API
</div>

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.

<Warning>
  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ć.
</Warning>

<div id="step-2-create-your-first-strategy">
  ### Krok 2: Utwórz swoją pierwszą strategię
</div>

Strategie możesz budować w całości przez interfejs Aftersell — bez pisania kodu. Zobacz przewodnik [Budowanie strategii w aplikacji](/pl/aftersell/strategies_building_in_app).

<div id="step-3-integrate-with-your-storefront">
  ### Krok 3: Zintegruj ze swoim storefrontem
</div>

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