TrueAna Pro automatically sends 11 WordPress-specific custom dimensions to GA4 — author, category, post type, user role, form data, and more — with zero code required.
GA4 tracks page views and sessions, but knows nothing about your content structure. Custom Dimensions add the WordPress context GA4 is missing.
Every parameter key, its scope, when it fires, and the exact value format — sourced directly from the plugin.
| Parameter Key | Scope | GA4 Display Name | Value & Behaviour |
|---|---|---|---|
| Content Dimensions — sent on singular pages only (is_singular()) | |||
| ga4wp_author_id | Event |
Author ID of Writer
|
WordPress numeric user ID of the post author (post_author field). An integer cast to string, e.g. "4". Used by the Content Performance → Author Based Views report via customEvent:ga4wp_author_id.
info_outline Only fires on singular posts/pages with a valid WP_Post object
|
| ga4wp_category | Event |
Category of the Post
|
Comma-separated list of all category names from wp_get_post_categories(), e.g. "Tutorials,WooCommerce". Used by Content Performance → Category Based Views report.
info_outline Only fires on singular pages; empty string if no categories assigned
|
| ga4wp_tag | Event |
Tag of the Post
|
Comma-separated list of all tag names from wp_get_post_tags(), e.g. "analytics,tracking". Used by Content Performance → Tag Based Views report.
info_outline Only fires on singular pages; empty string if no tags assigned
|
| ga4wp_post_type | Event |
Post Type
|
WordPress post type slug from get_post_type(), e.g. "post", "page", "product", or any custom post type. Used by Content Performance → Post Type Based Views report.
info_outline Only fires on singular pages
|
| User Dimensions — sent on every page load for logged-in visitors | |||
| ga4wp_user_role | User |
Current User Role
|
Comma-separated list of WP role slugs if logged in (e.g. "subscriber", "customer,editor") — falling back to the literal string "logged_in" if a logged-in user somehow has no roles — or "guest" for anonymous visitors. Sent on every page.
info_outline Fires on every page — both logged-in and logged-out visitors
|
| ga4wp_user_id | User |
TrueAna User ID
|
WordPress numeric user ID as a string. Only sent when the visitor is logged in AND the "Do Not Track User ID" tracking setting is disabled. Also attached to WooCommerce conversion events server-side.
info_outline USER-scoped. Requires "Do Not Track User ID" to be unchecked in settings
|
| Form Dimensions — sent with form_view and form_submit events only | |||
| ga4wp_form_id | Event |
Form ID
|
The form plugin's numeric or string ID, e.g. "123" for CF7, WPForms, Gravity Forms, Fluent Forms, or Formidable. Sent with form_view and form_submit events via both gtag and dataLayer.
info_outline Only fires with form tracking events — not with page_view
|
| ga4wp_form_name | Event |
Form Name
|
Human-readable form title/name from the form plugin, e.g. "Contact Us". Used by the Form Conversion Report which queries customEvent:ga4wp_form_name for event counts per form.
info_outline Only fires with form tracking events — not with page_view
|
| WooCommerce Dimensions — sent with purchase and refund events only | |||
| ga4wp_conversion_type | Event |
Conversion Type
|
Identifies the WooCommerce conversion event type. Values include "purchase", "refund", "subscription_created", and other order status events. Sent with completed purchase and refund events.
info_outline WooCommerce only — requires WooCommerce to be active
|
| WooCommerce Subscriptions Dimensions — requires WooCommerce Subscriptions plugin | |||
| ga4wp_subscription_id | Event |
Subscription ID
|
The WooCommerce Subscriptions post ID as a string. Sent with subscription lifecycle events: subscription_created, subscription_cancelled, subscription_expired, payment failed, and renewal events.
info_outline Requires WooCommerce Subscriptions plugin to be active
|
| ga4wp_subscription_renewal_count | Event |
Subscription Renewal Count
|
The total number of completed renewals for this subscription. Sent with subscription renewal events to track retention — useful for identifying which renewal number has the highest churn risk.
info_outline Requires WooCommerce Subscriptions plugin to be active
|
Click any dimension to see its exact parameter key, value format, which GA4 reports it powers, and real data examples.
Identifies the WordPress post author for every singular page view. The value is the numeric WP user ID — the TrueAna Content Performance report then resolves author names server-side to display "Author Based Views".
ga4wp_author_id
customEvent:ga4wp_author_id
Sends all category names for the current post as a comma-separated string. A post in both "Tutorials" and "WooCommerce" sends ga4wp_category = "Tutorials,WooCommerce".
ga4wp_category
customEvent:ga4wp_category
Sends all post tag names as a comma-separated string. Useful for granular content analysis and topic cluster performance — especially for sites using tags as micro-categories.
ga4wp_tag
customEvent:ga4wp_tag
Distinguishes between WordPress post types in GA4. Crucial for sites that mix editorial and e-commerce content — segment WooCommerce revenue by whether the traffic came from a blog post or a product page.
ga4wp_post_type
customEvent:ga4wp_post_type
Sends the WordPress user role(s) of the current visitor on every page. Logged-out visitors always receive the value "guest". Logged-in visitors get their actual role(s) as a comma-separated string.
ga4wp_user_role
A USER-scoped dimension that associates logged-in WordPress user IDs with GA4 sessions for cross-device tracking. Only collected when the "Do Not Track User ID" setting is unchecked.
ga4wp_user_id
Three steps from zero to full custom dimension data in GA4 — no developer, no GTM, no code.
Go to WP Admin → TrueAna → Settings → Custom Dimensions. Each of the 11 dimensions has its own toggle. All are enabled by default once the Pro license is active — disable any you don't need.
In GA4, go to Admin → Custom definitions → Custom dimensions → Create. Use the exact parameter names below. 9 of the 11 are Event-scoped. ga4wp_user_role and ga4wp_user_id are both User-scoped — register those two as User properties, not Event parameters.
After 24–48 hours, the dimensions populate in GA4. The TrueAna Content Performance tab shows Author, Category, Tag, and Post Type reports automatically. In GA4 Explore add any dimension as a row, column, or segment filter.
The TrueAna Content Performance tab queries all four content dimensions via the GA4 Data API automatically.
Real questions that become answerable the moment custom dimensions are enabled.
The free plugin handles GA4 connection and event tracking. All 11 custom dimensions are exclusive to TrueAna Pro.
| Capability | Free | Pro · $49/yr |
|---|---|---|
| Standard GA4 Tracking | ||
| GA4 page_view, session_start tracking | check | check |
| WooCommerce e-commerce events | check | check |
| Form tracking events | remove | check |
| Content Custom Dimensions | ||
Author ID ga4wp_author_id |
remove | check |
Post Category ga4wp_category |
remove | check |
Post Tags ga4wp_tag |
remove | check |
Post Type ga4wp_post_type |
remove | check |
| User & Session Custom Dimensions | ||
User Role ga4wp_user_role |
remove | check |
User ID (USER-scoped) ga4wp_user_id |
remove | check |
| Form & WooCommerce Custom Dimensions | ||
Form ID & Name ga4wp_form_id |
remove | check |
Conversion Type ga4wp_conversion_type |
remove | check |
Subscription ID & Renewal Count ga4wp_subscription_id |
remove | check |
| Reports Powered by Custom Dimensions | ||
| Content Performance → Author / Category / Tag / Post Type | remove | check |
| Form Conversion Report | remove | check |
| GA4 Explore with all custom dimensions | remove | check |
Everything you need to know before enabling custom dimensions on your site.
Other analytics plugins charge extra for every integration. TrueAna Pro includes everything in one plan — use whatever you need, whenever you need it.
Lock in the launch discount on your first year of Pro — once 1,000 spots are claimed, this offer is gone for good.