Changement de nom : le secteur de la vente au détail s'appelle Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

Cette page a été traduite par l'API Cloud Translation.

Saisie semi-automatique pour la recherche

Cette page présente la fonctionnalité de saisie semi-automatique et explique comment l'utiliser. La recherche fournit la saisie semi-automatique pour fournir aux marchands des suggestions de saisie dans le champ de recherche.

La fonctionnalité de saisie semi-automatique permet de prédire le reste d'une requête qu'un utilisateur saisit, ce qui peut améliorer l'expérience de recherche de l'utilisateur et accélérer le processus d'achat avant le règlement. Cela peut également améliorer la qualité des réponses de recherche et ainsi générer des revenus plus élevés en fournissant des requêtes correctement formatées.

Présentation

Lorsqu'un utilisateur final commence à saisir un terme de recherche sur votre site, l'outil de recherche peut fournir une liste de suggestions susceptibles de l'intéresser. Par exemple, "chaussures" et "chemises" peuvent être suggérés lorsque l'utilisateur saisit "sh".

Source de données

Vous pouvez choisir l'une des sources de données suivantes pour vos prédictions de suggestions:

Un ensemble de données BigQuery que vous importez
Ensemble de données généré à partir d'événements utilisateur et d'autres métadonnées à l'aide du machine learning

Ensemble de données importé

Table de suggestions BigQuery que vous importez en tant qu'ensemble de données et qui permet de suggérer des requêtes. Pour savoir comment importer un ensemble de données, consultez la page Importer des données de saisie semi-automatique.

Ensemble de données d'apprentissage automatique

Ensemble de données de suggestions alimenté par le machine learning et généré par une recherche basée sur les événements de recherche des utilisateurs.

Pour activer l'apprentissage automatique:

Console

Accéder à la page "Contrôles"
Accédez à l'onglet Commandes de saisie semi-automatique.
Cliquez sur Modifier les paramètres.
Activez l'apprentissage automatique.
Cliquez sur Enregistrer les paramètres.

L'actualisation de l'apprentissage automatique peut prendre un à deux jours.

cURL

curl -X PATCH -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?update_mask.paths=auto_learning"  --data "{auto_learning: true}"

Prérequis pour l'ensemble de données d'apprentissage automatique

L'apprentissage automatique génère des suggestions à partir des événements utilisateur de type de recherche (eventType = "search"). La génération utilise les événements utilisateur des 180 derniers jours. Elle nécessite une bonne quantité et une bonne quantité d'événements utilisateur importés.

L'apprentissage automatique filtre les suggestions rares. Par conséquent, si la quantité d'événements utilisateur pour le type de recherche est trop faible (moins de 20 000), de nombreuses suggestions peuvent être filtrées. Dans ce scénario, vous pouvez d'abord tester la fonction de saisie semi-automatique avec une requête de recherche plus fréquente.

Calendrier de publication des ensembles de données à apprentissage automatique

L'ensemble de données d'apprentissage automatique est généré quotidiennement, puis envoyé pour l'indexation et la publication. Le cycle complet dure environ deux jours.

Fonctionnalités d'apprentissage automatique

La recherche applique des techniques de machine learning pour nettoyer et formater les requêtes et les données de suggestion, mais uniquement pour un ensemble de données d'apprentissage automatique.

Sélection	Description	Exemple
Supprimer les caractères spéciaux	Supprimez les caractères non standards des données de suggestion et des requêtes saisies. Les caractères standards conservés dans les données de suggestion et dans les requêtes saisies sont les suivants: `%`, `$`, `&` et `.` (point)	"Le meilleur lait du monde #*!" → "le meilleur lait du monde"
Supprimer les recherches sans résultat	Supprimer les requêtes sans résultat de recherche	"Sacs à main Gucci" n'étant associé à aucun résultat de recherche, l'article "Sacs à main Gucci" a été supprimé.
Corriger les fautes de frappe	Corriger l'orthographe des mots correspondant à des fautes de frappe Nettoyer également les requêtes d'entrée en temps réel avant la mise en correspondance	"Milc" → "Lait"
Ajouter des requêtes à la liste d'autorisation	Les requêtes que vous autorisez explicitement sont ajoutées	Consultez la section Plus d'informations ci-dessous.
Supprimer les requêtes de la liste de blocage	Les requêtes que vous bloquez explicitement sont supprimées	Consultez la section Plus d'informations ci-dessous.
Supprimer les termes dangereux	Fourni par Google SafeSearch Supprimer les requêtes inappropriées	Pornographie, contenu pour adultes, vulgaire, violence, etc.
Supprimer les termes très rares	Le système d'IA ajuste la limite en fonction des statistiques des requêtes Si les termes sont inhabituellement rares, ils sont supprimés.	"Matelas pneumatique double couche 74 x 39 x 9 pouces avec pompe portable 120 V"
Dédupliquer les termes	Basé sur la compréhension sémantique basée sur l'IA Pour les termes presque identiques, l'un ou l'autre des termes correspondront, mais seul le plus populaire sera suggéré	"Chaussures pour femmes", "Chaussures pour femmes" et "Chaussures pour femmes" sont dédupliqués. Une seule d'entre elles sera donc suggérée.

