TrustCommander (deprecated)
Community home
English
English
  • Overview
  • Responsability of actors
  • Releases notes
  • Setup Guides
    • Tag Manager
      • TagCommander
      • Google Tag Manager (GTM)
      • Consent Mode
      • Consent Mode in GTM
      • Adobe Launch
    • Websites (Hardcoded)
    • Mobile apps
      • iOS
        • ATT - App Tracking Transparency (iOS 14.5+)
      • Android
  • User Guides
    • Categories & Tags
      • Manage Categories
      • Manage Vendors
      • Assign Categories
    • Privacy Banners
      • Banner Templates
        • Accessibility Template
      • Manage Banner
      • Deploy Banner
      • Copy Banner
    • Dashboard
    • Exports
    • Options
  • Extensions
    • Cookie Scanner
    • TagFirewall
    • Tag Hierarchy
  • Marketing Preferences Center
    • Marketing Preferences Center (Trust Premium only)
  • Knowledge Base
    • Consent Object
    • TrustCommander cookies exemption
    • Consent Cookie
    • IAB TCF V2.0 Consent
    • IAB TCF V2.0 and Google FAQ
  • Rest data API
    • GET/PUT Consents / preferences
  • Onsite API
    • Getting Started
    • consent.get
    • consent.update
    • consent.revoke
    • consent.onUpdate
    • consent.onReady
    • consentBanner.show
    • consentBanner.hide
    • consentCenter.show
    • consentCenter.hide
  • PLATFORM API
    • Get statistics
Powered by GitBook
On this page
  • Creating Privacy Banner
  • Update Privacy Banner
  • Customise banner content
  • Options for banner customisation
  • Options for privacy center customisation
  • Advanced Options for IAB TCF Banner
  • Customise Publisher Country Code Field
  • Customise Purpose One Treatment Field
  • Neutral vendor buttons
  • Synchronisation mode between vendors and categories
  • IAB TCF Stacks Beta
  • Move native Categories above IAB Purposes
  1. User Guides
  2. Privacy Banners

Manage Banner

Options to create and edit banner templates.

PreviousAccessibility TemplateNextDeploy Banner

Last updated 4 years ago

TRUST > Privacy banners

Creating Privacy Banner

Click ADD PRIVACY BANNER in the top right of the interface to add a new banner to your account. Each template has following options:

Field

Description

Name

Label of the banner used in the interface.

Template

Dropdown to select a template for this banner.

Hosting

Consent duration

Duration how long the consent cookie is valid. After this duration the consent cookie is not valid anymore and a new banner will be presented to the user. It is possible to configure a duration in full months between 1 and 13 month. This has no impact on the storage duration of the consent in the TRUST consent database.

Use the new privacy center

This option allows to use the old privacy center template of TrustCommander. This option allows to use custom CSS and custom JS that was created for old banner templates. In case you are not sure if a banner was customised please check with your Commanders Act consultant or support contact before creating a new template. This option is not available on all templates.

Update Privacy Banner

You can open and edit the privacy banner settings via the gear icon on the top left of the interface.

Changing banner templates might not work for customised privacy banner templates. Please contact your Commanders Act consultant or support in case you are unsure if your banner was customised before using this option.

Customise banner content

TRUST > Privacy banners (tab EDIT BANNER)

Options for banner customisation

All banner templates can be customised with a WYSIWYG editor. Following options are available for all banners (except IAB TCF and Popin with Categories templates).

Options to manage the main text content of your banner.

  • Content: Text content (supports HTML formatting and links).

  • Font color: Text color.

  • Background color: Background color of the content area.

Options to manage up to two buttons.

  • Label: Button text.

  • Font color: Color of the button text.

  • Background color: Background color of the button.

  • Button action: Action the button performs (e.g. optin to all categories or open privacy center).

  • Button Position: Change Button Position to Top/Bottom of the banner. Only one button can be positioned to top.

Custom CSS that can be used by advanced users to customise the banner style. This CSS is applied globally to your website, avoid to use global selectors and use the HTML ID attribute of the banner elements instead.

Advanced customisation options. Please contact your Commanders Act consultant or support before using these.

Changes have to be saved with the SAVE button.

Options for privacy center customisation

Following options are available for the privacy center and "Popin with categories" templates.

Options to manage the header text of your privacy center.

  • Title: Text content.

  • Font color: Text color.

  • Background color: Background color of the header area.

Options to manage the main text content of your banner.

  • Categories introduction: Introductory text of the category tab (supports HTML formatting and links)

  • Vendors introduction: Introductory text of the vendor tab (supports HTML formatting and links, only visible in case IAB TCF 2.0 or custom vendors were activated)

  • Font color: Text color.

  • Background color: Background color of the content area.

Options to manage the privacy categories of the privacy center. These categories are based on the categories managed in the Categories & Tags part of the interface.

  • Order: Drag and Drop sorting of Categories.

  • edit icon that allows to overwrite the default name and description of categories and sub-categories that have been provided in the

    Categories & Tags section of the interface for this banner (used for localisation).

  • Checkbox that allows to hide a category (below edit icon).

  • Categories Blocked On: Checkbox that permanently enables a category that can not be deactivated by visitors (e.g. for an "essential cookies" category)

  • IAB TCF 2.0 option: IAB purposes, special purposes, features and special features are automatically displayed on the basis of selected vendors in Categories & Tags / Manage vendorssection. The categories translation is done automatically depending on the user’s browser language settings. Non-IAB categories will be displayed after the official IAB categories in the banner.

