auto_awesome Official Plugin Documentation

Google Analytics for WordPress — Pro

Complete setup guide for every feature TrueAna Pro offers — from first connection to 13 toggleable report tabs, custom reports, and full WooCommerce Subscriptions analytics.

vpn_key GA4 Auto Connect analytics 13 Report Tabs bolt 30+ GA4 Events shopping_cart WooCommerce table_chart Custom Report Builder link UTM Builder picture_as_pdf PDF / PNG / CSV Export

TrueAna Pro connects your WordPress site to Google Analytics 4 with one click, then displays a full analytics dashboard inside your WordPress admin — no code required. Three report tabs (Audience, Acquisition, Behavior) are included free; Pro unlocks 10 more, a Custom Report Builder, and WooCommerce Subscriptions analytics.

TrueAna Pro Admin Menu Tabs

analytics Dashboard tune Settings monitor_heart Status link UTM Builder table_chart Custom Reports help_outline Support

checklist

Requirements

Make sure your site meets these minimum requirements before installing.

web

WordPress 5.0+

WordPress version 5.0 or higher required.

code

PHP 7.4+

PHP version 7.4 or higher is required.

account_circle

Google Account

A Google account with access to a GA4 property.

admin_panel_settings

WordPress Admin

Administrator role access on your WordPress site.

download

Installation

Install and activate TrueAna Pro in 3 simple steps.

upload_file Upload the Plugin

Go to Plugins → Add New → Upload Plugin. Select the ga-for-wp-premium.zip file and click Install Now.

power Activate

Click Activate Plugin. A TrueAna Pro item appears in your WordPress sidebar, and 5 analytics widgets appear on your WP Dashboard home screen.

vpn_key Connect Google Analytics

Open TrueAna Pro — you land on the Authentication tab. Complete the connection (Auto Connect recommended). Tracking starts immediately after saving.

vpn_key

Authentication

Connect your WordPress site to a Google Analytics 4 property. Go to TrueAna Pro → Authentication.

link

Auto Connect Recommended

Sign in with Google. The plugin fetches all your GA4 properties automatically and lets you pick from a dropdown — no IDs to copy. Required for dashboard reports.

edit

Manual Entry

Enable the Manual Tracking checkbox and paste your Measurement ID (G-XXXXXXXXXX) directly. Tracking fires on your site, but in-WordPress dashboard reports require the GA4 Data API access token from Auto Connect, so they won't be available in this mode.

verified_user Accept Privacy Policy

Tick the agreement checkbox at the top of the Authentication page.

A Google sign-in popup opens. Choose the account with access to your GA4 property and grant permissions.

analytics Select Your GA4 Property

After authorising, a dropdown shows all your GA4 properties. Select the one for this website. GA4 properties begin with G-.

save Save Settings

Click Save Settings. A confirmation toast appears and the page refreshes. Tracking is now live.

add_circle

Create Property from Plugin

After connecting with Google, if you don't have a GA4 property yet, the plugin shows a Create Property form. Fill in Account, Property Name, Timezone, Currency, and Region — then click Create Property.

tune

Tracking Settings

Go to TrueAna Pro → Settings → Tracking tab to configure these options.

Setting	What it does	Default
manage_accounts Track Admin Users	Includes admin and editor visits in GA4 data. Turn OFF to exclude your own visits from reports.	ON
visibility_off Disable Page Views	Stops the automatic page_view event. Only enable if your theme fires it manually.	OFF
link Enhanced Link Attribution	Differentiates multiple links to the same URL on one page. Improves in-page link accuracy.	ON
inventory_2 Track Single Products WooCommerce	Fires the view_item event when a visitor loads a single product page.	ON
grid_view Track Product Archive WooCommerce	Fires view_item_list with full item data on shop and category listing pages (plus a lightweight viewed_shop marker event on the shop page itself).	ON
pause_circle Disable On-Hold Conversion WooCommerce	Excludes On Hold orders from conversion counts, preventing inflated revenue numbers.	ON
shield Anonymize IP	Removes the last IP octet before sending to Google. Helps GDPR compliance.	ON
psychology Track Interests	Enables Google's Advertising Features (interest-based reports, i.e. Google Signals). Requires user consent under GDPR.	OFF
badge Exclude User ID	Prevents sending the WordPress numeric user ID (ga4wp_user_id) to GA4. Preserves anonymity.	ON
cookie GA Consent Mode	Enables Google Consent Mode v2 (default-denied ad_storage/analytics_storage until your CMP grants consent). Off by default — turn on if you use a cookie consent plugin.	OFF
api Measurement Protocol	Enable server-side event sending via the GA4 Measurement Protocol. Need to add secret measurement protocol api keys from google analytics. Get it from: GA4 Admin → Data Streams → your stream → Measurement Protocol API secrets → Create.	OFF
bug_report Google Analytics Debug Mode	Sends all events as debug events visible in GA4 → Configure → DebugView. Useful for verifying setup. Always disable before going live.	OFF

