Customize the prebuilt banner in the Admin Interface

Use Usercentric’s out-of-the-box banner for a quick branding that covers all the basics.

Supportability

The functionalities described on this page are only available on Android or iOS.

The banner has the following layers:

• First layer: informs users about the use of tracking technologies and gives them the possibility to either accept all tracking or manage settings.

• Second layer: provides explanation for each category and service, and allows users to select what they consent to.

Customize the user experience in the Admin Interface, under Appearance - Layout and Styling. This documentation page provides you details on the available options.

Changes only take effect with a new initialization of the SDK and clean/updated cache.

Forcing configuration updates during testing

You may force a configuration update with the clearUserSession() function, or by deleting the app and installing it again. We only recommend doing this when integrating and testing the SDK.

Configuration updates in Production

The SDK caches essential data on the device after the first successful init, to be efficient with resources and provide offline capabilities. This cache is kept for several days, depending on app usage. Users will not get published changes from the Admin Interface immediately. However, changes will take effect for 100% of your user base latest within a week.

Customize the layout

In the Admin Interface, navigate to Appearance - Layout. Under Display Options, you will find the following options:

• Hide "Deny All" button

• Hide Language switch

Showing the language switch

The language switch will only be shown in the second layer of the banner.

The following requirements need to be fulfilled to show the language switch:

• Multiple visible languages are added in the Configuration section of the Admin Interface.

• The Hide language switch option is disabled in the Appearance section of the Admin Interface, under the Layout tab.

Customize the style

Style values set programmatically overwrite the values you set in the Admin Interface.

Navigate to Appearance - Styling. You can customize the following options:

• Colors: Set individual colors by providing a specific HEX or using our color picker for the following banner elements:

  • Background Color

  • Text Color

  • Links Color

  • Tab Color

  • Accent Color

  • Button Colors

  • Tabs Color

  • Toggle Colors

• Text Font and Size: Only supported via Programmatic Customization.

• Logo: Set an image to appear at the top of your banner by providing the image URL and the image position:

Supported URL image formats

When passing a URL to fetch an image, the SDK supports the following formats:

• iOS: PNG and JPEG.

• Android: PNG, JPEG, BMP, GIF and WebP.

SVG image support

To use SVGs in your app, add dedicated SVG libraries to your project using the following code snippet.

The App CMP does not support SVG for Unity.

pod 'SVGKit'

implementation 'com.pixplicity.sharp:sharp:1.1.3@aar'