Ce document concerne Recommendations AI, Retail Search et la nouvelle console Retail. Pour utiliser Retail Search dans la phase en disponibilité limitée, contactez le service commercial Cloud.

Si vous n'utilisez que Recommendations AI, restez dans la console Recommendations AI et consultez la documentation sur Recommendations AI.

Créer et gérer des contrôles

Cette page explique comment ajouter, afficher, modifier et supprimer des contrôles.

  • Les contrôles de diffusion sont des règles que vous définissez et appliquez à des configurations de diffusion Retail Search individuelles.
  • Les contrôles sur l'ensemble du site s'appliquent à tous vos résultats Retail Search.

Contrôles de diffusion

Les contrôles de diffusion vous permettent de créer des règles qui personnalisent la manière dont vos configurations de diffusion diffusent les résultats de recherche.

Vous pouvez créer un contrôle de diffusion basé sur des règles dans Cloud Console, ledit contrôle étant composé d'une condition qui déclenche la règle et d'une action effectuée lorsque la condition se déclenche. Vous pouvez ensuite associer le nouveau contrôle de diffusion à n'importe laquelle des configurations de diffusion Retail Search que vous avez créées.

Les configurations de diffusion Retail Search ont une relation multi-relationnelle avec les contrôles. Vous pouvez ajouter plusieurs contrôles à une configuration de diffusion, et un même contrôle peut être associé à plusieurs configurations de diffusion.

Vous pouvez créer des contrôles, puis les ajouter ou les échanger dans une configuration de diffusion Retail Search active.

Créez ou modifiez des contrôles d'inférence à tout moment sur la page Contrôles. Lorsque vous créez une configuration de diffusion Retail Search, Cloud Console pour Retail vous permet également de créer des contrôles.

Vous pouvez créer jusqu'à 1 000 contrôles de diffusion.

Les contrôles de diffusion sont disponibles pour les éléments suivants :

  • Remonter/redescendre : ce paramètre affecte le classement et l'ordre des résultats dans la liste des résultats renvoyés.
  • Filtrer : supprime les résultats qui ne respectent pas le filtre de la liste des résultats renvoyés.
  • Rediriger : redirige vos utilisateurs vers une page spécifique en fonction de la requête de recherche.
  • Linguistique : personnalise la linguistique des requêtes de recherche. Plusieurs types de contrôles linguistiques sont disponibles :
    • Synonyme : développe les synonymes pris en compte pour une requête de recherche.
    • Synonyme unidirectionnel : développe les synonymes pris en compte de manière unidirectionnelle pour des termes spécifiques.
    • Ne pas associer : empêche l'utilisation d'un groupe de termes dans la recherche lorsque des termes spécifiques apparaissent.
    • Ignorer : empêche l'utilisation d'un terme dans les recherches.
    • Remplacement : remplace les termes figurant dans la requête de recherche.

Pour obtenir des exemples de ces contrôles, consultez la section Règles de contrôle de diffusion.

Créer un contrôle de diffusion

