Skip to content

docs(web-trackers): document preserveOriginalReferrer tracker option - #1873

Merged
Matus Tomlein (matus-tomlein) merged 2 commits into
mainfrom
loop/3a607af295a280da8c2adea3051ca267-documentation
Jul 27, 2026
Merged

docs(web-trackers): document preserveOriginalReferrer tracker option#1873
Matus Tomlein (matus-tomlein) merged 2 commits into
mainfrom
loop/3a607af295a280da8c2adea3051ca267-documentation

Conversation

@snowplow-claude-review

Copy link
Copy Markdown
Contributor

What

Documents the new preserveOriginalReferrer tracker option added to browser-tracker-core. Three files updated:

tracker-setup/initialization-options/index.md

  • Added preserveOriginalReferrer row to the initialization options table, positioned after preservePageViewIdForUrl (same preserve* family), with default false, type boolean, and a link to the new anchor.
  • Added preserveOriginalReferrer: false to both the JS-tag and Browser-npm code examples so the option is discoverable at the point of setup.

tracking-events/page-views/index.md

  • Added ### Preserve the original referrer in SPAs subsection under the existing 'Change ID behavior for SPAs' section.
  • Explains the freeze behavior, the no-op for empty document.referrer (direct navigation), and includes code examples for both tracker variants.

tracking-events/index.md

  • Expanded the 'For Single Page Apps' tip callout to present two approaches side by side: the declarative preserveOriginalReferrer: true (recommended for most integrations) and the existing imperative setReferrerUrl(document.referrer) (retained for cases needing more control). All existing content preserved.

Reviewer checklist

  • Table row format and column order in initialization-options/index.md matches the preservePageViewIdForUrl row.
  • The new ### Preserve the original referrer in SPAs heading in page-views/index.md follows a </Tabs> block without a transition sentence — minor style gap noted; not blocking but worth a one-liner fix next time the section is touched.
  • All internal anchor links verified by path search.

Draft PR opened for review — please verify and run CI before merging.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 23, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
documentation 6717999 Commit Preview URL

Branch Preview URL
Jul 27 2026, 02:00 PM

@snowplowcla

Copy link
Copy Markdown

Thanks for your pull request. Is this your first contribution to a Snowplow open source project? Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

📝 Please visit https://docs.snowplowanalytics.com/docs/contributing/contributor-license-agreement/ to learn more and sign.

Once you've signed, please reply here (e.g. I signed it!) and we'll verify. Thanks.

@matus-tomlein
Matus Tomlein (matus-tomlein) marked this pull request as ready for review July 27, 2026 13:56
Copilot AI review requested due to automatic review settings July 27, 2026 13:56

Copilot AI 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@matus-tomlein
Matus Tomlein (matus-tomlein) merged commit 47f2f27 into main Jul 27, 2026
7 of 8 checks passed
@matus-tomlein
Matus Tomlein (matus-tomlein) deleted the loop/3a607af295a280da8c2adea3051ca267-documentation branch July 27, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants