Reddit Pixel checks cover image and form collectors.
Reddit Pixel sends POST form requests to /rp and GET image fallbacks to /rp.gif. Both transports receive event, metadata and matching-field checks.
Documented custom names accept any UTF-8 character through 64 characters, including newlines. SDK-derived checks remain advisory and accept numeric strings in products.
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 |
|---|---|---|---|---|
id |
required | It is the Reddit advertiser ID. Reddit documents how to install the pixel rather than this query name, so this rule is ecosystem evidence. Fix: Copy the advertiser ID from Reddit Ads into the pixel snippet. | vendor.reddit.param.id.missingvendor.reddit.param.id.empty |
docs |
event |
recommended | Reddit documents these standard names on rdt('track'). Custom events use Custom. Unrecognized values warn because a misspelling (Purchse) otherwise ships as a new event. Value diagnostic severity: warning. Fix: Use a standard event name, or Custom with customEventName in the pixel call. | vendor.reddit.param.event.missingvendor.reddit.param.event.emptyvendor.reddit.param.event.invalid |
docs |
m.customEventName |
optional | It is the custom event name Reddit documents on rdt('track', 'Custom', { customEventName }). Generated pixels send it as m.customEventName. Reddit allows any UTF-8 character up to 64 characters including spaces. Empty slots on standard events are unfilled GTM template fields. Fix: Set m.customEventName to the custom event name, at most 64 characters, or drop the pair on a standard event. | vendor.reddit.param.m.customEventName.emptyvendor.reddit.param.m.customEventName.invalid |
docs |
em |
optional | The pinned SDK hashes this wire field to lowercase SHA-256 hex. Inputs may be raw or prehashed; hash correctness and identity ownership are external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.em.emptyvendor.reddit.param.em.invalid |
docs |
pn |
optional | The pinned SDK hashes this wire field to lowercase SHA-256 hex. Inputs may be raw or prehashed; hash correctness and identity ownership are external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.pn.emptyvendor.reddit.param.pn.invalid |
docs |
aaid |
optional | The pinned SDK hashes this wire field to lowercase SHA-256 hex. Inputs may be raw or prehashed; hash correctness and identity ownership are external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.aaid.emptyvendor.reddit.param.aaid.invalid |
docs |
external_id |
optional | The pinned SDK hashes this wire field to lowercase SHA-256 hex. Inputs may be raw or prehashed; hash correctness and identity ownership are external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.external_id.emptyvendor.reddit.param.external_id.invalid |
docs |
idfa |
optional | The pinned SDK hashes this wire field to lowercase SHA-256 hex. Inputs may be raw or prehashed; hash correctness and identity ownership are external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.idfa.emptyvendor.reddit.param.idfa.invalid |
docs |
m.conversionId |
optional | The pinned SDK hashes this wire field to lowercase SHA-256 hex. Inputs may be raw or prehashed; hash correctness and identity ownership are external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.m.conversionId.emptyvendor.reddit.param.m.conversionId.invalid |
docs |
m.value |
optional | Populated conversion values are numeric. Legacy cents and decimal values are separate fields; no positive amount or freshness bound is inferred. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.m.value.emptyvendor.reddit.param.m.value.invalid |
docs |
m.valueDecimal |
optional | Populated conversion values are numeric. Legacy cents and decimal values are separate fields; no positive amount or freshness bound is inferred. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.m.valueDecimal.emptyvendor.reddit.param.m.valueDecimal.invalid |
docs |
m.itemCount |
optional | The published metadata example specifies an integer item count. Value diagnostic severity: warning. | vendor.reddit.param.m.itemCount.emptyvendor.reddit.param.m.itemCount.invalid |
docs |
m.currency |
optional | A populated metadata currency is a three-letter code. Account support is external. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.m.currency.emptyvendor.reddit.param.m.currency.invalid |
docs |
m.orderId |
optional | The pinned SDK truncates order identity to 100 UTF-16 code units. Presence diagnostic severity: warning. Evidence: vendor template. Maximum decoded UTF-16 code units: 100. | vendor.reddit.param.m.orderId.invalid |
docs |
m.products |
optional | The SDK serializes product objects as a JSON array. Empty metadata slots are valid. | docs | |
esurl |
optional | The SDK sends an absolute page or referrer URL when available. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.esurl.emptyvendor.reddit.param.esurl.invalid |
docs |
drfr |
optional | The SDK sends an absolute page or referrer URL when available. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.drfr.emptyvendor.reddit.param.drfr.invalid |
docs |
ts |
optional | The SDK emits a nonnegative integer timestamp or screen dimension. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.ts.emptyvendor.reddit.param.ts.invalid |
docs |
sh |
optional | The SDK emits a nonnegative integer timestamp or screen dimension. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.sh.emptyvendor.reddit.param.sh.invalid |
docs |
sw |
optional | The SDK emits a nonnegative integer timestamp or screen dimension. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.sw.emptyvendor.reddit.param.sw.invalid |
docs |
opt_out |
optional | The SDK uses a binary opt-out flag. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.param.opt_out.emptyvendor.reddit.param.opt_out.invalid |
docs |
custom.requires_name |
required | A Custom event is missing m.customEventName. Reddit documents rdt('track', 'Custom', { customEventName }) and treats that name as a distinct conversion. Fix: Add m.customEventName with the custom event name, at most 64 characters. | vendor.reddit.custom.requires_name |
docs |
root |
optional | The pinned SDK emits this JSON type. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: array. | vendor.reddit.body.root.invalid |
docs |
root |
optional | The pinned SDK emits this JSON type. Body scope: []. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: object. | vendor.reddit.body.root.invalid |
docs |
id |
optional | The pinned SDK emits this JSON type. Body scope: []. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string. | vendor.reddit.body.id.invalid |
docs |
name |
optional | The pinned SDK emits this JSON type. Body scope: []. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string. | vendor.reddit.body.name.invalid |
docs |
category |
optional | The pinned SDK emits this JSON type. Body scope: []. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string. | vendor.reddit.body.category.invalid |
docs |
quantity |
optional | The SDK retains native numbers and numeric strings in product metadata. No positive amount or integer-only quantity bound is inferred. Body scope: []. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: number or string. | vendor.reddit.body.quantity.emptyvendor.reddit.body.quantity.invalid |
docs |
itemPrice |
optional | The SDK retains native numbers and numeric strings in product metadata. No positive amount or integer-only quantity bound is inferred. Body scope: []. Decoded body source: m.products. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"present","param":"m.products"}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: number or string. | vendor.reddit.body.itemPrice.emptyvendor.reddit.body.itemPrice.invalid |
docs |
method |
optional | Captured image and form producers use GET or POST. Complete HTTP capture contract. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.http.method.emptyvendor.reddit.http.method.invalid |
docs |
content_type |
recommended | POST collector requests use URL-encoded form bodies. Complete HTTP capture contract. Applies when {"kind":"value_in","param":"method","values":["POST"]}. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.reddit.http.content_type.missingvendor.reddit.http.content_type.emptyvendor.reddit.http.content_type.invalid |
docs |
Validate a payload
pixellint validate request @request.json --rulepack vendor/reddit
Try this failing payload in the playground. A Reddit form collector with an unhashed wire identity.
{"url": "https://alb.reddit.com/rp?id=t2_synthetic&event=Purchase", "method": "POST", "headers": {"Content-Type": "application/x-www-form-urlencoded"}, "body": "em=synthetic%40example.test"}
cargo install pixellint
·
npm install pixellint