IAS UVP identities stay stable across declared ad sessions.
The published IAS UVP guide defines vevent paths, generated tag identifiers and the external session field xsId. Empty session IDs are an observable contract violation.
Sessions mode compares known xsId values within caller-declared ad sessions and detects known reuse across distinct sessions. The guide recommends UUIDv4 without requiring that format. Optional application, privacy and diagnostic fields keep their published formats.
Every declared ad session keeps one external identity.
UVP URLs in one caller-declared ad session use the same stable external xsId. A known mismatch remains an error when another row is unresolved. Coverage shows which observations were compared or skipped.
Distinct declared ad sessions use distinct identities.
Known reuse across explicitly declared ad sessions produces one finding per reused identity. Original input rows and occurrences stay attached even when the ordinary document report deduplicates equal URLs. A repeated observation inside one group does not establish duplicate firing.
Incomplete observations keep their coverage limits visible.
A within-session comparison needs two resolved rows. A cross-session comparison needs known values in two distinct groups. Placeholders, unresolved macros, unsupported endpoints and invalid encodings receive coverage skips. These identity checks do not establish event completeness, event order or destination acceptance.
What this pack matches
Declared ad sessions add source-scoped relationship checks.
This profile compares xsId in explicitly grouped original input rows matched by this owner. Stable identities remain opaque. Unsupported endpoints, unresolved macros and invalid identity encoding receive visible coverage skips.
Within-session consistency and cross-session reuse require sufficient known observations. Evaluated coverage does not establish a complete event set, event order, firing frequency or destination acceptance.
Profile source · vendor documented
{
"owner_plugin_id": "vendor/ias-video-pixel",
"source_level": "official_vendor",
"docs": "https://assets.ctfassets.net/o1orzsgogjpz/4Q8TPW9OcTv2lg35DRf3DX/7a0bd2d4564e4fea7cff97cb6137088e/IAS_Video_Solutions_Guide_.pdf",
"rules": [
{
"code": "vendor.ias-video-pixel.session.xsid.inconsistent",
"kind": "consistent_parameter",
"param": "xsId",
"severity": "error",
"message": "IAS UVP URLs in the declared ad session contain different external session IDs.",
"fix_hint": "Populate every UVP URL in this ad session with the same stable ad-server session ID.",
"placeholder_values": [
"[PLEASE_IMPLEMENT_UNIQUE_ADSERVER_IMPRESSION_ID_HERE]"
]
},
{
"code": "vendor.ias-video-pixel.session.xsid.reused",
"kind": "unique_parameter_across_sessions",
"param": "xsId",
"severity": "error",
"message": "The same IAS external session ID appears in multiple declared ad sessions.",
"fix_hint": "Generate a distinct stable external session ID for each ad session. IAS recommends UUIDv4.",
"placeholder_values": [
"[PLEASE_IMPLEMENT_UNIQUE_ADSERVER_IMPRESSION_ID_HERE]"
]
}
]
}
Choose Sessions in the browser validator. Supply a document and sessions whose artifact_indexes refer to original document.artifacts rows.
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 |
|---|---|---|---|---|
event_name |
required | Published UVP paths identify their event here. The guide shows seven events but does not declare a closed event enumeration. Evidence: vendor template. | vendor.ias-video-pixel.param.event_name.missingvendor.ias-video-pixel.param.event_name.empty |
docs |
advertiser_id |
required | Numeric generated IAS tag identifier, preserved from the published UVP template. Evidence: vendor template. | vendor.ias-video-pixel.param.advertiser_id.missingvendor.ias-video-pixel.param.advertiser_id.emptyvendor.ias-video-pixel.param.advertiser_id.invalid |
docs |
publisher_id |
required | Numeric generated IAS tag identifier, preserved from the published UVP template. Evidence: vendor template. | vendor.ias-video-pixel.param.publisher_id.missingvendor.ias-video-pixel.param.publisher_id.emptyvendor.ias-video-pixel.param.publisher_id.invalid |
docs |
xsId |
required | IAS explicitly requires the external ad-session identifier for UVP/CTV impression registration. UUIDv4 is recommended, so an opaque nonempty ID is accepted. | vendor.ias-video-pixel.param.xsId.missingvendor.ias-video-pixel.param.xsId.empty |
docs |
gdpr |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
gdpr_consent |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
gdpr_pd |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
ias_xmtp |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
ias_xmapp |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
ias_xappb |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
omidPartner |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
bundleId |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
ias_xerr |
optional | Optional published UVP template field. The guide gives no closed grammar or unconditional presence requirement. | docs | |
xdebug |
optional | Documented reporting or debugging input. Platform prerequisites and cross-session uniqueness are external. | docs | |
campaign_id |
optional | Documented reporting or debugging input. Platform prerequisites and cross-session uniqueness are external. | docs | |
placement_id |
optional | Documented reporting or debugging input. Platform prerequisites and cross-session uniqueness are external. | docs | |
xsid.placeholder |
required | The IAS external session ID still contains the installation placeholder. IAS requires an ad-session ID to register UVP and CTV impressions. Evidence: vendor documented. Fix: Replace this stub with an ad-server session ID or a macro your ad server expands to that ID. Reuse the same ID across the session's UVP events. | vendor.ias-video-pixel.xsid.placeholder |
docs |
xsid.unstable_macro |
recommended | IAS no longer recommends cachebuster or timestamp macros as external session IDs. They can vary between events or repeat across sessions. Evidence: vendor documented. Fix: Use an ad-server session ID that stays the same across this session's UVP events. IAS recommends UUIDv4; other stable unique IDs are accepted. | vendor.ias-video-pixel.xsid.unstable_macro |
docs |
xsId · within declared session |
session relationship | Caller-declared original row groups. IAS UVP URLs in the declared ad session contain different external session IDs. Skipped observations remain visible in relationship coverage. Fix: Populate every UVP URL in this ad session with the same stable ad-server session ID. | vendor.ias-video-pixel.session.xsid.inconsistent |
docs |
xsId · across declared sessions |
session relationship | Caller-declared original row groups. The same IAS external session ID appears in multiple declared ad sessions. Skipped observations remain visible in relationship coverage. Fix: Generate a distinct stable external session ID for each ad session. IAS recommends UUIDv4. | vendor.ias-video-pixel.session.xsid.reused |
docs |
Validate a payload
pixellint validate url "$ARTIFACT" --rulepack vendor/ias-video-pixel
Or paste it into the playground. Same engine, in the browser, nothing sent anywhere.
cargo install pixellint
·
npm install pixellint