Configuration du magasin pour communiquer avec IBM Digital Analytics(biConfig.xml)

Configurez les paramètres du fichier biConfig.xml afin que l'intégration avec soit activée et configurée pour votre magasin.

Avant de commencer

Examinez les informations suivantes concernant l'exemple de fichier biConfig.xml fourni avec HCL Commerce :

Exemple de fichier biConfig.xml pour IBM Digital Analytics :

Pourquoi et quand exécuter cette tâche

Lorsque vous mettez le fichier biConfig.xml pour définir la configuration du fournisseur d'analyse, vous pouvez définir des valeurs par défaut pour chaque paramètre de configuration. En définissant des valeurs par défaut, vous pouvez configurer rapidement plusieurs magasins pour utiliser la même configuration pour un fournisseur d'analyse. Vous pouvez également remplacer l'une des valeurs par défaut d'un magasin individuel en incluant une valeur différente dans la configuration du magasin. Pour plus d'informations, voir Configuration des valeurs par défaut pour un fournisseur d'analyse.

Procédure

Dans votre environnement de développement, définissez votre fichier biConfig.xml.

HCL Commerce DeveloperLorsque 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.

  1. Accédez au répertoire suivant, qui contient l'exemple de fichier biConfig.xml : WCDE_installdir/samples/Coremetrics/xml/biConfig.xml
  2. Ouvrez le fichier biConfig.xml pour l'éditer.
  3. Configurez les options de reporting d'analyse pour chaque magasin qui doivent être associées à un fournisseur d'analyse :
    1. Localisez une ligne similaire au code suivant :
      <store
          storeId = "10101"
          biprovider = "coremetrics"
          enabled = "true"
          debug = "true"
          marketingCenterEnabled="true"
          useHostedCMHLibraries = "true"
          useEmailForCustomerId = "false"
          segmentExportMode = "append">
      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.
    2. Modifiez la valeur de l'ID de magasin et de l'identificateur de fournisseur d'analyse pour associer le magasin au fournisseur d'analyse. Vous pouvez définir des valeurs pour les attributs suivants :
      storeId
      Spécifie le storeId du ou des magasins que vous souhaitez activer pour IBM Digital Analytics. Vous pouvez spécifier la valeur storeId comme :
      1. Valeur storeId unique.
      2. 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.
      3. 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
      Fournisseur d'analyse. Laissez cette valeur définie sur coremetrics.
    3. Définissez des valeurs pour l'une des options de rapport suivantes que vous souhaitez configurer pour chaque magasin.

      Si vous avez configuré des valeurs par défaut pour un fournisseur d'analyse, vous pouvez remplacer l'une de ces valeurs en définissant des valeurs spécifiques au magasin. Pour réutiliser une valeur par défaut, supprimez la valeur spécifique au magasin.

      clientId
      ID client du magasin, tel que fourni par le fournisseur d'analyse.
      enabled
      Indique si le suivi est activé, ce qui signifie que les données d'analyse sont 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.
      instrumentation
      Code d'instrumentation lié à l'intégration entre un magasin et le fournisseur d'analyse. 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>

      Vous pouvez définir la section CDATA par défaut dans cet attribut

      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 vous intégrez le Centre de gestion avec IBM Marketing Center, vous pouvez inclure cet élément pour remplacer l'URL par défaut vers 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
      En cas d'intégration à IBM Digital Data Exchange (DDX), vous pouvez inclure cet élément et l'attribut useDDX avec une valeur de "true" pour activer l'intégration. Pour plus d'informations sur cette intégration, voir Intégration à IBM Digital Data Exchange.
      sortie
      Les fragments JavaScript, ou tout autre contenu, que vous souhaitez écrire à un emplacement spécifique dans les pages de votre magasin.
      url
      URL pour le lancement du fournisseur d'analyse à partir du Centre de gestion.
      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.
      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.

      Définissez ce paramètre sur true uniquement si votre magasin exige que les clients fournissent leur adresse e-mail lorsqu'ils s'inscrivent et lorsqu'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 tmtconfigsegbiconfig.html.
  4. Facultatif : Configurez vos rapports d'analyse pour chaque magasin afin qu'ils utilisent des cookies pour stocker des informations de catégorie.
  5. Définissez l'ID client IBM Digital Analytics pour chaque magasin :
    1. Recherchez la ligne suivante :
       <clientid>69999999</clientid>
    2. Remplacez 69999999 par l'ID client de votre magasin, tel que fourni par IBM Digital Analytics :
      Cette valeur contrôle l'ID client utilisé par l'intégration pour lancer des rapports IBM Digital Analytics à partir du Centre de gestion.
      • Pour lancer des rapports à partir du serveur de testIBM Digital Analytics, utilisez votre ID client de test, qui commence généralement par le chiffre 6.
      • Pour lancer des rapports à partir de l'environnement de production IBM Digital Analytics, utilisez votre ID client de production.
  6. Facultatif : Configurez l'élément <url> de chaque magasin pour remplacer les URL par défaut afin d'ouvrir votre fournisseur d'analyse à partir du Centre de gestion.
  7. Mettre à jour le contenu de l'élément <output> pour chaque magasin :
    1. Recherchez les lignes suivantes :
      <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>
    2. Remplacez 99999999 par votre ID de client de production IBM Digital Analytics.
    3. Remplacez 69999999 par votre ID client de test IBM Digital Analytics.

      Notez que la ligne qui contient votre ID de client de production est commentée, alors que la ligne qui contient votre ID client de test ne l'est pas. Cet ID signifie que vos données d'analyse sont envoyées initialement au serveur de test IBM Digital Analytics. Lorsque vous êtes prêt à envoyer des données à l'environnement de production, vous pouvez commenter la ligne qui contient votre ID de client de test, supprimer les commentaires de la ligne qui contient votre ID de production, puis remplacer l'ID client que vous avez configuré à l'étape 5.a par votre ID de client de production.

      Remarque : Si vous utilisez IBM Digital Analytics Multisite, avec un ID client Multisite Analytics tel que '88888888' et un sous-ID, où <SiteID>est le sous-ID Multisite Analytics configuré, et que vous souhaitez envoyer en production, remplacez la valeur de cmSetClientID() par :
      cmSetClientID("88888888|SiteID",true,"data.coremetrics.com","thesite.com");
      Pour plus d'informations, voir cmSetClientID.
    4. Remplacez les deux occurrences thesite.com par le nom de domaine de votre serveur HCL Commerce.
  8. Facultatif : Au sein des éléments <header> et <footer> du fichier biConfig.xml, vous pouvez inclure toutes les fonctions ou instructions JavaScript courantes qui doivent être placées dans les fichiers JSP du magasin ainsi que les fonctions de balisage.
  9. Facultatif : Si vous souhaitez configurer une connexion unique entre le Centre de gestion et IBM Digital Analytics, vous pouvez ajouter une clé secrète pour l'authentification unique à votre fichier biConfig.xml dès maintenant. Vous pouvez également configurer l'authentification unique ultérieurement. Pour les étapes complètes, voir Configuration de l'authentification unique entre le Centre de gestion et IBM Digital Analytics.
  10. Enregistrez et fermez le fichier.
    Pour un exemple de fichier biConfig.xml complet, voir Exemple de fichier biConfig.xml pour IBM Digital Analytics :.
  11. Redémarrez les serveurs de test.