Wowza Google Analytics

The Analytics module for Wowza Streaming Engine™ media server software enables you to track your streaming connections in the Google Analytics service.

Prerequisites

Wowza Streaming Engine™ 4.8.22 or later is required.
Java 11 with the java.net.http module included.

You'll need your Google tracking ID for the domain (website property) being tracked in Google Analytics. The tracking ID is a string like G-XXXXXXXXXX.

Usage

Specify your Google tracking ID and Wowza Streaming Engine will report all video_start, video_progress, and video_complete events using the existing GA4 video events. Two custom events are added to optionally track video_publish and video_unpublish events. Extra parameters are added over and above the default parameters to specifically track video_type (live or vod), video_rendition, video_protocol, and video_live_progress. For full reporting, these custom events and parameters will need to be added to your GA4 property and custom dimensions created for each parameter.

The module is also able to send tracking events via a Server Side Tag Manager instance for further processing before forwarding to GA4.

Build instructions

Clone repo to local filesystem.
Update wseLibDir variable in the gradle.properties file to point to local Wowza Streaming Engine lib folder.
Run ./gradlew generateBuildProperties command to generate the BuildProperties.java file. This task will automatically run before each compile to regenerate the file.
Run ./gradlew build to build the jar file.

More resources

For full install instructions and to use the compiled version of this module, see Send connection and stream statistics to Google Analytics with a Wowza Streaming Engine Java module.

Wowza Streaming Engine Server-Side API Reference

How to extend Wowza Streaming Engine using the Wowza IDE

Wowza Media Systems™ provides developers with a platform to create streaming applications and solutions. See Wowza Developer Tools to learn more about our APIs and SDK.

Contact

Wowza Media Systems, LLC

License

This code is distributed under the Wowza Public License.