Skip to content

docs: Document automatic tracking filtering for bot, monitoring, and privacy opt-out traffic#796

Open
promptless-for-oss wants to merge 3 commits into
mautic:7.2from
Promptless:promptless/privacy-aware-tracking-filtering-7.2
Open

docs: Document automatic tracking filtering for bot, monitoring, and privacy opt-out traffic#796
promptless-for-oss wants to merge 3 commits into
mautic:7.2from
Promptless:promptless/privacy-aware-tracking-filtering-7.2

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Adds an 'Automatic tracking filtering' subsection under Tracking settings explaining that Mautic now excludes bot/crawler, HEAD, prefetch/prerender, Sec-GPC (Global Privacy Control), and DNT requests from page hits, Email opens, Asset downloads, and Contact tracking. Cross-references the new section from the Contacts overview. Documents mautic/mautic#15844.

Trigger Events


Tip: Configure how Promptless handles changelogs in Agent Settings 📋

…y opt-out traffic

Mautic now excludes bot/crawler, HEAD, prefetch/prerender, Sec-GPC, and DNT
requests from tracking (page hits, Email opens, Asset downloads, Contact
tracking). Add an Automatic tracking filtering subsection under Tracking
settings and cross-reference it from the Contacts overview.

Source: mautic/mautic#15844
* The tracking code automatically detects the Preferred Timezone and Preferred Locale fields.
* Landing Pages including 4-byte UTF-8 characters, such as emojis and some Chinese or other non-Latin characters, in the Landing Page title or URL aren't tracked on a Contact's activity history in Mautic. Mautic tracks all Latin characters used in English and other western languages which are of 1-byte.

Automatic tracking filtering

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Documented the new automatic tracking-filtering behavior introduced by this PR. The new IpLookupHelper::isRequestTrackable() method suppresses tracking for HTTP HEAD requests, prefetch/prerender requests (Purpose/Sec-Purpose headers), Sec-GPC: 1, and DNT: 1, falling through to existing bot/IP filtering. It gates page hits (PageModel::hitPage()), Email opens (EmailModel::hitEmail()), Asset downloads (AssetModel::trackDownload()), and Contact tracking (ContactTracker). The behavior is always-on with no configuration toggle, which is why the docs state it can't be turned off.

Source: mautic/mautic#15844

Comment thread docs/contacts/contacts_overview.rst Outdated
@adiati98 adiati98 added this to the Mautic 7.2 milestone Jun 26, 2026

@adiati98 adiati98 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.

@promptless-for-oss please address the suggestions.

Comment thread docs/configuration/settings.rst
Comment thread docs/configuration/settings.rst
Comment thread docs/configuration/settings.rst Outdated
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Thanks @adiati98 — done. I applied both suggested replacements verbatim (keeping the .. vale off / .. vale on directives) and rewrote the closing paragraph in active voice ("you can't turn it off") while dropping the redundant activity list that triggered the FeatureList warning. Vale now runs clean on the changed section. The remaining "page" references the generic tracked request rather than the Landing Page feature, so I left those as-is.

Comment thread docs/contacts/contacts_overview.rst Outdated
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Thanks @adiati98 — applied your suggestion. Added the trailing period to the cross-reference bullet so it reads exactly as suggested. The :ref:Automatic tracking filtering`` link resolves to the new section in settings.rst, and Vale is clean on the changed file. 🙏

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.

2 participants