Saisie semi-automatique pour la recherche

Cette page présente la fonctionnalité de saisie semi-automatique et explique son utilisation. La recherche fournit une saisie semi-automatique pour optimiser les suggestions du champ de recherche.

La saisie semi-automatique est une fonctionnalité permettant de prédire la fin d'une requête saisie par un utilisateur, ce qui améliore l'expérience de recherche des utilisateurs et accélère le processus d'achat avant le paiement. Elle peut également améliorer la qualité de la réponse de recherche et ainsi générer des revenus plus élevés en fournissant des requêtes bien formatées.

Présentation

Lorsqu'un utilisateur final commence à saisir un terme de recherche sur votre site, la recherche peut fournir une liste de suggestions susceptibles de l'intéresser. Par exemple, les termes shoes (chaussures) ou shirts (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.
• Un 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 est utilisée pour suggérer des requêtes. Pour savoir comment importer un ensemble de données, consultez Importer des données de saisie semi-automatique.

Ensemble de données d'apprentissage automatique

Ensemble de données de suggestions basé sur le machine learning généré par la recherche en fonction des événements de recherche des utilisateurs.

Pour activer l'apprentissage automatique :

console Cloud

1. Accédez à la page "Contrôles".

2. Accédez à l'onglet Commandes de saisie semi-automatique.

3. Cliquez sur Modifier les paramètres.

4. Activez l'apprentissage automatique.

5. Cliquez sur Enregistrer les paramètres.

   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 d'événements utilisateur de type recherche (eventType = "search"). La génération utilise les 180 derniers jours d'événements utilisateur. Elle nécessite une bonne qualité 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 de type recherche est trop faible (moins de 20 000), de nombreux candidats de suggestions peuvent être filtrés. Dans ce cas, vous pouvez d'abord tester la fonction de saisie semi-automatique avec une requête de recherche plus fréquente.

Calendrier de publication de l'ensemble de données d'apprentissage automatique

L'ensemble de données d'apprentissage automatique est généré quotidiennement, puis envoyé à 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 mettre en forme les requêtes et les données de suggestions uniquement pour l'ensemble de données d'apprentissage automatique.

Fonctionnalité	Description	Exemple
Supprimer les recherches sans résultat	Supprimez les requêtes qui ne renvoient aucun résultat de recherche.	Pour un détaillant de produits d'épicerie, Gucci handbags (sacs à main Gucci) ne renvoie aucun résultat de recherche. Il est donc supprimé.
Corriger les fautes de frappe	Corrigez l'orthographe des mots qui contiennent des fautes de frappe. Nettoyez également les requêtes d'entrée en temps réel avant de les faire correspondre.	Milc → Milk (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".
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".
Supprimer les termes non sécurisés	Utilise la recherche sécurisée Google. Supprimez les requêtes inappropriées.	Contenu pornographique, suggestif, vulgaire ou violent
Supprimer les termes très rares	Le système d'IA ajuste le seuil en fonction des statistiques de requête. Si les termes sont inhabituellement rares, ils sont supprimés.	74x39x9 inches 2 layer twin air mattress with 120V handheld pump. (Matelas pneumatique double à deux couches de 74 x 39 x 9 pouces avec pompe manuelle de 120 V)
Dédupliquer les termes	Basé sur la compréhension sémantique basée sur l'IA Pour les termes presque identiques, les deux termes correspondent, mais seul le plus populaire est suggéré.	Shoes for women, womens shoes (chaussures pour femmes) et womans shoes (chaussures pour femmes) sont dédupliqués. Par conséquent, un seul sera suggéré.

Obtenir des suggestions de saisie

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"

Implémenter le filtrage sur les résultats de suggestions

Lorsque vous utilisez l'ensemble de données cloud-retail, Agent Platform Search for commerce peut renvoyer des attributs correspondants, tels que des marques et des catégories populaires, ainsi que les suggestions de texte standards. Vous pouvez utiliser ces attributeResults pour enrichir votre interface utilisateur de saisie semi-automatique et permettre aux utilisateurs de sélectionner un chemin de recherche préfiltré.

Par exemple, si un utilisateur saisit sho, vous pouvez afficher la suggestion de requête shoe à côté d'une suggestion de filtre catégorisée telle que in Nike ou in Women's Shoes.

Exemple de réponse de saisie semi-automatique avec des attributs filtrables

{
  "completionResults": [
    {
      "suggestion": "shoe",
      "attributes": {}
    }
  ],
  "attributeResults": {
    "brands": {
      "suggestions": ["Nike", "Adidas"]
    },
    "categories": {
      "suggestions": ["Shoes", "Women's Shoes"]
    }
  }
}

Lorsqu'un utilisateur sélectionne l'une de ces suggestions enrichies par des attributs (par exemple, shoe in Nike), votre application doit capturer à la fois la requête (shoe) et l'attribut (Nike) à appliquer en tant que filtre dans l'appel suivant à l'API Search principale.

• (Facultatif) Filtrer les suggestions elles-mêmes : si vous devez filtrer ou bloquer complètement l'affichage de certaines expressions dans les résultats de vos suggestions de saisie semi-automatique, vous pouvez importer un ensemble de données denylist. Cela vous permet d'appliquer un opérateur EXACT_MATCH ou CONTAINS pour empêcher que des expressions indésirables ne soient suggérées à l'utilisateur.

Options et commandes de saisie semi-automatique

Cette section explique les options et commandes disponibles pour la saisie semi-automatique. Consultez la présentation dans le tableau suivant et plus de détails.

Contrôle	Détails	Emplacement
Liste de blocage	Supprime manuellement les requêtes des données de suggestions.	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 suggestions.	Requête API : CompletionData:import (consultez également 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.	Google Cloud Console > Contrôles
Ordre de correspondance	L'ordre de correspondance détermine comment la requête et les suggestions de l'utilisateur sont mises en correspondance.	Google Cloud Console > Contrôles
Nombre de suggestions	Il s'agit du nombre de suggestions qui seront renvoyées par la saisie semi-automatique.	Google Cloud Console > Contrôles 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 basées sur la popularité des types d'appareils donnés. Si vous ne spécifiez pas cette option, les suggestions sont renvoyées en fonction de la popularité combinée de tous les types d'appareils.	Requête API : completeQuery.deviceType
Source de données de suggestions	Si vous disposez de sources de données générées automatiquement et importé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 les suggestions s'affichent.	Requête API : completeQuery.languageCodes[]

Liste d'autorisation (liste "Ne pas supprimer")

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

Les termes autorisés ne sont jamais exclus des suggestions. La liste d'autorisation fonctionne à la fois pour les ensembles de données importés et l'ensemble 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 l'importation de données, vous pouvez utiliser Google Cloud console > Contrôles > Commandes de saisie semi-automatique > Liste "Ne pas supprimer" ou utiliser CompletionData:import dans l'API.

Les modifications prennent effet dans environ deux jours.

Liste de blocage

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

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

Pour importer une liste de blocage, vous pouvez utiliser Google Cloud Console > Contrôles > Commandes de saisie semi-automatique > Liste de blocage ou utiliser l'API CompletionData:import. Pour obtenir des instructions détaillées sur l'importation d'une liste de blocage, consultez Importer des données de saisie.

Les modifications prennent effet dans environ deux jours.

Longueur minimale de déclenchement

Vous pouvez définir le nombre de caractères requis avant que les requêtes avec saisie semi-automatique renvoient des résultats. Ce paramètre se trouve dans Google Cloud Console > Contrôles > Commandes de saisie semi-automatique > Longueur minimale de déclenchement.

Les modifications prennent effet immédiatement.

Ordre de correspondance

Cela détermine comment faire correspondre les suggestions avec les entrées utilisateur.

Lorsque l'option La suggestion commence par le terme est définie, la saisie semi-automatique fait correspondre le terme saisi par l'utilisateur en tant que préfixe exact aux suggestions. Par exemple, l'entrée utilisateur "sh" correspond aux suggestions "shoes" (chaussures) et "shirts" (chemises), mais pas à la suggestion "red shoes" (chaussures rouges).

Lorsque l'option La suggestion peut commencer n'importe où dans le terme est définie, la saisie semi-automatique divise l'entrée utilisateur en mots et la fait correspondre aux mots des suggestions, quel que soit l'ordre des mots. Par exemple, l'entrée utilisateur "red sh" correspond aux suggestions "shirts red" (chemises rouges), "red shoes" (chaussures rouges) et "kid red shoes" (chaussures rouges pour enfants). Toutefois, le terme saisi "hoes" ne correspond pas à ces suggestions, car aucun des mots des suggestions ne commence par "hoes".

Ce paramètre se trouve dans Google Cloud Console > Contrôles > 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 avec saisie semi-automatique. Il ne peut pas dépasser 20. Ce paramètre se trouve dans Google Cloud Console > Contrôles > Commandes de saisie semi-automatique > Nombre de suggestions ou peut être défini dans completeQuery.

Les modifications prennent effet immédiatement.

Type d'appareil

La saisie semi-automatique dans la recherche accepte 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 concerne tous les types d'appareils.

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

Fonctionnalités avancées

Cette section décrit les fonctionnalités avancées de saisie semi-automatique disponibles avec la recherche. Par exemple, vous pouvez compléter les suggestions de saisie semi-automatique des requêtes avec 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 d'apprentissage automatique.

Suggestion FeatureSet

Nous fournissons un FeatureSet 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 FeatureSet apparaît dans la réponse sous forme de mappage clé-valeur. Agent Platform Search for commerce renvoie jusqu'à cinq catégories et marques populaires associées à chaque suggestion de requête dans la completeQuery.completionResults.attributes réponse de l'API. Les suggestions de FeatureSet ne doivent pas nécessairement correspondre aux chaînes de requête saisies par l'utilisateur final.

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

• Agrégez et créez des 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 termes de suggestion de recherche.

Après avoir apporté des modifications au catalogue, par exemple en modifiant les catégories de produits, prévoyez un délai de deux semaines à 30 jours avant que les suggestions de FeatureSet ne reflètent les modifications apportées au catalogue de produits. Ce délai est dû au fait que l'apprentissage automatique s'entraîne sur les données d'événements de recherche des 30 derniers jours.

Suggestions d'attributs

La recherche fournit des suggestions d'attributs qui correspondent aux chaînes saisies par l'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 suggestions. Les suggestions d'attributs sont des listes d'attributs de produits suggérés (tels que les marques et les catégories), de la même manière que les suggestions de requêtes sont des listes de requêtes suggérées. Les suggestions d'attributs peuvent être utilisées indépendamment des suggestions de requêtes. Un FeatureSet de suggestions est une métadonnée pour une suggestion de requête. Il dépend donc des suggestions de requêtes.

Pour activer les suggestions d'attributs, corrigez completionConfig en définissant enableAttributeSuggestions sur "true".

cURL

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?updateMask=enable_attribute_suggestions" \
-d '{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig", "enableAttributeSuggestions": "true" }'

Les suggestions d'attributs peuvent être utilisées pour compléter automatiquement les marques ou les catégories saisies par un utilisateur final, dans des sections distinctes sous la liste des suggestions de recherche. Les résultats sont renvoyés dans le champ attributeResults de la réponse completeQuery, comme le montre cet exemple utilisant les clés brands et categories :

cURL

{
"completionResults": [
{
  "suggestion": "shoe",
  "attributes": {}
}
],
"attributionToken": "example_attribution_token",
"attributeResults": {
"brands": {
  "suggestions": [
    "Nike",
    "Adidas"
  ]
},
"categories": {
  "suggestions": [
    "Shoes",
    "Men's Shoes"
  ]
}
}
}

Attribut de suggestion avec nombre de produits

Lorsque la fonctionnalité d'attribut de suggestion avec nombre de produits est activée, le completeQuery.completionResults renvoyé fournit une liste de suggestions de saisie semi-automatique comme d'habitude, mais également le nombre de produits pour chaque suggestion avec le nombre total et le nombre de produits par attribut (comme color, category).

Par exemple, si la requête de recherche est "shoe" (chaussure), les suggestions de saisie semi-automatique renvoyées peuvent être les suivantes :

• womens shoes (chaussures pour femmes)
• mens shoes (chaussures pour hommes)

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

• womens shoes (32) (chaussures pour femmes (32))
  • black (10) (noir (10))
  • taupe (16) (taupe (16))
  • white (10) (blanc (10))
• mens shoes (43) (chaussures pour hommes (43))
  • black (10) (noir (10))
  • brown (5) (marron (5))
  • green (17) (vert (17))

En tant que détaillant, vous n'avez pas besoin de présenter le nombre de produits à l'acheteur, mais vous pouvez décider de trier la liste des suggestions en fonction du nombre de produits au lieu de l'ordre renvoyé dans completeQuery.completionResults. Par exemple, vous pouvez encourager les acheteurs à consulter les chaussures vertes pour hommes en les faisant apparaître en haut de la zone de suggestions, même si elles ne sont pas 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 forme de liste de Facets dans completeQuery.completionResults.facets pour chaque requête de recherche suggérée. Chaque attribut comporte une FacetValues liste 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 pendant au moins sept jours, assurez-vous que lorsque vous utilisez l'API search , incluez la clé d'attribut dans FacetSpecs et search.searchRequest.facetSpecs. Spécifiez les FacetKeys pour lesquelles vous souhaitez obtenir le nombre de produits. Seuls les attributs textual_fields sont autorisés.

Ce délai est dû au fait que les informations sur les attributs sont calculées à l'aide des données de l'historique de recherche de la semaine précédente.

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 saisie semi-automatique. Une entité peut être un site Web pour une autre marque ou région. Vous souhaitez que la saisie semi-automatique reflète au mieux le comportement des utilisateurs qui achètent cette marque ou ce site Web régional. Pour en savoir plus sur les entités, consultez Entités.

Notez que le filtrage des entités ne s'appliquera qu'à completion_results (pertinent pour UserEvent). Ce filtre ne s'appliquera pas à attribute_results (pertinent pour Product). Par conséquent, quelle que soit la valeur de entity, attribute_results est identique.

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

1. Incluez le entity champ dans vos événements utilisateur de recherche (eventType = "search"). Pour plus d'informations, consultez l'exemple d'objet complet pour l'événement utilisateur de recherche Recherche.

2. 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 correspondre exactement. Sinon, la saisie semi-automatique renvoie des suggestions vides.

3. Assurez-vous que l'entité (qu'elle se trouve dans les événements utilisateur de recherche ou dans les requêtes de saisie semi-automatique) ne comporte pas plus de 256 caractères. Une entité plus longue est tronquée à 256 caractères lorsque les événements ou les requêtes sont traités, ce qui risque de ne pas correspondre.

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