Skip to main content
Cette page est le catalogue complet derrière l’éditeur de Stratégie : chaque déclencheur et les opérateurs qu’il accepte, chaque action, les filtres globaux et la manière dont une Stratégie est évaluée. Elle accompagne le guide Créer des stratégies ; consultez-la lorsque vous avez besoin du détail exhaustif d’une option précise. Une règle associe des déclencheurs (le quand) à des actions (le alors), et vous pouvez combiner jusqu’à cinq déclencheurs sous un même sélecteur AND / OR : avec AND, chaque déclencheur doit correspondre ; avec OR, un seul suffit. Les sections ci-dessous suivent cette structure : d’abord les Déclencheurs et les Actions, puis les contrôles au niveau de la Stratégie qui s’appliquent à toutes les règles : l’ordre des règles, les filtres globaux et le Catch all.

​
Déclencheurs

Les déclencheurs déterminent quand une règle se déclenche. Types de déclencheurs disponibles :

​
Déclencheurs de produit

Ciblage en fonction des produits du contexte (le panier de l’acheteur, la commande qui vient d’être finalisée ou le produit consulté) :
  • Specific product(s) - correspond à des produits Shopify spécifiques par ID
  • Collection - correspond aux produits appartenant à des collections spécifiques
  • Tag(s) - correspond aux produits ayant des tags spécifiques (par ex. « sale », « summer »)
  • Title - correspond au titre du produit
  • Vendor - correspond au nom du fournisseur/de la marque
  • Type - correspond au champ de type de produit (par ex. « Apparel », « Electronics »)
  • Handle - correspond au slug d’URL du produit
  • Metafield - correspond à des paires namespace/clé/valeur de metafields personnalisés
  • Selling plan - correspond aux produits « subscription » ou « one-time ». N’est évalué que lorsque le contexte de la requête fournit un selling plan pour le produit ; les surfaces d’upsell du checkout et post-achat d’Aftersell ne l’envoient pas, le déclencheur ne correspondra donc pas sur ces surfaces, sauf si une intégration personnalisée le fournit explicitement

​
Déclencheurs client

Ciblage en fonction de l’identité de l’acheteur :
  • Customer tag - par ex. « VIP », « loyalty-gold »
  • Country code - pays de facturation
  • Province code - province/état de facturation
  • Locale - langue du client (par ex. « en-US »)
  • Accepts marketing - statut d’acceptation du marketing
  • Order count - nombre de commandes précédentes
  • Total spent - dépenses cumulées

​
Déclencheurs de panier

Ciblage en fonction de l’état global du panier :
  • Cart subtotal - par ex. sous-total supérieur à $50
  • Item count - quantité totale d’articles dans le panier
  • Line count - nombre de lignes d’articles distinctes
  • Cart attribute - attributs de panier personnalisés définis via l’API cart de Shopify
  • Cart note - le champ de note du panier

​
Déclencheurs de localisation

Ciblage en fonction de la destination d’expédition de l’acheteur et de la devise de la boutique :
  • Shipping country - pays de destination de l’expédition
  • Shipping province - province/état de destination de l’expédition
  • Shipping method - mode de livraison sélectionné
  • Store currency - le code de la devise active de la boutique

​
Déclencheurs marketing

Ciblage en fonction de l’URL de la page sur laquelle l’acheteur est arrivé :
  • URL - correspond à une sous-chaîne de l’URL d’arrivée, ce qui vous permet de cibler une campagne ou un canal précis en faisant correspondre un paramètre intégré à l’URL (par ex. utm_source=newsletter)

​
Déclencheurs temporels

Ciblage en fonction du moment où la requête est évaluée, à l’heure de la boutique :
  • Day of week - le jour actuel
  • Hour of day - l’heure actuelle

​
Déclencheurs dynamiques

  • Always match - un déclencheur sans condition qui se déclenche toujours. Utilisez-le pour qu’une règle s’exécute à chaque requête (à ne pas confondre avec le Catch all au niveau de la Stratégie, qui ne se déclenche que lorsqu’aucune autre règle ne correspond).
Tous les déclencheurs ne sont pas renseignés sur toutes les surfaces. Le checkout, par exemple, n’envoie que le contexte produit et panier ; les déclencheurs client, de localisation et marketing n’y correspondront pas. Consultez les guides Implémenter des Stratégies pour savoir ce que chaque surface envoie.

​
Opérateurs

Chaque déclencheur utilise un opérateur pour définir comment la valeur est comparée. Les opérateurs disponibles dépendent du type de déclencheur. Tous les opérateurs ne sont pas disponibles pour tous les déclencheurs :
  • Les opérateurs de liste (Contains any / all et leurs négations) s’appliquent aux champs multivaleurs comme les tags, les collections, les tags client et les produits spécifiques.
  • Les opérateurs de texte (Equals, Contains et leurs négations) s’appliquent aux champs texte à valeur unique comme le titre, le fournisseur, le handle, la langue, le pays et l’URL.
  • Les opérateurs numériques s’appliquent aux champs comme le sous-total du panier, le nombre d’articles, le nombre de lignes, le nombre de commandes, le total dépensé et l’heure de la journée. Les opérateurs numériques n’ont pas de variantes « does not ».
  • Quelques champs ne prennent en charge que Equals et Does not equal : selling plan, day of week et accepts marketing.

​
Actions

Les actions créent l’expérience que vous souhaitez offrir au client. C’est ici que vous décidez quels produits mettre en avant, comment les présenter et quelles données supplémentaires transmettre avec eux. Une règle peut comporter plusieurs actions configurées ensemble pour construire l’expérience complète. Pour chaque règle, toutes les actions configurées alimentent un même pool combiné. Par exemple, une règle avec une action de produit spécifique, une action de collection et une action basée sur les tags renverra des produits issus des trois sources ensemble. Si un produit correspond à plusieurs sources, il est dédupliqué.

