pixellint

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

Hosts
alb.reddit.com
Paths
/rp.gif, /rp
Vendor docs
business.reddithelp.com/articles/Knowledge/manual-conversion-events-with-the-reddit-pixel

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.missing
vendor.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.missing
vendor.reddit.param.event.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.reddit.http.content_type.empty
vendor.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