Display Behavior

Priority

When multiple banners are active and match the current page, Tolinku shows the one with the highest priority value. Set priority in the banner form (default is 0). Higher numbers take precedence.

For example, if you have:

A general “Install our app” banner with priority 0
A “Summer Sale” promo banner with priority 10

The promo banner is shown when both are active. When the promo ends (via scheduling or manual deactivation), the general banner takes over.

Display delay

You can add a delay before the banner appears using the data-delay attribute on the script tag:

<script
  src="https://cdn.tolinku.com/banner.js"
  data-key="tolk_pub_your_key"
  data-delay="2000"
  async
></script>

The value is in milliseconds. A 2-second delay gives the user time to start reading your page before the banner slides in.

Dismissal

When a user taps the close button on a banner, it is dismissed. The dismissal is saved in the browser’s localStorage so the banner does not reappear on the next page load.

You can control how long a banner stays dismissed with the dismiss days setting:

Not set: The banner stays dismissed until the user clears their browser data.
1 day: The banner reappears after 24 hours.
7 days: The banner reappears after a week.

Use shorter dismiss periods for time-sensitive promotions. Use longer periods (or no limit) for general install banners to avoid annoying repeat visitors.

A/B testing

Banners marked as A/B eligible can be included in A/B tests. When a banner is part of an active test, Tolinku uses a deterministic selection based on the visitor’s fingerprint (IP + user agent hash) so each visitor consistently sees the same variant.

See A/B Testing for details on setting up tests and reading results.