How can I track page scrolls (manual method)?

Analytics + Tag Manager

Piwik PRO tracks page scrolls automatically, saves scroll data as custom events and shows results in a custom report or in the site inspector for Chrome. But if you want to track page scrolls manually, for example, track only scrolls on your home page, you need to set it up. In this article we’ll show you how.

Turn off automatic scroll tracking

Available from 16.17.0. In versions below 16.17.0, just can skip this step.  

First, you need to turn off automatic scroll tracking, otherwise data will be collected twice.

To turn off automatic scroll tracking, follow these steps:

  1. Go to Menu > Administration.
  2. Navigate to Sites & apps.
  3. Choose the site or app you want to work with.
  4. Navigate to Data collection.
  5. In Page scrolling, turn off Measure scroll depth.
    Page scrolling (off) in Piwik PRO

Set up custom events with scroll triggers

To collect scroll data, you need to add a custom event tag with a page scroll trigger for each scroll point. The easiest way is to create four tags with 25%, 50%, 75% and 100% scroll points, but you can use different points.

When creating a custom event tag, you can use the following framework:

  • Event category: built-in page scroll (or Heatmap events for versions below 16.17.0)

    Note: Use exactly this name if you want to use collect data for scrollmaps in the site inspector for Chrome.

  • Event action: 25%, 50%, 75%, and 100%
  • Event name: Leave it empty if you want to collect data for scrollmaps in the site inspector for Chrome.

    Note: Each custom event contains information about a page URL so you don’t need to include it in custom event settings.

We’ll show you how to set up a custom event tag for a 25% scroll mark, and you’ll be able to repeat these steps for other marks.

To set up the tag for a 25% scroll mark, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Click Add new tag.
  3. Name the tag and select the following type: Custom event.
  4. Click Next.
  5. Set Category as built-in page scroll (or Heatmap events for versions below 16.17.0)
  6. Set Action as 25%.
  7. Leave Name empty.
    Manual setup for page scrolls in Piwik PRO
  8. In Tag triggers, click Add new trigger.
  9. Name the trigger.
  10. In Event type, choose the following type: Page scroll.
    A page scroll trigger in Piwik PRO
  11. Click Next.
  12. In Amount of page scrolled, set the percentage as 25%.
    Page scroll trigger in Piwik PRO

    Tip: Percentage depth is the relative measure most commonly used for understanding the scroll depth. But if you want to use an absolute measure, you can change the percentage to pixels and record the scroll distance in pixels. This can be useful for comparing across devices where the relative percentage heights vary greatly.

  13. In Event conditions, optionally define conditions for the trigger. You can decide to fire the tag only on some pages.
  14. In Multiplicity, mark Fire tag once per page view. This is the best option to see how far people are scrolling on a page.
    Multiplicity setting in Piwik PRO
  15. When you’re done, click OK.
  16. Test your tag in debug mode.
  17. When you’re happy how the tag works, click Publish.
  18. Done! Now you’re collecting scroll data.

You can now repeat these steps to set up the 50%, 75%, and 100% marks. Remember to change the action to the 50%, 75%, and 100% and percentages in the trigger setup.

Set up reporting for page scrolls

As the last step, you can set up a custom report to see page scrolls for each page.

To set up reporting for page scrolls, follow these steps:

  1. Go to Menu > Analytics.
  2. Navigate to Custom reports.
  3. Click Add a report.
  4. Choose the following report type: Explorer.
  5. Name the report. Example: Page scrolls.
  6. Choose the Visibility option: Author or All users. The All users option lets you share this report with other teammates.
  7. In Nested dimensions, set the following dimensions:
    • Page URL
    • Custom event action
    Page scroll report in Piwik PRO
  8. Add the following metrics:
    • Custom events
    • Unique custom events
    Page scroll report in Piwik PRO
  9. Optionally, set Default sorting options.

    Tip: You can choose to sort by dimensions or metrics. The default setting will always show this type of sorting in your custom report.

  10. In Filter dimension, set the following filter: Custom event category is built-in page scroll.
  11. Click Create a report.
  12. All done! Now click on a page URL in your report to see how far visitors scroll on that page.
    Page scroll report in Piwik PRO

Was this article helpful?

Technical support

If you still have some questions, visit our community.
There’s always someone ready to help!

Back to help center