Entités

Cette page présente les entités, leur utilisation et leur utilité.

Pour 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 même catalogue de produits peuvent obtenir de meilleurs résultats s'ils utilisent des entités.

Présentation

Configurer plusieurs entités dans votre projet permet de prendre en compte les différents comportements et préférences des acheteurs qui se trouvent dans différentes régions ou 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 au Canada et aux États-Unis.

L'organisation Example souhaite diffuser des résultats de recherche et de navigation, ainsi que des suggestions de saisie semi-automatique qui tiennent compte des différences entre les acheteurs des deux pays. Par conséquent, "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 que l'acheteur a visité (.com ou ca). Lorsqu'un acheteur envoie une requête de recherche, la valeur de l'entité est incluse dans la requête.

Les deux pays célèbrent 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'exemple d'organisation, les acheteurs américains voient d'abord les articles sur le thème du 4 juillet, et les acheteurs canadiens voient d'abord les articles sur le thème de la fête du Canada.

De même, les recommandations pour les acheteurs canadiens sont plus susceptibles d'afficher des articles pour la fête du Canada que des articles pour le 4 juillet.

Exemple de cas d'utilisation: acquisition

L'entreprise Example Organization a récemment acquis la start-up Example Organization. Les catalogues ont été combinés, mais la marque et le site Web de la start-up sont conservés, car ils ont une clientèle fidèle.

L'entreprise crée une entité, startup, pour taguer les événements utilisateur provenant du site de la start-up. Cela permet aux suggestions de recherche, de navigation, de saisie semi-automatique et de recommandation diffusées sur le site de la start-up de prendre en compte les préférences des acheteurs du 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 dans le même projet pour obtenir différentes suggestions pour vos différentes populations d'acheteurs.

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

Utilisez des entités lorsque:

  • 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 d'un même pays (par exemple, enterprise_east et enterprise_west)

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

Utilisez des projets distincts plutôt que des entités lorsque vous avez:

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

  • Entités nécessitant différentes langues 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.

    Inclure le 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 de saisie semi-automatique.

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

En règle générale, 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é 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 en savoir plus, consultez l'exemple d'objet complet pour l'événement utilisateur Search (Recherche).

  2. Ajoutez le champ entity à votre requête 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 tenant 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 à des fins de recommandation. En effet, la valeur de l'entité fait partie de l'événement utilisateur, qui est à son tour inclus dans l'appel de la méthode predict.