Singular Banners FAQ

Singular Banners is an enterprise feature. To learn more about this feature, reach out to your Customer Success Manager.

Singular Banners can be displayed in your mobile website to lead web users seamlessly to your app and display the most relevant app content.

Singular Banners can be easily designed, deployed and maintained through the Singular platform. To learn how, see How to Create a Singular Banner (Visual Guide).


Client Hints Update (March 2023)

What are client hints?

New versions of Chromium-based web browsers, rolled out from February to April 2023 (for mobile), will limit the availability of user agent data, which includes information about the user's device model, version, etc.

The same data will now be available through client hints instead. With client hints, the server has to actively ask for the data, as well as give permission to have it shared with third parties.

Chromium-based web browsers include Google Chrome, Microsoft Edge, and others.

For more information, see the Chromium developer documentation for Client Hints and the new Permissions Policy.

How do client hints affect the use of Singular Banners?

So far, Singular has relied on user agent data sent from the browser to determine the user's device type, platform, etc., and decide which banner should be displayed.

With the new changes, advertisers using Singular Banners need to allow the browser to fetch and share the relevant client hints with Singular. This is because the Singular Web SDK is a third party on the advertiser's website.

As an advertiser, what do I need to do to allow Singular Banners to work smoothly?

Singular asks that advertisers make a few minor changes in their website code to allow the Singular Web SDK (as a third party) to receive the Client Hints.

The changes are:

  1. Start asking for Client Hints (accept-ch header).
  2. Grant Singular permission (as a third party) so that the browser will send us the client hints on the fetch banner requests (permissions-policy header).

Add the following response headers to the page load response:

sec-ch-ua-full-version-list permissions-policy:

General FAQ

How do I enable Singular Banners on my site?
How do I create and deploy banners?
What can I customize in my banners?
Category Available Customizations
Creative and Look
  • Banner Placement
  • Logo (creative) and title
  • Call-to-action button
  • Any other customization you want to add through custom CSS code
User Interaction
  • Call-to-action button look
  • Link and deep linking behavior
Activation Rules
  • Which URLs the banner will appear on
  • Show on Android phones/tablets and/or iOS phones/tablets
How do I select when the banner is displayed?

The banner configuration wizard includes a section called Activation rules, which lets you support different use cases, such as:

  • Show a banner only to iOS or only to Android users
  • Show a banner promoting different apps on different pages


Can I have one website show banners for multiple mobile apps?

Yes. When you create the banner in the Banner Configuration panel, you can configure the links, deep links, and deferred deep links the call-to-action button will send the user to. The default behavior for the banner is to link to the parent app under which you defined the banner. However, you can select custom apps to send users to other mobile apps.

How do I set up Singular to track which ad network led users to my website?

To enable ad network attribution, be sure to use the withWebToAppSupport(); option when setting up the BannerOptions object in your code. For more information, see How to Enable Singular Banners (Developers Guide)

How do I track banner performance in Singular reports?

Once banners are enabled for your organization, you will see a new dimension in Singular reports: Banner Name. Include this dimension in your report to see the installs and other stats per banner. For example:


Note: The Source dimension is available only if you have set up Singular to track it. See How do I set up Singular to track which ad network led users to my website?
What is an "organic banner"?

If you have set up the Singular Website SDK to track the ad network that sent the user to your website or landing page (see instructions), this network appears in the Source column. 

However, if the user browsed to your website organically and then clicked the banner, the source is given as Organic banner.