Skip to content

Add Fathom click tracking for reference filter vs global search usage - #1574

Closed
ritiupa wants to merge 1 commit into
processing:mainfrom
ritiupa:fathom-custom-events
Closed

Add Fathom click tracking for reference filter vs global search usage#1574
ritiupa wants to merge 1 commit into
processing:mainfrom
ritiupa:fathom-custom-events

Conversation

@ritiupa

@ritiupa ritiupa commented Aug 14, 2026

Copy link
Copy Markdown

Summary

Adds two Fathom custom click events so we can directly compare reference filter usage against sitewide search usage in the analytics dashboard, building on the base Fathom script added in #1511.

  • Reference Filter Used: fires once per session on the first non-empty keystroke in the page-level "Filter by keyword" box on /reference/.
  • Global Search Used: fires once per session on the first non-empty sitewide search term.

Both events are guarded behind typeof window !== "undefined" && window.fathom, so nothing breaks if the Fathom script hasn't loaded yet or is blocked.

Why

Related to #1221 (Fathom analytics was one of the requested usability/design improvements). Right now filter and search usage aren't distinguishable in analytics, which makes it hard to tell how often each tool is actually used, something this round of usability research keeps running into.

Testing

  • 14/14 existing tests passing
  • Full type check run, no other areas of the site affected
  • Manually verified both events fire exactly once per session and don't fire on empty input

Notes

I shared this branch with @ksen0 for a look before opening the PR (no changes requested), opening it now so it's in the queue for review.

Co-authored-by: Cursor <cursoragent@cursor.com>
@ksen0

ksen0 commented Aug 14, 2026

Copy link
Copy Markdown
Member

Hi @ritiupa , I apologize for the miscommunication, but please do check the existing PR about this first: #1531 Please do have a look and leave a review there.

After looking into it, we will only merge behavioral tracking once privy policy is updated.

Since this one is a duplicate, unfortunately I will close it! Sorry!

@ksen0 ksen0 closed this Aug 14, 2026
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