bolt

Events Settings

Go to TrueAna Pro → Settings → Events tab — toggle each event on/off. The GA4 Event Name column below is the literal event name sent to Google, verified against the plugin source — use these exact names when building GA4 Explorations, audiences, or conversions.

GA4 Event Name	Triggered When	Default
tune user_login	Successful WordPress login	ON
tune user_login_errors	Failed login attempt	ON
tune user_logout	User logs out	ON
tune viewed_signup_form	Registration form is displayed	ON
tune user_signup	New user account created	ON
tune wrote_review	Product or post review submitted	ON
tune commented	Blog comment posted	ON
tune log_error	JavaScript error occurs on any page	ON

GA4 Event Name	Triggered When	Default
tune viewed_shop	Shop archive page loaded (simple marker event, no item data). WP Admin toggle: "Track Product Archive"	ON
tune view_item_list	Shop/category listing page loaded, with full item array data. WP Admin toggle: "Track Product Archive"	ON
tune view_item	Single product page viewed. WP Admin toggle: "Track Single Products"	ON
tune add_to_cart	Item added to cart. WP Admin toggle: "Track Single Products" area	ON
tune remove_from_cart	Item removed from cart	ON
tune view_cart	Cart page loaded	ON
tune applied_coupon	Valid coupon code applied	ON
tune begin_checkout	Checkout page loaded	ON
tune add_payment_info	Payment method selected at checkout (a separate parameter-less processing_payment event also fires at this step)	ON
tune add_shipping_info	Shipping option selected at checkout	ON
tune purchase	Order confirmed / payment complete. WP Admin toggle: "Completed Purchase"	ON
tune order_failed	Payment fails	ON
tune order_cancelled	Order status set to Cancelled	ON
tune refund	Refund issued on an order. WP Admin toggle: "Order Refunded"	ON

GA4 Event Name	Fires When	Requires
tune subscription_created	A new subscription is created at checkout.	Pro
tune subscription_plan_switched	The customer switches to a different subscription plan.	Pro
tune subscription_payment_failed	A subscription payment attempt fails.	Pro
tune subscription_renewal_failed	A renewal payment attempt fails.	Pro
tune subscription_cancelled	The customer or store cancels a subscription.	Pro
tune subscription_expired	A subscription reaches the end of its term.	Pro
tune subscription_on_hold	A subscription is put on hold.	Pro
tune subscription_trial_ended	A free trial period ends.	Pro
tune subscription_expiration_scheduled	An end date is scheduled for a subscription.	Pro
tune subscription_prepaid_term_ended	A prepaid subscription term ends.	Pro

extension

Advanced Integration

Go to TrueAna Pro → Advanced Integration tab.

Field	Description	Format
tune Google Ads Code	Your conversion tag ID	AW-XXXXXXXXX
tune Conversion Label	The specific conversion action label from Google Ads	String

Platform	Setting Fields	Literal Conversion Event Fired
facebook Facebook / Meta Pixel	Enable Facebook Pixel (toggle) + Pixel ID (text field)	PageView / ViewContent / AddToCart / Purchase
language Bing / Microsoft UET	Enable toggle + UET Tag ID field	purchase (via uetq.push)
music_note TikTok Pixel	Enable toggle + Pixel Code field	CompletePayment
interests Pinterest Tag	Enable toggle + Tag ID field	checkout
work LinkedIn Insight Tag	Enable toggle + Partner/Insight ID field	conversion_id tracked via lintrk
camera_alt Snapchat Pixel	Enable toggle + Pixel ID field	PURCHASE

dashboard_customize

