Pour configurer vos événements utilisateur:
Importer un historique d'événements utilisateur
Enregistrez des événements utilisateur en direct.
Taguez les événements utilisateur avec des entités.
Marquez les événements utilisateur avec des jetons d'attribution.
Informations sur l'utilisateur
La valeur visitorId
représente l'identifiant utilisateur unique. Il est obligatoire lorsque vous enregistrez un événement utilisateur. (UserInfo
) est inclus lorsque vous enregistrez un événement utilisateur avec la valeur visitorId
et, le cas échéant, la valeur userId
.
Vous pouvez utiliser la valeur userId
facultative comme identifiant unique et persistant pour un utilisateur sur tous les appareils, chaque fois qu'il se connecte à votre site. Lorsque vous enregistrez le userId
d'un utilisateur, Vertex AI Search for commerce peut générer des résultats plus personnalisés pour un utilisateur sur plusieurs appareils, tels qu'un appareil mobile et un navigateur Web.
Code temporel de l'événement utilisateur
Lorsque vous enregistrez un événement utilisateur, veillez à inclure un horodatage précis de l'événement. Des codes temporels précis permettent de s'assurer que les événements sont stockés dans le bon ordre. Les horodatages sont enregistrés automatiquement pour les événements collectés à l'aide de Tag Manager et du pixel JavaScript. Lorsque vous importez des événements, vous devez spécifier l'horodatage dans le champ eventTime
au format indiqué par RFC 3339.
Attributs personnalisés pour les événements utilisateur
Vous pouvez intégrer des attributs et des fonctionnalités personnalisés supplémentaires pour les événements utilisateur. Vous pouvez ainsi améliorer les recommandations de vos utilisateurs lorsque vous utilisez des recommandations. Pour ajouter des attributs personnalisés, utilisez attributes
lorsque vous enregistrez un événement utilisateur.
Si vous fournissez des attributs personnalisés pour les événements utilisateur ingérés, il est important de les inclure également dans les événements utilisateur que vous associez aux requêtes de prédiction. La mise en forme des attributs personnalisés doit être cohérente entre les événements importés et les événements fournis avec les requêtes de prédiction. Cela permet d'utiliser ces attributs personnalisés lors de l'entraînement des modèles et de la diffusion des prédictions, ce qui contribue à améliorer la qualité des recommandations.
Vous pouvez fournir des valeurs de texte personnalisées à l'aide du champ text
ou des valeurs numériques personnalisées à l'aide du champ number
.
Par exemple, voici la section attributes
d'une requête d'enregistrement d'un événement utilisateur :
"attributes": { "user_age": {"text": ["teen", "young adult"]}, "user_location": {"text": ["CA"]} }
Surveiller l'état des importations
Il est important d'enregistrer les événements utilisateur pour obtenir des résultats de haute qualité. Vous devez surveiller les taux d'erreur d'enregistrement des événements et, les cas échéant, prendre des mesures adéquates. Pour en savoir plus, consultez la section Configurer des alertes pour les problèmes d'importation de données.