Ajoutez un contrôle de diffusion sur la page Contrôles de Google Cloud Console.

  1. Accédez à la page "Contrôles Retail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

  3. Saisissez un nom pour votre nouveau contrôle.

  4. Saisissez un ID de contrôle.

  5. Choisissez le type de contrôle :

    Remonter/redescendre

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles "Remonter/redescendre".

    1. (Facultatif) Saisissez des termes de requête (par exemple, running shoes) à faire remonter ou redescendre, et sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la règle "Remonter/redescendre" prend effet. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également remplis.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. Si vous spécifiez des termes de requête, la règle n'est appliquée que si l'un de ces termes est utilisé dans une requête au cours de cette période.

    3. Dans le champ Remonter/redescendre le produit, spécifiez les attributs du produit à faire remonter ou redescendre. Utilisez la syntaxe d'expression de filtre décrite dans la section Filtrage et ordre.

      Par exemple, pour spécifier les versions rouge et bleue de "product1" et "product2", procédez comme suit : (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

    4. Pour Remonter/redescendre la valeur, utilisez le curseur pour définir l'intensité du changement. Les valeurs positives font remonter les résultats et les valeurs négatives les font redescendre.

      Il s'agit d'une action de contrôle, qui spécifie le comportement de la règle si les conditions de contrôle sont remplies.

    Filtre

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de filtrage.

    1. Saisissez des termes de requête (par exemple, running shoes) pour filtrer et sélectionner l'un des éléments suivants pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la règle de filtrage peut prendre effet. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également satisfaits.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    3. Dans le champ Action de filtre, spécifiez un filtre à appliquer lorsque la règle est déclenchée.

      Utilisez la syntaxe d'expression de filtre décrite dans la section Filtrage et ordre.

      Par exemple, pour filtrer les versions rouge et bleue de "product1" et "product2" : (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

      Il s'agit d'une action de contrôle, qui spécifie le comportement de la règle si les conditions de contrôle sont remplies.

    Redirection

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de redirection.

    1. Saisissez des termes de requête (par exemple, running shoes) qui doivent déclencher la règle de redirection, puis sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la règle de redirection peut prendre effet. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également remplis.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    3. Dans le champ URI de redirection, spécifiez la page vers laquelle effectuer la redirection lorsque la règle est déclenchée.

      Il s'agit d'une action de contrôle, qui spécifie le comportement de la règle si les conditions de contrôle sont remplies.

    Synonyme

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles des synonymes.

    1. Saisissez au moins deux termes de requête (par exemple, running shoes) qui doivent être synonymes et sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Lorsque l'un de ces termes est inclus dans une requête, la recherche considère les autres termes de la requête comme des synonymes du terme inclus.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la règle de synonyme peut prendre effet. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également remplis. (Ce champ fournit également l'action de contrôle, qui consiste à utiliser les autres termes que vous avez spécifiés comme synonymes.)

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    Synonyme unidirectionnel

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles des synonymes unidirectionnels.

    1. Saisissez des termes de requête (par exemple, running shoes) auxquelles des synonymes sont associés, puis sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la recherche considère les autres termes de requête comme des synonymes du terme inclus, que vous spécifiez dans la section Termes associés. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également satisfaits.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    3. Dans la section Termes associés, saisissez les termes qui doivent être utilisés comme synonymes pour les termes de requête que vous avez spécifiés précédemment.

      Il s'agit d'une action de contrôle, qui spécifie le comportement de la règle si les conditions de contrôle sont remplies.

    Ne pas associer

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles "Ne pas associer".

    1. Saisissez des termes de requête (par exemple, running shoes) pour lesquels vous souhaitez éliminer toute ambiguité, puis sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la règle empêche son association aux termes que vous spécifiez dans le champ Termes associés. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également satisfaits.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    3. Dans le champ Termes associés, saisissez les termes qui ne doivent pas être associés aux résultats de recherche, avec les termes de requête que vous avez spécifiés précédemment.

      Il s'agit d'une action de contrôle, qui spécifie le comportement de la règle si les conditions de contrôle sont remplies.

    Ignorer

    Pour en savoir plus sur ce type de contrôle, consultez la section contrôles de type "Ignorer".

    1. Saisissez des termes de requête (par exemple, running shoes) que vous souhaitez empêcher d'utiliser dans une recherche, puis sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, la règle "Ignorer" peut être appliquée. (Cette opération fournit également l'action de contrôle, qui consiste à ignorer les termes spécifiés.) Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également satisfaits.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    Remplacement

    Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de type "Remplacer".

    1. Saisissez des termes de requête (par exemple, running shoes) que vous souhaitez remplacer, puis sélectionnez l'une des options suivantes pour chaque terme :

      • Correspondance partielle : cette règle s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
      • Correspondance complète : cette règle ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.

      Il s'agit d'une condition de contrôle. Lorsque l'un de ces termes est inclus dans une requête, il est remplacé par le terme que vous fournissez dans Terme de remplacement. Si vous spécifiez une période, la règle n'est appliquée que si les critères de période sont également satisfaits.

    2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette règle doit s'appliquer.

      Il s'agit d'une condition de contrôle. La règle n'est appliquée que si l'un des termes de requête que vous avez spécifiés est utilisé dans une requête au cours de cette période.

    3. Dans le champ Terme de remplacement, saisissez le terme qui doit remplacer les termes de requête que vous avez spécifiés précédemment.

      Il s'agit d'une action de contrôle, qui spécifie le comportement de la règle si les conditions de contrôle sont remplies.

  6. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

  7. Envoyez vos paramètres de contrôle.

    Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez tester les modifications immédiatement sur la page Évaluer.

Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".

Afficher ou modifier un contrôle de diffusion

L'onglet Contrôles de diffusion de la page "Contrôles" répertorie tous vos contrôles de diffusion ainsi que les configurations de diffusion associées. Cliquez sur Modifier pour modifier les paramètres d'un contrôle, y compris pour l'appliquer à une configuration de diffusion supplémentaire.