Customise & Reorder Dashboard Tabs Free & Pro

Go to Settings → Dashboard tab. Toggle which of the 13 report tabs appear and drag-and-drop to reorder them. This is a single site-wide order, not per-user. Free tabs (Audience, Acquisition, Behavior) are always draggable; Pro-only tabs show a lock icon until you upgrade.

data_object

Custom Dimensions

Required for Content Performance and Subscription reports — create them once from the Status page.

TrueAna Pro automatically sends 11 custom dimensions with relevant events — 9 Event-scoped, 2 User-scoped. You must register these in your GA4 property before they appear in reports (GA4 does not backfill historical data). The Status page has a one-click “Create Missing” button that registers them all via the GA4 Management API.

Dimension Name	Scope	Used In
tune ga4wp_author_id	EVENT	Content Performance — Author
tune ga4wp_category	EVENT	Content Performance — Category
tune ga4wp_tag	EVENT	Content Performance — Tag
tune ga4wp_post_type	EVENT	Content Performance — Post Type
tune ga4wp_user_role	USER	User Role Segmentation
tune ga4wp_user_id	USER	Cross-Device User Tracking
tune ga4wp_form_id	EVENT	Form Tracking Report
tune ga4wp_form_name	EVENT	Form Tracking Report
tune ga4wp_conversion_type	EVENT	Subscription Reports
tune ga4wp_subscription_id	EVENT	Subscription Reports
tune ga4wp_subscription_renewal_count	EVENT	Subscription Reports

widgets

WordPress Dashboard Home-Screen Widgets

TrueAna adds five analytics widgets directly to the WordPress Dashboard home screen, free — an overview chart, and country, language, and device breakdowns, plus quick stats.

Widget	What it shows	Default
show_chart Overview Report	Users and new users trend line chart on the WordPress dashboard.	ON
public Users by Country	Bar chart showing user distribution by country.	ON
translate Users by Language	Bar chart showing user distribution by browser language.	ON
devices Users by Device	Donut chart showing user distribution by device category.	ON
speed Quick Stats	Summary cards for sessions, pageviews, and total users at a glance.	ON

view_module

All Report Tabs

Each tab is individually toggleable and reorderable via Settings → Dashboard. 3 are free; 10 require Pro (2 of those also require WooCommerce, 1 requires WooCommerce Subscriptions).

people

Audience — Free

Line Chart

Users, new users, sessions, engagement rate, and average session duration, broken down by country, language, and device category.

public Country translate Language devices Device lock_open Free

travel_explore

Acquisition — Free

Line Chart

Active users by GA4's default channel groups, exact source/medium pairs, and screen resolution breakdown.

call_merge Channel data_object Source/Medium phone_iphone Screen size lock_open Free

insights

Behavior — Free

Line Chart

Top pages by traffic, average time on page, and demographic reports: age group, gender, and operating system.

article Top pages schedule Time on page wc Age & gender lock_open Free

article

Content Performance — Pro

Line Chart

Author, category, tag, and post-type breakdowns, powered by 4 custom dimensions. Only fires on singular posts/pages (is_singular()).

person Author category Category label Tag workspace_premium Pro

assignment

Form Tracking — Pro

Line Chart

Views, submissions, and conversion rate per form across 10 supported form plugins (Contact Form 7, WPForms, Gravity Forms, Ninja Forms, Elementor Forms, Divi, Fluent Forms, Mailchimp for WP, WS Form, Formidable).

visibility Views send Submissions percent Conversion rate workspace_premium Pro

play_circle

Video Tracking — Pro

Line Chart

Starts, completions, completion rate, and average watch depth per video title — built on GA4's own native Enhanced Measurement video events (YouTube), not custom TrueAna tracking code.

play_circle Starts check_circle Completions trending_up Watch depth workspace_premium Pro

shopping_bag

WooCommerce Conversions — Pro + WooCommerce

Line Chart

Total revenue, transactions, revenue per user, revenue per transaction, buy-to-detail rate, and new buyers, with revenue broken down by product, source, device, and region.

payments Revenue KPIs map By region workspace_premium Pro shopping_cart Requires WooCommerce

route

Purchase Journey — Pro + WooCommerce

Line Chart

The purchase funnel — product views → add to cart → checkout → purchase — broken down by device category, with period-over-period comparison.

