pixellint

Google Ads pixels check conversion and remarketing request fields.

Conversion-action labels remain recommended on conversion hits. Remarketing can omit them. Advice for privacy flags, transport markers, numeric metadata, language slices and URL lengths follows the reviewed cv=9, async=1 producer.

Signed and exponent-form values from the async producer remain valid. Custom data and configured IDs stay opaque. Legacy and future profiles keep their own checks. Receiver acceptance, account configuration and attribution require external evidence.

What this pack matches

Hosts
googleadservices.com, googleads.g.doubleclick.net
Paths
Full path expression: ^/pagead/(?:viewthrough)?conversion(?:/[^/]*)?/?$
Vendor docs
support.google.com/tagassistant/answer/2947038

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
conversion_id required It is the numeric conversion ID, unique per Google Ads account, and it travels in the path rather than the query. Fix: Copy the conversion ID from the conversion action's tag setup. vendor.google-ads-conversion.param.conversion_id.missing
vendor.google-ads-conversion.param.conversion_id.empty
vendor.google-ads-conversion.param.conversion_id.invalid
docs
label recommended A conversion-action label is recommended on conversion hits. Remarketing requests may omit a conversion label. Applies when {"kind":"value_in","param":"tracking_route","values":["conversion"]}. Fix: Add the conversion label from the conversion action's tag setup. vendor.google-ads-conversion.param.label.missing
vendor.google-ads-conversion.param.label.empty
docs
value optional It is the conversion value. Google documents google_conversion_value as numbers and decimals only, with no currency symbol or comma. Applies when {"kind":"not","condition":{"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}}. Fix: Send a number such as 20 or 20.00, not $20.00. vendor.google-ads-conversion.param.value.empty
vendor.google-ads-conversion.param.value.invalid
docs
currency_code optional It is the ISO 4217 currency of `value`. Google documents it on conversion tags as `currency_code`. Fix: Send the three-letter code, such as `USD`. vendor.google-ads-conversion.param.currency_code.empty
vendor.google-ads-conversion.param.currency_code.invalid
docs
ord optional It is the cache buster on the image tag. Google documents a unique `ord` so repeat fires are counted separately. Fix: Emit a fresh `ord` on every fire, or drop the empty pair. vendor.google-ads-conversion.param.ord.empty docs
guid optional The generated image tag sends `guid=ON`. Value diagnostic severity: warning. vendor.google-ads-conversion.param.guid.empty
vendor.google-ads-conversion.param.guid.invalid
docs
script optional The image fallback sends `script=0` to say no JavaScript ran. Value diagnostic severity: warning. vendor.google-ads-conversion.param.script.empty
vendor.google-ads-conversion.param.script.invalid
docs
tracking_route optional Captured endpoint distinguishes conversion-action labeling from remarketing. docs
cv optional Producer version marker. New advice is scoped to the reviewed version 9 with async=1. docs
async optional Async transport marker. Missing, future or unresolved markers do not activate producer-specific advice. docs
random optional The reviewed async producer serializes random as decimal digits. Timestamp freshness and screen plausibility are not inferred. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.random.empty
vendor.google-ads-conversion.param.random.invalid
docs
fst optional The reviewed async producer serializes fst as decimal digits. Timestamp freshness and screen plausibility are not inferred. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.fst.empty
vendor.google-ads-conversion.param.fst.invalid
docs
u_h optional The reviewed async producer serializes u_h as decimal digits. Timestamp freshness and screen plausibility are not inferred. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.u_h.empty
vendor.google-ads-conversion.param.u_h.invalid
docs
u_w optional The reviewed async producer serializes u_w as decimal digits. Timestamp freshness and screen plausibility are not inferred. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.u_w.empty
vendor.google-ads-conversion.param.u_w.invalid
docs
num optional The producer increments a positive snippet counter. No batch-size or upper bound is invented. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. Minimum numeric value: 1. vendor.google-ads-conversion.param.num.invalid docs
tfcd optional Child-directed treatment. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.tfcd.empty
vendor.google-ads-conversion.param.tfcd.invalid
docs
tfua optional Under-age-of-consent treatment. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.tfua.empty
vendor.google-ads-conversion.param.tfua.invalid
docs
npa optional Ad personalization flag. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.npa.empty
vendor.google-ads-conversion.param.npa.invalid
docs
rdp optional Restricted data processing flag. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.rdp.empty
vendor.google-ads-conversion.param.rdp.invalid
docs
uaw optional User-agent WOW64 flag. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.uaw.empty
vendor.google-ads-conversion.param.uaw.invalid
docs
frm optional Producer frame context. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.frm.empty
vendor.google-ads-conversion.param.frm.invalid
docs
ig optional Reviewed producer integration marker. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.ig.empty
vendor.google-ads-conversion.param.ig.invalid
docs
fmt optional Reviewed async script transport format. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.fmt.empty
vendor.google-ads-conversion.param.fmt.invalid
docs
rfmt optional Reviewed async response format. Advice describes the reviewed producer, not a universal receiver enum. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.param.rfmt.empty
vendor.google-ads-conversion.param.rfmt.invalid
docs
url optional The producer truncates url to 512 UTF-16 code units before removing any fragment. Truncated and custom-scheme values remain opaque, so absolute-URL syntax is not imposed. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. Maximum decoded UTF-16 code units: 512. vendor.google-ads-conversion.param.url.invalid docs
ref optional The producer truncates ref to 512 UTF-16 code units before removing any fragment. Truncated and custom-scheme values remain opaque, so absolute-URL syntax is not imposed. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. Maximum decoded UTF-16 code units: 512. vendor.google-ads-conversion.param.ref.invalid docs
top optional The producer truncates top to 512 UTF-16 code units before removing any fragment. Truncated and custom-scheme values remain opaque, so absolute-URL syntax is not imposed. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. Maximum decoded UTF-16 code units: 512. vendor.google-ads-conversion.param.top.invalid docs
hl optional The producer emits a two-character language or region slice. This checks slice length without inventing an account language registry. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. Minimum decoded characters: 2. Maximum decoded characters: 2. vendor.google-ads-conversion.param.hl.invalid docs
gl optional The producer emits a two-character language or region slice. This checks slice length without inventing an account language registry. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"cv","values":["9"]},{"kind":"value_in","param":"async","values":["1"]}]}. Presence diagnostic severity: warning. Minimum decoded characters: 2. Maximum decoded characters: 2. vendor.google-ads-conversion.param.gl.invalid docs
async.value.numeric recommended The reviewed async producer supports signed numeric conversion values, including JavaScript exponent notation. vendor.google-ads-conversion.async.value.numeric docs
method optional The reviewed async producer loads its conversion request with a GET script. Other producer versions and transports are not constrained. Complete HTTP capture contract. Applies when {"kind":"all","conditions":[{"kind":"value_in","param":"query.cv","values":["9"]},{"kind":"value_in","param":"query.async","values":["1"]}]}. Presence diagnostic severity: warning. vendor.google-ads-conversion.http.method.empty
vendor.google-ads-conversion.http.method.invalid
docs
query.cv optional Producer marker used only to scope method advice. Complete HTTP capture contract. docs
query.async optional Producer marker used only to scope method advice. Complete HTTP capture contract. docs

Validate a payload

pixellint validate url "$ARTIFACT" --rulepack vendor/google-ads-conversion

Try this failing payload in the playground. A Google Ads async conversion with an invalid personalization flag.

https://www.googleadservices.com/pagead/conversion/123456789/?label=synthetic&cv=9&async=1&npa=false

cargo install pixellint · npm install pixellint