Skip to content

FRD-1556: Add UTM links for npm and GitHub SDK docs - #12

Merged
kathinaios merged 1 commit into
mainfrom
FRD-1556-Create-UTM-link-for-npm
Jul 29, 2026
Merged

kathinaios merged 1 commit into
mainfrom
FRD-1556-Create-UTM-link-for-npm

Conversation

@kathinaios

@kathinaios kathinaios commented Jul 28, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Add static UTM query params to Bespot product links in README.md, docs/integration-guide.md, and docs/authentication.md so GA can attribute traffic from the public SDK package and GitHub docs.
  • Keep one tagged signup CTA per README / integration guide (duplicate signup hrefs removed or plain-text).
  • Leave API example URLs, badges, and third-party links untagged.
  • No source-repo (gatekeeper-web-sdk) changes — marketing links live only in this release repo; npm ships README but not docs/.

UTM taxonomy

Param Values
utm_source readme | integration | authentication
utm_medium signup | docs-home | docs-auth
utm_campaign gatekeeper-web-sdk
utm_content see inventory below

Note: README is shared by npm and GitHub, so utm_source=readme does not split host; use GA referrer if that distinction is needed. docs/* links are GitHub-only.

UTM link inventory

Location Position Destination utm_source utm_medium utm_campaign utm_content
README.md:21 Prerequisites › Signup gatekeeper.bespot.com readme signup gatekeeper-web-sdk readme-signup
README.md:25 Documentation › Docs home docs.bespot.com readme docs-home gatekeeper-web-sdk readme-docs-home
README.md:35 Documentation › Docs auth docs.bespot.com/api/auth readme docs-auth gatekeeper-web-sdk readme-docs-auth
docs/integration-guide.md:54 Bespot prerequisites › Signup gatekeeper.bespot.com integration signup gatekeeper-web-sdk integration-signup
docs/integration-guide.md:60 Bespot prerequisites › Docs home docs.bespot.com integration docs-home gatekeeper-web-sdk integration-docs-home
docs/integration-guide.md:643 Support › Docs auth docs.bespot.com/api/auth integration docs-auth gatekeeper-web-sdk integration-docs-auth
docs/authentication.md:9 Official reference › Docs home docs.bespot.com authentication docs-home gatekeeper-web-sdk authentication-docs-home
docs/authentication.md:10 Official reference › Docs auth docs.bespot.com/api/auth authentication docs-auth gatekeeper-web-sdk authentication-docs-auth

Test plan

  • Spot-check all 8 hrefs render correctly on GitHub
  • Confirm npm README preview shows UTM query strings on the three README links
  • Click each destination once and confirm GA realtime (or Tag Assistant) receives the expected source/medium/campaign/content
  • Confirm gatekeeper.bespotcompany.com example baseUrl strings remain without UTMs
  • Confirm Quick start / Account portal no longer use a second signup href

Made with Cursor

Tag signup and docs CTAs in the README and GitHub docs so GA can attribute traffic from npm/GitHub surfaces; keep params static and drop duplicate signup hrefs.

Co-authored-by: Cursor <cursoragent@cursor.com>
@kathinaios
kathinaios requested a review from dimdimitros July 28, 2026 12:14
@kathinaios kathinaios self-assigned this Jul 28, 2026
@kathinaios kathinaios added the documentation Improvements or additions to documentation label Jul 28, 2026

@dimdimitros dimdimitros left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@kathinaios
kathinaios merged commit 2a6cee3 into main Jul 29, 2026
5 checks passed
@kathinaios
kathinaios deleted the FRD-1556-Create-UTM-link-for-npm branch July 29, 2026 10:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants