Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL parameter

Corresponding Macro

Representation in URL

gdpr

GDPR

&gdpr=${GDPR}

gdpr_consent

GDPR_CONSENT_XXXXX

&gdpr_consent=${GDPR_CONSENT_XXXXX}

XXXXX means here the numeric Vendor ID. E.g. &gdpr_consent=${GDPR_CONSENT_123} for Vendor ID 123.

Values to fill in the macros:

Macro

possible values

purpose

${GDPR}

0 / 1

0 gdpr does not apply; 1 gdpr applies

${GDPR_CONSENT_XXXXX}

URL-safe base64-encoded Transparency & Consent string.

Only meaningful if gdpr=1

Encodes the TC string, as obtained from the CMP JS API or OpenRTB

...

There are three modes of TCF logic which can be set for the ad space

  1. Inactive mode- : This means that TCF macros are neither added to tracking links nor is tracking traffic treated restrictively. There is no TCFv2.0 based filtering for this ad space.

  2. Setup mode without traffic restrictions- : TCF macros appear in the ad media tracking links and can be used for setup and testing. Tracking system interprets and stores the TCF signals but there aren’t any restrictions in the request data storage and processing.

  3. Restrictive mode- : Ad media tracking links are generated containing macros for TCF. If GDPR applies and there is no sufficient consent, our system will restrict the amount of stored and processed request information according to purposes enabled by enduser.

...

The initial TCF mode is set to “Inactive mode” and does not change the default behaviour. This means that neither TCF macros are attached to the tracking links for creatives delivered through this ad space, nor is tracking traffic restricted. No tracking requests based on TCF consensus will be restricted.

Note

Attention: Even if the partner sends reasonable filled GDPR parameters with a request, request processing will not be affected. It is necessary that the option must be set to “Restrictive mode” if requests are to be restricted based on TCF.

Setup mode

If setup mode is activated for the ad space, TCF params (s. Macros) appear in ad media tracking tag and product data feed urls. Partner is to properly obtain and set these params by obtaining the TC String from his CMP.

...

In the setup mode we don’t restrict the way we store and process the actual request.

Restrictive mode

Note

...

IMPORTANT!
Before partner enablies restrictive mode it is required, that their Consent Management Platform is set up to obtain user consent for the Vendor IDs configured in your platform TCF settings. By default it is the Vendor ID 871 of Ingenious Technologies AG. If your platform is configured to use custom vendor ID, please inform partners about it.

...

Info

If restrictive mode is not activated, both parameters gdpr and gdpr_consent are not applied during the tracking request processing.

In restrictive mode, we restrict the request handling in accordance to TCF policies and TCF features enabled for the given vendor id in the submitted consent string.

...

Wenn calling a click code with following parameters appended

...&gdpr=${GDPR}&gdpr_consent=${GDPR_CONSENT_871}&preview_mode=1

the response JSON object will contain the following error information

"error" : { "code" : 401 , "reason" : "TCF2MissingTCString"}

TCF parameters

Parameter gdpr

...