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. Chaque niveau de performances est automatiquement activé lorsque vous remplissez toutes ses exigences de données bloquant la mise à niveau. Vous devez également répondre aux exigences aux niveaux précédents pour passer au niveau suivant.

Rechercher des cas d'utilisation

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

• Recherche par requête textuelle : utilisée lorsque vos acheteurs recherchent des articles dans votre application en saisissant des requêtes textuelles et obtiennent un ensemble de résultats pertinents.
• Recherche par navigation : utilisée lorsque vos clients accèdent à une page de catégorie spécifique, comme la page Web de la catégorie "Appareils électroménagers" du site Web d'un magasin de bricolage et parcourent les articles triés dans cette catégorie.

Pour en savoir plus sur les différences entre ces cas d'utilisation, consultez la section À 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.

Les niveaux de performances suivants sont disponibles pour les deux cas d'utilisation, la recherche par requête textuelle et la navigation:

Recherche de requête textuelle

Parcourir

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.

Les sections suivantes expliquent comment vous abonner à des alertes de qualité des données qui vous indiquent dans quelle catégorie se trouvent vos données, en fonction de vos paramètres actuels. Ces alertes vous aident également à déterminer les données requises pour votre cas d'utilisation spécifique afin d'optimiser au mieux vos résultats de recherche.

Vérifier la qualité de vos 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 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 afficher les métriques de recherche dans le navigateur, 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é.
   • Si aucun problème bloquant n'est détecté, vous avez satisfait aux 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 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 problèmes pouvant bloquer les mises à niveau de niveau ou affecter les performances de recherche.

5. Dans la colonne État, vérifiez le niveau de priorité de chaque métrique de vérification des données :

   • 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, effectuez toutes les vérifications requises sur les données pouvant empêcher la mise à niveau pour ce niveau de performances (et pour les 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 cette 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. Vérifiez les seuils dans le panneau Details (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. 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 fortement recommandé à atteindre. Ne pas atteindre ce seuil peut avoir un impact négatif important sur des performances.
   • Seuil d'avertissement : seuil recommandé à atteindre. 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 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 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 sur 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

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"
        }
      ]
    }
  ]
}'

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

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": [
      ]
    }
  ]
}'

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
• La valeur d'une métrique s'affiche sous la forme "N/A".
• Un niveau de performances n'est pas marqué comme "En cours d'utilisation", mais ne présente aucun problème de données bloquant

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 grande quantité 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 valeur "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 bloquant la mise à niveau effectuées, il faut environ 24 heures pour entraîner et préparer le modèle, puis activer le niveau nouvellement débloqué.

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:

• Exigences générales de Vertex AI Search pour le commerce lors de l'importation de données d'événement utilisateur: Exigences concernant les événements utilisateur
• Conditions minimales requises pour les événements utilisateur afin d'obtenir des résultats de recherche: Exigences concernant la recherche
• Exigences concernant les données de catalogue: Métriques de qualité des données de catalogue

Étape suivante

• Importer des événements utilisateur historiques
• Importer des informations du catalogue