Skip to main content

AttributionInput

First-touch attribution captured on the landing site and carried in the vc_attr cookie.

Every field is optional and every field is UNTRUSTED — it is client-supplied context relayed to the ad platform, never an authorization input. The console must read vc_attr transiently and pass it here; it must never persist a copy of it, because the copy would outlive the user's consent withdrawal.

input AttributionInput {
utmSource: String
utmMedium: String
utmCampaign: String
utmTerm: String
utmContent: String
clickIds: Map
landingPath: String
referrer: String
}

Fields

AttributionInput.utmSource ● String scalar

AttributionInput.utmMedium ● String scalar

AttributionInput.utmCampaign ● String scalar

AttributionInput.utmTerm ● String scalar

AttributionInput.utmContent ● String scalar

AttributionInput.clickIds ● Map scalar

Advertising click ids keyed by parameter name (fbclid, gclid, msclkid, …). Allowlisted server-side: an open bag would eventually swallow a password-reset token, and unfiltered keys could collide with the server-derived fbp/fbc values.

AttributionInput.landingPath ● String scalar

AttributionInput.referrer ● String scalar

Member Of

TrackConversionInput input