Check if your tracking works correctly

When you need to check if tracking works on your website correctly, you can use two methods: debug mode in Tag Manager or an inspector tool in the browser.

In this article, we’ll explain how to work with those methods.

Use debug mode in Tag Manager

To check tracking in debug mode, follow these steps:

  1. Go to Menu > Tag Manager.
  2. From the website picker, choose a website or app you want to work with.
  3. In the top-right corner click Debug.
  4. Click debug in Tag Manager in Piwik PRO.

    Tip: To open debug mode, you can also add ?_stg_debug at the end of your website’s URL.

  5. Your website will open in a new tab with debug mode running.
  6. Debug mode in Tag Manager in Piwik PRO.
  7. Check if the container is installed on the page.
    • Sync: on or off. It should be on, if you use the container for synchronous tags.
    • Async: on.  It should be always on. It shows the status of the container for asynchronous tags.
    Elements of debug mode in Tag Manager in Piwik PRO.
  8. Check if the tag called Piwik PRO was fired.
  9. Piwik PRO Tag in debug mode in Tag Manager in Piwik PRO.
  10. Click the tag name to see tag details like HTML tag content, tag type, and trigger.
  11. Piwik PRO Tag in debug mode in Tag Manager in Piwik PRO.
  12. If the tag wasn’t fired, check if the trigger is set as All page views. You may also need to check trigger’s conditions.
  13. Piwik PRO Tag in debug mode in Tag Manager in Piwik PRO.
  14. Additionally, navigate to Events log.
  15. Find a stg.pageView element on the event list and click on it.
  16. Here you’ll see all tags that were fired on page view. If you see the Piwik PRO tag fired, the tracking is working correctly.
Piwik PRO Tag in debug mode in Tag Manager in Piwik PRO.

Use inspector tool in the browser

To check tracking using an inspector tool in the browser, follow these steps:

  1. Open your website.
  2. Right click on any element on the website and click Inspect or Inspect Element, depending on the browser you’re using.
  3. Navigate to Network.
  4. Refresh the browser.
  5. Find the ppms.php element on the network list.
  6. Piwik PRO on a network list in an inspector tool.

    Tip: You may see two types of  ppms.php elements:  ppms.php?action-name= and  ppms.php?ping=. Action-name is a request of page view. Ping is a request that checks if the visitor’s session is still active. The frequency of the ping is set in Piwik PRO tag settings.

  7. Click ppms.php and check the following items:
    • Status is 200 OK. This means that tracking works correctly.
    • Request URL is the name of your account (instance) in Piwik PRO.
    • Website ID is the ID that should match the one used in your account (instance) in Piwik PRO.
    Piwik PRO on a network list in an inspector tool.

    Tip: To find a website ID in Piwik PRO, follow these guidelines.

  8. If you need further information, navigate to Console.
  9. If the tracking is broken, you’ll see an error message in the console.
  10. Piwik PRO in console in an inspector tool.
  11. In Console, you can also use the following calls:
    • _paq: if the call returns _paq.push tracking is working correctly.
    • _paq.push(['trackPageView']);: if returns undefined tracking is working correctly.
    Piwik PRO in console in an inspector tool.

    Tip: Using an inspector tool you can also check cookies set by Piwik PRO in your browser. Navigate to Application > Cookies and look for cookies listed here.

    Reasons for broken tracking

    If you run into a broken tracking on your website, then one of the following issues may cause that:

    • Piwik PRO tag, which is responsible for tracking, is disabled.
    • Trigger for the Piwik PRO tag is incorrect. It should be set as All page views usually with no additional conditions.
    • Tracking code is not installed on your website properly. For more about installing a tracking code, read this article
Was this article helpful?

Be the first to rate this article.

Technical Support

If you have any questions, drop us a line at support_SPC@piwik_SPC.pro.

We’re happy to help!