Skip to content
Optima docs
ConsoleEdgeConsent banner and CMP

CMP mapping

Translate the answers of your consent platform into Optima consent purposes.

If your website uses a consent management platform (CMP), it records the visitor's choices in its own vocabulary. The Purpose map on the Consent & CMP tab of Tracking tells Optima what each of those choices means in terms of your Optima purposes. Without a map, a decoded signal means nothing to Optima.

Who uses it

Privacy officers decide which Optima purpose each CMP category grants; app developers know the token names. Reading needs integration_viewer and changing needs integration_editor, or another role your administrator has given access to this area — see Licences and roles.

Tokens

Each row pairs one CMP token with one or more Optima purposes. A token is one of:

TokenMeaning
tcf:1 to tcf:24IAB TCF purpose consent, for example tcf:1 is "store and access information on a device".
tcf:li:1 to tcf:li:24IAB TCF legitimate interest for that purpose.
gcm: plus a Consent Mode key, for example gcm:analytics_storageA Google Consent Mode v2 category.
key: plus a name, for example key:marketingA category of a platform that uses its own names.

The basis matters. A tcf:li: token carries legitimate interest, so it can only reach purposes whose lawful basis is Legitimate interest. Every other token can only reach purposes whose basis is Consent. The picker offers only matching purposes and shows a Consent or Legitimate interest badge on the row. Purposes of the other basis are not offered, and a message says when the catalogue has none of the right kind.

Rules and messages

MessageCause
Enter a token.The row has purposes but no token.
Not a token the gateway recognises.The token does not follow one of the forms above.
This token is already mapped above.A token can appear once.
Pick at least one purpose.A row needs at least one Optima purpose.
Fix the flagged rows first.The save is blocked until the rows above are fixed.
Enforce needs at least one mapped tokenEnforce with an empty map would grant nothing.

A row left empty while you are adding it is not flagged until you start typing.

Examples

CMP tokenOptima purposesEffect
tcf:1analyticsConsent to storage grants analytics.
tcf:3marketing, personalizationConsent to build an advertising profile grants both purposes.
tcf:li:7service_improvementLegitimate interest to measure performance reaches a legitimate-interest purpose.
gcm:analytics_storageanalyticsGoogle Consent Mode analytics storage.

Common problems

  • No purposes are offered for a token. The catalogue has no active purpose with the right lawful basis. Create one under Settings → Privacy → Purposes.
  • Coverage shows signals but no granted purposes. The tokens in the map are not the ones your platform sends. Check the real signal and compare.
  • One bad row blocks the save. Fix or remove the flagged row.

On this page