Règles de tagging — portée & propagation - Solya Docs

La scope optionnelle d’une règle décide quelles entités elle évalue et comment l’étiquette se propage.

"scope": {
  "entityType": "VARIANT",
  "propagationMode": "BUBBLE_UP",
  "brandIds": ["<uuid>"],
  "productIds": [],
  "taxonomies": [ { "type": "gender", "values": ["M"] } ],
  "collections": ["<uuid>"]
}

Champs de portée

Champ	Signification
`entityType`	L’entité que la règle cible : `PRODUCT`, `BRAND`, `VARIANT`, `INVENTORY_ITEM`. Toujours défini.
`brandIds`	Restreindre à ces marques.
`productIds`	Restreindre à ces produits.
`taxonomies`	Restreindre par dimension — chaque `{ type, values }` (p. ex. genre = M).
`collections`	Restreindre à ces collections.
`propagationMode`	Comment l’étiquette se propage dans la hiérarchie (ci-dessous).

Un filtre vide/absent signifie « pas de restriction sur cette dimension ». Les filtres se combinent pour affiner la population évaluée.

Modes de propagation

La hiérarchie est Marque → Produit → Variante → Article d’inventaire.

Mode	Effet
`ENTITY_ONLY`	Étiquetez uniquement l’entité correspondante (défaut — pas de propagation).
`CASCADE_DOWN`	Étiquetez aussi les descendants de l’entité (p. ex. marque → ses produits → leurs variantes).
`BUBBLE_UP`	Étiquetez aussi les ancêtres de l’entité (p. ex. variante → son produit → sa marque).

Hiérarchie des entités et modes de propagation :

Le parcours de propagation exact s’exécute dans le moteur d’évaluation d’étiquettes de la plateforme données ; la règle ne déclare que le mode. Choisissez CASCADE_DOWN pour étiqueter un sous-arbre entier à partir d’un niveau supérieur, ou BUBBLE_UP pour marquer un parent parce que l’un de ses enfants a correspondu.