How to...

Track Bibblio in your Google Analytics

The fast track

Whether you are using one or several modules on your site, you may want to track how users interacting with the recommendations behave across other key metrics such as bounce rate, pages per session or average session duration. Adding tracking parameters to your Bibblio modules allows you to track users who accessed a page by clicking on one of the recommendations.

 

The problem with UTMs

People familiar with tracking may assume UTM parameters in a link's query string could fit the bill. UTM parameters are designed to track audience acquisition between sites by creating a session to follow the activity from source to destination and beyond. If UTMs are used purely for in-site journeys, they will start a new session each time a recommendation link is clicked, which will disrupt the session data, making clear tracking impossible.

Instead, Bibblio uses ITM parameters on its recommendation links. ITMs are an unofficial labelling convention that refers to the "internal" nature of tracking in-site behavior. The use of ITMs are gaining traction among analysts and marketers alike. (This is Bibblio's suggestion to you, but you can use any labelling taxonomy you like.)

Nb. Bibblio still uses UTMs for their Syndicated recommendations, where cross-site linking is required. 

Suggested ITMs

Here is the suggested naming convention for three ITM parameters that could be useful to track clicks on Bibblio recommendation links throughout your site:

itm_source

This is the broadest parameter. It declares the link being clicked on is provided by Bibblio. Use this to find all Bibblio links in your Google Analytics:

itm_source=bibblio

 

itm_campaign

This parameter lets you hone in on a particular recommendation type. Multiple modules can use the same recommendation type, so you can get a reading of how they are performing as a group. For example, you can use this value to find all Bibblio links that use the "Related" recommendation type:

itm_campaign=bibblio-related

 

itm_medium

This parameter can apply to any links within a module based upon its location or by targeting a specific module. Use this to drill down to its placement on-page or to an individual module. E.g. Use this value to find all links clicked in any module located in the footer:

itm_medium=bibblio-footer

Or use this value to find all links clicked in a specific module that you are using for e-commerce:

itm_medium=bibblio-ecommerce

Any value can be created for your own tracking, so long as it's consistent.



You can also make further custom ITM parameters if you wish, to cover other tracking needs you may have.

 

In this guide

  1. How Quick Start code users can track Bibblio using Google Analytics

  2. Where to find Bibblio in your Google Analytics dashboard

How Quick Start code users can track Bibblio using Google Analytics

The display code snippet can be customized to include tracking parameters.

 

If you are creating a new Bibblio module:

  1. Log in to your Explorer account and go to Quick Start.

  2. Follow the Quick Start installation wizard. When you reach Add tracking, click Create new tracking parameter.

  3. In the Name field, type itm_source. In the Value field, type bibblio. Click Add to Snippet.

  4. Click Create new tracking parameter. In the Name field, type itm_campaign. In the Value field, type bibblio- followed by the recommendation type you're using for this module, e.g. bibblio-related. (Nb. The default recommendation type is 'Related'. Different recommendation types cannot be chosen using this wizard. Ask the Bibblio team about changing the recommendation type.) Click Add to Snippet.

  5. Click Create new tracking parameter. In the Name field, type itm_medium. In the Value field, type bibblio- followed by either the module location or a unique indentifier you want to use for this module. E.g. A module in the footer could use the value bibblio-footer to identify it. Click Add to Snippet.

You can add as many UTM tags as you need
These main three ITM tags will help granulate your tracking, but you can create as many as you like.
  1. Beyond these three, you can add as many extra tracking parameters as you'd like, in the same way.

  2. Scroll down to step 4b of the Quick Start installation wizard to find the display code automatically filled with the tracking values.

  3. Copy the code and paste it into your site's template where you want the recommendations to appear.

 

If you are adding tracking parameters to an existing Bibblio module:

To add tracking parameters to a module already on your site, you must update the display code snippet within your site's template:

  1. Navigate to the section of your site's template where you added the Bibblio code. 

  2. Add tracking parameters to the display <div> snippet as a single string using the data-query-string-params attribute. For example:

    <div class="bib--rcm-init"
    data-recommendation-key="YOUR_RECOMMENDATION_KEY"
    data-style-classes="YOUR_CLASSES"
    data-query-string-params="itm_source=bibblio&itm_campaign=bibblio-related&itm_medium=bibblio-footer">
    </div>

    Once updated, save and publish your changes on your site.

That's it! You can verify it works by going to a page on your site where Bibblio appears and clicking one of the recommendations in the module. The page should load with the tracking parameters appended to the page URL with the following format:

https://your-domain.com/article-1234?itm_source=bibblio&itm_campaign=bibblio-related&itm_medium=bibblio-footer

Where to find Bibblio in Google Analytics 

Once ITM tags have been added, Bibblio's modules can be tracked alongside other page behaviors. 

 

Page views, average time on page, and bounce rate

  1. In your Google Analytics menu, navigate to Behavior > Site Content > All Pages.

  2. Choose the date range you are interested in.

  3. In the filter field beneath the graph, type itm_source=bibblio (or whichever parameter name and value you wish to find) and click the magnifier icon.

Related guides

Need further assistance?

Visit the Help Center or get in touch with the Bibblio team.