Entités

Cette page présente les entités, qui permettent de capturer différents comportements des utilisateurs en fonction de plusieurs marques ou produits sur un même site d'entreprise, ainsi que la façon et la raison pour lesquelles elles peuvent être utilisées.

Dans la plupart des cas d'utilisation, les entités ne sont pas nécessaires pour Vertex AI Search pour le commerce. Toutefois, les marchands qui proposent plusieurs marques ou régions à partir d'un seul catalogue de produits peuvent obtenir de meilleurs résultats s'ils utilisent des entités.

Présentation

La configuration de plusieurs entités dans votre projet vous permet de prendre en compte les différents comportements et préférences des acheteurs qui se trouvent dans différentes régions ou différents pays, ou qui effectuent des achats sur des sites de marques différentes appartenant à votre entreprise.

Exemple de cas d'utilisation : deux pays

Un marchand, Exemple d'organisation, est présent sur le Web aux États-Unis et au Canada.

L'entreprise Exemple souhaite diffuser des résultats de navigation et de recherche, ainsi que des suggestions de saisie automatique qui tiennent compte des différences entre les acheteurs des deux pays. Par conséquent, l'organisation Exemple désigne deux entités : org_us et org_ca.

Les événements utilisateur sont tagués avec une valeur d'entité, en fonction du site Web visité par l'acheteur (.com ou ca). Lorsqu'un acheteur effectue une demande de recherche, la valeur d'entité est incluse dans la demande.

Les deux pays ont des jours fériés importants, mais différents, en juillet. Une fois les entités configurées, lorsque les acheteurs recherchent July sur le site de l'organisation exemple, les acheteurs américains voient en premier les articles sur le thème du 4 juillet, tandis que les acheteurs canadiens voient en premier les articles sur le thème de la fête du Canada.

De même, les recommandations pour les acheteurs canadiens sont plus susceptibles de présenter des articles pour la fête du Canada que pour le 4 juillet.

Exemple de cas d'utilisation : une acquisition

"Enterprise Example Organization" a récemment fait l'acquisition de "Startup Example Organization". Les catalogues ont été combinés, mais la marque et le site Web Startup sont conservés, car ils bénéficient d'une base de fans fidèles.

L'entreprise crée une entité, startup, pour taguer les événements utilisateur provenant du site de la startup. Cela permet aux suggestions de recherche, de navigation, de saisie semi-automatique et de recommandation proposées sur le site de la startup de tenir compte des préférences des acheteurs.

Plusieurs projets ou plusieurs entités ?

Lorsque vous configurez Vertex AI Search pour le commerce, vous pouvez utiliser différents projets ou différentes entités dans le même projet pour obtenir des suggestions différentes pour vos différentes populations d'acheteurs.

Pour certaines applications, des projets distincts sont requis. Pour les autres applications, la meilleure solution consiste à configurer des entités.

Utilisez entities lorsque vous avez :

  • Un catalogue entièrement ou partiellement partagé entre les entités

  • Un ou plusieurs des problèmes suivants surviennent :

    • Plusieurs marques dans le même pays ou la même zone linguistique (par exemple, votre marque d'origine et une marque acquise, google_home et nest).

    • Plusieurs régions d'un même pays, par exemple enterprise_east et enterprise_west.

    • Une même marque dans plusieurs pays où la langue est la même (par exemple, brand_us et brand_ca).

Utilisez des projets distincts au lieu d'entités lorsque :

  • Catalogues qui ne peuvent pas être combinés ou qui, s'ils le sont, se chevauchent peu ou pas.

  • Entités nécessitant des langues différentes. Une seule langue est autorisée par projet.

Événements et entités utilisateur

Pour profiter de la fonctionnalité d'entités, ajoutez le champ d'entité à vos événements utilisateur.

  • Pour la recherche et la saisie semi-automatique : incluez le champ entity dans les événements utilisateur de type search.

    L'inclusion du champ d'entité dans d'autres types d'événements utilisateur peut être utile pour le dépannage, mais n'affecte pas la qualité des réponses de recherche ou d'autocomplete.

  • Pour les recommandations : incluez le champ d'entité dans autant de types d'événements utilisateur que possible.

En général, il faut entre 30 et 90 jours de données d'événements utilisateur pour que la fonctionnalité d'entité renvoie des suggestions optimales.

Si une entité est manquante dans une requête, la requête ne fait aucune hypothèse sur l'entité dans le résultat. Vous obtiendrez un résultat moyen basé sur les événements utilisateur avec et sans l'entité spécifiée.

Recherche et entités

Pour obtenir des résultats de recherche ou de navigation qui tiennent compte de l'entité :

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

  2. Ajoutez le champ entity à votre demande de recherche. Pour savoir comment effectuer des requêtes de recherche, consultez Obtenir des résultats de recherche.

Saisie semi-automatique et entités

Pour obtenir des résultats de saisie semi-automatique qui tiennent compte de l'entité :

Recommandations et entités

Une fois que vous avez ajouté le champ entity à vos événements utilisateur, aucune autre action n'est requise pour profiter des entités pour les recommandations. En effet, la valeur de l'entité fait partie de l'événement utilisateur, qui est lui-même inclus dans l'appel à la méthode predict.