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. Though tracking parameters can be any type of value of your choosing, this guide takes you through the steps to add UTM parameters which are frequently used to track marketing and advertising campaigns on Google Analytics.

This guide covers: 

  1. How WordPress plugin users can track Bibblio using Google Analytics
  2. How Quick Start code users can track Bibblio using Google Analytics
  3. Where to find Bibblio in your Google Analytics dashboards

How WordPress plugin users can track Bibblio using Google Analytics

  1. In your WordPress admin, navigate to the Bibblio tab and click the Modules option in the menu.

  2. In the My Modules section, click the module you wish to track.

  3. Once the module builder appears, reveal the module's extra controls by clicking Module Settings.

    Open the Module Settings via this link
    Open the Module Settings via this link
  4. Scroll down to the Manage Tracking section and click on Add new tracking parameter.

  5. Enter the UTM type (ex: utm_source) in the Name field and whichever name you want to see appear in your reports in the Value field.

    Add as many parameters as you want
    Add as many parameters as you want
  6. Don’t forget to click Update.

    Save your settings by clicking Update
    Save your settings by clicking Update

That's it! You can confirm 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?utm_source=Bibblio&utm_medium=Sidebar_widget&utm_campaign=Sponsored

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 to generate a display code snippet.

    2. Follow the Quick Start installation wizard. Once you reach step 3 Add tracking (optional), select Create new tracking parameter.

    3. Enter the UTM type (ex: utm_source) in the Name field and whichever name you want to see appear in your reports in the Value field.

You can add as many UTM tags as you need
You can add as many UTM tags as you need
  1. Add as many tags as you want and select Add to snippet.

  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 want to add tracking parameters to a Bibblio module already on your site, you will need to update the display code snippet in 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="utm_source=Bibblio&utm_medium=Sidebar_widget&utm_campaign=Sponsored_content">
    </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?utm_source=Bibblio&utm_medium=Sidebar_widget&utm_campaign=Sponsored

Where to find Bibblio in Google Analytics 

Once UTM tags have been added, Bibblio's modules can be tracked alongside other traffic sources. Here are some instructions on how to create GA reports including Bibblio.

User metrics: New and Returning users, Session duration, pages per session

  1. In your Google Analytics menu, navigate to Acquisition > All Traffic > Source/Medium.
  2. Choose the date range you are interested in.
  3. You can filter the results so the report only displays Bibblio by typing "Bibblio" in the advanced search settings underneath the Explorer graph.
  4. For campaigns, go to Acquisition > Campaigns and follow the same steps.
Find Bibblio in your Acquisition reports
Find Bibblio in your Acquisition reports

Page metrics: Page views, Average time on page, 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. You can filter the results so the report only displays Bibblio. To do so, click the Secondary dimension icon and select Source/Medium in the drop-down menu. Next, click on advanced next to the search bar and choose a filtered view that includes Source/Medium containg "Bibblio":
    Find Bibblio in your Behavior report
    Find Bibblio in your Behavior report

Related guides

Need further assistance?

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