e-Commerce Tracking:
How to Track Successful Orders to excentos Analytics

The e-Commerce Tracking is part of the excentos' Web Analytics and allows tracking orders of products that have been recommended by the Product Guide. E-Commerce Tracking is offered by excentos free of charge and we recommend activating it in order to measure and improve your Product Guide's long term success. Depending on your contract with excentos, e-Commerce Tracking can also be mandatory.
This documentation describes how orders in your Shop are generated (addToBasket) and how excentos gets informed about successful orders (successNotifier).

Goal of e-Commerce Tracking

The standard event tracking only recognizes User Actions that take place within the Product Guide. Because some consumers tend to purchase later, also sometimes in another visit, and because transactions often take place outside of excentos Product Guide (i.e. in your product detail page), it is in many cases impossible for excentos to track the transaction itself without your help.

How are orders generated (addToBasket)?

excentos uses the shopping cart functionality of your Shop or Website. Most of the times, this functionality is called addToBasket or addToCart.
The only thing excentos needs to know is how we put a product into your basket. Most shop systems use a method similar to addToBasked(SKU,referrer) that adds one or several SKUs into your basket and transmits a referrer.

How does excentos get informed about successful orders (successNotifier)?

For each successful visitor (i.e. the user actually completed the checkout), excentos stores the information needed to determine whether an excentos recommendation led to a purchase or not. The information is kept anonymously in a serverside database.

