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:
| Token | Meaning |
|---|---|
tcf:1 to tcf:24 | IAB TCF purpose consent, for example tcf:1 is "store and access information on a device". |
tcf:li:1 to tcf:li:24 | IAB TCF legitimate interest for that purpose. |
gcm: plus a Consent Mode key, for example gcm:analytics_storage | A Google Consent Mode v2 category. |
key: plus a name, for example key:marketing | A 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
| Message | Cause |
|---|---|
| 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 token | Enforce 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 token | Optima purposes | Effect |
|---|---|---|
tcf:1 | analytics | Consent to storage grants analytics. |
tcf:3 | marketing, personalization | Consent to build an advertising profile grants both purposes. |
tcf:li:7 | service_improvement | Legitimate interest to measure performance reaches a legitimate-interest purpose. |
gcm:analytics_storage | analytics | Google 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.