Reglas manuales: documentación de CheckoutOS

Las reglas manuales permiten sustituir recomendaciones de IA cuando sabes más. Fija productos, excluye artículos, da prioridad a categorías o crea selecciones para ocasiones especiales.

Cuándo usar reglas manuales

Úsalas para lanzamientos, promociones de temporada, liquidaciones, optimización del margen o cuando tienes conocimientos que la IA no posee.

Tipos de reglas

Productos fijados

Haz que determinados productos aparezcan obligatoriamente en las recomendaciones:

Regla de productos fijados

{
  "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
  }
}

Productos excluidos

Impide que determinados productos aparezcan en las recomendaciones:

Regla de exclusión

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

Exclusiones habituales

Productos descontinuados
Artículos agotados, si no se excluyen automáticamente
Productos con problemas de calidad
Artículos que se están retirando
Productos de competidores en un marketplace

Prioridad por categoría

Aumenta la visibilidad de productos de ciertas categorías:

Regla de prioridad por categoría

{
  "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"
      }
    }
  }
}

Optimización del margen

Da más prioridad a productos de mayor margen:

Regla de prioridad por margen

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

Selecciones de recomendaciones

Crea colecciones de recomendaciones elegidas a mano:

Selección preparada

{
  "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
  }
}

Relaciones entre productos

Define relaciones explícitas entre productos:

Relaciones entre productos

{
  "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"
    }
  ]
}

Reglas condicionales

Aplica reglas según condiciones:

Regla 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"
  }
}

Condiciones disponibles

Rango de fechas — Temporadas o períodos promocionales
Segmento de clientes — VIP, nuevos, recurrentes
Contenido del carrito — Productos o categorías específicos
Valor del carrito — Umbral mínimo
Tipo de dispositivo — Teléfono o computadora
Fuente de tráfico — Orgánico, de pago, email
Ubicación geográfica — País o región

Prioridad de las reglas

Si se aplican varias reglas, la prioridad determina cuál prevalece:

Ejemplo de prioridad

{
  "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 prioridad

La prioridad va de 1 a 100. Los números más altos prevalecen. Las recomendaciones generadas por IA tienen una prioridad predeterminada de 0.

Gestionar reglas

Ir a las reglas

Ve a CheckoutOS → Smart Recommendations → Manual Rules.

Crear una regla

Haz clic en “Create Rule” y selecciona el tipo de regla.

Configurar la regla

Define los productos, las condiciones y la prioridad.

Probar la regla

Previsualiza cómo afecta a las recomendaciones.

Activar

Guarda y activa la regla.

Buenas prácticas

Consejos para las reglas manuales

Úsalas con moderación — Deja que la IA haga la mayor parte del trabajo
Fija fechas de fin — Evita que reglas temporales se vuelvan permanentes
Supervisa el impacto — Compara el rendimiento con las recomendaciones de IA
Documenta los motivos — Anota por qué se crearon
Revísalas regularmente — Audita las reglas cada trimestre

Temas relacionados

Motor de IA

Cómo funcionan las recomendaciones de IA

Más información

Ubicaciones

Dónde mostrar las recomendaciones

Más información