Title: Headless GA4
Author: jakubkanna
Published: <strong>13 آوریل 2026</strong>
Last modified: 13 آوریل 2026

---

جستجوی افزونه‌ها

![](https://s.w.org/plugins/geopattern-icon/headless-ga4.svg)

# Headless GA4

 توسط [jakubkanna](https://profiles.wordpress.org/jakubkanna/)

[دانلود](https://downloads.wordpress.org/plugin/headless-ga4.0.1.1.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/headless-ga4/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/headless-ga4/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/headless-ga4/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/headless-ga4/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/headless-ga4/)

## توضیحات

Headless GA4 adds a compact Google Analytics 4 widget to the main WordPress dashboard.

It is designed for sites where:

 * the frontend is not rendered by WordPress
 * GA4 tracking already happens on the frontend
 * WordPress only needs to read and display GA4 reporting data for admins

The plugin uses the Google Analytics Data API and a Google service account. It does
not inject frontend tracking code.

Features:

 * settings page for GA4 configuration
 * dashboard widget with core traffic metrics
 * last 7 days trend chart
 * top pages and top traffic sources
 * transient caching
 * manual refresh action

### Privacy

Headless GA4 does not track visitors or inject analytics scripts.

The plugin only sends server-side requests to Google when an administrator configures
a GA4 property and opens the dashboard or tests the connection. Those requests use
the service account credentials you provide in the plugin settings.

### External services

This plugin connects to Google services to authenticate requests and fetch Google
Analytics 4 report data. These requests are only made after an administrator configures
the plugin and then opens the dashboard widget, refreshes the data, or uses the 
Test connection button.

#### Google OAuth token service (`oauth2.googleapis.com`)

Used to exchange the configured Google service account credentials for a short-lived
access token.

Data sent: a signed JWT assertion containing the service account email, requested
scope, token endpoint, issued-at time, and expiration time.

Terms of service: https://developers.google.com/terms
 Privacy policy: https://policies.
google.com/privacy

#### Google Analytics Data API (`analyticsdata.googleapis.com`)

Used to request GA4 report data for the configured GA4 property.

Data sent: the GA4 property ID, report request parameters such as date ranges, dimensions,
metrics, and limits, plus the OAuth access token in the request headers.

Terms of service: https://developers.google.com/terms
 Privacy policy: https://policies.
google.com/privacy

## نصب

 1. Upload the `headless-ga4` folder to `/wp-content/plugins/`.
 2. Activate the plugin through the WordPress Plugins screen.
 3. Go to `Settings > Headless GA4`.
 4. Enter your GA4 property ID.
 5. Paste your service account JSON credentials.
 6. Save the settings.
 7. Use the `Test connection` button.
 8. Open the main Dashboard screen to view the widget.

## سوالات متداول

### What is a service account?

A service account is a Google Cloud machine identity used by the plugin to read 
your GA4 reporting data without requiring a human Google login inside wp-admin.

### Does this plugin install tracking on my site?

No. This plugin only reads GA4 report data. Your frontend must already send data
to GA4.

### What do I need from Google?

You need:

 * a Google Cloud project
 * the Google Analytics Data API enabled
 * a service account
 * the full service account JSON credentials
 * Viewer access for that service account email in your GA4 property
 * your GA4 numeric property ID

### How do I set it up?

 1.  Create a Google Cloud project.
 2.  In Google Cloud Console, open `APIs & Services`, click `Enable APIs and Services`,
     search for `Google Analytics Data API`, open it, and click `Enable`.
 3.  Create a service account.
 4.  Open the service account, go to `Keys`, click `Add key`, choose `Create new key`,
     then select `JSON` and download the file.
 5.  Copy the service account email address.
 6.  In GA4, open `Admin`, then `Property access management`, add that service account
     email, and grant it `Viewer` access.
 7.  In GA4, open `Admin`, then `Property settings`, and copy the numeric `Property
     ID`.
 8.  Paste the property ID and the full service account JSON into the plugin settings.
 9.  Save the settings and test the connection.

### Why do I not see any data?

Possible reasons:

 * the frontend is not sending GA4 events
 * the wrong property ID was entered
 * the service account email was not added in `GA4 > Admin > Property access management`
 * the service account JSON is invalid
 * the property has not received enough recent traffic

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“Headless GA4” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

 *   [ jakubkanna ](https://profiles.wordpress.org/jakubkanna/)

[ترجمه “Headless GA4” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/headless-ga4)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/headless-ga4/)، [مخزن SVN](https://plugins.svn.wordpress.org/headless-ga4/)
را بررسی کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/headless-ga4/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/headless-ga4/) مشترک شوید.

## گزارش تغییرات

#### 0.1.1

 * Replace inline admin CSS with an enqueued stylesheet
 * Move admin screen markup into template files
 * Remove deprecated OpenSSL cleanup call
 * Add external service disclosures for Google services

#### 0.1.0

 * Initial release
 * Settings page with service account configuration
 * Dashboard widget with traffic summary
 * GA4 Data API integration using a service account

## اطلاعات

 *  نگارش **0.1.1**
 *  آخرین به‌روزرسانی **5 ماه پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 6.4 یا بالاتر **
 *  آزمایش‌شده تا **6.9.7**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/headless-ga4/)
 * برچسب
 * [admin](https://fa.wordpress.org/plugins/tags/admin/)[analytics](https://fa.wordpress.org/plugins/tags/analytics/)
   [dashboard](https://fa.wordpress.org/plugins/tags/dashboard/)[ga4](https://fa.wordpress.org/plugins/tags/ga4/)
   [headless](https://fa.wordpress.org/plugins/tags/headless/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/headless-ga4/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/headless-ga4/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/headless-ga4/reviews/)

## مشارکت کنندگان

 *   [ jakubkanna ](https://profiles.wordpress.org/jakubkanna/)

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/headless-ga4/)