{"id":435,"date":"2026-09-02T08:00:00","date_gmt":"2026-09-02T06:00:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/?p=435"},"modified":"2026-10-24T01:42:42","modified_gmt":"2026-10-23T23:42:42","slug":"server-side-pii-redaction-building-a-privacy-firewall-in-ssgtm","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/en\/digital-marketing\/server-side-pii-redaction-building-a-privacy-firewall-in-ssgtm\/","title":{"rendered":"Server-Side PII Redaction: Building a Privacy Firewall in ssGTM"},"content":{"rendered":"

Email addresses, telephone numbers and access tokens can accidentally reach analytics systems through URLs, page titles or form fields. Server-side Google Tag Manager (ssGTM) adds a filtering point before configured tags send data onward. This reduces exposure, but does not automatically make a collection anonymous or compliant.<\/p>\n

1. Prevent collection at the source<\/h2>\n

Personal data should not enter analytics URLs. Google Analytics prohibits PII in ordinary URL and event fields; hashing an email address does not turn a custom parameter into an approved customer-data channel. Dedicated user-provided-data features have separate fields, configuration and policy requirements.<\/p>\n

Hashing, encryption and anonymisation serve different purposes. A hash used to match a customer can remain personal data. The GDPR does not impose a blanket rule that every permitted disclosure must first be hashed; lawful processing, data minimisation and appropriate security remain necessary.<\/p>\n

POST avoids placing form values in the URL, but still transmits a request body. HTTPS, restricted logging and control over analytics collection remain necessary. An ssGTM filter cannot retrospectively remove information already stored in browser history, proxies or vendor systems. An incident requires stopping collection and assessing deletion in each affected system.<\/p>\n

\"Controlled
Only the approved event-data path is filtered; raw requests, logs and browser tags require separate controls.<\/figcaption><\/figure>\n

2. Define the boundary of the filter<\/h2>\n

The ssGTM client converts an incoming request into event data. Transformations can modify, allow or exclude event parameters before selected tags read the data. Affected Tags and Matching Conditions determine coverage; defaults cover all tags and events, but later configuration changes can narrow that scope.<\/p>\n

This is not a global rewrite of the HTTP request. A template with permission to read request headers or the raw body can access a separate data source. Browser pixels, server logs, client code and other outbound integrations need their own review. Different transformations or tag mappings can also produce different outbound payloads.<\/p>\n

3. Prefer explicit fields and known routes<\/h2>\n

A regular expression detects a pattern, not the meaning of data. An email pattern can miss encoded or unusual addresses. A 9\u201315 digit pattern also matches order IDs and timestamps; eleven digits do not establish a valid PESEL number. A checksum test would still not establish that a number is safe to disclose.<\/p>\n

A smaller data model is easier to check: no arbitrary form text, only approved parameters, and canonical page routes without identifiers. The following illustrative variable accepts three exact URLs and discards every query string and fragment. Unknown routes and non-string inputs return undefined<\/code>. The example domain and routes require replacement with reviewed site values.<\/p>\n

const getEventData = require('getEventData');\nconst getType = require('getType');\nconst value = getEventData(data.parameter);\nif (getType(value) !== 'string') return undefined;\nconst base = value.split('#')[0].split('?')[0];\nconst allowed = [\n  'https:\/\/www.example.com\/',\n  'https:\/\/www.example.com\/products',\n  'https:\/\/www.example.com\/checkout\/complete'\n];\nfor (let i = 0; i < allowed.length; i++) {\n  if (base === allowed[i]) return allowed[i];\n}\nreturn undefined;\n<\/code><\/pre>\n
The template needs a text field named parameter<\/code> and read_event_data<\/code> permission limited to the relevant URL field. The return value always comes from the static list; encoded parameter names and double-encoded query values cannot pass through that output. This is deliberately restrictive and also removes campaign parameters. It is not a general-purpose PII detector.<\/p>\n
4. Apply the rule without a raw-value fallback<\/h2>\n
    \n
  1. Separate variables evaluate page_location<\/code> and any other approved URL field. The same allowlist is unsuitable for arbitrary external referrers; an unknown referrer must be omitted or handled by its own reviewed policy.<\/li>\n
  2. An Augment event transformation supplies accepted canonical URLs to the intended tags. Unneeded free-text fields are excluded; a parameter allowlist must retain the technical fields required by the selected tags.<\/li>\n
  3. A rejected value must explicitly block the affected tag or cause explicit field exclusion. Returning undefined<\/code> alone is not proof of removal: a tag can fall back to a raw URL or another source.<\/li>\n
  4. Transformation order, affected tags, conditions and template permissions need review. A later transformation must not restore the raw value.<\/li>\n<\/ol>\n
    GA4 and Meta require separate outbound inspection. Meta customer-data fields do not all use SHA-256: email and phone matching differ from fields such as client IP, user agent and browser identifiers. A cleaned URL neither authorizes those fields nor anonymises the complete event.<\/p>\n
    5. Test the outbound request<\/h2>\n
    Test data should be synthetic: uppercase and encoded parameter names, %40<\/code>, double encoding, fragments, repeated keys, invalid types, unknown paths and token-bearing URLs. A known route such as https:\/\/www.example.com\/products?email=test%40example.com<\/code> must return only https:\/\/www.example.com\/products<\/code>. An unknown path must fail the allowlist.<\/p>\n
    The variable logic can be tested separately, but publication also requires ssGTM preview checks of every destination and the actual outgoing payload. The incoming preview still contains the original request. Log retention and access therefore require separate controls.<\/p>\n
    \n
    Questions and answers<\/h2>\n
    Are later tags automatically protected?<\/h3>\n
    Only the configured data path is covered. A new tag must match the transformation scope, consume the transformed field and avoid raw-request fallbacks. Each new tag needs an outbound test.<\/p>\n
    Does URL cleaning remove all personal data?<\/h3>\n
    No. Titles, search terms, nested objects, cookies, identifiers and custom fields can contain personal data. The safest field can be an omitted field; free text should not be collected merely because a regex is available.<\/p>\n<\/div>\n
    \n
    Sources<\/h2>\n