Depending on your project configuration and contract type, this information contains the following data:

  • visitor ID
  • list of product IDs rendered by the client (i.e. displayed in the web browser's viewport upon active user request / scrolling to make the recommendation visible)
  • product ID and, if applicable, master product ID (in order to determine if a user bought a variant of a product recommended by excentos)
  • Technical Integration of e-Commerce Tracking

    In order to activate the e-Commerce Tracking, you only have to integrate the successNotifier code snippet into the transaction confirmation page of your Shop, which tracks the above mentioned information.

      1 |  <script>
      2 |       (function(E,x,c,e,n,t,o,s){o="ExcentosSuccessNotifier";E[o]=E[o]||function(){(E[o].q=E[o].q||[]).push(arguments)};
      3 |       n=x.createElement(c);t=x.getElementsByTagName(c)[0];n.async=1;n.src=e;t.parentNode.insertBefore(n,t);})
      4 |       (window,document,"script","//service.excentos.com/projectName/systemName/ajaxclient/xcProject/ExcentosSuccessNotifier.js");
      5 |       // example service-URL: "//service.excentos.com/bikeshop/DE/ajaxclient/xcProject/ExcentosSuccessNotifier.js"
      6 |  
      7 |       // Send each item from shop checkout to the ExcentosSuccessNotifier with "checkout" command,
      8 |       // which matches against previously recommended products
      9 |  
     10 |       // Please call the following function for each product in the shopping cart. Below are some sample calls.
     11 |       // ExcentosSuccessNotifier(command, ProductId, ProductMasterId, ProductLabel, Category, Price per SKU, Quantity, Currency);
     12 |
     13 |       ExcentosSuccessNotifier("checkout", "236120001", "23612", "Cooles Herren Shirt", "T-Shirt", 19.99, 1, "Euro");
     14 |       ExcentosSuccessNotifier("checkout", "236120052", "23612", "Fancy Herren Shirt", "T-Shirt", 19.99, 1, "Euro");
     15 |       ExcentosSuccessNotifier("checkout", "251560008", "25156", "Herren Strick Pullover", "Pullover", 79.98, 2, "Euro");
     16 |
     17 |       // Finally the "track" command will send the data to the excentos Analytics System
     18 |       // together with the Order/Transaction-ID of your Shop-System / Cart-Functionality  
     19 |       // ExcentosSuccessNotifier(command, OrderID)
     20 |       ExcentosSuccessNotifier("track", "order123456789");
     21 |  </script>
  • Pay per Order (PPO) Tracking

    If we agreed upon the Pay-per-Order (PPO) model, excentos gets a monetary incentive if your Shop/Website sells more through Guided Selling. This section describes how the PPO tracking works. It is only relevant to you if both parties agreed upon the PPO model.
    In the PPO model, only revenues from Guided Selling Transactions are invoiced. A Guided Selling Transaction is a transaction within your Shop system where a user buys a product that was previously rendered by excentos in the user's viewport (i.e. the web-browser or mobile device browser of your visitor).

    Pay Per Order Tracking

    As the image shows, excentos stores information only if required for checking orders caused by excentos and for invoicing.

  • FAQ and further information

    How does the successNotifier work?

    The successNotifier is activated by your transaction confirmation page. It checks via a cookie whether the user ever used the excentos Product Guide. If not, no further data is exchanged. Only if the user ever used the excentos Product Guide, the successNotifier checks for every product ID of an order, if the product was recommended by excentos (i.e. displayed in the browser's viewport). Only if a product was recommended by excentos, the order data is transmitted to and stored by excentos.

    • How does the successNotifier work?

      The successNotifier anonymously checks whether the user ever used the excentos Product Guide.

      The successNotifier is activated by your transaction confirmation page. It checks via a cookie whether the user ever used the excentos Product Guide. If not, no further data is exchanged. Only if the user ever used the excentos Product Guide, the successNotifier checks for every product ID of an order, if the product or a product variant was recommended by excentos (i.e. displayed in the browser's viewport). Only if a product was recommended by excentos, the order data is transmitted to and stored by excentos.

    • Does the excentos e-Commerce Tracking affect my website's shopping basket functionality?

      No since it is not integrated into the checkout, but only into the order confirmation page

      The excentos SuccessNotifier method is activated only in the order confirmation page. Thus, the user already purchased the product. The SuccessNotifier does not interfer with your website's order functionality.
      Most websites have integrated tracking pixels and / or affiliate tracking methods in the order confirmation page, that's why excentos also uses it for the SuccessNotifier.

    • Which data does excentos use in the invoice for pay-per-order-based business models?

      excentos uses the data contained in the excentos Analytics

      If your pricing contains a pay-per-order-based component, your invoice is derived from the excentos Analytics in the report "Ecommerce | Overview". Please check that report for the corresponding date range to compare with the data contained in your invoice.

      The values of the excentos Analytics used are: Ecommerce Orders (number of orders) and Average Order Value (average price of the products bought).

      As typical in web analytics / tracking solutions, sometimes values of different tracking solutions can slightly vary (e.g. also of the eCommerce figures from excentos Analytics or the PPO module in excentos Backend) due to e.g. slightly different time stamps or different metrics definition / reports. Another possible reason for deviations is if the successNotifier is called multiple times which can happen if the user reloads the order confirmation page (the multiple logs are included in the excentos Backend (full database log), but not in the excentos Analytics (unique user actions). In case of deviations, the figures of excentos Analytics are relevant.

      If you want to doublecheck the figures of your invoice, you may use the excentos Backend reports to see the full list of transactions and products bought per user ID. See the FAQ "How can I compare an order tracked by excentos..." below for instructions.

    • What is a recommended product? What does rendered in theviewport mean?

      Each product that was rendered by the user's web-browser is interpreted as a recommended product

      excentos uses Javascript functions to assess whether a product was rendered in the user's web-browser. A product can only be rendered by the web-browser if the user clicked or scrolled through the Product Guide to see the result list. Depending on your project configuration, this in most cases requires answering mandatory questions. Thus, rendered products are individual recommendations actively requested by the user.

    • How can I test which products were recommended by the excentos Product Guide?

      You can check the list of recommended products in the excentos backend for each visitor

      excentos stores for each visitor which products were recommended to him. Here is how you can access this information:

      1. get the excentos Visitor ID
        • get the excentos Visitor ID for yourselves: if you want to check the list of recommended products for you own excentos Visitor ID after using the excentos Product Guide with your web-browser, you can derive your excentos Visitor ID from the cookie stored in your browser. Open the list of cookies in your web-browser, then filter for the cookies of your website (e.g. www.your-bikeshop.com) and search for the cookie named xcVisitorId. Your excentos Visitor ID is contained in the field content or so of the cookie. An example for the excentos Visitor ID is: 1162205206
        • get the excentos Visitor ID for another visitor: If you want to check the recommended products for another Visitor, you first need to identify the user's excentos Visitor ID. Log into the excentos Analytics-system. Go to the report "Visitors | Visitor Log". Select the corresponsing date range or custom segments to identify the user. In the list of visitors, there are 2 options to read the excentos Visitor ID: a) hover over the list item for the Visitor and see the excentos Visitor ID on the right side or b) see the excentos Visitor ID on the left side below the date (please note that in the tooltip in our Analytics-system, the ID is called "User ID" but it denotes the excentos Visitor ID)
      2. get the list of recommended products for a excentos Visitor ID: login into the excentos Backend. Go to the menu "Start | Administration | Pay-Per-Order" (only available if pay-per-order tracking is enabled for your project). Go to the report "Recommended Products for a Visitor of the Product Guide". Enter the excentos Visitor ID into the search field and hit "Get Recommended Products".
        The report shows several dates when this Visitor used the Product Guide, and for each visit lists the Product IDs of your Shop-System that were recommended to this Visitor.
        To compare these Product IDs with your Shop-System, most Shop-Systems contain this data in their search and product detail page.
    • How can I check all events / actions of a user? How can I see the order details for a visitor ID?

      You can analyse all activities for every user in the excentos Analytics system

      If you want to check the actions a user made or want to see the order details for a user, you need the visitor ID and the excentos Analytics system. Here's how you can access the data:
      • go to the excentos Analytics system and log in
      • open thevisitor log (report: Visitors | Visitor Log)
      • determine the visitorID that you want to look for and when (date and time) this visitor used the Product Guide. To determine the date and time of a visitor, you can also use the excentos PPO backend functionality described above
      • filter the Piwik visitor log view for the date when the visitorID used the Product Guide
      • if the visitor log contains more than 1 page, then go to the page of the visitor log with the corresponding time value
      • identify the data set by comparing the visitor ID (numerical value shown in the left column, row 4)
      • you can now see all actions and - if applicable - the order the user placed
    • How can I compare an order tracked by excentos with the order data in my Shop?

      Compare the order ID that excentos stored for each successful visitor

      If you want to compare the orders tracked by excentos with the orders generated and tracked in your Shop / e-Commerce system, use the order ID to compare the information stored in excentos Analytics and your Shop:

      1. go to the excentos Backend, login and select the view "Start | Administration | Pay-Per-Order"
      2. go to the report "E-commerce Orders by Date Range"
      3. select the corresponding date range and run the report with "Get Ordered Products"
      4. check the table that contains the order IDs of your Shop
      5. compare the order ID and order information in the excentos Backend with the order information of your Shop
    • What about product variants?

      When users shop for products, they first decide for a basic product and then for a product variant such as e.g. color or size variation. Depending on the product data you provide to excentos and whether the product variant is already selected within the Product Guide or within your product detail pages (which is mostly the case), excentos displays master products or one (or several) selected product variant.
      Since in any case excentos helped to convince the user of the (master) product itself - and in many cases the variant is only selected within your Shop / Website - the PPO tracking contains any product variant no matter whether this specific or another product variant was recommended to the user.