Skip to content

feat: enable Kapa anonymous user tracking on docs chat - #535

Merged
dannyneira merged 2 commits into
mainfrom
danny/kapa-user-tracking
Aug 14, 2026
Merged

feat: enable Kapa anonymous user tracking on docs chat#535
dannyneira merged 2 commits into
mainfrom
danny/kapa-user-tracking

Conversation

@dannyneira

@dannyneira dannyneira commented Aug 14, 2026

Copy link
Copy Markdown
Member

Summary

Enable Kapa anonymous user tracking on the docs Ask AI chat so unique visitors and journeys show up in the Kapa Users dashboard.

Per Kapa React SDK docs, KapaProvider supports userTrackingMode of cookie (default), fingerprint, or none. We had explicitly set none.

Changes

src/components/KapaChatLauncher.tsx

  • Switched userTrackingMode from none to cookie (first-party kapa_web_id cookie; no PII)

Notes

  • Cookie tracking is anonymous only
  • Fingerprint tracking and email/window.kapaSettings enrichment are intentionally out of scope
  • No CSP changes required for cookie mode

Unverified claims

None — behavior matches Kapa React SDK userTrackingMode docs.

Co-Authored-By: Warp agent@warp.dev

Switch KapaProvider from userTrackingMode none to cookie so unique
visitors are tracked via the first-party kapa_web_id cookie. When a
user submits a support handoff email, attach it to window.kapaSettings
so later Kapa turns can enrich the same user profile.

Co-Authored-By: Warp <agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Aug 14, 2026
@vercel

vercel Bot commented Aug 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 14, 2026 9:35pm

Request Review

Drop handoff email enrichment; keep anonymous first-party cookie tracking.

Co-Authored-By: Warp <agent@warp.dev>
@dannyneira
dannyneira requested a review from rachaelrenk August 14, 2026 21:43
@dannyneira
dannyneira marked this pull request as ready for review August 14, 2026 21:43
@oz-for-oss

oz-for-oss Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

@dannyneira

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@oz-for-oss oz-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Overview

This PR changes the docs Kapa chat provider from opting out of SDK user tracking to using Kapa's cookie-based anonymous tracking mode. The SDK value is consistent with the intended behavior, and no tests are changed.

Concerns

  • Enabling cookie tracking in this globally mounted launcher can set a persistent first-party Kapa identifier for docs visitors on page load, not only after a visitor opens or submits the chat, so the change needs disclosure or consent gating before merge.

Verdict

Found: 0 critical, 1 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Comment thread src/components/KapaChatLauncher.tsx
@dannyneira
dannyneira merged commit 5a6c34a into main Aug 14, 2026
8 checks passed
@dannyneira
dannyneira deleted the danny/kapa-user-tracking branch August 14, 2026 22:02
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.

2 participants