Skip to content

docs: fix GA4 Exploration setup guide#308

Merged
wil-gerken merged 3 commits intotrunkfrom
docs/fix-ga4-exploration-guide
Mar 6, 2026
Merged

docs: fix GA4 Exploration setup guide#308
wil-gerken merged 3 commits intotrunkfrom
docs/fix-ga4-exploration-guide

Conversation

@wil-gerken
Copy link
Contributor

Changes proposed in this Pull Request:

The plugin sends republication tracking data as event parameters on page_view events. It does not use user_properties. This can be seen here: includes/pixel.php, lines 139-152.

The setup guide, on the other hand, referenced Users and was also missing instructions on registering the custom dimension.

Changes:

  • Added "Register Custom Dimensions in GA4" section for shared_post_url
  • Changed "User segment" to "Event segment" in Exploration instructions
  • Updated the segment screenshot to show Event scope

Closes NPPM-2638.

How to test the changes in this Pull Request:

  1. Read through docs/tracking-republished-posts.md end to end — confirm the instructions are clear and complete enough that a publisher could follow them without prior GA4 Exploration experience
  2. Verify the new "Register Custom Dimensions" section matches the current GA4 Admin UI (Admin → Data display → Custom dimensions)
  3. Confirm the Exploration instructions reference Event segment (not User segment).
  4. Check that the updated screenshot (docs/img/google-analytics-segment-settings.png) shows "Include events when:" rather than "Include users when:"

@wil-gerken wil-gerken requested a review from a team as a code owner February 27, 2026 21:44
Copilot AI review requested due to automatic review settings February 27, 2026 21:44
@wil-gerken wil-gerken removed the request for review from a team February 27, 2026 21:46
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the GA4 Exploration setup documentation to correctly reflect how the plugin emits republication tracking data (as event parameters on page_view), and to guide users through configuring GA4 so shared_post_url is usable in Explorations.

Changes:

  • Added a GA4 custom dimension registration section for shared_post_url (Event scope).
  • Updated Exploration instructions to use an Event segment (instead of a User segment).
  • Updated the “Segment Comparisons” instruction to refer to the event segment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 2 changed files in this pull request and generated 1 comment.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 2 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@wil-gerken wil-gerken merged commit 1c19647 into trunk Mar 6, 2026
12 checks passed
@wil-gerken wil-gerken deleted the docs/fix-ga4-exploration-guide branch March 6, 2026 18:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants