Skip to content

Refactor owned-link attribution tracking across web and desktop#4997

Open
ComputelessComputer wants to merge 2 commits intomainfrom
refactor/centralize-owned-link-utms
Open

Refactor owned-link attribution tracking across web and desktop#4997
ComputelessComputer wants to merge 2 commits intomainfrom
refactor/centralize-owned-link-utms

Conversation

@ComputelessComputer
Copy link
Copy Markdown
Collaborator

Summary

  • centralize owned-link UTM tagging so blog, docs, changelog, and desktop settings links use one shared convention
  • persist the browser PostHog distinct ID on tracked download flows and carry it through the auth callback and desktop deeplink
  • add desktop analytics alias support so browser download activity and desktop machine activity can be merged during sign-in

Validation

Completed:

  • pnpm exec dprint fmt
  • pnpm -F @hypr/web typecheck
  • pnpm -F desktop typecheck
  • cargo check -p analytics -p tauri-plugin-analytics -p tauri-plugin-deeplink2

Known unrelated workspace issue:

  • full cargo check still fails in crates/notification-worker/src/lib.rs because of an existing cron::Schedule / apalis_cron::Schedule<Utc> mismatch

Validation Plan

  • verify a tracked web download click emits download_clicked with web_distinct_id
  • complete desktop sign-in from that same browser session and confirm the callback deeplink includes web_distinct_id
  • confirm the web callback aliases the stored/current browser distinct ID to the authenticated user ID
  • confirm the desktop auth path aliases that same browser distinct ID to the machine fingerprint before desktop identify runs
  • check in PostHog that the merged person shows both the web download event and subsequent desktop auth/activity events
  • regression check that docs and blog owned links still render with the expected UTM parameters and that desktop auth still works when web_distinct_id is absent

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 11, 2026

Deploy Preview for char-cli-web canceled.

Name Link
🔨 Latest commit f93361d
🔍 Latest deploy log https://app.netlify.com/projects/char-cli-web/deploys/69da0b775f07f00008353193

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 11, 2026

Deploy Preview for hyprnote ready!

Name Link
🔨 Latest commit f93361d
🔍 Latest deploy log https://app.netlify.com/projects/hyprnote/deploys/69da0b77d906cb0008536dab
😎 Deploy Preview https://deploy-preview-4997--hyprnote.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

ComputelessComputer added 2 commits April 11, 2026 17:50
Add a shared Char UTM URL helper, route blog/docs MDX links through centralized tagging, and update the repo/docs references to match the new convention.
Persist browser distinct IDs on tracked download flows, alias them during web auth, and pass the ID through desktop auth so PostHog can connect browser and device identities.
@ComputelessComputer ComputelessComputer force-pushed the refactor/centralize-owned-link-utms branch from f3b2669 to f93361d Compare April 11, 2026 08:51
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.

1 participant