Video provider dimension
The video provider dimension records which platform served an embedded video — for GA4's enhanced measurement, that means YouTube via its iframe API. This page explains what video_provider captures, why non-YouTube and self-hosted players are not auto-measured, and how to fill the gap with custom events.
What this means
GA4's enhanced measurement can track embedded video automatically and stamps each video event with a video_provider parameter identifying the platform. In practice the auto-measured provider is YouTube, because GA4's listener hooks into the YouTube iframe Player API.
The video provider dimension sits alongside video_title and video_url, letting you group video engagement (starts, progress, completes) by the platform that served it.
- GA4 stamps video events with video_provider
- Auto-measurement targets YouTube via its iframe API
- Pairs with video_title and video_url dimensions
Why coverage is limited
Auto-measurement only works for players GA4 knows how to listen to. A YouTube embed using the iframe API gets tracked; a Vimeo, Wistia, or self-hosted HTML5 player does not produce video_provider data automatically because GA4 has no built-in listener for it.
To measure those, you instrument the player's own JavaScript events and send custom video events, setting video_provider yourself. So a provider breakdown that shows only YouTube usually reflects the limits of auto-measurement, not the absence of other video on the site.
- Only iframe-API YouTube embeds auto-measure
- Vimeo, Wistia, self-hosted players need custom events
- A YouTube-only breakdown often means uninstrumented players
How it appears in analytics and logs
A video provider value identifies the player platform behind a video event. If a video has no provider data, it is almost certainly not a YouTube iframe-API embed, so enhanced measurement never saw it.
Diagnostic use case
Separate video engagement by the platform serving the player, and recognize which embeds GA4 measures automatically versus which need custom tracking.
What WebmasterID can help detect
WebmasterID records video interactions as first-party events where instrumented, so you can attribute engagement across providers your own tracking covers, not just the auto-measured one.
Common mistakes
- Assuming all embedded video is auto-measured.
- Reading a YouTube-only breakdown as your only video.
- Forgetting non-YouTube players need custom event tracking.
Privacy and accuracy notes
Video provider is player metadata, not personal data. Embedding third-party players can set that platform's own cookies, which is the embed's behaviour, not the analytics dimension. This is educational, not legal advice.
Related pages
- Video title dimension: which videos get watched
Video title is the dimension that records which embedded video a visitor engaged with. GA4 enhanced measurement captures it for YouTube embeds that use the IFrame Player API, firing video_start, video_progress, and video_complete with a video_title parameter. The key limit: only API-enabled YouTube players are auto-tracked — other hosts and plain embeds need manual instrumentation to populate the dimension.
- Custom events: tracking what matters to you
Custom events capture meaningful actions a pageview cannot — a CTA click, a signup, a video play, a form submit. The value is in a consistent naming taxonomy and well-chosen properties. The risk is putting personal data into event names or properties, which turns analytics into surveillance. This page covers both.
- The click event and outbound clicks
A click event records that a visitor activated a link or element. The most common analytics use is the outbound click — a click on a link leaving your domain — which a normal page_view can never capture because the destination is another site. This page covers what to record on a click, how outbound detection works, and which properties stay privacy-safe.
- Events documentation
Send custom video events for non-YouTube players.
Sources and verification notes
- Google Analytics Help — [GA4] Enhanced measurement (video engagement)Documents video_provider on auto-measured YouTube iframe-API embeds.
- developers.google.com — YouTube IFrame Player APIThe API GA4's video listener hooks into.
Last reviewed 2026-06-24. Facts are checked against primary/official sources where available; uncertain specifics are marked “Data not yet verified” rather than guessed.