Skip to content

Measure consented developer demo use and operation outcomes - #124

Merged
mattConnHarbour merged 5 commits into
superdoc:mainfrom
jelkes1:codex/gallery-analytics-20261115
Nov 16, 2026
Merged

mattConnHarbour merged 5 commits into
superdoc:mainfrom
jelkes1:codex/gallery-analytics-20261115

Conversation

@jelkes1

@jelkes1 jelkes1 commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Add optional, consented measurement to the five developer demos and gallery using SuperDoc's existing GA4 property. Capture exposure, explicit selection, editor readiness, trusted editing, implementation-resource use, and bounded operation outcomes from real callbacks: review commands, field updates, synchronized collaboration, agent jobs, answers and saved versions.

The shared production-only adapter is installed during normal release assembly, not in downloaded local quickstarts. Refusal, withdrawal, DNT/GPC, opt-out and private URLs suppress tracking. Payloads contain fixed categories only, with canonical URL/title/referrer overrides. No document text, prompts, filenames, rooms, user identities or raw errors enter events. No CRM identification, new analytics provider or scheduler.

Validation: all 80 release/analytics script tests pass; all five apps build; Vue type check and six version-history server tests pass. Chromium desktop and phone-sized WebKit checked gallery-to-editor navigation, actual editor readiness and consent accepted/declined. QA intercepts Google transport and does not pollute production analytics. Production ingestion remains an explicit post-release check.

Companion changes add the homepage handoff event and complete-day Growth/weekly reporting. Preserve current demo versions and existing automatic release controls. This is a fork PR because the contributing account has read-only access to superdoc/demos; maintainer review/merge and the normal trusted release are required.

Privacy verification: Google now runs only in the isolated www.superdoc.dev frame introduced by homepage PR235. A real Google library test under the frame route CSP intercepted all collection requests, found no private synthetic document/title/room values, and sent zero production collection requests. Desktop Chromium and phone WebKit consent/decline checks pass. Later private navigation removes the frame without altering app navigation. Deploy homepage PR235 before this gallery release.

Prospective coverage: Josh clarified this standard applies to every future posted demo and example. The existing release test job now executes the real analytics adapter for every manifest route, checking stable IDs, readiness events and consent refusal; an unregistered future route cannot acquire transport. Future gallery entries fail CI until coverage is registered. README documents coordinated bounded frame/reporting updates, actual operation callbacks, post-release ingestion checks and format-specific limits. Preserve existing posts and private customer links.

@mattConnHarbour
mattConnHarbour merged commit 40f01cf into superdoc:main Nov 16, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants