Entités

Cette page présente les entités, comment et pourquoi 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 desservent plusieurs marques ou régions à partir d'un même 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 permet de tenir compte des comportements et des préférences différents des acheteurs situés dans des régions ou pays différents, ou qui effectuent des achats sur des sites aux marques différentes appartenant à votre entreprise.

Exemple de cas d'utilisation: deux pays

Le marchand "Exemple d'organisation" est présent en ligne aux États-Unis et au Canada.

Exemple d'organisation souhaite diffuser des résultats de navigation et de recherche, ainsi que des suggestions de saisie semi-automatique qui tiennent compte des différences entre les acheteurs des deux pays. Ainsi, "Exemple d'organisation" 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 consulté par l'acheteur (.com ou ca). Lorsqu'un acheteur effectue une requête de recherche, la valeur d'entité est incluse dans celle-ci.

Au mois de juillet, les deux pays ont des jours fériés importants, mais différents. Une fois les entités configurées, lorsque les acheteurs recherchent July sur le site Exemple d'organisation, les acheteurs américains voient d'abord des articles sur le thème du 4 juillet, et les acheteurs canadiens reçoivent des articles sur le thème de la fête du Canada.

De même, les recommandations destinées aux acheteurs canadiens sont plus susceptibles d'afficher des articles de la fête du Canada que des articles du 4 juillet.

Exemple de cas d'utilisation: 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 de la start-up sont conservés, car il possède une clientèle fidèle.

L'entreprise crée une entité, startup, pour ajouter des balises aux événements utilisateur provenant du site pour les start-up. Ainsi, les suggestions de recherche, de navigation, de saisie semi-automatique et de recommandation qui sont diffusées sur le site des start-up tiennent compte des préférences des acheteurs de ce site.

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 d'un même projet afin d'obtenir différentes suggestions pour vos différentes populations d'acheteurs.

Certaines applications nécessitent des projets distincts. Pour les autres applications, la configuration d'entités est la meilleure solution.

Utilisez des entités lorsque vous avez:

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

  • Un ou plusieurs des éléments suivants:

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

    • Plusieurs régions dans le même pays (par exemple, enterprise_east et enterprise_west)

    • Une marque, mais dans plusieurs pays parlant la même langue (brand_us et brand_ca, par exemple)

Utilisez des projets distincts plutôt que des entités lorsque vous disposez des éléments suivants:

  • Les catalogues qui ne peuvent pas être combinés ou ceux qui, s'ils sont combinés, présentent peu ou pas de chevauchement.

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

Événements utilisateur et entités

Pour tirer parti de la fonctionnalité des 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'a aucune incidence sur la qualité de la recherche ou des réponses de saisie semi-automatique.

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

Généralement, il faut 30 à 90 jours de données d'événements utilisateur pour que la fonctionnalité d'entité renvoie des suggestions optimales.

Si une entité ne figure pas dans une requête, la requête ne fait aucune hypothèse concernant cette 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.

Rechercher 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 requête de recherche. Pour en savoir plus sur l'envoi de requêtes de recherche, consultez la section 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 exploiter les entités pour les recommandations. En effet, la valeur de l'entité fait partie de l'événement utilisateur, qui, à son tour, est inclus dans l'appel de la méthode predict.