Skip to main content
Event Groups

How and why to use event groups

Updated over 4 months ago

This article describes how and why to use events groups.  

Consider these articles for more information on events: 


What are event groups?

Event groups are like folders for your events. They allow you to organize event data from different sources into distinct event groups and manage them independently. Some advertisers will choose to create different event groups based on shared characteristics, like the platform where the events originate (the brand’s website, app, or offline events), the product category, or the campaign focus.

This is an advanced feature created for growth-savvy advertisers, more complicated businesses with separate business lines, and performance agencies with complex needs. Most advertisers will only need one event group per ad account to report on purchases or page views across their entire business.

How does it work?

  1. Create groups: First, you’ll define event groups with custom names and install relevant events within each group.

  2. Organize data: Events within a group are segregated, offering clearer insights into specific areas. For example, you might choose to see events for your website separated from events for your app or see events for your homepage separated from events for your sign-up page.

  3. Optimize campaigns: Groups enable tailored optimization strategies for different sets of events.

  4. Report across groups: Generate reports and measure performance across individual groups or compare them collectively.

Who should use it?

  • Advertisers with complex campaigns: Manage complex campaigns with multiple platforms, products, or objectives by separating event data logically.

  • App and website advertisers: Track and analyze web and app events distinctly for informed optimization strategies.

  • Large advertisers: Organize massive event data sets for efficient analysis and reporting.

  • Agencies managing multiple clients: Create separate groups for each client for data clarity and client confidentiality.

Why is it important?

  • Improved data understanding: Segregated data offers deeper insights into specific areas of user behavior and campaign performance.

  • More specific campaign optimization: Tailor bidding, targeting, and messaging for diverse event groups based on their unique characteristics.

  • Granular reporting: Generate detailed reports focusing on specific areas or compare performance across groups for broader insights.

  • Enhanced organization and scalability: Manage large and complex event sets efficiently, promoting better decision-making.

  • Client management ease: Provide focused reporting and optimization for each client with separate event groups.

How do I set up event groups?

  1. Head to the Events page.

  2. Click "Add event group."

    1. A screenshot of a phone

Description automatically generated
    2. Alternatively, you can select an existing group and go to the Details tab. Use the drop-down arrow next to “Add event” and select “Add event group.”

  3. Name your event group.

    1. A screenshot of a computer

Description automatically generated
  4. Select how you’d like to connect your online actions to Roku Ads Manager (via JavaScript pixel or Events API). Your account will be able to use both the Events API and a JavaScript pixel to capture more complete data.

    1. A screenshot of a web page

Description automatically generated
  5. Depending on your choice, see the following sections:

  6. All created event groups will live on your Events tab. You can click into a group at any time to monitor your events, run diagnostics, or manage your event settings.


JavaScript pixel setup

Most advertisers will select this option due to its easy installation.

  1. Install your base pixel to begin setting up events.

    1. A screenshot of a computer code

Description automatically generated

  2. Select your data collection options.

    1. A screenshot of a web page

Description automatically generated
  3. Choose which events you’d like to track within this group. Select as many as you like from the list (snippet of events listed below):

    1. A list of events to track

Description automatically generated

  4. Install the code for each event you selected.

    1. A screenshot of a web page

Description automatically generated

Events API setup

Events API is a more complex option built for technically savvy performance advertisers.

To set this up, you’ll have three different steps to follow, all on one fly out.

  1. Generate an API token, if necessary.

  2. Copy the event group ID to your clipboard.

  3. Set up the API using the token and the ID.

  4. Click "Done.”

Read this article for more detailed information and instructions on Events API set up.

Did this answer your question?