Obtenir des suggestions d'achèvement

Utilisez l'API completeQuery pour récupérer les suggestions. Exemple :

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"

Options et commandes de saisie semi-automatique

Cette section décrit les options et les commandes disponibles pour la saisie semi-automatique. Vous trouverez une présentation dans le tableau suivant et plus de détails ci-dessous.

Contrôle	Détails	Emplacement
Liste de refus	Il supprime manuellement les requêtes des données de suggestion.	Requête API: CompletionData:import. Pour en savoir plus, consultez Importer des données de saisie semi-automatique.
Liste d'autorisation	Ajoute manuellement des requêtes aux données de suggestion	Requête API: CompletionData:import (voir aussi Importer des données de saisie semi-automatique )
Longueur minimale pour déclencher la saisie semi-automatique	Contrôle le nombre de caractères avant le déclenchement de la saisie semi-automatique.	Console Cloud > Commandes
Ordre de correspondance	L'ordre de correspondance détermine la façon dont la requête de l'utilisateur et les suggestions sont mises en correspondance.	Console Cloud > Commandes
Nombre de suggestions	Nombre de suggestions qui seront renvoyées par la saisie semi-automatique	Console Cloud > Commandes ou Requête API: completeQuery.maxSuggestions
Type d'appareil	Lorsque des types d'appareils sont spécifiés, les suggestions sont générées en fonction de leur popularité. Si vous ne spécifiez pas cet élément, vous obtenez des suggestions basées sur la popularité combinée de tous les types d'appareils	Requête API: completeQuery.deviceType
Source de données de la suggestion	Si vous avez à la fois généré et importé des sources de données, vous pouvez choisir celle à utiliser au moment de la requête	Requête API: completeQuery.dataset
Langue	Vous pouvez spécifier la ou les langues dans lesquelles vous souhaitez obtenir des suggestions.	Requête API: completeQuery.languageCodes[]

Liste d'autorisation (liste Ne pas supprimer)

La recherche effectue un post-traitement sur les données de suggestion de saisie semi-automatique, comme la correction orthographique. Vous pouvez créer une liste d'autorisation de termes que la recherche ignore lors du post-traitement.

Les termes de la liste d'autorisation ne sont jamais exclus des suggestions. Cette liste d'autorisation fonctionne à la fois pour les ensembles de données importés et pour les ensembles de données d'apprentissage automatique.

Exemples : Il existe des noms de marque intentionnellement mal orthographiés, tels que "froot loops" au lieu de "fruit" ou "foot". Consultez les instructions d'importation détaillées dans Importer des données de saisie.

Pour importer des données, vous pouvez utiliser la console Cloud > Commandes > Commandes de saisie semi-automatique > Ne pas supprimer la liste ou utiliser CompletionData:import.

Les modifications prendront effet dans un délai d'environ deux jours.

Liste de refus

La liste de blocage ne fonctionne que pour les ensembles de données à apprentissage automatique. La liste de blocage ne fonctionne pas pour les ensembles de données importés.

Les termes d'une liste de blocage n'apparaissent jamais dans les suggestions.

Pour importer une liste de blocage, vous pouvez accéder à la console Cloud > Commandes > Commandes de saisie semi-automatique > Liste de refus ou utiliser l'API CompletionData:import. Pour obtenir des instructions détaillées sur l'importation d'une liste de blocage, consultez la section Importer des données de saisie semi-automatique.

Les modifications prendront effet dans un délai d'environ deux jours.

Longueur minimale de déclenchement

Vous pouvez définir le nombre de caractères requis pour que les requêtes de saisie semi-automatique renvoient des résultats. Vous trouverez ce paramètre dans la console Cloud > Commandes > Commandes de saisie semi-automatique > Longueur minimale de déclenchement.

Les modifications prennent effet immédiatement.

Ordre de correspondance