Vous pouvez également consulter et modifier les contrôles pour chaque configuration de diffusion sur la page Configurations de diffusion. Cliquez sur une configuration de diffusion pour afficher sa page "Détails", qui répertorie tous les contrôles de diffusion et à l'échelle du site pour cette configuration.

Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez tester les modifications immédiatement sur la page Évaluer.

Supprimer un contrôle de diffusion

Supprimez un contrôle de serveur pour supprimer cette règle de toutes les configurations de diffusion qui l'utilisent.

  1. Accédez à la page "Contrôles Retail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

  2. Dans la ligne du tableau correspondant au contrôle que vous souhaitez supprimer, cliquez sur Supprimer.

  3. Dans la fenêtre de confirmation, cliquez sur Supprimer pour terminer la suppression.

Contrôles à l'échelle du site

Les contrôles à l'échelle du site vous permettent de gérer les paramètres de façon globale pour toutes les configurations de diffusion.

Contrôles d'attributs

Les contrôles d'attributs à l'échelle du site sont disponibles dans Cloud Console pour les attributs de produit de votre catalogue.

Les contrôles d'attributs à l'échelle du site sont les suivants :

  • Indexable : Retail Search peut filtrer les résultats en fonction de cet attribut.
  • Attribut dynamique : Retail Search peut utiliser automatiquement cet attribut en tant qu'attribut dynamique en se basant sur le comportement passé des utilisateurs (clics et vues par exemple). Pour activer l'option d'attribut dynamique pour un attribut, Indexable doit être défini sur "true" pour cet attribut.
  • Inclus dans l'index de recherche : cet attribut peut être trouvé par les requêtes Retail Search, ce qui augmente le nombre de rappels pour cet attribut. Ce contrôle ne s'applique qu'aux attributs de texte.

Vous pouvez activer ou désactiver les contrôles d'attributs à l'échelle du site pour des attributs individuels.

Les attributs dynamiques sont disponibles en tant que contrôle des attributs à l'échelle du site. Par défaut, les attributs dynamiques sont activés pour tous les attributs personnalisés.

En mode de configuration au niveau du catalogue, des contrôles d'attributs à l'échelle du site sont disponibles pour l'indexation et la recherche.

Les attributs système prédéfinis (tels que la marque, la couleur ou la taille) sont toujours indexables. Les attributs système textuels sont toujours inclus dans l'index de recherche. Les attributs personnalisés peuvent être rendus indexables et être inclus dans l'index de recherche (attributs définis à l'aide de Product.attributes[]). Par défaut, ces options sont définies sur "false" pour les attributs personnalisés.

Vous pouvez également définir certaines configurations d'attribut par produit à l'aide de la méthode API Product.

Pour en savoir plus sur les configurations d'attribut et sur leur disponibilité, consultez la section Configurations d'attributs.

Définir des contrôles d'attributs à l'échelle du site

Définissez un contrôle d'attribut à l'échelle du site sur la page Contrôles de Google Cloud Console.

La définition globale des contrôles d'attributs est disponible dans le mode de configuration au niveau du catalogue par défaut. Auparavant, la configuration au niveau du produit était le mode par défaut. Si vous êtes toujours en mode de configuration au niveau du produit et que vous devez changer de mode, contactez l'assistance Retail.

  1. Accédez à la page "Contrôles Retail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

  2. Accédez à l'onglet Contrôles à l'échelle du site.

    Cet onglet affiche un tableau de tous les attributs de produit pour lesquels vous pouvez définir des contrôles à l'échelle du site.

  3. Cliquez sur Modifier les contrôles.

  4. Activez ou désactivez un contrôle.

    • True : activez un contrôle pour cet attribut. Cette opération remplace toute configuration d'attributs au niveau du produit dans l'API Retail.
    • False : désactive un contrôle pour cet attribut. Cette opération remplace toute configuration d'attribut au niveau du produit dans l'API Retail.

      Notez que vous ne pouvez définir l'attribut dynamique sur "true" que pour les attributs qui sont également définis sur "indexable".

  5. Cliquez sur Enregistrer les contrôles.

    Les modifications apportées aux paramètres de configuration d'attribut pour les propriétés indexables et incluses dans l'index de recherche prennent effet dans un délai de 12 heures, ou immédiatement lors de votre prochaine ingestion de catalogue. Les modifications de configuration des attributs dynamiques peuvent prendre jusqu'à deux jours. Vous pouvez tester les modifications immédiatement sur la page Évaluer.