Configuration des valeurs par défaut pour un fournisseur d'analyse

Vous pouvez configurer des valeurs par défaut pour une configuration de fournisseur d'analyse afin d'appliquer les valeurs par défaut à tous les magasins associés au fournisseur d'analyse. En définissant des valeurs par défaut au niveau du site, vous pouvez configurer rapidement plusieurs magasins afin qu'ils utilisent les mêmes paramètres de fournisseur d'analyse. Vous pouvez également modifier les valeurs par défaut pour chaque magasin individuel.

Avant de commencer

Examinez le fichier d'exemple biConfig.xml .

Pourquoi et quand exécuter cette tâche

Lorsque vous définissez les valeurs par défaut d'une configuration de fournisseur d'analyse, vous définissez les valeurs par défaut dans l'élément <biprovider> du fournisseur d'analyse. Vous pouvez définir des valeurs par défaut pour les mêmes options de configuration qui sont disponibles pour chaque magasin. Pour remplacer les valeurs par défaut et configurer une valeur spécifique à un ou plusieurs magasins, vous pouvez inclure le paramètre avec une valeur différente dans la configuration <store> pour les magasins.

À titre d'exemple, les étapes suivantes montrent comment configurer les valeurs par défaut pour une intégration avec IBM Digital Analytics. Pour plus d'informations sur la configuration d'une intégration à IBM Digital Analytics, voir Configuration du magasin pour communiquer avec IBM Digital Analytics(biConfig.xml).

Procédure

Accédez au fichier de configuration biConfig.xml à l'emplacement suivant : workspace_dir\crs-web\WebContent\WEB-INF\xml\config\biConfig.xml

Pour mettre à jour la configuration de votre fournisseur d'analyse, mettez à jour le fichier biConfig.xml de votre environnement de développement, puis déployez votre fichier dans l'archive d'entreprise HCL Commerce (EAR) sur votre environnement de transfert ou de production.

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.
Dans l'élément <biproviders>, ajoutez ou mettez à jour la configuration <biprovider> de votre fournisseur d'analyse.
Par exemple,
```
<biprovider name = "coremetrics">
```
Dans la configuration du fournisseur d'analyse <biprovider>, ajoutez un ou plusieurs des attributs ou éléments suivants et définissez la valeur par défaut.
clientid

ID client du fournisseur d'analyse, tel que fourni par le fournisseur d'analyse.

enabled
Indicateur qui contrôle si les balises d'analyse dans les pages de magasin sont activées pour envoyer des données au fournisseur d'analyse. Vous pouvez définir les valeurs suivantes pour cet indicateur :
- true - Les balises d'analyse sont activées.
- false - Les balises d'analyse ne sont pas activées ; les données d'analyse ne sont pas envoyées au fournisseur d'analyse.
debug
Indicateur qui contrôle si les balises d'analyse sont activées dans le mode débogage. Les messages de débogage apparaissent sur la page du magasin à l'emplacement de la balise, généralement au bas de la page. Vous pouvez définir les valeurs suivantes pour cet indicateur :
- true - Le débogage est activé.
- false - Le débogage n'est pas activé.
instrumentation
Cet élément inclut le code lié à l'intégration entre un magasin et le fournisseur d'analyse. Vous pouvez définir la section CDATA par défaut de cet attribut. Par exemple, le code qui inclut les bibliothèques JavaScript ou d'autres tâches connexes spécifiques au magasin à l'intérieur de l'élément, comme illustré dans l'exemple suivant :
```
<instrumentation>
        <![CDATA[
           <script type="text/javascript">
            /* Instrumentation code if any */
           </script>
         ]]>
   </instrumentation>
```
marketingCenterEnabled

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

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. Pour plus d'informations, voir Intégration à.

includeShipAdjustInProductPrice

Cet indicateur d'activation 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 avec un attribut useDDX est utilisé pour intégrer HCL Commerce à IBM Digital Data Exchange (DDX).

sortie

Cet élément inclut 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. Par exemple, vous pouvez définir une valeur par défaut pour les paramètres de fonction cmSetClientID. Vous pouvez définir les valeurs par défaut pour les paramètres de fonction cmSetClientID suivants pour la production en magasin et les systèmes de test.

ID client

ID client fourni par le fournisseur d'analyse. Par exemple, "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 le client pour chaque magasin.

Nom de domaine du fournisseur d'analyse

