BCdiploma Knowledge BaseBCdiploma Knowledge Base
User guide
Technical guide
API
Terms and Data
  • English
  • Français
User guide
Technical guide
API
Terms and Data
  • English
  • Français
  • Technical

    • General information about technical architecture
    • Certificate’s integration in the issuer Website
    • Analytics Tracking
    • Sending emails from your own domain
    • Put a link to your website in the proofs
    • Integrating a Certificate Verification Tool into Your Website
    • Setting up a Certificate Adding Link on LinkedIn
    • Note on email deliverability
    • Moodle Plugin
    • SSO Setup

Analytics Tracking

You can track the use of links for certificates generated via BCdiploma using an analytics tool like Matomo, Google Analytics, or Google Tag Manager.

These tools work by inserting code into the certificate page, which will be executed when the certificate is accessed by a user.

Tips

Running this code will result in the collection of data by your analytics tool, including information related to the user visiting the page. As such, you must take all necessary measures to comply with current data protection regulations, especially by configuring your analytics tool and implementing a consent request.

Activation

To activate tracking in your analytics tool, provide us with the tracking code to integrate into your certificate templates. This code depends on the target tool you are using: send it to us, and we will integrate it for you. Here are a few examples:

Google Analytics

Google Analytics 4 codes are in the format G-XXXXXXXXXX

Google Tag Manager

Google Tag Manager codes are in the format GTM-XXXXXXXX

Matomo

Matomo requires 2 parameters to enable tracking:

  • the site URL
  • the site identifier (siteID)

To retrieve these:

  • Log in to Matomo
  • Click on Administration
  • In Websites | Tracking Code, copy the "JavaScript Tracking Code." It contains the 2 parameters
<!-- Matomo -->
<script>
  var _paq = (window._paq = window._paq || []);
  /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
  _paq.push(["trackPageView"]);
  _paq.push(["enableLinkTracking"]);
  (function () {
    var u = "https://certificates.yourdomain.com";
    _paq.push(["setTrackerUrl", u + "matomo.php"]);
    _paq.push(["setSiteId", "1"]);
    var d = document,
      g = d.createElement("script"),
      s = d.getElementsByTagName("script")[0];
    g.async = true;
    g.src = u + "matomo.js";
    s.parentNode.insertBefore(g, s);
  })();
</script>
<!-- End Matomo Code -->

Tracking the "Template" Dimension

You can specifically track the name of the template used by the accessed certificate in your analytics tool. To do this, you need to add a custom "template" dimension in your tracking tool.

Tips

The name of the custom dimension is not important (you can name it "template," for example), but it is essential that the index of this dimension be 1.

Events

The following events are reported to your analytics tool; they correspond to the user's interactions with buttons on your certificate’s web page.

share:linkedin profile
share:twitter
share:linkedin
share:facebook
share:mail
share:download qrcode
share:copy link
share:copy badgeID
download:pdf
download:badge
Prev
Certificate’s integration in the issuer Website
Next
Sending emails from your own domain