Qualité des données

Cette page décrit les cas d'utilisation de la recherche, leurs niveaux de performances respectifs et comment consulter la console Retail Search pour évaluer la qualité de vos données et les niveaux de performances que vous avez débloqués. Chaque niveau de performances est automatiquement activé lorsque vous remplissez toutes ses exigences de données bloquant la mise à niveau. Vous devez également remplir les conditions requises pour tous les niveaux précédents pour passer au niveau suivant.

Rechercher des cas d'utilisation

La recherche fournit des résultats de recherche 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.

Débloquer les niveaux de performances de recherche

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. Pour débloquer les niveaux de performances, vous devez importer les données d'événement utilisateur et de catalogue dans Vertex AI Search pour le commerce.

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

Recherche de requêtes textuelles

NIVEAU 1

Pertinence:

  • Les résultats sont renvoyés en fonction de leur pertinence par rapport à la requête, par exemple à quel point une robe est noire lorsque vous recherchez une robe noire.

Exigences minimales concernant les données:

  • Catalogue
  • Requête

NIVEAU 2

Pertinence et popularité:

  • affine le niveau 1 pour les éléments les plus populaires de la recherche effectuée.
  • Les produits tout aussi pertinents sont classés en fonction de leur popularité sur votre site.

Exigences minimales en termes de données: données sur les clics

NIVEAU 3

Classement optimisé pour les revenus: les résultats pertinents sont classés en fonction de la probabilité que le produit soit acheté en fonction d'une activité spécifique sur l'ensemble du site.

Exigences minimales concernant les données: un grand volume d'événements utilisateur.

NIVEAU 4

Classement personnalisé optimisé pour les revenus:

  • Les résultats pertinents sont classés en fonction des préférences de l'utilisateur et de la probabilité que le produit soit acheté en fonction de son activité sur l'ensemble du site.
  • Les produits sont classés en fonction de la "qualité de la correspondance" avec l'utilisateur unique qui recherche ou parcourt le site.

Exigences minimales concernant les données:

  • Un grand volume d'événements utilisateur.
  • Correspondance avec visitorID et/ou userId, formatée de manière cohérente pour tous les événements utilisateur.

Parcourir

BRONZE

Résultats aléatoires

  • Tous les résultats de recherche correspondant à vos filtres, dans un ordre aléatoire.

SILVER

Popularité

  • Les résultats sont renvoyés uniquement en fonction de leur pertinence par rapport à la catégorie.

OR

Classement 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.

PLATINUM

Classement personnalisé optimisé pour les revenus

  • Les résultats pertinents sont classés en fonction des préférences de l'utilisateur et de la probabilité que le produit soit acheté en fonction de l'activité sur l'ensemble du site.

La console Search for Retail propose une page Qualité des données sur laquelle vous pouvez vérifier si vous avez respecté les exigences de 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 dans la console de la recherche pour le commerce.

    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 recherche:

    • Pour les métriques de recherche textuelle, cliquez sur l'onglet Recherche.
    • 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 de chaque niveau de performances en haut de la page.

    • Si l'état est "Utilisé", cela signifie que vous avez résolu tous les problèmes bloquants pour ce niveau et que vous l'avez déverrouillé.
    • Si aucun problème de blocage n'est détecté, vous avez satisfait aux vérifications des données pour ce niveau. S'il n'y a aucun problème de blocage pour ce niveau et tous les niveaux précédents, il faut environ 24 heures pour entraîner et préparer le modèle, puis activer le niveau nouvellement débloqué.
    • En cas de problème bloquant, 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 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 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 requises sur les données pouvant empêcher la mise à niveau pour ce niveau de performances (et pour les niveaux précédents).
    • Critique 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 les performances de la recherche textuelle ou de la recherche par navigation.
    • Conforme: indique que cette vérification des données a réussi.
    • Indisponible: indique qu'une vérification des données bloquantes pour la non-migration n'est pas encore terminée. Les valeurs de ces métriques s'affichent sous la forme N/A. Le calcul de certaines vérifications 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 afin d'afficher un panneau qui présente la description, le code temporel de vérification des données et les valeurs de seuil de cette métrique.

  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. Tous les seuils ne s'appliquent pas à toutes les métriques:

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

Pour importer davantage de données afin de résoudre les problèmes de données, consultez les pages Importer un historique d'événements utilisateur ou Importer des informations de 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 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 différents appareils.
  • Envoyez les événements utilisateur en temps réel plutôt que de les importer de manière groupée avec un délai. Cela permet de personnaliser les résultats de 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 les événements attribuables aux recherches.

Sélection de fonctionnalités pour les niveaux supérieurs optimisés pour les revenus

Vertex AI Search pour le commerce a été mis à niveau pour les marchands dont les données ont atteint les niveaux de performances les plus élevés, ce qui leur permet de profiter de fonctionnalités de recherche optimisées pour les revenus. Ces marchands peuvent désormais utiliser la sélection de fonctionnalités:

  • Pour la navigation: ARGENT et OR
  • Pour la recherche: niveaux 3 et 4

Pourquoi cette mise à niveau du classement ?

Les grands clients du commerce de détail peuvent inclure jusqu'à 10 000 attributs personnalisés dans leur catalogue de produits, alors que le modèle de classement ne comportait auparavant que 20 caractéristiques de produit statiques (telles que le prix et la note moyenne) partagées par tous les clients. Par conséquent, le modèle de classement disposait de données produit très incomplètes et ne pouvait pas personnaliser les caractéristiques des produits en fonction de différents domaines et cas d'utilisation du commerce, comme la mode, le matériel ou les articles pour la maison.

