> ## 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.

# Visão geral de estratégias

> Saiba o que são Strategies, como funcionam e como começar a criar experiências inteligentes.

<div id="what-are-strategies">
  ## O que são Strategies?
</div>

Strategies é o mecanismo de experiências e recomendações de produtos baseado em regras do Aftersell. Uma Strategy individual é uma coleção de regras de segmentação que avaliam o contexto do comprador (produtos no carrinho, atributos do cliente, parâmetros UTM e mais) e retornam recomendações de produtos totalmente enriquecidas em tempo real.

Ao contrário de widgets de recomendação estáticos, as Strategies dão a você controle total sobre *quais* produtos são mostrados a *quais* compradores e *quando*. Você pode usá-las para alimentar carrosséis de upsell, blocos de cross-sell, ofertas pós-compra ou qualquer experiência personalizada em uma loja Shopify.

<div id="how-it-works">
  ### Como funciona
</div>

1. **Você cria uma Strategy** - uma estratégia contendo uma ou mais regras, cada uma com gatilhos (predicados) e um conjunto de produtos a recomendar quando esses gatilhos correspondem.
2. **Sua vitrine envia o contexto** - quando uma página carrega ou um carrinho é atualizado, sua vitrine envia os dados atuais de produto, carrinho, cliente e sessão para a API de Strategies.
3. **O mecanismo avalia** - o mecanismo de regras do Aftersell avalia todas as regras da estratégia em relação ao contexto fornecido e retorna produtos totalmente enriquecidos com títulos, preços, imagens, variantes e disponibilidade.
4. **Você renderiza os resultados** - a resposta da API contém tudo o que você precisa para exibir recomendações diretamente. Não são necessárias chamadas adicionais à API da Shopify.

<div id="key-concepts">
  ### Conceitos principais
</div>

**Strategy** - Uma coleção nomeada de regras que são avaliadas em conjunto. Cada estratégia tem um ID único (uma string hexadecimal de 24 caracteres) que você referencia ao chamar a API.

**Step** - Uma sequência hierárquica de avaliação dentro de uma Strategy. As regras são avaliadas na ordem dos steps, então as ações do Step 1 têm prioridade sobre as do Step 2.

**Rule** — Um par gatilho-ação dentro de uma estratégia. Uma regra define *quando* deve corresponder (por exemplo, "o carrinho contém um produto com a tag `summer`") e *então* a experiência correspondente a renderizar.

**Trigger** — Um predicado anexado a uma regra. Os gatilhos podem segmentar atributos de produto, propriedades do carrinho, dados do cliente, parâmetros de sessão/UTM e metafields de produto.

**Action** - Um resultado anexado a uma regra. As ações retornam uma seleção de produtos enriquecidos, opções de ordenação e filtragem, e metadados.

**Catch all** - Uma regra especial que dispara automaticamente quando nenhuma outra regra da Strategy corresponde. Ela não tem gatilhos e é sempre a etapa final da avaliação. Quando ativada, garante que o espaço de recomendação nunca fique vazio e pode ser configurada com qualquer tipo de ação disponível para regras comuns.

***

<div id="getting-started">
  ## Primeiros passos
</div>

<div id="prerequisites">
  ### Pré-requisitos
</div>

* Uma loja Shopify ativa com o app Aftersell instalado.
* Acesso ao painel do Aftersell (é aqui que você criará suas Strategies e gerará chaves de API).
* Strategies habilitado na sua loja. Strategies não está ativado em todas as lojas — se você não vê **Settings → Product Strategy** no painel, entre em contato com o suporte ou com seu gerente de conta para habilitá-lo.

<div id="step-1-generate-your-api-key">
  ### Passo 1: Gere sua chave de API
</div>

As chaves de API têm escopo de uma única loja e são obrigatórias em todas as requisições da API de Strategy. No painel, a chave é rotulada como seu **Security Token** - é o valor que você envia no cabeçalho `X-Strategy-Api-Key`.

1. Faça login no painel do Aftersell.
2. Navegue até **Settings** na barra lateral esquerda.
3. Abra **Product Strategy**.
4. No cartão **Security Token**, clique em **Generate Token**.
5. Copie a chave imediatamente - ela é exibida apenas uma vez e não pode ser recuperada depois. Apenas um hash unidirecional é armazenado.

<Warning>
  Armazene sua chave de API com segurança. A chave em texto simples é retornada **uma vez**, no momento da geração. Se você perdê-la, precisará gerar uma nova. Gerar uma nova chave revoga automaticamente a anterior — apenas uma chave de API pode estar ativa por loja de cada vez. Quaisquer integrações que usem a chave antiga deixarão de funcionar imediatamente.
</Warning>

<div id="step-2-create-your-first-strategy">
  ### Passo 2: Crie sua primeira Strategy
</div>

Você pode criar Strategies inteiramente pela interface do Aftersell - sem necessidade de código. Veja [Criando estratégias no app](/pt/aftersell/strategies_building_in_app) para um passo a passo.

<div id="step-3-integrate-with-your-storefront">
  ### Passo 3: Integre com sua vitrine
</div>

Depois de ter uma Strategy e uma chave de API, você pode chamar o endpoint Evaluate a partir da sua vitrine para buscar recomendações.
