pixellint

Outbrain browser and S2S pixels carry different identity fields.

Outbrain browser requests send marketerId. Image requests use ob_adv_id, and S2S conversions use ob_click_id. All three identity carriers select the same endpoint contract.

Browser POST beacons retain their valid transport when a click ID is present. S2S-only requests still require GET. Browser naming and missing-currency guidance remain advisory.

What this pack matches

Hosts
tr.outbrain.com
Paths
/pixel, /unifiedPixel
Vendor docs
www.outbrain.com/help/advertisers/outbrain-pixel-gtm/

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
ob_adv_id optional It is the Outbrain Advertiser ID. Generated noscript pixels send it. Outbrain documents the Marketer ID in GTM rather than this query, so the rule is ecosystem evidence. Fix: Set `ob_adv_id` to the Advertiser ID from Amplify Tracking. vendor.outbrain.param.ob_adv_id.empty docs
ob_click_id optional It is the click identifier S2S conversions send instead of `ob_adv_id`. Evidence: vendor documented. Fix: Set `ob_click_id` to the `ob_click_id` captured from the landing URL. vendor.outbrain.param.ob_click_id.empty docs
name optional It is the event name on the S2S postback. Outbrain documents it on the unifiedPixel URL. Page-view noscript pixels send `ev` instead and omit `name`. Evidence: vendor documented. Fix: Set `name` to the event name from Amplify, or drop the pair on a page-view pixel. vendor.outbrain.param.name.empty docs
orderValue optional It is the conversion value. Outbrain documents a decimal with a point, such as `4.99`, not `4,99`. Evidence: vendor documented. Fix: Send a number such as `4.99`, with a point and no currency symbol. vendor.outbrain.param.orderValue.empty
vendor.outbrain.param.orderValue.invalid
docs
orderId optional It is the advertiser order ID. Outbrain documents it so two conversions from the same user in a short window are not deduplicated. Evidence: vendor documented. Fix: Set orderId to the order ID, or drop the pair. vendor.outbrain.param.orderId.empty docs
currency optional It is the orderValue currency. Outbrain documents this fixed list of three-letter codes. Evidence: vendor documented. Fix: Use a documented code such as `USD` or `GBP`. vendor.outbrain.param.currency.empty
vendor.outbrain.param.currency.invalid
docs
timestamp optional Outbrain documents eight optional S2S timestamp representations. This advisory validates Gregorian calendar dates, 12-hour or 24-hour clocks and published numeric offset bounds. ISO UTC Z remains accepted for compatibility. Named zones retain their text without timezone membership, DST or instant resolution claims. Applies when {"kind":"present","param":"ob_click_id"}. Value diagnostic severity: warning. Evidence: vendor documented. vendor.outbrain.param.timestamp.empty
vendor.outbrain.param.timestamp.invalid
docs
marketerId optional The pinned browser SDK joins one or more configured marketer identities with commas. Fixed identity grammar is unpublished. Presence diagnostic severity: warning. Evidence: vendor template. vendor.outbrain.param.marketerId.empty docs
dl optional The browser SDK sends an absolute page or referrer URL. An empty referrer is valid. Presence diagnostic severity: warning. Evidence: vendor template. vendor.outbrain.param.dl.empty
vendor.outbrain.param.dl.invalid
docs
referrer optional The browser SDK sends an absolute page or referrer URL. An empty referrer is valid. Presence diagnostic severity: warning. Evidence: vendor template. vendor.outbrain.param.referrer.empty
vendor.outbrain.param.referrer.invalid
docs
pRef optional The browser SDK sends an absolute page or referrer URL. An empty referrer is valid. Presence diagnostic severity: warning. Evidence: vendor template. vendor.outbrain.param.pRef.empty
vendor.outbrain.param.pRef.invalid
docs
g optional The SDK marks its GTM origin or sendBeacon fallback. Presence diagnostic severity: warning. Evidence: vendor template. vendor.outbrain.param.g.empty
vendor.outbrain.param.g.invalid
docs
sb optional The SDK marks its GTM origin or sendBeacon fallback. Presence diagnostic severity: warning. Evidence: vendor template. vendor.outbrain.param.sb.empty
vendor.outbrain.param.sb.invalid
docs
identifier_required required The pixel needs an advertiser identity, captured S2S click identity or browser marketer identity. Fix: Use ob_adv_id for an image, ob_click_id for S2S, or marketerId for the browser collector. vendor.outbrain.identifier_required docs
s2s_event_required required An Outbrain S2S click identifier needs its configured event name. Evidence: vendor documented. vendor.outbrain.s2s_event_required docs
browser.event_required recommended The browser collector sends its configured event name. Evidence: vendor template. vendor.outbrain.browser.event_required docs
browser.event_name recommended The browser helper advises event names of at most 100 ASCII letters, digits, spaces or hyphens, starting with a letter or digit. Receiver rejection is not established. Evidence: vendor template. vendor.outbrain.browser.event_name docs
browser.currency_recommended recommended The browser helper advises a currency for a populated positive conversion value. Evidence: vendor template. vendor.outbrain.browser.currency_recommended docs
query.ob_click_id optional Outbrain S2S postbacks carry the captured click ID. Complete HTTP capture contract. docs
method required Outbrain requires GET for its S2S unifiedPixel postback. Complete HTTP capture contract. Applies when {"kind":"all","conditions":[{"kind":"present","param":"query.ob_click_id"},{"kind":"not","condition":{"kind":"present","param":"query.marketerId"}}]}. vendor.outbrain.http.method.missing
vendor.outbrain.http.method.empty
vendor.outbrain.http.method.invalid
docs
query.marketerId optional A browser identity separates the browser transport from the S2S method constraint. Complete HTTP capture contract. Evidence: vendor template. docs

Validate a payload

pixellint validate url "$ARTIFACT" --rulepack vendor/outbrain

Try this failing payload in the playground. An Outbrain browser conversion without its currency.

https://tr.outbrain.com/unifiedPixel?marketerId=synthetic&name=Purchase&orderValue=12.50

cargo install pixellint · npm install pixellint