Tracking

Makaira offers the possibility to record user behavior in the store by means of tracking. We use the tracking solution Matomo (formerly Piwik), which we host for this purpose on our own servers in Germany. We can then in turn use this data for you to expand the ranking mix with detailed page view and "added to cart" boosts or to automatically evaluate the data, which allows us to provide the functions machine learning and recommendations by shopping cart history or by user history. Bist du an diesen vielfältigen Möglichkeiten interessiert, dann kontaktiere uns einfach. Das Tracking an sich ist kostenlos und es zeigt sich, dass je früher man damit anfängt, desto besser die später Ergebnisse sind.

Where and what is tracked

 

On all pages

 

Search

 

Category page

 

Product page

 

Shopping cart page / Add product to shopping cart

 

Order confirmation page

 

On all other pages

 

Integrations

We have already prepared various integration options. For example, in our OXID Connect module or via Google Tag Manager - choose your desired solution to learn more:

Integrations

OXID

A page ID is required for tracking, which is provided by Makaira Support.
In the module settings, this can be stored under "Tracking & Privacy".

The tracking starts when the following points are fulfilled:

The module settings can be changed under oxide 6.2 only in the deactivated state of the module.

 

image-1605868909913.png

Integrations

Google Tag Manager

Variables

Constants

{{Makaira Tracking ID}} Can be retrieved from your Installation page in Makaira

Data Layer Variables (DLV)

{{DLV - addedToCart}} Object: Product added to the shopping cart with fields `sku`,`name`, `price` (unit price), `category` (category title) and `quantity`.
{{DLV - totalCartValue}} Float: Total basket value in the current currency
{{DLV - order}} Object: An order with the fields id, revenue, subtotal, tax, shippingtotal, discounttotal and products (purchased products - respectively `name`, `price` (unit price), `category` (category title) and `quantity` as well as `sku`)
{{DLV - pageType}} String: type of page - either `product` (product detail page) or `category` (category page) or `searchresults` (search results page)
{{DLV - pageType}} String: type of page - either `product` (product detail page) or `category` (category page) or `searchresults` (search results page)
{{DLV - category}} String: category name of the current category (on category page)
{{DLV - search}} Object: Search `searchTerm` (search term) `resultCount` (number of search results)
{{DLV - experiments}} Array of Objects: `experiment` (Experiment ID) `variation` (Experiment Variation)
(Can be read 1:1 from the Makaira API response (key: `experiments`) and passed to GTM)

Tags

Makaira Tracking - Base Tag

Type: Custom HTML
Trigger: All Pages

<script type="text/javascript">
  var _paq = window._paq || [];
  
  _paq.push(['enableLinkTracking']);
  (function() {
    var u="https://piwik.makaira.io/";
    _paq.push(['setTrackerUrl', u+'piwik.php']);
    _paq.push(['setSiteId', {{Makaira Tracking ID}}]);
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
    g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'piwik.js'; s.parentNode.insertBefore(g,s);
  })();
</script>

Makaira Tracking - AddToCart

Type: Custom HTML
Trigger:  addToCart - Custom Event

<script type="text/javascript">
(function() {
  var _paq = window._paq = window._paq || [];
  
  var product = {{DLV - addedToCart}}
  _paq.push(["addEcommerceItem",product.sku,product.name,product.category,product.price,product.quantity])
  _paq.push(["trackEcommerceCartUpdate",{{DLV - totalCartValue}}]);
})();  
</script>

Makaira Tracking - Purchase

Type: Custom HTML
Trigger: Pages witj thank-you-URL or Custom Event - Purchase 

<script type="text/javascript">
(function() {  
  var _paq = window._paq = window._paq || [];
  
  var order = {{DLV - order}};
  var order_items = order.products;
  for(var i = 0; i < order_items.length; i++){
    _paq.push(["addEcommerceItem", order_items[i].sku, order_items[i].name, order_items[i].category, order_items[i].price, order_items[i].quantity]);
  }
  _paq.push(["trackEcommerceOrder", order.id, order.revenue, order.subtotal, order.tax, order.shippingtotal, order.discounttotal]);  
  _paq.push(["trackPageView"]);
})();  
</script>

Makaira Tracking - Category, Product Detail

Type: Custom HTML
Trigger: Pages with detail URL pattern and category URL pattern or ProductDetailView & ProductImpression - Custom Events

<script type="text/javascript">
(function() {
  var _paq = window._paq = window._paq || [];
  
  var trackView = false;
  var arg1, arg2, arg3;
  switch ({{DLV - pageType}}) {
    case ('category'):
      var cat = {{DLV - category}};
      arg1 = false;
      arg2 = false;
      arg3 = cat;
      trackView = true;
      break;
    
    case ('product'):
      var prod = {{DLV - product}};
      arg1 = prod.sku;
      arg2 = prod.name;
      arg3 = prod.brand;
      trackView = true;
      break;
  }

  if (trackView) {
    _paq.push(['setEcommerceView', arg1, arg2, arg3]);
    _paq.push(['trackPageView']);
  }
})();  
</script>