​
Actions de produit

Les mêmes attributs de produit disponibles côté déclencheurs sont également disponibles lors de la définition des actions. Vous pouvez renvoyer des produits en fonction de :
  • Specific products - sélectionnez manuellement des produits individuels de votre catalogue Shopify.
  • Collection - renvoie tous les produits appartenant à une collection spécifique.
  • Attributs de produit - renvoie les produits correspondant à des critères comme les tags, le fournisseur, le type de produit ou les metafields, soit les mêmes types d’attributs que ceux utilisés dans les déclencheurs.

​
Actions dynamiques

Les actions dynamiques modifient ce qui est renvoyé en fonction de signaux en temps réel plutôt que d’une liste de produits fixe. Les types d’actions dynamiques disponibles incluent :
  • Most popular - les produits les plus performants de votre boutique en volume de ventes, sur toute la boutique ou limités à une collection.
  • Recently purchased - les produits récemment achetés dans la boutique.
  • Inherit from when - réutilise les propres déclencheurs de la règle (le « quand ») comme sélecteur de produits, de sorte que les produits renvoyés correspondent aux mêmes critères que ceux ayant déclenché la règle.
  • AI Recommendations - suggestions personnalisées générées par le modèle de recommandation d’Aftersell.

​
Actions de filtrage

Une fois le pool de produits constitué, vous pouvez configurer le nombre de produits renvoyés et leur ordre :
  • Sort - contrôle quels produits sont sélectionnés :
    • Random - une sélection aléatoire.
    • Price: high → low - les produits les plus chers sont renvoyés en premier.
    • Price: low → high - les produits les moins chers sont renvoyés en premier.
  • Amount/Limit - définit le nombre maximal de produits à renvoyer.
  • Type - restreint le pool de produits constitué à un seul type de produit Shopify. Choisissez Equals pour une correspondance exacte ou Contains pour une correspondance de sous-chaîne (les deux sont insensibles à la casse). Seuls les produits dont le type correspond à la valeur saisie sont conservés ; les autres sont retirés avant l’application de Amount/Limit.
Le filtre Type réduit le pool de produits constitué par vos actions de produit ; il diffère de l’action de produit Product type, qui renvoie les produits d’un type donné. Utilisez le filtre lorsque vous souhaitez restreindre ce qu’une action plus large (comme une action de collection ou dynamique) peut renvoyer.
Sort est appliqué en premier, puis Amount/Limit. Par exemple, si votre tri est défini sur Random, l’ensemble du pool de produits est mélangé avant l’application de la limite ; vous obtenez donc toujours un échantillon aléatoire, et non les mêmes produits dans un ordre aléatoire.

​
Actions clé-valeur

Vous pouvez éventuellement associer des paires clé-valeur à une règle. Lorsque la règle correspond, elles sont renvoyées dans meta.data dans la réponse de l’API, avec les résultats produits. Usages courants :
  • Texte de bannière promotionnelle
  • Libellés de campagne pour les analytics
Si plusieurs règles correspondent et émettent la même clé, c’est la valeur de la première règle correspondante qui l’emporte ; les règles suivantes ne peuvent pas la remplacer.

​
Priorité des règles et ordre d’évaluation

Les règles d’une Stratégie sont évaluées dans l’ordre, une étape à la fois. L’étape 1 est évaluée en premier, et ainsi de suite. Vous pouvez réorganiser les règles par glisser-déposer dans l’éditeur de Stratégie. Le moteur d’évaluation :
  1. Évalue les déclencheurs de chaque règle par rapport au contexte fourni.
  2. Collecte les produits de toutes les règles correspondantes.
  3. Déduplique et limite le résultat au maximum configuré (par défaut : 20 produits).

​
Filtres globaux

Les filtres globaux retirent des produits de l’éligibilité à la sélection pour toutes les règles d’une Stratégie. Vous y accédez via l’icône de filtre à côté du nom de la Stratégie, en haut à gauche de l’éditeur de Stratégie. Filtres globaux disponibles :
  • Exclude out of stock - exclut automatiquement tout produit actuellement indisponible à l’achat.
  • Exclude input products - exclut le ou les produits ayant déclenché la règle (par ex. le produit que l’acheteur consulte actuellement sur une PDP), afin de ne jamais recommander le produit que l’acheteur regarde déjà.
  • Exclude by product tag - exclut les produits portant des tags spécifiques.
  • Exclude by metafield - exclut les produits correspondant à un namespace/clé/valeur de metafield spécifique.
  • Exclude by product ID - exclut des produits spécifiques par ID.
  • Require stock at location - ne conserve que les produits disposant d’un stock disponible dans un emplacement choisi (nécessite les autorisations de lecture de l’inventaire et des emplacements).

​
Catch all

Le Catch all est une règle spéciale qui constitue l’étape finale de chaque évaluation de Stratégie. Il n’a pas de déclencheur ; il se déclenche automatiquement si aucune autre règle de la Stratégie ne correspond à la requête en cours. Lorsqu’il est activé, le Catch all garantit que votre emplacement de recommandation n’est jamais vide. Son action peut être configurée avec n’importe quel type d’action disponible pour les règles classiques : produits spécifiques, collections, actions dynamiques, etc.
  • Activer/désactiver - active ou désactive la règle Catch all pour la Stratégie. Lorsqu’elle est désactivée, les requêtes ne correspondant à aucune règle renvoient un résultat vide.
  • Configurer les actions - définissez ce qu’il faut renvoyer à l’aide de n’importe quelle combinaison de types d’actions disponibles, comme pour toute autre règle.
Lorsque le Catch all se déclenche, la réponse de l’API indique resolution.fallbackUsed: true.