vendor/liveramp-envelope-refresh · vendor documented

LiveRamp refresh needs a Placement ID, envelope type, and envelope value

Refresh is not retrieve. it is 19 for an ATS envelope or 24 for Meta-scoped. iv is the envelope string from the retrieve call, not the original hash. Cookie sync stays attributed.

it=4 is an identifier type, not an envelope type

Retrieve uses it=4 hashed email. Refresh documents it=19 ATS and it=24 Meta-scoped.

Rule: vendor.liveramp-envelope-refresh.param.it.invalid

What this pack matches

Hosts: api.rlcdn.com
Paths: /api/identity/v2/envelope/refresh
Vendor docs: developers.liveramp.com/authenticatedtraffic-api/docs/7-implement-the-ats-refresh-envelope-api

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
`pid`	required	It is the LiveRamp Placement ID. Fix: Send `pid` with the Placement ID LiveRamp issued for this property.	`vendor.liveramp-envelope-refresh.param.pid.missing` `vendor.liveramp-envelope-refresh.param.pid.empty` `vendor.liveramp-envelope-refresh.param.pid.invalid`	docs
`it`	required	It is the envelope type. LiveRamp documents `19` ATS envelopes and `24` Meta-scoped envelopes. Retrieve uses identifier types 4, 11, and 15 instead. Fix: Send `it=19` for an ATS envelope, or `it=24` for a Meta-scoped envelope.	`vendor.liveramp-envelope-refresh.param.it.missing` `vendor.liveramp-envelope-refresh.param.it.empty` `vendor.liveramp-envelope-refresh.param.it.invalid`	docs
`iv`	required	It is the stored envelope value, not the original hashed identifier. Fix: Send `iv` with the envelope string returned by the retrieve call.	`vendor.liveramp-envelope-refresh.param.iv.missing` `vendor.liveramp-envelope-refresh.param.iv.empty`	docs
`ct`	optional	It is the consent type. LiveRamp documents `4` TCF v2 and `3` CCPA. Fix: Send `ct=4` with a TCF string in `cv`, or `ct=3` for CCPA.	`vendor.liveramp-envelope-refresh.param.ct.empty` `vendor.liveramp-envelope-refresh.param.ct.invalid`	docs
`atype`	optional	It is the implementation source. LiveRamp documents `1` ATS.js, `2` ATS API, `3` server-to-server, and `4` the mobile SDK. Fix: Send `atype=2` from an API call, or `atype=3` from a server.	`vendor.liveramp-envelope-refresh.param.atype.empty` `vendor.liveramp-envelope-refresh.param.atype.invalid`	docs

Validate a payload

pixellint validate url "$ARTIFACT" --rulepack vendor/liveramp-envelope-refresh

Try this failing payload in the playground. LiveRamp envelope refresh with identifier type 4.

https://api.rlcdn.com/api/identity/v2/envelope/refresh?pid=14&it=4&iv=Alkc6LgKZzbqHvexyq4hyzxp0zQZnIztut2rFKjmcDtSBbM0rttk5pH2qb8iNkyxCO9kYAKg6oM2rt28dbWV6-lt9BxwoPCabDaOUXN3fr2C1qsCeV9H0qcW3wBPbbnTpxFWI0Wnh7WVPFYrCM8FgziDEBwSoYnUMO9wheayikvFSGX3Qsz1lr0QWnj2dHEMhx5V2QEbhkJ2iwH2zLEaKAt5oVa8EwAf59mOQepN3S_CwQk4C5OkgfZYiUXTYwxpDA

cargo install pixellint · npm install pixellint