Site Search Tag

Type: Custom HTML
Trigger: Pages with search page URL pattern or SearchResultView - Custom Event

<script type="text/javascript">
(function() {
  var _paq = window._paq = window._paq || [];
  
  var trackView = false;
  var arg1, arg2, arg3;
  
  switch ({{DLV - pageType}}) {
    case ('searchresults'):
      arg1 = {{DLV - search.searchTerm}};
      arg2 = false;
      arg3 = {{DLV - search.resultCount}};
      trackView = true;
      break;
  }
  if (trackView) {
    _paq.push(['deleteCustomVariables', 'page']);
    _paq.push(['trackSiteSearch', arg1, arg2, arg3]);
    _paq.push(['trackPageView']);
  }
})();  
</script>

Makaira Tracking - A/B-Testing

Type: Custom HTML
Trigger: All Pages

<script type="text/javascript">
(function() {  
  var _paq = window._paq = window._paq || [];
  
  var experiments = {{DLV - experiments}};
  for(var i = 0; i < experiments.length; i++){
   _paq.push(['trackEvent', 'abtesting', experiments[i].experiment, experiments[i].variation]);
  }
})();  
</script>

 

Integrations

Shopware 5

A page ID is required for tracking, which is provided by Makaira Support.
You must set it in the plugin setting "Tracking Page-ID".

The name of the cookie is makairaExperiments and it is registered under the name makairaTracking in the cookie consent manager.

The tracking starts when the following points are fulfilled:

Check the tracking function

image-1602155966010.png

Matomo (formerly Piwik see also https://matomo.org/) is integrated into your store via JavaScript and sends the actions of the users to our Matomo servers. To check if the tracking works correctly on your site you can do the following:

  1. Make sure JavaScript is enabled in your browser and no tracking blockers are active.

     

  2. Go to your site and perform some typical actions there, such as searches, or page visits.

     

  3. In the network tab of your browser, if you filter for Piwik, you should see at least two entries: piwik.js and piwik.php (see image above). If this is the case, your tracking is working fine.

    1. if you don't see the call to piwik.js: Check if you are loading our base tag correctly see https://docs.makaira.io/books/tracking/page/google-tag-manager#bkmrk-name%3A-3pt---piwik---
    2. If you don't see the call to piwik.php:
      1. Check if you have the correct siteID set and the base tag is loaded correctly by executing the following command in your comand line in the browser _paq.push(["trackPageView"])
      2. If yes: then your integration works correctly but your events that are firing the tracking are maybe not working correctly. Check your Google Tag Manager Configuration and/or your Javascript.
        See also https://docs.makaira.io/books/tracking/page/google-tag-manager for our default event code
  4. In the data of the piwik.php requests you will find, among other things, the field _id. This is your user ID in our Matomo.
  5. If steps 1-4 worked, please simulate a user and buy something in your store.

  6. Now please send us your Matomo UserID so that we can search your visitor profile for you. With this profile you can check in detail if all places have been tracked by our tracking.

    image-1602156007169.png

Privacy

Important notes for the users of Makaira

If you embed Makaira on your website, you must inform your website visitors about this in your privacy policy. We provide you with a corresponding passage for this purpose. Please note that the data protection passage has been created to the best of our knowledge and belief, but it is a voluntary service on our part that cannot replace legal advice. In particular, we cannot guarantee that the passage we have provided does not contain any contradictions with your existing data protection statement. In case of doubt, you should therefore have it checked by your lawyer.

Please also note that based on existing case law, the use of analytics tools may require consent, which we also recommend.

1. Analysis with Makaira

The website operator uses analysis tools from Makaira GmbH, Rudolf-Diesel-Strasse 11, 69115 Heidelberg (hereinafter Makaira) on its website. An order processing agreement has been concluded with Makaira.
Makaira enables the website operator to analyze the use of the website by website visitors using the open source software Matomo. This involves various usage data, such as page views, dwell time, device categories, operating system (e.g. PC with Windows operating system) and origin of the user (e.g. access to the site via paid advertisements or unpaid search results) or contents of the current shopping cart. This data is summarized by Makaira in a profile that is assigned to the respective user or their end device.
Based on the collected data, Makaira creates a forecast about the preferences of the website visitors. Depending on the preferences determined, the products in the store are then presented to the customer in a specific order or suitable product suggestions are made.

2. Legal basis

The use of Makaira is based on the legitimate interest of the website operator of an optimal promotional presentation of its products (Art. 6 para. 1 p. 1 lit. f DSGVO). If consent has been requested, the data is processed exclusively on the basis of Art. 6 para. 1 p. 1 lit. a DSGVO. The consent can be revoked at any time with effect for the future.
3. Storage

The profiles created with the help of Makaira are stored anonymously only.