Nom de domaine du fournisseur d'analyse. Par exemple, "data.coremetrics.com".

Serveur HCL Commerce

Nom du domaine de votre serveur HCL Commerce. Par exemple, "thesite.com".

url

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

useCookies

Indicateur d'activation pour le stockage des informations de catégorie dans les cookies. Pour plus d'informations, voir Stockage d'informations de catégorie dans les cookies pour les rapports d'analyse.

useHostedCMHLibraries
Indique si le magasin utilise la bibliothèque standard IBM Digital Analytics. Vous pouvez définir les valeurs suivantes pour cet indicateur :
- true - La bibliothèque standard IBM Digital Analytics est utilisée.
- false - La bibliothèque personnalisée IBM Digital Analytics est utilisée.
useEmailForCustomerId
Indique s'il faut utiliser une adresse e-mail au lieu d'un ID de membre HCL Commerce pour identifier les clients dans IBM Digital Analytics. Vous pouvez définir les valeurs suivantes pour cet indicateur :
- true - Utilisez l'adresse e-mail du client comme identifiant 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 lorsque 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. Pour plus d'informations, voir tmtconfigsegbiconfig.html.
Facultatif : Remplacez les paramètres par défaut d'un ou de plusieurs magasins qui doivent utiliser différents paramètres de configuration.
1. Dans l'élément <stores>, ajoutez ou mettez à jour la configuration <store> des magasins. Dans cette configuration, vous devez associer le magasin au fournisseur d'analyse.
  Si vous souhaitez qu'un magasin n'utilise que les valeurs par défaut, vous devez toujours associer le magasin au fournisseur d'analyse en incluant la configuration d'élément <store> suivante :
```
<store storeId="10101" biprovider="coremetrics">
...
</store>
```
  Où
  storeId
  ID du ou des magasins que vous associez à un fournisseur d'analyse. Lorsque vous configurez les options de rapport d'analyse pour plusieurs magasins, vous pouvez appliquer une configuration à plusieurs magasins en incluant une liste de valeurs d'ID de magasin. Vous pouvez également copier l'exemple de configuration pour créer plusieurs configurations et appliquer chaque configuration à un ou plusieurs magasins. Vous pouvez spécifier la valeur storeId dans les formats suivants :
  
  Valeur storeId unique.
  
  Liste de valeurs storeId, séparées par des virgules. Par exemple, spécifiez storeId="10000, 10001" pour activer 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, spécifiez storeId="10000-10200" pour activer 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
  
  Nom du fournisseur d'analyse. Ce nom est le même que la valeur name spécifiée dans l'élément <biprovider>.
2. Dans l'élément de configuration <store>, ajoutez ou mettez à jour l'un des attributs ou éléments suivants pour remplacer les valeurs par défaut.
  Pour l'élément <output>, vous pouvez remplacer les configurations individuelles dans l'élément.
  - enabled
  - debug
  - instrumentation
  - marketingCenterEnabled
  - marketingCenterUrl
  - options
  - output
  - url
  - useCookies
  - useHostedCMHLibraries
  - useEmailForCustomerId
  - segmentExportMode
3. Enregistrez et fermez le fichier.
  Par exemple, l'exemple suivant biConfig.xml définit les valeurs par défaut pour 5 magasins et inclut des remplacements pour trois magasins. Deux magasins incluent uniquement la configuration pour associer le magasin au fournisseur d'analyse.
```
<BIConfiguration>
  <ssoKey></ssoKey>
  <biproviders>
    <biprovider name="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>
      <options>
        <attribute name="useDDX" value="true"/>
      </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>
      <header>
        <![CDATA[<script type="text/JavaScript">
        
        </script>]]>
      </footer>
    </biprovider>
  </biproviders>
 
  <stores>
   <store storeId="10101, 10102" 
      biprovider="coremetrics" 
      marketingCenterEnabled="false" >
      <useCookies>false</useCookies>
      <options>
        <attribute name="useDDX" value="true"/>
      </options>
    </store>
    <store storeId="10103" 
      biprovider="coremetrics" 
      marketingCenterEnabled="false"
      useEmailForCustomerId="true" >
      <options>
        <attribute name="useDDX" value="true"/>
      </options>
    </store>
    <store storeId="10104, 10105" biprovider="coremetrics" />
  </stores>
</BIConfiguration>   
```
Redémarrez les serveurs de test.