Enabling the Smart Banner feature

A smart banner on a mobile website is designed to encourage users to open the native app, or install it if they don’t already have it. It provides a smart link that automatically opens up the app if it’s installed or takes the user to the app store page if not.

The following parameter and value are used to specify whether to enable the Smart Banner feature when MicroStrategy Library is used on a mobile device. When the Smart Banner feature is explicitly enabled, the smart banner is visible. When the Smart Banner feature is explicitly disabled, the smart banner is hidden.

When the Smart Banner parameter is not present in the URL, the default behavior depends on whether the dashboard is embedded or not.

• When the dashboard is not embedded, the default is to display the smart banner on the Library page, the dashboard page, and the login page (if the user is redirected there).
• When the dashboard is embedded, the default is to not display the smart banner on the dashboard page and the login page (if the user is redirected there). The Smart Banner feature is not supported on the Library page for an embedded dashboard.

This is a feature-level setting. Feature-level settings override UI settings and also imply UI settings when they are associated with UI elements.

Parameter	Setting Level	Value	Target Component	Behavior
feature.smartBanner	Feature	Possible values include: true false Default value depends on whether the dashboard is embedded For embedded dashboards, default = false For non-embedded dashboards, default = true		Specifies whether to make the Smart Banner visible When set to "true", the Smart Banner is visible. When set to "false", the Smart Banner is hidden

The sample URLs below show how to explicitly enable and disable the Smart Banner feature.

Sample URL for explicitly enabling the Smart Banner feature on the dashboard page

http(s)://webserver:port/webapp/app/projectID/docID?feature.smartBanner=true

Sample URL for explicitly disabling the Smart Banner feature on the dashboard page

http(s)://webserver:port/webapp/app/projectID/docID?feature.smartBanner=false

If the user is redirected to the login page, the Smart Banner parameter setting on the original URL will apply.

Sample URL for explicitly enabling the Smart Banner feature on the Library page of a non-embedded dashboard

http(s)://webserver:port/webapp/app?feature.smartBanner=true

Sample URL for explicitly disabling the Smart Banner feature on the Library page of a non-embedded dashboard

http(s)://webserver:port/webapp/app?feature.smartBanner=false

The Smart Banner feature is not supported on the Library page of an embedded dashboard.