Vous êtes ici :
Suivi des activités Einstein : Champs obligatoires
Lors de l’implémentation du suivi d’activité Einstein pour les boutiques hybrides ou personnalisées, incluez des champs spécifiques pour chaque type d’activité. Cette rubrique répertorie les champs obligatoires attendus par les API Einstein pour une collecte et une attribution correctes des données.
Si vous utilisez Storefront Reference Architecture (SFRA) ou SiteGenesis, la boutique en ligne effectue le suivi des champs d’activité requis via des balises isobject. Toutefois, si vous créez une boutique hybride ou personnalisée, assurez-vous de bien remplir les champs obligatoires. Le suivi des champs obligatoires permet à Einstein de traiter les données.
Des champs manquants ou mal formatés peuvent amener Einstien à filtrer de manière incorrecte les activités importantes, ce qui entraîne des données incomplètes dans les tableaux de bord et les recommandations Einstein.
Champs obligatoires pour toutes les activités
Chaque activité Einstein nécessite les champs de base suivants :
| Champ | Type | Description |
|---|---|---|
idCookie |
Chaîne | Identifiant unique de la session de l’acheteur. Cette valeur associe les activités à un acheteur spécifique. |
Royaume |
Chaîne | Votre identifiant de realm B2C Commerce. |
siteId |
Chaîne | ID du site où l’activité s’est produite. |
Type d’instance |
Chaîne | Type d’instance (prd pour les instances de production). Einstein ne génère pas de rapports pour les instances hors production. |
Type d’activité |
Chaîne | Le type d’activité. Valeurs valides : viewProduct, viewReco, clickReco, addToCart, finishCheckout, viewCategory, viewSearch, clickCategory, clickSearch. |
Plus de champs par type d’activité
En plus des champs de base, chaque type d’activité nécessite les champs spécifiques suivants :
| Type d’activité | Champs obligatoires | Remarques |
|---|---|---|
viewProduct |
|
Se déclenche lorsqu’un acheteur consulte la page de détails d’un produit. Active les recommenders consultés récemment et la personnalisation en temps réel. |
viewReco |
|
Se déclenche lorsqu’un acheteur consulte une page contenant des recommandations. Assurez-vous que le recommenderName correspond au recommender configuré dans Business Manager. |
clickReco |
|
Se déclenche lorsqu’un acheteur clique sur un produit recommandé. Obligatoire pour l’attribution des clics sur les recommandations. |
addToCart |
|
Se déclenche lorsqu’un acheteur ajoute un produit à son panier. Obligatoire pour l’attribution liée au panier. |
finishCheckout |
|
Se déclenche lorsqu’un acheteur termine une commande. Obligatoire pour l’attribution des revenus et le suivi des conversions. |
viewCategory |
|
Se déclenche lorsqu’un acheteur consulte une page de grille de catégories. |
viewSearch |
|
Se déclenche lorsqu’un acheteur consulte les résultats de la recherche. |
cliquerCatégorie |
|
Se déclenche lorsqu’un acheteur clique d’une page de catégorie vers une page de détails d’un produit. |
cliquez surRechercher |
|
Se déclenche lorsqu’un acheteur clique sur les résultats d’une recherche jusqu’à la page de détails d’un produit. |
Dépannage
Si les activités n’apparaissent pas dans les tableaux de bord Einstein, recherchez les problèmes courants suivants :
- Type d’instance hors production: Einstein ne génère pas de rapports pour les activités dont les valeurs
instanceTypesont autres queprd. - Types d’activité manquants ou vides: Einstein ne rend pas compte des activités sans
activityTypevalide. - Noms de recommenders manquants: pour
les activités viewReco,clickRecoet recommendation-to-cart, unrecommenderNamemanquant empêche une attribution correcte. - Identifiants de produits non valides: assurez-vous que les identifiants de produits correspondent aux identifiants de votre catalogue de produits.
Utilisez l’extension Chrome Commerce Cloud Recommendation Validator pour inspecter les données d’activité envoyées depuis votre boutique.

