Règles manuelles : documentation CheckoutOS

Les règles manuelles permettent de remplacer les recommandations IA lorsque vous savez mieux qu’elle. Épinglez des produits précis, excluez des articles, favorisez des catégories ou créez des sélections de recommandations pour des occasions spéciales.

Quand utiliser les règles manuelles

Utilisez les règles manuelles pour les lancements de produits, promotions saisonnières, articles en déstockage et l’optimisation des marges, ou lorsque vous possédez une expertise métier qui manque à l’IA.

Types de règles

Produits épinglés

Imposez la présence de produits précis dans les recommandations :

Règle de produits épinglés

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

Produits exclus

Empêchez certains produits d’apparaître dans les recommandations :

Règle d’exclusion

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

Exclusions courantes

Produits dont la commercialisation a cessé
Articles en rupture de stock (s’ils ne sont pas exclus automatiquement)
Produits présentant des problèmes de qualité
Articles en cours de retrait
Produits concurrents (place de marché)

Mise en avant d’une catégorie

Augmentez la visibilité des produits de catégories précises :

Règle de mise en avant d’une catégorie

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

Optimisation des marges

Favorisez les produits à marge plus élevée dans les recommandations :

Règle de mise en avant selon la marge

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

Sélections de recommandations

Créez des collections de recommandations sélectionnées manuellement :

Sélection manuelle

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

Relations entre produits

Définissez explicitement les relations entre produits :

Relations entre produits

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

Règles conditionnelles

Appliquez les règles selon des conditions :

Règle conditionnelle

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

Conditions disponibles

Période — Saisons ou périodes promotionnelles
Segment de clientèle — VIP, nouveaux clients, clients qui reviennent
Contenu du panier — Produits ou catégories précis
Valeur du panier — Seuil minimum
Type d’appareil — Mobile ou ordinateur
Source de trafic — Organique, payant, e-mail
Localisation géographique — Pays ou région

Priorité des règles

Lorsque plusieurs règles s’appliquent, la priorité détermine laquelle prévaut :

Exemple de priorité

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

Échelle de priorité

La priorité va de 1 à 100. Les valeurs les plus élevées prévalent. Les recommandations générées par l’IA ont une priorité par défaut de 0.

Gérer les règles

Accéder aux règles

Accédez à CheckoutOS → Smart Recommendations → Manual Rules.

Créer une règle

Cliquez sur "Create Rule" et sélectionnez le type de règle.

Configurer la règle

Définissez les produits, les conditions et la priorité.

Tester la règle

Prévisualisez l’effet de la règle sur les recommandations.

Activer

Enregistrez et activez la règle.

Bonnes pratiques

Conseils sur les règles manuelles

Utilisez-les avec parcimonie — Laissez l’IA faire l’essentiel du travail
Définissez des dates de fin — Ne laissez pas les règles temporaires devenir permanentes
Surveillez les effets — Comparez les performances à celles des recommandations IA
Documentez les raisons — Notez pourquoi les règles ont été créées
Réexaminez-les régulièrement — Auditez les règles chaque trimestre

Sujets associés

Moteur d’IA

Fonctionnement des recommandations IA

Emplacements

Où afficher les recommandations