Ce paramètre détermine comment mettre en correspondance les suggestions avec les termes saisis par l'utilisateur.

Lorsque ce paramètre est défini sur "La suggestion commence par le terme", la saisie semi-automatique met en correspondance le terme saisi par l'utilisateur en tant que préfixe exact des suggestions. Par exemple, l'entrée utilisateur "sh" correspond aux suggestions "chaussures" et "chemises", mais pas à la suggestion "chaussures rouges".

Lorsque ce paramètre est défini sur "La suggestion peut commencer à partir de n'importe quelle partie du terme", la saisie semi-automatique tokenise le terme saisi par l'utilisateur en mots et le met en correspondance avec ceux des suggestions, quel que soit l'ordre des mots. Par exemple, le terme saisi par l'utilisateur "rouge ch" correspond aux suggestions "chemises rouges", "chaussures rouges" et "chaussures rouges enfant". Toutefois, le terme d'entrée "hoes" ne correspond pas à ces suggestions, car aucun mot des suggestions ne commence par "hoes".

Vous trouverez ce paramètre dans la console Cloud > Commandes > Commandes de saisie semi-automatique > Ordre de correspondance.

Les modifications prennent effet immédiatement.

Nombre de suggestions

Il s'agit du nombre de suggestions qui seront renvoyées par les requêtes de saisie semi-automatique. Il ne peut pas dépasser 20. Vous trouverez ce paramètre dans la console Cloud > Commandes > Commandes de saisie semi-automatique > Nombre de suggestions ou dans completeQuery.

Les modifications prennent effet immédiatement.

Type d'appareil

La saisie semi-automatique de la recherche est compatible avec différents types d'appareils, tels que MOBILE et DESKTOP. Vous pouvez importer ou obtenir différentes suggestions en fonction des types d'appareils. Si deviceType n'est pas spécifié dans completeQuery, la suggestion s'applique à tous les types d'appareils.

Pour un ensemble de données d'apprentissage automatique basé sur la recherche d'événements utilisateur, définissez user_agent dans UserEvent.user_info pour prendre en charge différents types d'appareils. Voir agent utilisateur dans le wiki.

Fonctionnalités avancées

Cette section décrit les fonctionnalités de saisie semi-automatique avancées disponibles avec la recherche. Par exemple, vous pouvez compléter les suggestions de saisie semi-automatique des requêtes par d'autres suggestions, telles que des marques et des catégories.

Ces fonctionnalités avancées ne sont disponibles que pour les ensembles de données à apprentissage automatique.

Suggestion d'ensemble de fonctionnalités

Nous fournissons un ensemble de fonctionnalités supplémentaire pour chaque terme de suggestion de requête afin de permettre aux clients d'afficher des fonctions avancées sur leurs sites Web.

Le jeu de caractéristiques apparaît dans la réponse sous la forme d'un mappage clé-valeur. Actuellement, Vertex AI Search pour le commerce renvoie jusqu'à cinq catégories et marques populaires associées à chaque suggestion de requête dans la réponse de l'API completeQuery.completionResults.attributes. Les suggestions d'ensembles de caractéristiques ne doivent pas nécessairement correspondre aux chaînes de requête saisies par l'utilisateur final.

Vous pouvez utiliser FeatureSet dans la réponse pour enrichir les suggestions de recherche. Exemple :

Agrégez et créez les sections "Marques populaires" et "Catégories populaires" qui s'affichent sous la liste des suggestions de recherche.
Affichez la marque ou la catégorie la plus populaire à côté des suggestions de recherche.

Après avoir modifié le catalogue, par exemple en changeant les catégories de produits, attendez de deux semaines à 30 jours que les suggestions d'ensembles de fonctionnalités reflètent les modifications apportées au catalogue de produits. Ce délai d'attente est dû au fait que l'apprentissage automatique s'entraîne sur les 30 derniers jours de données d'événements de recherche.

Suggestions d'attributs

La recherche fournit des suggestions d'attributs qui correspondent aux chaînes d'entrée utilisateur. Les types de suggestions d'attributs compatibles sont les marques et les catégories.

Les suggestions d'attributs diffèrent d'un FeatureSet de suggestion. Les suggestions d'attributs sont des listes d'attributs de produits suggérés (comme les marques et les catégories), de la même manière que les suggestions de requête sont des listes de requêtes suggérées. Les suggestions d'attributs peuvent être utilisées indépendamment des suggestions de requête. Un FeatureSet de suggestion est une métadonnée de suggestion de requête. Il dépend donc des suggestions de requête.

