ReferenceExtensions

GoogleAnalytics

Options for the Google Analytics 4 extension that tracks video engagement and playback events

Adds the Google Analytics 4 (GA4) extension to the player. It renders nothing — place it anywhere inside the player, and it follows whatever media the player attaches, dispatching standard GA4 Enhanced Measurement video events and playback interaction events to window.dataLayer. See Google Analytics for how telemetry works.

Import

pnpm add @videojs/react @videojs/google-analytics

import { GoogleAnalytics } from '@videojs/react/extensions/google-analytics';

Anatomy

<GoogleAnalytics />

Options

Prop	Type	Description
`metadata`	`GoogleAnalyticsMetadata`	Video metadata and custom dimensions reported with GA4 events
`dataLayerName`	`string`	Name of the dataLayer array on `window`. Defaults to `'dataLayer'`
`disableProgress`	`boolean`	Disables 10%, 25%, 50%, and 75% progress milestones tracking. Defaults to `false`
`debug`	`boolean`	Logs telemetry events to the console. Defaults to `false`
`onEvent`	`(event: string, params: object) => void`	Callback to intercept dispatched events

Collection limits

Google Analytics 4 enforces collection limits on event parameters:

25 parameters per event: The extension sends 8 standard parameters (video_current_time, video_duration, video_percent, video_provider, video_stream_type, video_title, video_url, and visible), leaving room for up to 17 custom dimensions in metadata.
Parameter names: Up to 40 characters in length.
String values: Up to 100 characters in length.

Import

Anatomy

Options

Collection limits

See also