docs: tag README and docs signup CTAs for link attribution - #456
Open
us wants to merge 1 commit into
Open
Conversation
Every signup link on the repo and on docs.fastcrw.com pointed at a bare /register, so all of them collapsed into a single row in the funnel and there was no way to tell which one converted. Docs referers arrive truncated to the origin under strict-origin-when-cross-origin, so the referer header cannot recover the page either. - README and README.zh-CN: the four signup CTAs carry ?ref=gh-<slot> - docs template: the navbar and TOC CTAs carry ?ref=docs-<slug>-<slot>, rewritten per page by build-docs-pages.mjs - quick-start, search and monitoring inline links carry ?ref=docs-<slug>-inline Visible link text is unchanged everywhere; the slug lives only in the href. sitemap.xml is deliberately not regenerated so 50 URLs do not all report a fresh lastmod for a query-string change.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Every signup link on the repo and on docs.fastcrw.com pointed at a bare
/register. Measured over 30 days on the funnel data, those two surfaces arethe highest-converting entry points we have (github 113 visitors / 17 signups,
docs 57 / 8), but each is a single undifferentiated row: there is no way to tell
which README CTA or which docs page produced them.
The referer header cannot answer it either. Docs referers arrive truncated to
the origin under
strict-origin-when-cross-origin(125 hits onhttps://docs.fastcrw.com/against 2 on any deep page), and every README linkreports the same
https://github.com/us/crw.What changed
README.mdandREADME.zh-CN.md: the signup CTAs carry?ref=gh-<slot>(
hero,quickstart,sdk,table,zh).docs/index.html: the navbar and TOC CTAs carry?ref=docs-home-<slot>.scripts/build-docs-pages.mjsrewritesdocs-home-to the page's own slugwhen generating each page, so
docs/scraping/index.htmlemits?ref=docs-scraping-navand?ref=docs-scraping-cta.docs/docs/{quick-start,search,monitoring}.md: inline signup links carry?ref=docs-<slug>-inline.Notes
href, including where the anchor text is itself the URL(
[fastcrw.com/register](...)in quick-start).docs/sitemap.xmlis deliberately left alone. Regenerating bumpedlastmodon all 50 URLs, which would report 50 content updates to crawlersfor a query-string change.
curl -fsSL https://fastcrw.com/install | shisuntouched.
generator only.
Follow-up in the private repo
A companion change drops the
refparameter from the address bar on arrivalvia
history.replaceState. The edge middleware records the full URLserver-side before first paint, so the slug is captured either way and the
reader never sees a tracking string.