How to Set Up Google Analytics Tracking in FluentPlayer

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:

  1. FluentPlayer Pro
  2. A Google Analytics 4 property
  3. A video added through FluentPlayer
  4. Access to your WordPress dashboard
  5. 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 NameWhat It Means
playA visitor started playing the video
pauseA visitor paused the video
endedA visitor reached the end of the video
progress_25A visitor reached 25% of the video
progress_50A visitor reached 50% of the video
progress_75A visitor reached 75% of the video
progress_100A 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:

  • play
  • pause
  • progress_25
  • progress_50
  • progress_75
  • ended

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:

  • play
  • pause
  • ended
  • progress_25
  • progress_50
  • progress_75
  • progress_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:

  1. Make sure FluentPlayer Pro is active.
  2. Make sure Enable Google Analytics is turned on.
  3. Make sure you saved the settings.
  4. Open a page with a FluentPlayer video and actually play the video.
  5. Check the GA4 Realtime report first.
  6. If using an existing tag, make sure Google Analytics is already installed on the site.
  7. 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:

  1. Open a page with a FluentPlayer video.
  2. Play the video.
  3. Pause the video.
  4. Watch at least 25% of the video.
  5. 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.

Previous

Leave a Reply

Your email address will not be published. Required fields are marked *