pixellint

GA4 browser hits keep numeric properties numeric.

The public Google tag sends /g/collect query parameters. This profile checks GA4 identity alongside populated browser metadata and numeric epn and upn property families.

Custom events, string properties, product tuples and consent encodings remain open. Source checks are advisory. Plaintext batch bodies and the Measurement Protocol JSON API have separate scope.

What this pack matches

Hosts
analytics.google.com, google-analytics.com
Paths
/g/collect, /g/collect/, /debug/g/collect, /debug/g/collect/
Vendor docs
developers.google.com/analytics/devguides/collection/ga4

Rules

Codes are stable. A finding in CI, MCP, or the playground lands on the same id.

Field Required What it checks Rule ids Source
v required GA4 collection uses protocol version 2. Version 1 is Universal Analytics, which stopped processing data. Value diagnostic severity: warning. Fix: Send `v=2` from a Google tag configured for a GA4 property. vendor.google-analytics-collect.param.v.missing
vendor.google-analytics-collect.param.v.empty
vendor.google-analytics-collect.param.v.invalid
docs
tid required It is the GA4 measurement ID, which starts with `G-`. A `UA-` value here is a Universal Analytics property that no longer collects data. Value diagnostic severity: warning. Fix: Point the tag at a GA4 measurement ID. vendor.google-analytics-collect.param.tid.missing
vendor.google-analytics-collect.param.tid.empty
vendor.google-analytics-collect.param.tid.invalid
docs
cid required It is the client ID that ties events to one browser. Without it, hits cannot be attributed to a session. vendor.google-analytics-collect.param.cid.missing
vendor.google-analytics-collect.param.cid.empty
docs
en recommended It is the event name. vendor.google-analytics-collect.param.en.missing
vendor.google-analytics-collect.param.en.empty
docs
dl optional The producer sends an absolute page or referrer URL. Blank referrers remain valid. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.dl.empty
vendor.google-analytics-collect.param.dl.invalid
docs
dr optional The producer sends an absolute page or referrer URL. Blank referrers remain valid. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.dr.empty
vendor.google-analytics-collect.param.dr.invalid
docs
dt optional Document title remains an open string. Presence diagnostic severity: warning. Evidence: vendor template. docs
cu optional The producer uses a three-letter currency token. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.cu.empty
vendor.google-analytics-collect.param.cu.invalid
docs
sr optional Browser screen dimensions use width x height. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.sr.empty
vendor.google-analytics-collect.param.sr.invalid
docs
sid optional The browser producer emits a nonnegative integer counter or timestamp. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.sid.empty
vendor.google-analytics-collect.param.sid.invalid
docs
sct optional The browser producer emits a nonnegative integer counter or timestamp. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.sct.empty
vendor.google-analytics-collect.param.sct.invalid
docs
_s optional The browser producer emits a nonnegative integer counter or timestamp. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._s.empty
vendor.google-analytics-collect.param._s.invalid
docs
_et optional The browser producer emits a nonnegative integer counter or timestamp. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._et.empty
vendor.google-analytics-collect.param._et.invalid
docs
_p optional The browser producer emits a nonnegative integer counter or timestamp. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._p.empty
vendor.google-analytics-collect.param._p.invalid
docs
tfd optional The browser producer emits a nonnegative integer counter or timestamp. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.tfd.empty
vendor.google-analytics-collect.param.tfd.invalid
docs
seg optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.seg.empty
vendor.google-analytics-collect.param.seg.invalid
docs
frm optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.frm.empty
vendor.google-analytics-collect.param.frm.invalid
docs
npa optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.npa.empty
vendor.google-analytics-collect.param.npa.invalid
docs
dma optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.dma.empty
vendor.google-analytics-collect.param.dma.invalid
docs
uamb optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.uamb.empty
vendor.google-analytics-collect.param.uamb.invalid
docs
uaw optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.uaw.empty
vendor.google-analytics-collect.param.uaw.invalid
docs
_fv optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._fv.empty
vendor.google-analytics-collect.param._fv.invalid
docs
_ss optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._ss.empty
vendor.google-analytics-collect.param._ss.invalid
docs
_nsi optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._nsi.empty
vendor.google-analytics-collect.param._nsi.invalid
docs
_ee optional The pinned browser producer uses a binary flag. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param._ee.empty
vendor.google-analytics-collect.param._ee.invalid
docs
numeric_properties… optional Numeric event and user property families retain signed decimal and exponent values. Presence diagnostic severity: warning. Evidence: vendor template. vendor.google-analytics-collect.param.numeric_properties.empty
vendor.google-analytics-collect.param.numeric_properties.invalid
docs
method recommended The source uses these transport methods. Complete HTTP capture contract. Presence diagnostic severity: warning. vendor.google-analytics-collect.http.method.missing
vendor.google-analytics-collect.http.method.empty
vendor.google-analytics-collect.http.method.invalid
docs

Validate a payload

pixellint validate url "$ARTIFACT" --rulepack vendor/google-analytics-collect

Try this failing payload in the playground. A GA4 hit with a nonnumeric event value.

https://www.google-analytics.com/g/collect?v=2&tid=G-SYNTHETIC0&cid=opaque&en=purchase&epn.value=free

cargo install pixellint · npm install pixellint