route 4-step funnel devices By device workspace_premium Pro shopping_cart Requires WooCommerce

star

Store Performance — Pro + WooCommerce

Line Chart

Product Performance report: revenue, views, cart-adds, and purchases per product, ranked highest to lowest.

inventory_2 Per product attach_money Revenue workspace_premium Pro shopping_cart Requires WooCommerce

ads_click

Google Ads — Pro

Line Chart

Site-wide impressions, clicks, and cost, plus 4 reports: Campaign Cost, Campaign Traffic, Search Query, and Ad Network Distribution. Revenue/ROAS/CPA are not currently part of this report.

payments Cost search Search queries hub Ad network workspace_premium Pro

payments

Google AdSense — Pro

Line Chart

AdSense revenue and ad clicks by page title, plus total ad impressions as a site-wide KPI. RPM and CTR are not currently part of this report.

attach_money Revenue by page ads_click Clicks by page workspace_premium Pro

sensors

Real-Time — Pro

Line Chart

Live active users, refreshed every 30 seconds, across 4 sub-tabs — see the dedicated Real-Time Reports section below.

sensors Auto-refresh 30s dashboard 4 sub-tabs workspace_premium Pro

subscriptions

WooCommerce Subscriptions — Pro + WooCommerce Subscriptions

Line Chart

MRR, ARR, churn, renewals, and subscriber lifecycle, across 5 sub-tabs — see the dedicated WooCommerce Subscriptions section below. Computed directly from WooCommerce data, not GA4.

payments MRR/ARR dashboard 5 sub-tabs workspace_premium Pro subscriptions Requires WC Subscriptions

sensors

Real-Time Reports

Dashboard tab: Real-Time. Polls GA4's Realtime API every 30 seconds across 4 sub-tabs, covering roughly the last 30 minutes of activity.

dashboard

Overview

Line Chart

Active users right now, refreshed automatically, plus rolling event and page-view totals for the last 30 minutes.

sensors Active users bolt Events pageview Page views

people

Audience

Line Chart

Live breakdown of current visitors by country, city, device category, and platform.

public Country & city devices Device smartphone Platform

call_merge

Acquisitions

Line Chart

Live traffic channel split for visitors currently on your site — organic, direct, and more, updated on every refresh.

call_merge Channel split refresh Live update

web

Behavior

Line Chart

Top active pages right now, with users and views in the last 30 minutes, plus a live events breakdown.

web Top active pages bolt Live events

subscriptions

WooCommerce Subscriptions Dashboard

Dashboard tab: Woo Subscriptions — requires the WooCommerce Subscriptions plugin. Organised into 5 sub-tabs.

dashboard

Overview

Line Chart

Active subscriptions, MRR, ARR, ARPU, LTV, churn rate, and renewal success rate as top-line KPI cards.

subscriptions Active subs payments MRR/ARR loyalty LTV

people

Audience

Line Chart

Subscriber status breakdown — active, on hold, cancelled, expired, pending cancellation, pending — plus geography by country and city.

pie_chart Status breakdown public Country & city

call_merge

Acquisitions

Line Chart

New subscriptions this period and a 6-month monthly trend of new sign-ups.

add_circle New subs show_chart 6-month trend

attach_money

Revenue

Line Chart

Renewal revenue this period, a 6-month monthly revenue trend chart, and top subscription products ranked by revenue.

attach_money Renewal revenue show_chart 6-month trend star Top products

trending_down

Retention

Line Chart

Cancellations, monthly churn trend, churn broken down by product, failed payments, and average subscription age.

cancel Cancellations trending_down Churn trend error_outline Failed payments

table_chart

Custom Report Builder

Dashboard tab: Custom Reports — build your own GA4 report, save it, and pin it as a permanent dashboard tab.

Pick dimensions and metrics from 12 categories — Time, Page/Screen, Geography, Technology, Traffic, Google Ads, Ecommerce, Events, User, Engagement, App, and Search Console — plus any custom dimension you’ve registered. Visualise as a table, bar, horizontal bar, line, or pie/doughnut chart, filter with AND/OR logic, and export.

