Skip to content

docs(builder-codes): add tool-agnostic user analytics section for app developers - #2082

Closed
bvsakhil wants to merge 1 commit into
masterfrom
docs/builder-codes-user-analytics-v2
Closed

bvsakhil wants to merge 1 commit into
masterfrom
docs/builder-codes-user-analytics-v2

Conversation

@bvsakhil

@bvsakhil bvsakhil commented Oct 6, 2026

Copy link
Copy Markdown
Collaborator

What changed? Why?

Adds a Track User Analytics section at the end of the Builder Codes for App Developers page. It tells app developers what to measure (active users, retention, conversion) and where each signal comes from, so they can build their own analytics now that Base Dashboard doesn't show these metrics.

This supersedes #2077 and addresses all review feedback there:

  • No external tools: removed the agent prompt and all PostHog / Plausible / Mixpanel / Amplitude references
  • No copy-paste prompt: replaced with four plain steps: identify users by wallet address, record key moments in the user journey, use onchain data for transactions, build three dashboards
  • No Wagmi: removed useAccount and the Wagmi note. The transactions step now points to onchain signals that work with any stack: the Builder Code suffix (linking to Verify Attribution), the sending wallet address, and receipt status (success vs. revert)
  • Dashboards: kept, now described as journey stages (open → connect → first successful transaction) instead of event names

Notes to reviewers

@youssefea, thanks for the review on #2077. This is the reworked version. I'll close #2077 once you're happy with this one.

Unchanged and out of scope: the Wagmi and Viem setup sections earlier on the page, and the older Dashboard references on the Overview page and under Verify Attribution.

How has it been tested?

  • node scripts/lint-mdx.js on the changed file: 0 errors, 0 warnings
  • node scripts/check-terminology.js: passed
  • node scripts/validate-docs-structure.js: passed (no navigation changes)
  • Rendered and reviewed locally with mint dev

Screenshots

To be added. Verified locally at /specifications/builder-codes/for-app-developers#track-user-analytics.

Generated with Toshi

… developers

Adds a Track User Analytics section to the Builder Codes for App Developers page describing what to measure and where each signal comes from, without naming analytics tools or wallet libraries. Supersedes #2077.
@bvsakhil
bvsakhil requested a review from youssefea October 6, 2026 15:29
@mintlify

mintlify Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
base 🟢 Ready View Preview Oct 6, 2026, 3:30 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@bvsakhil

bvsakhil commented Oct 6, 2026

Copy link
Copy Markdown
Collaborator Author

Closing in favor of #2077. The same changes have been pushed there so the review stays in one place.

Generated with Toshi

@bvsakhil bvsakhil closed this Oct 6, 2026
@bvsakhil
bvsakhil deleted the docs/builder-codes-user-analytics-v2 branch October 6, 2026 15:32

This branch was successfully deployed

1 active deployment
staging - docs — 9f559dec Deployed Oct 6, 2026 by mintlify[bot]
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