Utilisation de la balise de commande avec IBM Digital Analytics

Placement de balise dans la page JSP du magasin

Incluez la balise <cm:order /> dans la page de confirmation de la commande. Dans la page, placez la balise <cm:order /> avant la balise <cm:pageview />.

Vous devez également inclure la bibliothèque de balises dans la page JSP du magasin avant le contenu de la page principale. Utilisez le code suivant :

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

La sortie de données par la balise <cm:order /> diffère selon le type de bibliothèque de balises IBM Digital Analytics utilisé par votre magasin. Pour voir des exemples, accédez à l'une des sections suivantes :

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

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

digitalData.transaction={attributes:{exploreAttributes:'', 
  extraFields:'-_--_--_--_--_--_--_--_--_--_--_--_-Save $25 on all orders over $200 USD-_--25.00-_-'}, 
  profile:{address:{city:'City', postalcode:'90210', state_province:'CA'}, 
  profileInfo:{profileID:'-1000'}},
  total:{basePrice:'1110.00', currency:'USD', shipping:'0.00'}, transactionID:'11001'};
digitalData.transaction.item=new Array();
digitalData.transaction.item[0]={};
digitalData.transaction.item[0]={attributes:{exploreAttributes:'', 
  extraFields:'-_--_--_--_--_--_--_--_--_--_--_--_--_-'}, 
  category:{primaryCategory:'3074457345616676683', virtualCategory:''}, 
  currency:'USD', price:'977.97', 
  productInfo:{productID:'MCL008_0802', 
  productName:'Albini Dark Gray Wool Suit'}, quantity:'1'};
digitalData.transaction.item[1]={};
digitalData.transaction.item[1]={attributes:{exploreAttributes:'', 
  extraFields:'-_--_--_--_--_--_--_--_--_--_--_--_--_-'}, 
  category:{primaryCategory:'3074457345616676695', virtualCategory:''}, 
  currency:'USD', price:'132.03', productInfo:{productID:'CAC024_2401', 
  productName:'Widescreen LCD Monitor'}, quantity:'1'};
  
cmSetupOther({"cm_currencyCode":"USD"});

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

1. Pour chaque article du panier d'achat, la balise IBM Digital Analytics suivante est générée :

   cmCreateShopAction9Tag (productId, productName, productQuantity, productPrice, 
   customerId, orderId, orderTotal, categoryId, store_id, currency, 
   account_name, contract_name, masterItemCategory, catIDoverride, attributes)

2. Pour obtenir des informations récapitulatives de commande, la balise IBM Digital Analytics suivante est générée :

   cmCreateOrderTag (orderId, orderTotal, orderShipping, customerId, 
   customerCity, customerState, customerZip, store_id, currency,
    promotion_name, promotion_discount, promotion_code, attributes)

Exemple 1 :

Pour transmettre le résumé de la commande de base et les données d'élément du panier d'achat à IBM Digital Analytics :

<cm:order databean="${order_OrderDataBean}" />

<cm:order orderType="${order}" /> 

cmCreateShopAction9Tag("FULO-01", "White Fabric Roll Arm Chaise", 
"1", "355.45", "7002", "35002", "355.45", 
"10104", "10101", "USD", null, null, "10104");

cmCreateOrderTag("35002", "355.45", "6.44", "7002", "Atlanta", 
"GA", "23456", "10101", "USD", 
"Furniture Category Discount|Save 10%|Flat Shipping", 
"-90.0|-36.0|-0.94", "||"); 

Exemple 2 :

Pour inclure la taxe dans le prix unitaire et le total de commande qui est envoyé à IBM Digital Analytics, utiliser les paramètres includeTaxInUnitPrice et includeTaxInTotalPrice :

<cm:order databean="${order_OrderDataBean}"
includeTaxInUnitPrice="true" includeTaxInTotalPrice="true" />

<cm:order orderType="${order}" 
    includeTaxInUnitPrice="true" includeTaxInTotalPrice="true" />

Exemple 3 :

Pour transmettre les attributs IBM Digital Analytics Explore à IBM Digital Analytics cmCreateShopAction9Tag et cmCreateOrderTag, utilisez le paramètre extraparms (deuxième position) et le paramètre orderExtraparms (première position) :

<cm:order databean="${order_OrderDataBean}" 
extraparms="null,attr1-_-attr2-_-attr3" 
orderExtraparms="attr4-_-attr5-_-attr6"/>

<cm:order orderType="${order}" 
extraparms="null,attr1-_-attr2-_-attr3" 
orderExtraparms="attr4-_-attr5-_-attr6"/>

cmCreateShopAction9Tag("FULO-01", "White Fabric Roll Arm Chaise", 
"1", "355.45", "7002", "35002", "355.45", 
"10104", "10101", "USD", null, null, "10104", null, "attr1-_-attr2-_-attr3");

cmCreateOrderTag("35002", "355.45", "6.44", "7002", "Atlanta", 
"GA", "23456", "10101", "USD", 
"Furniture Category Discount|Save 10%|Flat Shipping", 
"-90.0|-36.0|-0.94", "||", "attr4-_-attr5-_-attr6");

Exemple 4 :

Pour transmettre à la fois les attributs IBM Digital Analytics Explore and plus de données pour les rapports personnalisés à IBM Digital Analytics cmCreateShopAction9Tag et cmCreateOrderTag, utilisez le paramètre extraparms (deuxième et troisième position) et le paramètre orderExtraparms (première et deuxième position) :

<cm:order databean="${order_OrderDataBean}" 
extraparms="null, attr1-_-attr2-_-attr3,exField1-_-exField2-_-exField3" 
orderExtraparms="attr4-_-attr5-_-attr6,exField4-_-exField5-_-exField6"/

<cm:order orderType="${order}" 
extraparms="null, attr1-_-attr2-_-attr3,exField1-_-exField2-_-exField3" 
orderExtraparms="attr4-_-attr5-_-attr6,exField4-_-exField5-_-exField6"/

cmCreateShopAction9Tag("FULO-01", "White Fabric Roll Arm Chaise", 
"1", "355.45", "7002", "35002", "355.45", 
"10104", "10101", "USD", null, null, "10104", null,
"attr1-_-attr2-_-attr3","exField1-_-exField2-_-exField3");

cmCreateOrderTag("35002", "355.45", "6.44", "7002", "Atlanta", 
"GA", "23456", "10101", "USD", 
"Furniture Category Discount|Save 10%|Flat Shipping", 
"-90.0|-36.0|-0.94", "||", 
"attr4-_-attr5-_-attr6","exField4-_-exField5-_-exField6");

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.