Widget Calling

Yespo provides a wide range of options for flexible customization of widget display conditions so that they work as efficiently as possible in each situation. 

To set the widget display rules, click on the edit button in the corresponding section of the Parameters tab:

By Rules

Set up the following rules:

Display Frequency

• Do not limit
• Only once
• Once per session
• One time per some period

A user web session is an interactive period during which a user engages with your website, where the service script is installed.

During a session, a user may perform various actions, such as navigating between pages, interacting with content, submitting forms, or using specific features.

Examples of interactions:

• Cursor movements

• Clicks

• Keyboard pressings

• Taps

• Scrolls

A new session starts when a user enters a page where the service script is installed, and the user’s previous session has timed out or there was no previous session.

A session ends after 30 minutes of user inactivity.

Examples of user inactivity:

• A user does not interact for 30 minutes with the site where the service script is installed.

• A user closes all tabs with the site where the service script is installed and does not return to this site for at least 30 minutes.

When to Display 

You can choose to display a widget immediately or when all or any of the following conditions are met:

• Spent some time on the page 
• Spent some time on the website
• Read the page by some percentage
• Visited some amount of pages
• Not active on the page for some time
• Left the cursor off the page

When to Stop Displaying

• After a certain amount of seconds, in case of no interaction with the widget (the condition is canceled when a user hovers over the widget)
• After closing a certain amount of times

• After subscription (from any or this widget): do not show the widget to the contacts with the subscribed status.

Our system identifies the subscription status of a contact based on the contact ID. When a contact visits your site, the script requests the system to check the subscription status. This request includes the contact ID, which is stored on the site as the result of the following events:

• A contact subscribed using any or this particular widget.
• A contact clicked a link in an email message redirecting to the site where our script is installed. The contact ID is retrieved from the URL’s UTM tags.
• A contact subscribed to the web push notification.

You can select the After subscription from any widget option for general subscription types, for example, weekly digests. This widget will not be displayed if a contact has already signed up using any widget or channel.

If you select the After subscription from this widget option, the widget will not be displayed only in case the contact has already subscribed using this widget.

Note
If a contact has any status other than Active, the widget will be shown to that contact when the After subscription condition is enabled.

Annoyance Safeguard

Set annoyance safeguard when several floating widgets must be displayed on one screen based on their triggering rules. See details >

To Whom

New visitors

You can show your widget only to the new visitors of your site. 

The visitors are identified as new when:

• They have not visited the site after the installation of our script on it.
• They previously visited the site in incognito mode.
• After the past visits, they cleared the cache, cookies, and local data.

To show the widget only to the new visitors, enable the New visitors option in the To whom section.

Device type

• Show on all device types.
• Show on desktop. 
• Show on mobile.

Segment

You can display a widget only to contacts included into a specific segment.

To add a segment to the To whom condition:

1. Click the Select a segment button.
2. Select the segment in the Select a segment to display the widget window.

You can add both lists and dynamic segments. Segment preview is available for a dynamic segment.

The widget will be displayed to the identified and unidentified site visitors if they are included into the segment. The system uses the following information to identify whether a site visitor is included into the segment:

• Cookies: For unidentified contacts if the segment contains only the Web Tracking conditions.
• Contact ID: For identified contacts.

The identified contacts are:

• Those who subscribed using any or this particular widget.
• Those who click a link in an email message redirect to the site where our script is installed. 
• Those who subscribed to the web push notifications.

On Pages

Similar to dynamic segments builder, you can choose pages where to display or not to display the widget. Use this widget-calling rule to show promotions depending on products and their categories, the site’s sections, etc.

In Locations

Read Setting Up Locations for the Widget Calling Rules to learn details.

By Click on Launcher

The launcher calls the widget (Subscription form/Informer types) regardless of the widget display conditions.

Rules for forms that showed by clicking on a launcher:

• Show each time
• Immediately
• Stop to display forever after subscription from any widget
• Show on all types of devices
• On any pages
• Show in all countries

On Clicking an HTML Element

Specify specify one or more CSS selectors of the call elements.

To learn about finding an element and copying its CSS selector, click on the How to find a CSS selector link.

API Based

Show a widget by clicking on a page element or via JavaScript. Copy the JS function below to show the widget on some extra condition.