Les suggestions d'attributs permettent de compléter automatiquement les marques ou les catégories saisies par l'utilisateur final dans des sections distinctes sous la liste de suggestions de recherche.

Attribut de suggestion avec le nombre de produits (expérimental)

Cette fonctionnalité est expérimentale et réservée à un nombre limité de clients. Pour l'utiliser, contactez l'équipe d'assistance.

Lorsque l'attribut de suggestion avec la fonctionnalité de nombre de produits est activé, le completeQuery.completionResults renvoyé fournit une liste de suggestions de saisie semi-automatique comme d'habitude, mais le nombre total de produits pour chaque suggestion ainsi que le nombre total de produits et le nombre de produits par attribut (comme "couleur" ou "catégorie") sont également générés.

Par exemple, si la requête de recherche est "chaussure", les suggestions de saisie semi-automatique renvoyées pourraient se présenter comme suit:

chaussures femme
chaussures pour hommes

De plus, si la clé d'attribut qui vous intéresse est "color", un nombre de produits et un nombre de produits par couleur sont également renvoyés avec chaque suggestion de saisie semi-automatique:

chaussures pour femmes (32)
- noir (10)
- taupe (16)
- blanc (10)
chaussures pour hommes (43)
- noir (10)
- marron (5)
- vert (17)

En tant que marchand, vous n'avez pas besoin de présenter le nombre de produits à l'acheteur, mais vous pouvez décider de classer la liste des suggestions en fonction du nombre de produits au lieu de la commande retournée dans completeQuery.completionResults. Par exemple, vous pouvez encourager les acheteurs à regarder les chaussures vertes pour hommes en les faisant apparaître en haut de la boîte à suggestions, même s'il ne s'agit pas de l'article le plus populaire.

Exemple :

{
  "completion_results": [{ 
    "suggestion": "womens shoes"
    "facets": [ 
      {
        "key": "color"
        "values": [ 
          {
            "value": "black"
            "count": 10
          }
          {
            "value": "taupe"
            "count": 16
          }
          {
            "value": "white"
            "count": 10
          }
        ]
      }
    ]
    "total_product_count": 32
  },
  (...)
  ],
}

Les informations sur le nombre d'attributs s'affichent sous la forme d'une liste de Facets dans completeQuery.completionResults.facets pour chaque requête de recherche suggérée. Chaque attribut possède une liste FacetValues qui contient le nombre de produits par valeur d'attribut. Le nombre total de produits pour chaque requête de recherche suggérée est renvoyé dans completeQuery.completionResults.totalProductCount.

Pour activer et utiliser les attributs de suggestion avec le nombre de produits, procédez comme suit:

Contactez l'équipe d'assistance et demandez-lui d'activer la fonctionnalité "Attribut de suggestion avec le nombre de produits". Spécifiez les FacetKeys pour lesquelles vous souhaitez obtenir le nombre de produits. Seuls textual_fields attributs sont autorisés.
Pendant au moins sept jours, assurez-vous que, lorsque vous utilisez l'API search, incluez la clé d'attribut dans FacetSpecs et incluez la clé d'attribut dans search.searchRequest.facetSpecs.

Ce délai d'attente est dû au fait que les informations sur les attributs sont calculées à l'aide des données de l'historique des recherches de la semaine précédente.
Une fois la fonctionnalité activée, les suggestions renvoyées par l'API completeQuery contiennent le nombre de produits par attribut et par suggestion.

Suggestion filtrée par entité

Les entités vous permettent de filtrer les suggestions de recherche via la saisie semi-automatique. Une entité peut être un site Web pour une marque ou une région différente. Vous souhaitez que la saisie semi-automatique reflète au mieux le comportement des utilisateurs qui achètent cette marque spécifique ou ce site Web régional. Pour en savoir plus sur les entités, consultez la section Entités.

Pour inclure des entités dans les suggestions de saisie semi-automatique:

Incluez le champ entity dans les événements utilisateur de votre recherche (eventType = "search"). Pour en savoir plus, consultez l'exemple d'objet complet pour l'événement utilisateur Search.
Définissez le champ entity dans votre requête API CompleteQuery pour obtenir des suggestions uniquement pour cette entité.

La chaîne d'entité dans les événements utilisateur et les requêtes API doit être une correspondance exacte. Sinon, la saisie semi-automatique renvoie des suggestions vides.

En règle générale, il faut 30 à 90 jours de données d'événements utilisateur pour que la fonctionnalité d'entité puisse renvoyer des suggestions de saisie semi-automatique optimales.