Capability	Detail	Notes
tune Dimensions & metrics	12 categories, plus registered custom dimensions	Dynamic
tune Visualisation types	Table, bar, horizontal bar, line, pie/doughnut	5
tune Filters	AND/OR logic across multiple conditions	Supported
tune Row limit	Adjustable per report	10–500
tune Date range	Presets or fully custom range	Flexible
tune Saved reports	No fixed cap in the plugin	Unlimited
tune Pin as dashboard tab	Appears alongside built-in tabs, drag-and-drop reorderable	Yes
tune Export	Table as CSV or PDF; chart as PNG or PDF	CSV/PNG/PDF

category

WooCommerce revenue by content category

Dimension: ga4wp_category · Metric: a revenue metric · Chart: bar. Not built into any default tab — see which content topics produce the most WooCommerce revenue.

campaign

Campaign-level attribution

Dimensions: sessionCampaignName + sessionCampaignId · Metrics: sessions, conversions · Chart: table. The free Acquisition report only goes down to channel/source/medium — this adds full UTM campaign granularity.

supervisor_account

Engagement rate by user role

Dimension: ga4wp_user_role · Metrics: sessions, engagement rate · Chart: bar. See whether logged-in subscribers or customers engage more deeply than guests.

public

Mobile session duration by country

Dimension: country · Filter: deviceCategory = mobile (AND) · Metric: average session duration · Chart: table. Isolates a specific device+geography segment the built-in Audience report doesn't cross-tabulate.

article

Traffic by post type

Dimension: ga4wp_post_type · Metric: sessions or pageviews · Chart: pie. Compare product pages against blog posts on your own terms, since the built-in Content Performance tab reports each dimension separately, not cross-filtered.

table_chart

Landing page performance by source

Dimensions: landing page + sessionSource (AND filter on a specific source, e.g. google) · Metrics: sessions, bounce rate · Chart: table. Cross-references two dimensions that live in different built-in tabs.

drag_indicator

Reordering Dashboard Tabs

Go to Settings → Dashboard to reorder or hide any report tab.

drag_indicator

Drag-and-drop, site-wide

A single order applies to your whole site — this is not a per-user personal layout.

lock

Pro tabs show a lock icon

On the free plan, Pro-only tabs appear in the list but aren't draggable until you upgrade.

toggle_on

Toggle any tab on or off

Hide tabs you don't use to keep the dashboard navigation short.

table_chart

Saved custom reports join the list

Anything you build with the Custom Report Builder appears in the same sortable list.

link

UTM Campaign URL Builder

Dashboard tab: UTM Builder — create tracked campaign links.

UTM parameters are tags added to URLs that tell GA4 where your traffic came from. The builder includes one-click preset chips for common values, a live URL preview, one-click clipboard copy, and a URL history panel.

Parameter	What it tracks	Required
tune utm_source	Where traffic originates — e.g. google, newsletter, facebook. Presets: google · facebook · instagram · linkedin · twitter · newsletter · bing · youtube	Yes
tune utm_medium	Marketing channel — e.g. cpc, email, social. Presets: cpc · email · social · organic · referral · banner · affiliate · display	Yes
tune utm_campaign	Campaign name — e.g. spring_sale, product_launch	No
tune utm_term	Paid search keyword	No
tune utm_content	Differentiates ads or links in the same campaign	No

security

Pixel & Ad Platform Integrations

Go to TrueAna Pro → Settings → Integrations. Enter a pixel ID and toggle each platform on.

Platform	What it fires	Plan
analytics GA4 / Google Analytics 4	page_view, session events, plus all GA4 e-commerce and custom events.	Free
facebook Facebook / Meta Pixel	PageView, ViewContent, AddToCart, InitiateCheckout, Purchase.	Free
ads_click Google Ads Conversion Tracking	Conversion event with revenue value and transaction ID on order completion.	Free
language Microsoft / Bing UET	Universal Event Tracking tag — page load, ViewProduct, AddToCart, Purchase.	Pro
music_note TikTok Pixel	PageView, ViewContent, AddToCart, Purchase.	Pro
interests Pinterest Tag	PageVisit, ViewCategory, AddToCart, Checkout.	Pro
camera_alt Snapchat Pixel	PAGE_VIEW, VIEW_CONTENT, ADD_CART, PURCHASE.	Pro
work LinkedIn Insight Tag	Site-wide page tracking plus a Purchase conversion event.	Pro

