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 et les niveaux de performances, et comment accéder à la console Search for Retail de la qualité de vos données et des niveaux de performances obtenus. Il explique comment s'inscrire pour recevoir des alertes sur la qualité des données.

Rechercher des cas d'utilisation

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

  • La recherche de requête textuelle, qui est utilisée lorsque vos clients recherchent des articles sur votre en saisissant des requêtes textuelles et en obtenant un ensemble de résultats pertinents.
  • Rechercher sur les pages de résultats : cette fonctionnalité est utilisée lorsque vos clients accèdent à une catégorie spécifique. telle que la page "Appareils" page Web de catégorie pour des travaux d'intérieur site de vente en ligne du magasin et parcourir 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 des niveaux de performances différents : améliorer de plus en plus vos résultats de recherche. Pour accéder aux niveaux de performances, les données d'événement utilisateur et de catalogue que vous importez dans Vertex AI Search pour le commerce.

Chaque niveau de performances est automatiquement activé lorsque vous remplissez tous les critères et les blocages de mise à niveau. Vous devez également répondre aux exigences aux 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 au requête. Les produits pertinents sont classés en fonction de la popularité du produit sur votre site
    • Optimisation des revenus: les résultats pertinents sont classés en fonction Probabilité d'achat en fonction de l'activité sur l'ensemble du site
    • Personnalisées et optimisées pour les revenus: les résultats pertinents sont classés en fonction les préférences de l'utilisateur individuel et la probabilité que le produit soit acheté 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 Probabilité d'achat en fonction de l'activité sur l'ensemble du site
    • Personnalisées et optimisées pour les revenus: les résultats pertinents sont classés en fonction les préférences de l'utilisateur individuel et la probabilité que le produit soit acheté en fonction de l'activité sur l'ensemble du site

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

Vérifier la qualité de vos données

Une fois vos données importées, accédez à la console Search for Retail pour les consulter Vérifiez les métriques de 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 rempli tous les critères de blocage. de niveau et que vous l'avez déverrouillé.
    • S'il n'y a aucun problème bloquant:vous êtes satisfait 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 et la préparation des et activer le niveau nouvellement débloqué.
    • En cas de problèmes bloquants:vérifiez les métriques de ce niveau. pour voir les problèmes de données à résoudre pour débloquer ce niveau.

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

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

    • Blocage des mises à niveau: identifie les problèmes de données qui empêchent en remplaçant votre cas d'utilisation par niveau de performances. Pour débloquer un niveau, remplissez toutes les données sur le blocage des mises à niveau vérifie ce niveau de performances (et ceux des niveaux précédents).
    • Essentiel pour les performances: identifie les problèmes de données qui n'affectent pas bloquer une mise à jour, mais peuvent avoir un impact significatif sur la recherche textuelle ou parcourir les performances de la recherche.
    • Conforme: indique que la vérification des données a réussi.
    • Indisponible: indique qu'une donnée bloquante en dehors d'une mise à niveau vérification n'est pas encore terminée. Les valeurs de ces métriques s'affichent sous la forme N/A Après l'importation des données, il peut s'écouler jusqu'à 24 heures avant que certaines vérifications des données.

  6. Pour en savoir plus sur une métrique, cliquez sur Détails afin de consulter qui affiche la description de la métrique, le code temporel de la vérification des données valeurs de seuil.

  7. Consultez 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. Il est possible que s'appliquent à toutes les métriques:

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

Pour importer davantage de données afin de résoudre d'éventuels problèmes de données, consultez Importer les événements utilisateur historiques ou Importer les informations du catalogue dans la documentation publique.

Bonnes pratiques

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

Désactiver la personnalisation

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

Alertes concernant la qualité des données

Les alertes relatives à 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 la vérification des données échoue, cliquez sur Détails pour cette métrique dans le panneau Données "Qualité" pour obtenir une description plus détaillée de cette métrique et de la et les seuils à atteindre pour répondre à cette vérification des données.

Si vous avez déjà rempli les exigences concernant les données, consultez la section Timestamp de 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 la métrique.

Si vous ne respectez pas les exigences concernant les données, vous devrez peut-être les reformater ou collecter plus de données pour répondre aux exigences de vérification des données. Après vous être assuré vos données atteindront le seuil de métrique, réimportez vos données reformatées ou importez vos 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 sont affichées avec la valeur "N/A" si aucune donnée n'a été importée ou si la les métriques ne sont pas encore calculées. L'opération peut prendre jusqu'à 24 heures après l'importation des données dans et effectuer des vérifications de données.

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 qui bloquent la mise à niveau vers le cloud, environ 24 heures pour entraîner, préparer et activer le modèle à un niveau supérieur.

Si le niveau de performances n'est pas marqué comme "En cours d'utilisation" dans les deux jours suivant la réussite ses vérifications des données bloquant la mise à niveau, contactez l'assistance Vertex AI Search pour 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:

Étape suivante