Exemple de fichier biConfig.xml pour IBM Digital Analytics :

L'exemple de fichier biConfig.xml suivant représente la version par défaut incluse avec .

L'exemple de fichier biConfig.xml par défaut que HCL Commerce fournit se trouve dans le répertoire suivant :

workspace_dir\crs-web\WebContent\WEB-INF\xml\config\bi

Votre fichier biConfig.xml mis à jour doit être déployé dans le répertoire suivant afin que IBM Digital Analytics puisse y faire référence : workspace_dir\WC\xml\config\bi

HCL Commerce Developer Lorsque vous mettez à jour le fichier biConfig.xml dans votre environnement de développement, vous pouvez utiliser un fichier de rechargement pour vous aider à tester rapidement les modifications de configuration. En utilisant ce fichier de rechargement, vous n'avez pas besoin de redémarrer continuellement votre serveur pour appliquer des modifications de configuration à partir du fichier biConfig.xml.

Pour plus d'informations sur la configuration des paramètres pour le fichier biConfig.xml à utiliser avec IBM Digital Analytics, voir Configuration du magasin pour communiquer avec IBM Digital Analytics(biConfig.xml).

L'exemple de fichier suivant inclut les éléments et l'attribut dans le fichier biConfig.xml que vous pouvez mettre à jour avec les informations spécifiques à votre site. Les valeurs en gras sont des valeurs d'exemple, que vous devez remplacer par des valeurs spécifiques à votre magasin ou à votre site.

<?xml version="1.0" encoding="UTF-8"?>

<!--
 =================================================================
  Licensed Materials - Property of IBM

  HCL Commerce

  (C) Copyright IBM Corp. 2010, 2013 All Rights Reserved.

  US Government Users Restricted Rights - Use, duplication or
  disclosure restricted by GSA ADP Schedule Contract with
  IBM Corp.
 =================================================================
-->
<BIConfiguration>
1  <ssoKey></ssoKey>
2  <biproviders>
3    <biprovider name="coremetrics">
      <options><attribute name="useDDX" value="false"/></options>
      <header>
        <![CDATA[<script type="text/JavaScript">
        <!--
        ]]>
      </header>
      <footer>
        <![CDATA[
        //-->
        </script>]]>
      </footer>
    </biprovider>
  </biproviders>
  
4  <stores>
5    <store storeId="10101" 
      biprovider="coremetrics" enabled="true" debug="true" 
      marketingCenterEnabled="true"
      useHostedCMHLibraries="true" useEmailForCustomerId="false" 
      segmentExportMode="append" >
      <useCookies>true</useCookies>
      <clientid>69999999</clientid>
      <url>https://welcome.coremetrics.com/analyticswebapp/analytics.jsp</url>
      <marketingCenterUrl>https://mc.coremetrics.com/mcwebapp/welcome.do</marketingCenterUrl>
      <includeShipAdjustInProductPrice>true</includeShipAdjustInProductPrice>
      <options><attribute name="useDDX" value="false"/></options>
      <output section="header">
        <![CDATA[
        <script type="text/javascript" src="//libs.coremetrics.com/eluminate.js"></script> 
        <script type="text/javascript"> 
        cmSetupNormalization("krypto-_-krypto");
        
        // send data to production system 
        //cmSetClientID("99999999",true,"data.coremetrics.com","thesite.com"); 
        
        // send data to test system 
        cmSetClientID("69999999",false,"testdata.coremetrics.com","thesite.com"); 
        </script> 				
        ]]>
      </output>
    </store>
  </stores>
</BIConfiguration>

Où

1 Identifie une clé secrète pour l'authentification unique à votre fournisseur d'analyse pour les utilisateurs du Centre de gestion. L'authentification unique est activée uniquement pour une intégration entre IBM Digital Analytics et le Centre de gestion.

2 Démarre la section de configuration du fournisseur d'analyse. Dans cet élément, vous pouvez inclure plusieurs éléments <biprovider>. Chaque élément <biprovider> inclut les paramètres de configuration d'un fournisseur d'analyse individuel.

3 Inclut les paramètres de configuration d'un fournisseur d'analyse spécifique. Dans cet exemple de fichier, un seul élément <biprovider> est inclus pour configurer les paramètres d'intégration avec IBM Digital Analytics. L'élément <biprovider> peut inclure les éléments et attributs suivants :