shield

GDPR & Privacy

All privacy controls below are included in the free plugin.

Consent Mode v2

Toggle "GA Consent Mode" in Tracking Settings (off by default). When on, ad_storage and analytics_storage default to denied until your CMP grants consent. Works with any CMP that implements Google's standard API — no named plugin integration required.

cloud_sync

Server-side consent bridging

A first-party cookie mirrors the visitor's consent state, so Measurement Protocol server-side calls also skip sending when analytics_storage is denied.

visibility_off

Anonymize IP

Removes the last IP octet before sending to Google.

manage_accounts

Track Admin Users toggle

Exclude your own admin/editor visits from GA4 data.

block

Track Interests toggle

Off by default — controls Google's Advertising Features (Google Signals-based demographics/remarketing).

badge

Exclude User ID

Prevents sending the WordPress numeric user ID to GA4.

mark_email_read

Scheduled Email Reports

Dashboard tab: Settings → Email Reports — Pro only.

Section	Metrics Included	Notes
tune Audience Overview	Users, new users, sessions, sessions/user, pageviews, avg. session duration, engagement rate, pageviews/user.	Always available
tune Google Ads	Ad impressions, ad clicks, ad cost.	Always available
tune Google AdSense	AdSense revenue, ads viewed, ad clicks.	Always available
tune WooCommerce Conversions	Total revenue, transactions, revenue/active user, revenue/transaction, product detail views, new buyers.	Requires WooCommerce

schedule

3 schedule options

Daily, weekly, or monthly — configured in Settings → Email Reports.

group

Multiple recipients

Add any number of email addresses, including people without a WordPress login.

mail

HTML formatted email

Sent via wp_mail(); an SMTP plugin is recommended for reliable delivery. No plain-text fallback currently.

send

Send a test email

Preview the report before the first scheduled send goes out.

monitor_heart

Status Page

Go to TrueAna Pro → Status to verify your connection and manage custom dimensions.

business

Property Overview Free

Display Name, Measurement ID, Resource Name, Service Level (Standard/360), and Industry Category — pulled live from the GA4 Admin API.

settings

Regional Settings Check Free

Compares your GA4 property timezone against your WordPress timezone, with a Match/Mismatch indicator.

storage

Data & Marketing Preferences Free

Shows your GA4 property's event data retention window and whether reset-on-new-activity is enabled.

data_object

All Custom Dimensions Pro

Lists all 11 required custom dimensions with live status badges. Click Create Missing to auto-create any that are absent.

vpn_key

Measurement Protocol Secret Pro

Shows whether your server-side API secret has been generated, with Generate Now / Retry.

picture_as_pdf

Export Reports

Download any dashboard report as PDF, export chart data as PNG, or export table data as CSV.

picture_as_pdf

PDF Export

Every chart and table across the dashboard can be exported as a PDF. Look for the export icon in the top-right of any report card.

bar_chart

Chart Export (PNG)

Charts can be exported as PNG images directly from the report header — useful for presentations.

table_view

CSV Export

Table data can be downloaded as a CSV spreadsheet — the export menu offers CSV or PDF depending on whether you're exporting a chart or a table.

help_outline

Frequently Asked Questions

Common questions answered.

My dashboard reports show no data. What do I check?

expand_less

Verify authentication — check for the "Connected" status in the plugin header.
GA4 data has a 24–48 hour processing delay. Use the Real-Time tab to verify events fire live immediately.
Confirm "Disable Page Views" is OFF in Tracking settings.
If Content Performance reports are empty, create your custom dimensions via the Status page (Create Missing button).

Content Performance reports show no author / category / tag data.

expand_more

The Woo Subscriptions tab doesn't appear.

expand_more

Why are Audience, Acquisition, and Behavior available on the free plan but everything else isn't?

expand_more

I see "Re-auth needed" — how do I fix it?

expand_more

Can I reorder the dashboard tabs?

expand_more

Can I use the plugin without connecting to Google?

expand_more

What is the difference between Auto Connect and Manual Tracking?

expand_more

Does this plugin work with cookie consent plugins?

expand_more

Can I build a report the 13 default tabs don't cover?

expand_more

Google Analytics for WordPress — Pro

Why pay more for separate add-ons?

30% off TrueAna Pro for the first 1,000 users