L'impossibilité de modéliser des attributs personnalisés a conduit certains utilisateurs à placer les attributs qu'ils considéraient comme importants dans les fonctionnalités de produit statiques (fixes). Cependant, cette opération nécessitait un effort manuel et ne fonctionnait clairement que pour un petit nombre d'attributs.

Sélection de fonctionnalités personnalisées dynamiques

Vertex AI Search pour le commerce a mis à niveau ses niveaux optimisés pour les revenus afin de sélectionner automatiquement les attributs personnalisés. La mise à niveau implique d'intégrer des attributs personnalisés pertinents au processus de classement:

  • Examine tous les attributs personnalisés de chaque marchand et choisit les plus utiles à ajouter à l'ensemble de fonctionnalités de produits statiques.
  • Affiche les attributs sélectionnés pour chaque marchand.
  • Répète le processus de sélection des fonctionnalités régulièrement (une fois tous les 30 jours).

En résumé, Vertex AI Search pour le commerce permet au modèle de classement d'accéder à plus de 100 nouvelles fonctionnalités potentielles à sélectionner pour le modèle. De plus, les attributs de chaque client sont actualisés régulièrement pour s'adapter aux ventes saisonnières et à d'autres modifications de données dynamiques.

La nouvelle solution de classement fournit des insights de recherche plus performants, en utilisant des attributs personnalisés régulièrement mis à jour pour améliorer la qualité des données.

Connaissances complètes sur les produits

  • Sélection de caractéristiques: l'algorithme Vertex AI Search pour le commerce sélectionne jusqu'à 20 attributs personnalisés les plus importants pour chaque marchand.
  • Avantages:améliorez la précision des classements en utilisant des informations supplémentaires sur les produits, comme les codes de réduction, les spécifications des produits ou des styles.
  • Visibilité: les marchands peuvent consulter les attributs personnalisés sélectionnés et s'assurer qu'ils sont gérés et à jour.
  • Personnalisation et apprentissage: les clients peuvent identifier des tendances dans les attributs personnalisés sélectionnés et en ajouter d'autres pertinents pour améliorer encore les performances de classement.

Afficher les attributs utilisés

Si un client a activé les niveaux supérieurs et dispose de suffisamment de données sur les événements utilisateur, les nouvelles informations sur les attributs personnalisés sont désormais visibles dans la console, sous l'onglet Recherche textuelle et/ou Recherche par navigation de la page Qualité des données de la recherche pour le commerce. Il indique ici les attributs personnalisés choisis par le système Vertex AI Search pour le commerce.

Texte alternatif

Que faire des attributs personnalisés ?

  • Conservez les attributs choisis, et ne les supprimez ni ne les abandonnez, car cela pourrait affecter le modèle.
  • Améliorez la couverture des attributs sélectionnés automatiquement en remplissant ces champs pour plus de produits.
  • Examinez les tendances selon lesquelles les attributs personnalisés sont sélectionnés automatiquement. Si vous avez d'autres attributs similaires, ajoutez-les à votre catalogue. Ils seront ensuite sélectionnés par l'algorithme de recherche de fonctionnalités.
  • Annotez correctement les attributs numériques en leur attribuant des valeurs numériques plutôt que des valeurs de chaîne. Par exemple, indiquez la valeur numérique 10.5 au lieu du texte ("10, 5").

Désactiver la personnalisation

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

Alertes de qualité des données

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

Pour afficher les alertes liées à Cloud Monitoring, accédez à Configurer des alertes.

Afficher les informations de qualité des données

  1. Accédez à la page Qualité des données dans la console de la recherche pour le commerce.

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

  2. Examinez les lignes, les métriques et les alertes: une ligne correspond à une métrique, et une métrique à une alerte.

Configurer des alertes de 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 abonner pour recevoir les alertes. Ils doivent être conformes à SMTP. Vous ne pouvez pas ajouter plus de 20 adresses e-mail à une règle d'alerte.

Console

  1. Accédez à la page Qualité des données dans la console de la recherche pour le commerce.

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

  2. En haut de la page, cliquez sur  Configurer les alertes.

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

  4. Cliquez sur Envoyer.

Désactiver les alertes de 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 dans la console de la recherche pour le commerce.

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

  2. Cliquez sur  Configurer les alertes.

  3. Supprimez tous les e-mails existants.

  4. Cliquez sur Envoyer.

Résoudre les problèmes

Voici comment résoudre les problèmes courants suivants.

La 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'obtenir une description plus détaillée de cette métrique et des seuils à respecter pour réussir cette vérification des données.

Si vous avez déjà rempli les exigences concernant les données, consultez la section Code temporel pour savoir quand cette métrique a été calculée pour la dernière fois. Si vous avez récemment reformaté ou ingéré une quantité importante de données, le calcul de cette métrique peut prendre plusieurs heures.

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

Valeur d'une métrique libellée "N/A"

Les valeurs des métriques sont affichées sous la forme "N/A" si aucune donnée n'a été importée ou si les métriques ne sont pas encore calculées. Le calcul de certaines vérifications peut prendre jusqu'à 24 heures après l'importation des données.

Le niveau de performances ne présente aucun problème de blocage, 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 utilisé dans les deux jours suivant la réussite de toutes les vérifications des 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.

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

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

Étape suivante