Regras manuais: documentação do CheckoutOS

As regras manuais permitem substituir as recomendações da IA quando você souber o que funciona melhor. Fixe produtos específicos, exclua itens, dê destaque a categorias ou crie conjuntos de recomendações selecionadas para ocasiões especiais.

Quando usar regras manuais

Use regras manuais para lançamentos de produtos, promoções sazonais, liquidações, otimização de margens ou quando você tiver conhecimento especializado que a IA não tem.

Tipos de regras

Produtos fixados

Garanta que produtos específicos apareçam nas recomendações:

Regra de produtos fixados

{
  "rule": {
    "name": "New Product Launch",
    "type": "pin",
    "products": ["new-serum-001", "new-cream-002"],
    "position": "first",
    "placements": ["product_page", "cart_page"],
    "conditions": {
      "date_range": {
        "start": "2025-02-01",
        "end": "2025-02-28"
      }
    },
    "priority": 100
  }
}

Produtos excluídos

Impeça que determinados produtos apareçam nas recomendações:

Regra de exclusão

{
  "rule": {
    "name": "Exclude Discontinued",
    "type": "exclude",
    "products": ["discontinued-001", "recalled-002"],
    "reason": "Product no longer available"
  }
}

Exclusões comuns

Produtos descontinuados
Itens sem estoque (se não forem excluídos automaticamente)
Produtos com problemas de qualidade
Itens em processo de descontinuação
Produtos de concorrentes (marketplace)

Destaque de categorias

Aumente a visibilidade dos produtos de categorias específicas:

Regra de destaque de categorias

{
  "rule": {
    "name": "Summer Collection Boost",
    "type": "boost",
    "target": {
      "type": "collection",
      "id": "summer-2025"
    },
    "boost_factor": 2.0,
    "conditions": {
      "date_range": {
        "start": "2025-06-01",
        "end": "2025-08-31"
      }
    }
  }
}

Otimização de margens

Dê destaque a produtos com margens mais altas nas recomendações:

Regra de destaque por margem

{
  "rule": {
    "name": "High Margin Priority",
    "type": "boost",
    "target": {
      "type": "margin",
      "threshold": 0.4
    },
    "boost_factor": 1.5,
    "max_boosted_products": 2
  }
}

Conjuntos de recomendações selecionadas

Crie coleções de recomendações escolhidas manualmente:

Conjunto selecionado

{
  "rule": {
    "name": "Valentine's Day Gift Guide",
    "type": "curated_set",
    "trigger": {
      "type": "date_range",
      "start": "2025-02-01",
      "end": "2025-02-14"
    },
    "products": [
      { "id": "gift-box-001", "position": 1 },
      { "id": "perfume-002", "position": 2 },
      { "id": "jewelry-003", "position": 3 },
      { "id": "flowers-004", "position": 4 }
    ],
    "title": "Valentine's Day Picks",
    "override_ai": true
  }
}

Relações entre produtos

Defina relações explícitas entre produtos:

Relações entre produtos

{
  "relationships": [
    {
      "source_product": "camera-body-001",
      "related_products": ["lens-001", "memory-card-002", "camera-bag-003"],
      "relationship_type": "accessories",
      "priority": "high"
    },
    {
      "source_product": "shampoo-001",
      "related_products": ["conditioner-001", "hair-mask-001"],
      "relationship_type": "companion",
      "priority": "high"
    },
    {
      "source_product": "phone-basic-001",
      "related_products": ["phone-pro-001"],
      "relationship_type": "upgrade",
      "priority": "medium"
    }
  ]
}

Regras condicionais

Aplique regras com base em condições:

Regra condicional

{
  "rule": {
    "name": "VIP Customer Exclusives",
    "type": "curated_set",
    "conditions": {
      "customer_tag": "vip",
      "cart_value_min": 100
    },
    "products": ["exclusive-001", "limited-edition-002"],
    "title": "Exclusive for You"
  }
}

Condições disponíveis

Intervalo de datas — Períodos sazonais ou promocionais
Segmento de clientes — VIP, novos, recorrentes
Conteúdo do carrinho — Produtos ou categorias específicos
Valor do carrinho — Limite mínimo
Tipo de dispositivo — Dispositivo móvel ou computador
Origem do tráfego — Orgânico, pago, e-mail
Localização geográfica — País ou região

Prioridade das regras

Quando várias regras se aplicam, a prioridade determina qual prevalece:

Exemplo de prioridade

{
  "rules": [
    {
      "name": "Global New Arrivals",
      "priority": 50,
      "type": "boost",
      "target": { "type": "tag", "value": "new-arrival" }
    },
    {
      "name": "Flash Sale Override",
      "priority": 100,
      "type": "curated_set",
      "products": ["sale-item-001", "sale-item-002"]
    }
  ]
}

Escala de prioridade

A prioridade vai de 1 a 100. Os números mais altos prevalecem. As recomendações geradas pela IA têm prioridade padrão de 0.

Gerenciamento de regras

Acessar as regras

Acesse CheckoutOS → Smart Recommendations → Manual Rules.

Criar nova regra

Clique em "Create Rule" e selecione o tipo de regra.

Configurar a regra

Defina produtos, condições e prioridade.

Testar a regra

Veja uma prévia de como a regra afeta as recomendações.

Ativar

Salve e ative a regra.

Boas práticas

Dicas para regras manuais

Use com moderação — Deixe a IA fazer a maior parte do trabalho
Defina datas de término — Não deixe regras temporárias se tornarem permanentes
Monitore o impacto — Compare o desempenho com as recomendações da IA
Documente os motivos — Registre por que as regras foram criadas
Revise regularmente — Faça uma auditoria das regras a cada trimestre

Tópicos relacionados

Motor de IA

Como funcionam as recomendações de IA

Saiba mais

Posicionamentos

Onde mostrar recomendações

Saiba mais