Options to manage and translate descriptions of custom vendors. IAB TCF 2.0 vendor descriptions and translations are managed automatically by the IAB TCF 2.0 framework.

  • Vendor Description: Description displayed in the vendor tab.

  • Hide Vendor: Options to hide the vendor from the banner.

  • Order of vendors can be changed via drag & drop. (IAB TCF 2.0 vendors are always displayed before custom vendors).

Options to manage the save button, and the category controls of the privacy center.

  • Label: Button text.

  • Font color: Color of the button text.

  • Background color: Background color of the button.

  • Default status of buttons (IAB and non-IAB) to accept or refuse categories and sub-categories:

    • "On": "On" is chosen by default for categories/sub-categories (IAB and non-IAB) in the Privacy Center. When the visitor leaves it as such, their status for browsing is “optin”.

    • "Off": "Off" is chosen by default for categories/sub-categories in the Privacy Center. When the visitor leaves it as such, their status for browsing is “optout”.

    • "Neutral position": In this position, neither "On" nor "Off" is chosen by default for categories/sub-categories in the Privacy Center. The user must choose “On” or “Off” for each of the categories and sub-categories to be able to save their preferences and continue browsing. The “Warning message” field allows you to personalise the message that will appear to the left of the save button in the Privacy Center: this will inform the user that they must give or refuse their consent for all the categories before saving.

  • Default status of buttons to accept or refuse vendors (IAB and non-IAB):

    • "Off": The default status of vendors is "Off". When a new visitor accepts consent categories in the privacy center for the first time the vendors are not not activated based on their linked categories.

  • Label for "Off for all": "Off for all" button text if the user wants to give their choice for all of a category’s sub-categories in one click.

  • Label for "Off" button: "Off" button text which appears in the Privacy Center (e.g. you can replace it by “No”).

  • Label for "On for all": "On for all" button text if the user wants to give their choice for all of a category’s sub-categories in one click.

  • Label for "On" button: "On" button text which appears in the Privacy Center (e.g. you can replace it by “Yes”).

  • "ON blocked" look & feel: Styling of on blocked Categories (Checkbox or Text)

Custom CSS that can be used by advanced users to customise the banner style.

Advanced customisation options. Please contact your Commanders Act consultant or support before using these.

Changes have to be saved with the SAVE button.

Advanced Options for IAB TCF Banner

Customise Publisher Country Code Field

Option to manage the publisherCC field of the IAB TCF API.

TrustCommander sets this value to "FR" by default in the IAB response. The publisher country code field can be customised with following JavaScript snippet (should be implemented in the first container on the website.).

tC.privacy.iabPublisherCC = "<country_code>";

Example to set the publisher country code field to a German country code:

tC.privacy.iabPublisherCC = "DE";

Customise Purpose One Treatment Field

Option to manage the purposeOneTreatment field of the IAB TCF API.

IAB TCF offers this field to specify how purpose one should be treated in specific scenarios.

true: Purpose 1 not disclosed at all. CMPs use publisherCC to indicate the publisher's country of establishment to help Vendors determine whether the vendor requires Purpose 1 consent.

false: There is no special Purpose 1 treatment status. Purpose 1 was disclosed normally (consent) as expected by TCF Policy

TrustCommander sets this value to false by default in the IAB response. The purpose one treatment field can be customised with following JavaScript snippet (should be implemented in the first container on the website.).

tC.privacy.iabPublisherCC = (true|false);

Neutral vendor buttons

You can change the vendor button type to neutral if you choose the neutral position as the default status.

You can't choose a neutral position for IAB categories (purposes) as it's not allowed by the framework policy

Synchronisation mode between vendors and categories

You can choose to synchronise vendors status with categories, choosing to do it only for neutral buttons or always. If you use an IAB TCF template, this option will not have any effects on TCF vendors, as the TCF framework doesn't allow this.

IAB TCF Stacks Beta

Only available for IAB TCF 2.0 banner.

Right now IAB TCF Stacks are in beta in TrustCommander. They are activated with a JavaScript command that needs to be added to the privacy center CUSTOM JS field JS BLOCK BEFORE.

TrustCommander offers two options to activate Stacks:

pc.iab.useAutoStack();

This option uses an algorithm to automatically find the tightest Stack combination for the configured vendors. This option is the recommended approach.

pc.iab.useStackIds(1,2); // activates Stacks with ID 1 and 2

Purposes may only be included in one Stack. In case of a bad configuration TrustCommander ignores IAB Stack configuration and provides an error in the browser console.

Move native Categories above IAB Purposes

Per default IAB Purpose controls are placed above native category controls. It is possible to display native categories above IAB TCF Purpose controls by adding following JavaScript snippet to the CUSTOM JS field JS BLOCK BEFORE of the privacy center.

pc.tc.categoriesSectionTop(true);

The "Other" headline of the native category controls can be translated by adding following configuration snippet to the CUSTOM JS field JS BLOCK BEFORE of the privacy center.

pc.addTranslation({
    en: { others: 'My Headline' }
});
pc.setLocale('en');

Hosting method used for this banner (see ).

"Neutral position": The default status of vendors is "Undecided". When a new visitor accepts consent categories in the privacy center for the first time the vendors activate based on their linked categories (see ).

of the country that determines the legislation of reference. Normally corresponds to the country code of the country in which the publisher's business entity is established.

TrustCommander offers IAB TCF Stacks to reduce the size of the purpose list in the privacy center. IAB TCF Stacks group purposes and special features in a foldable panel and allows visitors to configure consent for all purposes and special feature in a Stack at once. More information on IAB TCF Stacks can be found in the .

This option allows to manually activate IAB TCF Stacks by providing a list of Stack IDs. The Stack IDs can be found in the .

Manage Vendors
Country code
IAB TCF Policy
IAB TCF Policy
Deploy Banner
Example: Configuring options of a privacy banner.
Example: Activating Auto Stacks