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

Cette page décrit des cas d'utilisation de la recherche et leurs niveaux de performances respectifs. Elle explique également comment vérifier la console Search for Retail pour évaluer la qualité de vos données et connaître les niveaux de performances que vous avez débloqués. Il explique comment s'inscrire pour recevoir des alertes sur la qualité des données.

Rechercher des cas d'utilisation

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

  • Requête textuelle : cette fonctionnalité est utilisée lorsque vos clients recherchent des articles dans votre application en saisissant des requêtes textuelles et en obtenant un ensemble de résultats pertinents.
  • Recherche par navigation : option utilisée lorsque les clients accèdent à une page de catégorie spécifique (par exemple, la page Web de la catégorie "Appareils" du site 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

Les requêtes textuelles et la recherche par navigation présentent différents niveaux de performances qui améliorent davantage vos résultats de recherche. Le déverrouillage des niveaux de performances repose sur les données d'événements utilisateur et de catalogue que vous importez dans Vertex AI Search pour le commerce.

Chaque niveau de performances est automatiquement activé lorsque vous remplissez toutes ses exigences concernant les données bloquant les mises à niveau. Vous devez également remplir les conditions 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 également pertinents sont classés en fonction de leur popularité sur votre site
    • Optimisé pour les 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 chaque utilisateur et de la probabilité d'achat du produit en fonction de son activité sur l'ensemble du site.

  • Parcourir le cas d'utilisation de la recherche

    • Popularité: les résultats sont renvoyés uniquement en fonction de leur pertinence par rapport à la catégorie.
    • Optimisé pour les 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 chaque utilisateur et de la probabilité d'achat du produit en fonction de son 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 avez répondu aux exigences concernant les données de chaque niveau.

Vérifier la qualité des données

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

  1. Accédez à la page Qualité des données dans 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 sur le Réseau de Recherche:

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

  3. Consultez le tableau de scores des problèmes pour chaque niveau de performances en haut de la page.

    • Si le libellé est "Utilisé" : vous avez résolu tous les problèmes bloquants pour ce niveau et vous l'avez déverrouillé.
    • S'il n'y a aucun problème bloquant:les vérifications de données pour ce niveau sont satisfaisantes. 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 pour débloquer ce niveau.

  4. Consultez le tableau des métriques de vérification des données de chaque niveau de performances pour afficher la liste des problèmes susceptibles de bloquer les mises à 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 supérieur. Pour débloquer un niveau, effectuez toutes les vérifications de données bloquant la mise à niveau pour ce niveau de performances (et pour ses niveaux précédents).
    • Essentiel pour les performances: identifie les problèmes de données qui n'empêchent pas la mise à niveau, mais qui peuvent avoir un impact significatif sur la recherche textuelle ou la navigation dans les performances de recherche.
    • Conforme: indique que la vérification des données a réussi.
    • Non disponible: indique qu'une vérification des données bloquantes sans mise à niveau n'est pas encore terminée. Les valeurs de ces métriques s'affichent avec la mention N/A. Le calcul de certaines vérifications de données peut prendre jusqu'à 24 heures après l'importation des données.

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

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

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

Pour importer davantage de données afin de résoudre tout problème de données, consultez Importer l'historique des événements utilisateur ou Importer les 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 de personnaliser les résultats de recherche pour l'utilisateur en fonction de ses é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 en différé. 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, n'envoyez pas uniquement des événements attribuables aux recherches.

Désactiver la personnalisation

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

Alertes sur la qualité des données

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

Si vous souhaitez voir les alertes associées à Cloud Monitoring, accédez à Configurer des alertes.

Afficher les informations de qualité des données

Accédez à la page Qualité des données dans 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 sur 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, 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.

Désactiver les alertes sur 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.

Résoudre les problèmes

Voici quelques problèmes courants et comment les résoudre:

Une vérification des données ne réussit pas

Si une vérification des données échoue, cliquez sur Détails de la métrique concernée sur la page Qualité des données pour obtenir une description plus détaillée de cette métrique et des seuils à atteindre pour satisfaire cette vérification.

Si vous remplissez déjà les exigences concernant les données, consultez la section Horodatage 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, le recalcul de cette métrique peut prendre plusieurs heures.

Si vous ne respectez pas les exigences concernant les données, vous devrez peut-être reformater les données ou collecter plus de données pour répondre aux exigences de vérification des données. Après vous être assuré que vos données atteindront le seuil requis, 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 s'affiche comme N/A.

Les valeurs des métriques sont affichées avec la mention "N/A" si aucune donnée n'a été importée ou si les métriques n'ont pas encore été calculées. Après l'importation des données, le calcul de certaines vérifications de données peut prendre jusqu'à 24 heures.

Un niveau de performances ne présente aucun problème bloquant, 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 remplir les conditions de tous les niveaux précédents pour passer au niveau suivant.

  2. Patientez 24 heures. Une fois toutes les vérifications de données bloquant la mise à niveau effectuées, l'entraînement, la préparation du modèle et l'activation du nouveau niveau déverrouillé prennent environ 24 heures.

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

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

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

Étapes suivantes