FluentPlayer Pro can send video playback activity to Google Analytics 4, also known as GA4. This helps you understand how visitors are interacting with your videos, such as when they play, pause, finish, or reach certain progress points in a video.
This guide explains how to set it up step by step.
Before You Start
To use Google Analytics tracking in FluentPlayer, you need:
- FluentPlayer Pro
- A Google Analytics 4 property
- A video added through FluentPlayer
- Access to your WordPress dashboard
- Access to your Google Analytics account, if you need to copy your Measurement ID
Google Analytics tracking is a Pro feature in FluentPlayer. If only the free version is active, Google Analytics video events will not be sent.
Important: FluentPlayer Analytics and Google Analytics Are Different
Inside FluentPlayer, you may see two analytics options:
FluentPlayer Analytics
This is FluentPlayer’s own built-in analytics system. It stores video analytics inside your WordPress site and shows the data inside FluentPlayer.
Use this if you want to view video analytics inside your WordPress dashboard.
Google Analytics
This sends video events to your Google Analytics 4 account.
Use this if you want video activity to appear in Google Analytics.
These two options are separate. You can enable Google Analytics even if FluentPlayer’s own analytics is disabled.
What FluentPlayer Sends to Google Analytics
When Google Analytics is enabled, FluentPlayer sends video activity events to GA4.
The events include:
| Event Name | What It Means |
|---|---|
play | A visitor started playing the video |
pause | A visitor paused the video |
ended | A visitor reached the end of the video |
progress_25 | A visitor reached 25% of the video |
progress_50 | A visitor reached 50% of the video |
progress_75 | A visitor reached 75% of the video |
progress_100 | A visitor reached 100% of the video |
FluentPlayer also sends extra video details with the event, such as:
- Video ID
- Video title
- Current playback time
- Video duration
- Video provider
- Video URL
These are sent as custom Google Analytics event details.
Which Setup Option Should You Choose?
There are two ways to connect FluentPlayer with Google Analytics.
Option 1: Use Existing Google Analytics Tag
Choose this option if your website already has Google Analytics installed.
For example, use this option if GA4 is already added through:
- Google Site Kit
- Your WordPress theme
- Another analytics plugin
- A manually added GA4 script
- A developer’s custom setup
This is usually the best option if Google Analytics is already working on your site.
Option 2: Let FluentPlayer Load Google Analytics
Choose this option if your website does not already have Google Analytics installed.
In this case, FluentPlayer will load the Google Analytics script using your GA4 Measurement ID.
Option 1: Use an Existing Google Analytics Tag
Use this method if Google Analytics is already added to your website.
Step 1: Open FluentPlayer Settings
From your WordPress dashboard, go to:
FluentPlayer → Settings → Analytics
Then open the Google Analytics section/tab.
Step 2: Enable Google Analytics
Turn on:
Enable Google Analytics
This allows FluentPlayer to send video events to Google Analytics.
Step 3: Keep “Use Existing On-Page Tag” Enabled
Turn on or keep enabled:
Use existing on-page tag
This tells FluentPlayer:
“Do not load another Google Analytics script. Use the one that is already available on this website.”
Step 4: Save the Settings
Click Save.
Step 5: Test a Video
Open a page where a FluentPlayer video is published.
Then play, pause, and watch part of the video.
FluentPlayer should now send video events to your existing GA4 setup.
Option 2: Add Your GA4 Measurement ID in FluentPlayer
Use this method if Google Analytics is not already installed on your website.
Step 1: Find Your GA4 Measurement ID
Log in to Google Analytics.
Then go to:
Admin → Data streams → Web
Click your website’s web data stream.
Copy the Measurement ID. It usually starts with G-, for example:
G-XXXXXXXXXX
Google’s official Analytics documentation also explains that the Measurement ID is found from the web data stream details in Google Analytics.
Step 2: Open FluentPlayer Settings
From your WordPress dashboard, go to:
FluentPlayer → Settings → Analytics
Then open the Google Analytics section/tab.
Step 3: Enable Google Analytics
Turn on:
Enable Google Analytics
Step 4: Disable “Use Existing On-Page Tag”
Turn off:
Use existing on-page tag
After disabling this option, the Measurement ID field should appear.
Step 5: Paste Your Measurement ID
Paste your GA4 Measurement ID into the field.
Example:
G-XXXXXXXXXX
Step 6: Save the Settings
Click Save.
Step 7: Test a Video
Open a page where a FluentPlayer video is published.
Play, pause, and watch part of the video.
FluentPlayer should now load Google Analytics and send video events to your GA4 account.
How to Check If It Is Working
After setting up Google Analytics, you can test it from Google Analytics.
Method 1: Check the Realtime Report
In Google Analytics, open the Realtime report.
Google’s Realtime report is designed to show activity as it happens, including event activity from users on your website.
After opening a video page and playing the video, look for event names such as:
playpauseprogress_25progress_50progress_75ended
Google Analytics may show these under event activity. Google’s documentation notes that the Realtime report can show event count by event name for events triggered in the last 30 minutes.
Method 2: Wait for Standard Reports
Realtime data usually appears faster.
Normal GA4 reports may take longer to show the same event data. So if you do not see the events immediately in regular reports, check the Realtime report first.
Recommended Setup
For most users, the recommended setup is:
If your site already has Google Analytics
Use:
Enable Google Analytics: ON
Use existing on-page tag: ON
This avoids loading Google Analytics more than once.
If your site does not already have Google Analytics
Use:
Enable Google Analytics: ON
Use existing on-page tag: OFF
Measurement ID: Your GA4 Measurement ID
This lets FluentPlayer load the Google Analytics tag for you.
Important Notes
Do Not Add Google Analytics Twice
If your website already has Google Analytics installed, do not make FluentPlayer load another copy of the same GA4 tag.
In that case, use Use existing on-page tag.
Adding Google Analytics multiple times on the same site may cause confusing or duplicate tracking.
Google Tag Manager Users
If your site uses Google Tag Manager only, FluentPlayer may not always be able to send events automatically.
FluentPlayer sends events through the Google Analytics gtag() function. Some Google Tag Manager setups do not create this function on the page.
If you use Google Tag Manager and do not see FluentPlayer events in GA4, ask your site developer or analytics person to confirm whether window.gtag is available on the page.
GA4 Events Are Custom Events
FluentPlayer sends custom event names like:
playpauseendedprogress_25progress_50progress_75progress_100
These are not the same as Google’s default video event names.
So in GA4, look for the exact FluentPlayer event names listed above.
Troubleshooting
I enabled Google Analytics, but no events appear in GA4
Please check the following:
- Make sure FluentPlayer Pro is active.
- Make sure Enable Google Analytics is turned on.
- Make sure you saved the settings.
- Open a page with a FluentPlayer video and actually play the video.
- Check the GA4 Realtime report first.
- If using an existing tag, make sure Google Analytics is already installed on the site.
- If not using an existing tag, make sure the Measurement ID starts with
G-.
I am using “Use existing on-page tag,” but events are not tracking
This usually means FluentPlayer cannot find the existing Google Analytics tag on the page.
Please check:
- Is Google Analytics actually installed on the site?
- Is the GA4 tag loading on the video page?
- Is the site using Google Tag Manager only?
- Is a cookie/privacy plugin blocking Google Analytics before consent?
If you are not sure, ask your developer to confirm whether window.gtag exists on the video page.
I entered the Measurement ID, but tracking still does not work
Please check:
- The Measurement ID is copied correctly.
- It starts with
G-. - “Use existing on-page tag” is turned off.
- There is no caching or optimization plugin blocking Google Analytics scripts.
- Browser ad blockers are not blocking the test.
I see page views in Google Analytics, but not video events
Page views can come from your normal Google Analytics setup.
Video events are only sent when visitors interact with FluentPlayer videos.
To test properly:
- Open a page with a FluentPlayer video.
- Play the video.
- Pause the video.
- Watch at least 25% of the video.
- Check GA4 Realtime events.
I use a cookie consent plugin
If your website blocks Google Analytics until the visitor accepts cookies, FluentPlayer video events may also be blocked until consent is accepted.
This is expected behavior.
To test, accept cookies first, then play the video again.
FAQ
Do I need FluentPlayer Analytics enabled for Google Analytics to work?
No.
FluentPlayer Analytics and Google Analytics are separate. Google Analytics can work even if FluentPlayer’s own analytics is disabled.
Does FluentPlayer store Google Analytics events in WordPress?
No.
Google Analytics events are sent to Google Analytics. They are not stored in the WordPress database by FluentPlayer.
Does FluentPlayer support GA4?
Yes.
FluentPlayer uses the GA4 gtag() event method to send video playback events.
Does FluentPlayer support Universal Analytics?
No.
The setup is intended for Google Analytics 4 Measurement IDs, which usually start with G-.
Can I use Google Tag Manager?
Possibly, but it depends on how Google Tag Manager is configured.
FluentPlayer currently sends events through gtag(). If your Google Tag Manager setup does not provide gtag() on the page, FluentPlayer events may not be sent automatically.
Where do I find the Measurement ID?
In Google Analytics, go to:
Admin → Data streams → Web → select your website stream
Then copy the Measurement ID. Google’s official documentation says the Measurement ID is shown in the stream details and usually starts with G-.
Best Practice
Use only one Google Analytics loading method.
If Google Analytics is already installed on the site, enable Use existing on-page tag in FluentPlayer.
If Google Analytics is not installed anywhere else, turn off Use existing on-page tag and add the GA4 Measurement ID directly in FluentPlayer.
This keeps the setup clean and avoids duplicate tracking.