Balise de produit

La balise de produit HCL Commerce recueille des détails sur les produits qu'un client a consultés.

Cette balise recueille les données suivantes pour les transmettre à un système d'analyse externe :

Nom de la page
Numéro de référence du produit
Nom du produit
Catégorie de produit dans le catalogue que le client parcourt actuellement
Catégorie de produit dans le catalogue principal
Identificateur de magasin

Cette balise peut également transmettre des paramètres supplémentaires pour la personnalisation des balises.

Paramètres

Voici une liste de paramètres requis et facultatifs pour la balise de produit.

Remarque pour IBM Digital Analytics : les paramètres suivants sont pour la balise HCL Commerce <cm:product />. Cette balise génère la balise de données IBM Digital Analytics cmCreateProductviewTag.

Pour transmettre les données de produit précédemment répertoriées à un système d'analyse externe, utilisez l'un des deux paramètres suivants :

databean: Utilisez ce paramètre si votre page d'affichage de produit contient un bean de données lié au produit. Ce paramètre est une instance remplie de com.ibm.commerce.catalog.beans.ProductDataBean, com.ibm.commerce.catalog.beans.ItemDataBean, com.ibm.commerce.catalog.beans.BundleDataBean ou com.ibm.commerce.catalog.beans.PackageDataBean. Si vous n'incluez pas ce paramètre, vous devez inclure le paramètre catentryId (voir ci-dessous).
L'utilisation du paramètre databean offre de meilleures performances que le paramètre catentryId, car la balise de produit n'a pas besoin d'utiliser des ressources supplémentaires pour générer le bean de données à partir de catentryId.
catentryId: Utilisez ce paramètre si votre page d'affichage de produit ne contient pas de bean de données lié au produit. Ce paramètre est l'ID de l'entrée de catalogue en cours d'affichage. La balise produit crée automatiquement un bean de données lié au produit pour obtenir les informations dont le système d'analyse externe a besoin.
Ce paramètre est ignoré si vous avez utilisé le paramètre databean.

Pour transmettre plus d'informations au système d'analyse externe, utilisez le paramètre suivant :

extraparms

Paramètre facultatif qui communique plus d'informations au système d'analyse externe. Ce paramètre est fourni pour les scénarios dans lesquels vous avez peut-être négocié avec le fournisseur d'analyse externe pour générer un rapport personnalisé qui nécessite des informations supplémentaires.

Remarque pour : utilisez le extraparms paramètre pour transmettre les attributs d'exploration ou les données pour les rapports personnalisés, ou les deux. Voir Transmission de données supplémentaires à IBM Digital Analytics avec le paramètre extraparms.

Il existe plusieurs façons de transmettre des valeurs à l'aide du paramètre extraparms :


Description	Exemple
Spécifiez les valeurs explicites comme JavaScript correctement échappé. Pour transmettre plus d'une valeur, séparez les valeurs par une virgule.	`extraparms="\"value1\",\"value2\""`
Spécifiez le contenu dynamique en appelant une méthode. Toute valeur `extraparms` qui commence et se termine par le symbole $ , par exemple, $getMethod$ , est supposé être un nom de méthode de ProductDataBean, ItemDataBean, BundleDataBean, ou PackageDataBean, selon le type qui est utilisé. La seule restriction concernant le nom de la méthode est qu'il ne doit pas prendre d'arguments et que l'objet qui est retourné doit implémenter la méthode toString().	`extraparms="$getMethod$"`

Versions des balises

HCL Commerce fournit deux versions de la balise de produit :

Classe d'implémentation de balise de base abstraite : com.ibm.commerce.bi.taglib.ProductBaseTag. Les fournisseurs d'analyse qui souhaitent fournir une balise de produit dans leur bibliothèque de balises JSP d'analyse Web peuvent étendre cette classe de balises de base pour obtenir les données de balise de produit et implémenter leur propre logique pour générer les API de balisage d'affichage de produit spécifique au fournisseur.
Une implémentation par défaut de la balise de produit (<cm:product />) pour IBM Digital Analytics. Cette implémentation génère automatiquement la balise de données IBM Digital Analytics cmCreateProductviewTag.