Accédez aux niveaux de performances sur le Réseau de Recherche

Cette page décrit les cas d'utilisation de la recherche et leurs niveaux de performances respectifs. Elle explique également comment consulter la console Search for Retail afin d'évaluer la qualité de vos données et les niveaux de performances que vous avez débloqués. Il explique comment s'inscrire aux alertes de qualité des données.

Rechercher des cas d'utilisation

La recherche fournit des résultats pour deux cas d'utilisation:

  • Recherche par requête textuelle : cette fonctionnalité est utilisée lorsque les acheteurs recherchent des articles dans votre application en saisissant des requêtes textuelles et en obtenant un ensemble de résultats pertinents.
  • Parcourir la recherche : cette fonctionnalité est utilisée lorsque les clients accèdent à une page de catégorie spécifique (par exemple, la page Web de la catégorie "Électroménager" du site de vente d'un magasin de bricolage) et qu'ils parcourent les articles triés dans cette catégorie.

Pour en savoir plus sur les différences entre ces cas d'utilisation, consultez À propos de la recherche textuelle et de la recherche par navigation.

Niveaux de performances

La recherche par requête textuelle et la recherche par navigation ont différents niveaux de performances qui améliorent de plus en plus vos résultats de recherche. L'accès aux niveaux de performances repose sur les événements utilisateur et les données de catalogue que vous importez dans Vertex AI Search pour le commerce.

Chaque niveau de performance est automatiquement activé lorsque vous remplissez toutes ses exigences concernant les données bloquant les mises à niveau. Vous devez également répondre aux exigences de tous les niveaux précédents pour passer au niveau suivant.

Les niveaux de performances suivants sont disponibles pour chaque cas d'utilisation:

  • Cas d'utilisation de la recherche de requêtes textuelles

    • Pertinence: les résultats sont renvoyés uniquement en fonction de leur pertinence par rapport à la requête.
    • Pertinence et popularité: les résultats sont renvoyés en fonction de leur pertinence par rapport à la requête. Les produits pertinents sont classés en fonction de leur popularité sur votre site.
    • Optimisation des revenus: les résultats pertinents sont classés en fonction de la probabilité d'achat du produit en fonction de l'activité sur l'ensemble du site.
    • Personnalisé et optimisé pour les revenus: les résultats pertinents sont classés en fonction des préférences de l'utilisateur et de la probabilité d'achat du produit en fonction de l'activité sur l'ensemble du site.

  • Parcourir le cas d'utilisation de la recherche

    • Popularité: les résultats sont affichés uniquement en fonction de leur pertinence par rapport à la catégorie.
    • Optimisation des revenus: les résultats pertinents sont classés en fonction de la probabilité d'achat du produit en fonction de l'activité sur l'ensemble du site.
    • Personnalisé et optimisé pour les revenus: les résultats pertinents sont classés en fonction des préférences de l'utilisateur et de la probabilité d'achat du produit en fonction de l'activité sur l'ensemble du site.

La console Search for Retail fournit une page Qualité des données qui vous permet de vérifier si vous respectez les exigences concernant les données de chaque niveau.

Vérifier la qualité de vos données

Après avoir importé vos données, accédez à la console Search for Retail afin de consulter les métriques de vérification des données pour chaque niveau de performances pour votre cas d'utilisation.

  1. Accédez à la page Qualité des données de la console Search for Retail.

    Accéder à la page "Qualité des données"

  2. Affichez les métriques de vérification des données pour votre cas d'utilisation de la recherche:

    • Pour les métriques sur la recherche textuelle, cliquez sur l'onglet Rechercher.
    • Pour parcourir les métriques de recherche, cliquez sur l'onglet Parcourir.

  3. Consultez le tableau de données des problèmes pour chaque niveau de performance en haut de la page.

    • Si la colonne est associée au libellé "Utilisée" : vous avez résolu tous les problèmes bloquants pour ce niveau et l'avez déverrouillé.
    • S'il n'y a aucun problème bloquant:vous avez effectué les vérifications des données pour ce niveau. S'il n'y a aucun problème bloquant pour ce niveau et tous les niveaux précédents, l'entraînement, la préparation du modèle et l'activation du niveau nouvellement déverrouillé prennent environ 24 heures.
    • En cas de problèmes bloquants:vérifiez les métriques de ce niveau pour identifier les problèmes de données à résoudre afin de débloquer ce niveau.

  4. Consultez le tableau des métriques de vérification des données pour chaque niveau de performances afin de consulter la liste des problèmes susceptibles de bloquer les mises à niveau de niveau ou d'affecter les performances de recherche.

  5. Consultez la colonne État pour connaître le niveau de priorité de chaque métrique de vérification des données:

    • Blocage de la mise à niveau: identifie les problèmes de données qui empêchent la recherche de faire passer votre cas d'utilisation au niveau de performances suivant. Pour débloquer un niveau, effectuez toutes les vérifications des données bloquant les mises à niveau pour ce niveau de performances (et ceux des niveaux précédents).
    • Essentiel pour les performances: identifie les problèmes de données qui ne bloquent pas la mise à niveau, mais qui peuvent avoir un impact significatif sur les performances de la recherche textuelle ou de la recherche.
    • Conforme: indique que la vérification des données a réussi.
    • Indisponible: indique qu'une vérification des données bloquantes sans mise à niveau n'est pas encore terminée. Les valeurs de ces métriques sont affichées sous la forme N/A. Après l'importation des données, le calcul de certaines vérifications peut prendre jusqu'à 24 heures.

  6. Pour en savoir plus sur une métrique, cliquez sur Détails afin d'afficher un panneau de détails affichant la description de la métrique, l'horodatage de la vérification des données et les valeurs de seuil.

  7. Vérifiez les seuils dans le panneau Détails d'une métrique pour connaître les valeurs nécessaires pour effectuer la vérification des données de cette métrique et améliorer les résultats. Tous les seuils ne s'appliquent pas à l'ensemble des métriques:

    • Seuil de blocage: seuil requis pour effectuer la vérification des données pour cette métrique.
    • Seuil critique: seuil vivement recommandé à atteindre. Ne pas atteindre ce seuil peut avoir un impact négatif important sur les performances.
    • Seuil d'avertissement: seuil recommandé à respecter. Le non-respect de ce seuil peut avoir un impact mineur sur les performances.

Pour importer plus de données afin de résoudre les problèmes liés aux données, consultez Importer des événements utilisateur historiques ou Importer des informations du catalogue dans la documentation publique.

Bonnes pratiques

  • Dans les requêtes de recherche et dans les événements utilisateur, fournissez des ID utilisateur en plus des ID de visiteur pour les utilisateurs connectés. Cela permet à la recherche de personnaliser les résultats pour l'utilisateur en fonction des événements de connexion des utilisateurs sur tous leurs appareils.
  • Envoyez les événements utilisateur en temps réel au lieu d'effectuer des importations groupées avec un certain délai. Cela permet de personnaliser la recherche en fonction de l'activité la plus récente d'un utilisateur sur votre site.
  • Importez tous les événements utilisateur. Par exemple, ne soumettez pas que des événements attribuables à des recherches.

Désactiver la personnalisation

Pour désactiver la personnalisation, définissez ServingConfig.personalizationSpec sur mode.DISABLED.

Alertes concernant la qualité des données

Les alertes concernant la qualité des données sont déclenchées si une valeur de métrique dans le tableau de bord passe de "satisfaisante" à "non satisfaisante". Les alertes sont envoyées par e-mail.

Si vous souhaitez voir les alertes associées à Cloud Monitoring, consultez la page Configurer des alertes.

Afficher les informations de qualité des données

Accédez à la page Qualité des données de la console Search for Retail.

Accéder à la page "Qualité des données"

Une ligne correspond à une métrique et une métrique à une alerte.

Configurer des alertes concernant la qualité des données

REST

Appelez l'API UpdateAlertConfig.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud.
  • EMAIL_ADDRESS_1 et EMAIL_ADDRESS_2: adresses e-mail auxquelles vous souhaitez vous inscrire pour recevoir les alertes. Ils doivent être conformes au protocole SMTP (Simple Mail Transfer Protocol). Vous pouvez ajouter jusqu'à 20 adresses e-mail à une règle d'alerte.

Console

  1. Accédez à la page Qualité des données de la console Search for Retail.

    Accéder à la page "Qualité des données"

  2. En haut, cliquez sur Configurer des alertes.

  3. Ajoutez au moins une adresse e-mail. Les adresses e-mail doivent être conformes au protocole SMTP (Simple Mail Transfer Protocol). Vous pouvez ajouter jusqu'à 20 adresses e-mail à une règle d'alerte.

  4. Cliquez sur Envoyer.

Désactiver les alertes liées à la qualité des données

REST

Appelez l'API UpdateAlertConfig.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud.

Console

  1. Accédez à la page Qualité des données de la console Search for Retail.

    Accéder à la page "Qualité des données"

  2. En haut, cliquez sur Configurer des alertes.

  3. Supprimez tous les e-mails existants.

  4. Cliquez sur Envoyer.

Résoudre les problèmes

Voici quelques problèmes courants et la façon de les résoudre:

Une vérification des données échoue

Si une vérification des données échoue, cliquez sur Détails pour cette métrique sur la page Qualité des données afin d'afficher une description plus détaillée de cette métrique et des seuils à respecter pour répondre à cette vérification.

Si vous avez déjà rempli les exigences concernant les données, consultez la section Timestamp pour connaître la date du dernier calcul de cette métrique. Si vous avez récemment reformaté ou ingéré une quantité importante de données, plusieurs heures peuvent être nécessaires pour recalculer cette métrique.

Si vous ne répondez pas aux exigences concernant les données, vous devrez peut-être les reformater ou en collecter plus pour répondre aux exigences de vérification des données. Après vous être assuré que vos données atteignent le seuil de métrique, réimportez les données reformatées ou les données supplémentaires, puis attendez que la métrique soit recalculée.

Une valeur de métrique affiche la mention "N/A".

Les valeurs des métriques s'affichent avec la valeur "N/A" si aucune donnée n'a été importée ou si les métriques ne sont pas encore calculées. Une fois les données importées, le calcul de certaines vérifications peut prendre jusqu'à 24 heures.

Un niveau de performances ne présente pas de problèmes bloquants, mais n'est pas utilisé

Pour résoudre le problème, procédez comme suit:

  1. Vérifiez s'il existe des problèmes de données bloquants pour les niveaux précédents. Vous devez répondre aux exigences de tous les niveaux précédents pour passer au niveau suivant.

  2. Patientez 24 heures. Une fois toutes les vérifications des données bloquant les mises à niveau effectuées, il faut environ 24 heures pour entraîner et préparer le modèle, et activer le niveau nouvellement déverrouillé.

Si le niveau de performances n'est pas marqué comme utilisé dans les deux jours suivant la réussite de toutes ses vérifications de données bloquant la mise à niveau, contactez l'assistance Vertex AI Search pour le commerce en indiquant votre numéro et votre ID de projet pour obtenir de l'aide.

Informations supplémentaires sur les exigences concernant les données

Pour en savoir plus sur les exigences concernant les données de Vertex AI Search pour le commerce, consultez la documentation:

Étapes suivantes