Guides

Custom Event Tracking

UserBird supports tracking of custom events, for example signups.

To do this you'll need to be able to edit the HTML of the page in which the event takes place and insert some custom JavaScript.

UserBird automatically detects Google Analytics 4 events

If you already have Google Analytics 4 event tracking installed in your site, you don't need to do anything. UserBird will detect these events. Learn more.

How to Track Custom Events with UserBird

  1. Find the page where you want to fire your event

    For example, the after a signup page.

  2. Add the following event tracking javascript

    <script> userbirdq.push(['custom_event',{ name: 'Signup', }]); </script>

    where Signup is an example string of an event you can send.

    You can adapt this javascript to fire whenever you like.

    The name field is limited to 100 characters.

  3. Test your event

    Navigate to the page and trigger your event.

    Then, navigate to another page, or close the window.

    UserBird only sends data when the user has left the current page (via Beacon).

    You should see your event be counted in UserBird the interface within a few seconds.

    Test your event

Frequently Asked Questions

Can I add custom parameters or metadata?

No. Event tracking records only a string.

How long can the event name be?

Event names are limited to 100 characters.