Lightweight embeddable widget that asks the user for a marketing preference, stores it in localStorage, and invokes a publisher-defined continuation URL with that preference - typically the 51Did generation endpoint. The chosen standard or personalized value is the id.usage input for 51Did (51Degrees Identifier).

Endpoint🔗

GET https://cloud.51degrees.com/api/v4/pmp?resource=<RESOURCE_KEY>

Returns the minified locale-resolved bundle. Locale is picked from the accept-language query parameter or the Accept-Language header, falling back to en-us.

Integration🔗

Add a single <script> tag to your page. The cloud endpoint selects the locale bundle from the request, so the same URL works for every language.

<script

src="https://cloud.51degrees.com/api/v4/pmp?resource=YOUR-RESOURCE-KEY"

data-action-url="https://cloud.51degrees.com/api/v4/YOUR-RESOURCE-KEY.js?id.usage={preference}"

data-tcf-vendor="<TCF v2 vendor string>"

data-brand-name="Your Brand"

data-brand-terms-url="https://yoursite.com/privacy"

data-alt-name="Subscribe to remove ads"

data-alt-url="https://yoursite.com/subscribe"

data-brand-logo="https://yoursite.com/logo.svg"

data-show-standard="true">

</script>

Configuration attributes🔗

The full set of attributes the widget reads from its own <script> tag.

Attribute	Required	Default	Purpose
`data-action-url`	Yes	-	URL invoked on every user choice. `{preference}` is replaced with `standard` or `personalized`. `http(s)` URLs are injected as `<script src>`; `javascript:` URLs run inline.
`data-tcf-vendor`	Yes	-	Static TCF v2 consent string. Multi-segment strings (e.g. `core.disclosedvendors`) are accepted - trailing segments are preserved verbatim.
`data-brand-name`	Yes	-	Brand shown in the UI.
`data-brand-terms-url`	Yes	-	Link to the publisher's terms / privacy page.
`data-alt-name`	Yes	-	Label for the Alternative button (e.g. "Subscribe to remove ads").
`data-alt-url`	Yes	-	Destination of the Alternative button. `http(s)` URLs navigate the page; `javascript:` URLs run inline. `{preference}` is NOT substituted here.
`data-brand-logo`	No	-	URL to the publisher's logo, shown in the dialog header.
`data-show-standard`	No	`false`	Set to `"true"` to add a Standard marketing button alongside Personalized and the Alternative button. When `false`, only Personalized and Alternative are shown.

`id.usage` mapping🔗

Preference	Meaning
`standard`	Frequency capping and measurement only.
`personalized`	All marketing purposes including personalization.

The Alternative button (e.g. "Subscribe to remove ads") stores standard as the preference, fires data-action-url with id.usage=standard, then runs data-alt-url: for an http(s) URL the page navigates to it; for a javascript: URL the code runs inline and the page stays on the publisher's site. Users who take this path avoid personalized advertising, but standard marketing tracking still applies.

Flow🔗

The script loads and reads any stored preference from localStorage.
If none is stored, the dialog is shown.
The user chooses; the preference is saved to localStorage.
data-action-url is dispatched with {preference} substituted - this is the continuation that drives downstream behaviour (most commonly fetching /api/v4/<KEY>.js?id.usage={preference} so 51Did data lands on the page). For http(s) URLs PMP injects <script src="...">; for javascript: URLs the code runs inline.

On subsequent visits steps 2-3 are skipped: PMP reads the stored preference from localStorage and goes straight to step 4. So data-action-url fires on every page load, not just on the first user choice.

localStorage🔗

The preference is stored under the key __51d_pmp_pref as a JSON object of shape {v, p, t} - schema version, preference (standard or personalized), and a millisecond timestamp:

{ "v": 1, "p": "personalized", "t": 1715980800000 }

To re-prompt the user (e.g. a "Change preferences" footer link), remove this key and reload the page:

localStorage.removeItem('__51d_pmp_pref');

location.reload();

Cross-references🔗

51Did (51Degrees Identifier) - how id.usage is consumed.
Prebid - downstream RTB enrichment that consumes the 51Did.

PMP (Preference Management Platform)