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
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.missingvendor.google-analytics-collect.param.v.emptyvendor.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.missingvendor.google-analytics-collect.param.tid.emptyvendor.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.missingvendor.google-analytics-collect.param.cid.empty |
docs |
en |
recommended | It is the event name. | vendor.google-analytics-collect.param.en.missingvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.missingvendor.google-analytics-collect.http.method.emptyvendor.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