nom: Nom du fournisseur d'analyse. La valeur coremetrics identifie le fournisseur d'analyse en tant que IBM Digital Analytics.
options: Cet élément et le nom d'attribut useDDX indiquent le magasin intégré à IBM Digital Data Exchange (DDX).
en-tête: Cet élément inclut toutes les fonctions ou instructions JavaScript courantes qui doivent être placées sur les pages de magasin ainsi que les fonctions de balisage.
pied de page: Cet élément inclut toutes les fonctions ou instructions JavaScript courantes qui doivent être placées sur les pages de magasin ainsi que les fonctions de balisage.

Dans l'élément <biprovider>, des valeurs par défaut peuvent être définies pour chaque paramètre de configuration. Ces valeurs s'appliquent à chaque magasin associé au fournisseur d'analyse identifié. Pour plus d'informations, voir Configuration des valeurs par défaut pour un fournisseur d'analyse.

4 Commence la section de configuration au niveau du magasin. Dans cet élément, vous pouvez inclure plusieurs éléments <store>. Chaque élément <store> peut inclure les paramètres de configuration d'un ou plusieurs magasins.

5 Inclut les paramètres de configuration d'un ou de plusieurs magasins. Dans cet exemple de fichier, un élément <store> est inclus pour configurer les paramètres d'un magasin pour utiliser IBM Digital Analytics comme fournisseur d'analyse pour chaque magasin. L'élément <store> peut inclure les éléments et attributs suivants :

storeId

storeId du ou des magasins pour lesquels vous souhaitez activer le fournisseur d'analyse configuré, comme IBM Digital Analytics. Les valeurs d'ID de magasin peuvent être définies aux formats suivants :

Valeur storeId unique.
Liste de valeurs storeId, séparées par des virgules. Par exemple, storeId="10000, 10001" active IBM Digital Analytics pour deux magasins à l'aide du même ID client IBM Digital Analytics et de la même bibliothèque de balises définie dans la configuration.
Plage de valeurs storeId. Par exemple, storeId="10000-10200" active IBM Digital Analytics pour tous les magasins dotés de valeurs storeId comprises dans la plage, y compris dans les limites supérieure et inférieure indiquées. Les magasins spécifiés dans la plage doivent partager l'ID client IBM Digital Analytics et la bibliothèque de balises définie dans la configuration.

biprovider

Fournisseur d'analyse. La valeur coremetrics identifie le fournisseur d'analyse en tant que IBM Digital Analytics.

enabled

Indique si le suivi est activé ou non, ce qui signifie que les données d'analyse sont suivies et envoyées à IBM Digital Analytics. Les valeurs sont true ou false.

debug

