Balise d'élément

La balise d'élément HCL Commerce suit les interactions des clients avec le contenu d'une page ou des éléments de page. Dans les magasins type HCL Commerce, ces éléments incluent la recherche rapide du produit, et la navigation à facettes sur les pages de résultats de catégorie et de recherche. D'autres exemples d'éléments incluent des portlets de recherche et de nouvelles, des lectures de vidéo et des détails Ajax pour les produits ou les avis des clients.

La balise d'élément ne génère aucune donnée à elle seule. Pour cette balise, vous devez utiliser les paramètres de balise pour transmettre les données que vous souhaitez collecter. 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 d'élément.

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

elementId

Paramètre obligatoire spécifiant l'identificateur de l'élément avec lequel le client interagit. Il doit s'agir d'un nom distinctif, tel que Product Fast Finder (Recherche rapide de produits).

catégorie

Paramètre optionnel qui spécifie la catégorie de l'élément en question.

pageID

Paramètre optionnel qui spécifie l'ID de la page sur laquelle l'élément est situé. Par défaut, la valeur de pageId est le titre de la page.

pageCategory

Paramètre optionnel qui spécifie la catégorie de la page sur laquelle l'élément est situé.

emplacement

Paramètre optionnel qui spécifie l'emplacement de l'élément sur la page, par exemple, navigation supérieure ou barre latérale.

storeId

Paramètre optionnel correspondant à l'identificateur du magasin auquel appartient la page actuellement visualisée. Si vous n'incluez pas ce paramètre, la valeur storeId est extraite de l'URL actuelle.

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 des valeurs explicites sans échapper les valeurs. Pour transmettre plus d'une valeur, séparez les valeurs par une virgule.	`extraparms="value1,value2"`

returnAsJSON

Paramètre facultatif conçu pour être utilisé lors du suivi des interactions avec les clients qui ne provoquent pas d'actualisation complète de la page. Par exemple, dans un magasin Web 2.0, le client peut interagir avec le mini panier d'achat, la fonction de recherche rapide de produits ou une liste de souhaits. Pour suivre ces interactions de page, vous pouvez utiliser ce paramètre pour renvoyer un objet JSON au lieu de générer la balise de données d'analyse. Lorsque la structure de balisage du magasin Web 2.0 détecte que cet événement d'analyse s'est produit, la structure de balisage peut utiliser l'objet JSON pour remplir la balise de données d'analyse. Les valeurs autorisées sont les suivantes :

true = Renvoyer un objet JSON.
false = Générer la balise de données d'analyse.

Voici la structure de données JSON pour la balise d'élément :

[{elementId:"ELEMENTID",category:"CATEGORY",pageId:"PAGEID",
pageCategory:"PGCATEGORY",location:"LOCATION"'}]

Versions des balises

HCL Commerce fournit deux versions de la balise d'élément :

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