Utilisation de la balise d'enregistrement avec IBM Digital Analytics

Si votre site est intégré à IBM Digital Analytics, vous pouvez utiliser l'implémentation par défaut de la balise <cm:registration /> que fournit HCL Commerce. La balise <cm:registration /> génère la balise IBM Digital Analytics suivante : cmCreateRegistrationTag.

Placement de balises dans les pages de magasin

Incluez la balise <cm:registration /> dans la page JSP d'affichage du compte de votre client. Dans la page, placez la balise <cm:registration /> avant la balise <cm:pageview />.

Pour utiliser la balise <cm:registration />, vous devez également inclure la bibliothèque de balises dans le fichier JSP avant le contenu de la page principale. Utilisez le code suivant pour inclure la bibliothèque de balises :


<%@ taglib uri="http://commerce.ibm.com/coremetrics" prefix="cm" %>

Les données que la balise <cm:registration /> génère sont différentes selon la version de la bibliothèque IBM Digital Analytics que votre magasin utilise.

Exemple d'utilisation et de sortie de balise pour IBM Digital Data Exchange (DDX)

Si votre magasin HCL Commerce est intégré avec DDX pour simplifier la collecte de données d'analyse, la balise <cm:registration /> génère des données dans l'objet JavaScript digitalData qui est envoyé à DDX. DDX peut ensuite relayer les données à IBM Digital Analytics. Les données générées dans cet objet JavaScript, peuvent ressembler à la sortie suivante :

digitalData.user=new Array();
digitalData.user[0]={};
digitalData.user[0].profile=new Array();
digitalData.user[0].profile[0]={};
digitalData.user[0].profile[0]={address:{city:'City', country:'US', postalcode:'90210', state_province:'CA'}, 
  profileInfo:{exploreAttributes:'-_--_--_--_--_--_--_-', 
  profileEmail:'johnsmith@example.com', profileID:'-1000'}};

Dans cette sortie, le format user[0].profile[0] est utilisé pour inclure les données utilisateur. Ce format est le seul format que HCL Commerce et IBM Digital Analytics prennent en charge.

Pour plus d'informations sur l'intégration à DDX, voir Intégration à IBM Digital Data Exchange.

Exemples d'utilisation de balise : pour la bibliothèque IBM Digital Analytics personnalisée

La balise <cm:registration /> génère la balise de données IBM Digital Analytics suivante :

cmCreateRegistrationTag(customerId, customerEmail, customerCity, 
customerState, customerZip, __nl, __sd, store_id, 
customer_country, age, gender, marital_status, 
num_children, num_in_household, company_name, hobbies, 
income, attributes)

Exemple 1 :

Pour transmettre les données d'enregistrement de base à IBM Digital Analytics :


Incluez une balise dans votre page de magasin avec le code suivant :	Si votre magasin utilise des beans de données et des commandes d'URL pour les fonctions d'exécution d'enregistrement, vous pouvez inclure la balise sans paramètres : `<cm:registration />` Si votre magasin utilise des services Web pour les fonctions d'exécution d'enregistrement, utilisez le paramètre `personType` : `<cm:registration personType="${personType}"/>`
Exemple de balise de données IBM Digital Analytics générée :	`cmCreateRegistrationTag("2002", "user1@test.com", "LA", "CA", "45123", null, null, "10101", "US", null, "N", null, null, null, null, null, null);`

Exemple 2 :

Pour transmettre des attributs Explore à IBM Digital Analytics, utilisez le paramètre extraparms (première position) :

Remarque : Les exemples de cette rubrique utilisent la syntaxe simplifiée pour spécifier des valeurs extraparms. Vous devez spécifier les valeurs à l'aide de JavaScript correctement échappé :

Exemple de syntaxe simplifiée: extraparms="value1-_-value2,value3-_-value4"
Exemple de JavaScript correctement échappé: extraparms="\"value1-_-value2\",\"value3-_-value4\""

Si l'une de vos valeurs extraparms est une variable JavaScript, consultez les règles de syntaxe expliquées dans Syntaxe pour la transmission de variables JavaScript en tant que paramètres supplémentaires.

Incluez une balise dans votre page de magasin avec le code suivant :	`<cm:registration personType="${personType}" extraparms="attr1-_-attr2-_-attr3"/>`
Exemple de balise de données Digital Analytics générée :	`cmCreateRegistrationTag("2002", "user1@test.com", "LA", "CA", "45123", null, null, "10101", "US", null, "N", null, null, null, null, null, null, "attr1-_-attr2-_-attr3");`

Incluez une balise dans votre page de magasin avec le code suivant :

<cm:registration personType="${personType}" 
extraparms="attr1-_-attr2-_-attr3"/>

Exemple de balise de données Digital Analytics générée :

cmCreateRegistrationTag("2002", "user1@test.com", "LA", "CA", "45123", 
null, null, "10101", "US", null, "N", null, null, null, null, null, null, 
"attr1-_-attr2-_-attr3");

Pour plus d'informations sur chaque paramètre de la balise de données IBM Digital Analytics, consultez la documentation fournie par IBM Digital Analytics.