Indique si le mode débogage est activé ou non. (Les messages de débogage apparaissent sur la page Web à l'emplacement de la balise, généralement au bas de la page.) Les valeurs sont true ou false.

marketingCenterEnabled

Indicateur d'activation pour l'intégration du Centre de gestion avec IBM Marketing Center. Pour plus d'informations, voir Intégration à.

useHostedCMHLibraries

Indique si le magasin utilise la bibliothèque standard IBM Digital Analytics. Les valeurs sont true pour la bibliothèque IBM Digital Analytics standard ou false pour la bibliothèque IBM Digital Analytics personnalisée. Laissez la valeur définie sur true.

useEmailForCustomerId

Indique d'utiliser ou non une adresse e-mail au lieu d'un ID de membre HCL Commerce pour identifier les clients dans IBM Digital Analytics. Les valeurs valides sont les suivantes :

true: Utilisez l'adresse e-mail du client comme ID client IBM Digital Analytics.
false: Utilisez l'ID de membre HCL Commerce comme ID client IBM Digital Analytics. Il s'agit de la valeur par défaut.

Lorsque la valeur est true, un magasin exige des clients de fournir leur adresse e-mail quand ils s'inscrivent et quand ils passent une commande en tant qu'acheteur invité. L'utilisation de l'adresse e-mail du client comme ID client est utile si seule l'adresse e-mail peut être collectée de manière cohérente lorsque les clients établissent un nouveau compte, s'inscrivent pour recevoir un bulletin d'information ou remplissent un autre formulaire d'identification. Par exemple, à l'aide de l'adresse e-mail, vous pouvez établir une corrélation entre un client qui remplit un formulaire de demande de produit sur un site externe et le même client qui s'inscrit dans un magasin HCL Commerce. L'utilisation de l'adresse e-mail peut également vous aider à suivre plusieurs commandes qui sont passées par le même visiteur. Lorsqu'un client passe une commande, un visiteur se voit attribuer à chaque fois un identifiant de membre unique différent ; toutefois, l'adresse e-mail du visiteur est susceptible de rester la même.

Le paramètre ID client est transmis à IBM Digital Analytics dans la balise de données cmCreateRegistrationTag (qui est générée par la balise <cm:registration />) et dans les balises cmCreateShopAction9 et cmCreateOrderTag (qui sont toutes deux générées par la balise <cm:order />).

segmentExportMode

Indique le mode d'exportation à utiliser lorsque vous mettez à jour des segments de clientèle basés sur IBM Digital Analytics. Voir ../tasks/tmtconfigsegbiconfig.html.

useCookies

Indique si les informations de catégorie sont stockées dans les cookies. Pour plus d'informations, voir Stockage d'informations de catégorie dans les cookies pour les rapports d'analyse.

clientid

ID client du fournisseur d'analyse pour le magasin, comme fourni par le fournisseur d'analyse.

url

URL pour le lancement du fournisseur d'analyse à partir du Centre de gestion.

marketingCenterUrl

Si le Centre de gestion est intégré à IBM Marketing Center, cet élément peut être utilisé pour remplacer l'URL par défaut par IBM Marketing Center.

includeShipAdjustInProductPrice

Cet indicateur contrôle si les ajustements d'expédition sont appliqués aux prix des produits dans une commande ou aux frais d'expédition lorsque les données de commande sont envoyées à IBM Digital Analytics. Ce paramètre n'affecte pas les détails de commande qu'un client affiche lorsqu'il soumet ou examine une commande.

true: Valeur par défaut. Les ajustements d'expédition sont appliqués aux produits d'une commande au lieu d'être appliqués aux frais d'expédition lorsque les données de commande sont envoyées à IBM Digital Analytics. Par exemple, un produit coûte 40 USD avec des frais d'expédition de 10 USD. Si une promotion qui offre un rabais de 5 USD sur l'expédition est appliquée, le total de la commande est de 45 USD. Lorsque l'indicateur includeShipAdjustInProductPrice est défini sur true, les balises de commande et de panier d'achat envoient les données de commande à IBM Digital Analytics. Les renseignements qui sont envoyés indiquent que le total de la commande était de 45 USD, le prix du produit de 35 USD, et non de 40 USD, et les frais d'expédition de 10 USD, et non de 5 USD.
false: Les ajustements d'expédition sont appliqués aux frais d'expédition lorsque les données sont envoyées à IBM Digital Analytics. Par exemple, si l'indicateur includeShipAdjustInProductPrice est false dans le scénario précédent, les informations auxquelles les balises de commande et de panier d'achat IBM Digital Analytics envoient indiquent que le total de la commande était de 45 USD, le prix du produit de 40 USD et les frais d'expédition de 5 USD.

options

Cet élément et l'attribut useDDX avec une valeur de "true" indique que le magasin est intégré à IBM Digital Data Exchange (DDX).

sortie

Cet élément configure les fragments JavaScript, ou tout autre contenu, que vous souhaitez écrire à un emplacement spécifique dans les pages de votre magasin pour suivre et envoyer des données d'analyse. Mettez à jour les paramètres de la fonction cmSetClientID dans l'élément pour définir les valeurs suivantes. Il existe un paramètre cmSetClientID pour configurer l'ID client pour votre système de production et l'autre pour votre système de test.

ID client

ID client fourni par votre fournisseur d'analyse, tel que IBM Digital Analytics. Dans cet exemple de fichier, la valeur est "99999999".

Méthodes de collecte de données

La méthode de collecte des données. Vous pouvez définir l'une des valeurs suivantes :

true: La collecte de données est gérée par le fournisseur d'analyse, tel que IBM Digital Analytics.
false: La collecte de données est gérée par votre client.

Nom de domaine du fournisseur d'analyse

Nom de domaine de votre fournisseur d'analyse. Dans cet exemple, la valeur est "data.coremetrics.com" pour IBM Digital Analytics.

Serveur HCL Commerce

Nom du domaine de votre serveur HCL Commerce. Dans cet exemple de fichier, la valeur est "thesite.com".