Guide - Widget for websites

Widget display rules

If you want your widget to work properly, you need to download and install the code only once. Any rules by which the widget should appear on the site can be customized from the interface. This allows for convenient and quick management of rules thanks to which the widget is presented to website users.

Widget display rules

After adding the widget questions, select Display rules (2) on the Collect (1) tab. Then select: Add a new set of rules (3).

After selecting this option, the display conditions section will appear.

It allows you to configure rules whose fulfillment will cause the widget to appear.

The following rules are available:

  • URL address or page contains:

This rule ensures that the widget will appear only if the URL of the page you are viewing contains the selected phrase.

The desired phrase should be entered in the field that appears after choosing the option URL address or page (4). For example, if the selected phrase is / console then the widget will appear only if the user enters the subpage where the URL will contain the given phrase eg www.mystore.pl/console or www.myshop.pl/new-console .

NOTE – If you don’t enter the URL address, the widget will appear on those pages where the installation code has been inserted.

  • The URL of the previous page

It has the same function as the previous: URL address or page. It allows displaying the widget if the URL code of the previous page (5) is equal / different, etc. the value entered by the user.

  • Cookie content

Display the widget by specifying the name and value of the cookies (6) previously set with the superWidget.setRetargetCookie () function. Documentation of the method can be found in the section Account settings -> Widget code.

  • The time on the current page is minimum:

Thanks to this rule, you can make sure that the widget will be displayed only if the user spends the given amount of time on a page.

The time should be given in seconds and entered in the field next to the selected rule (7). If this field is left blank, the default value is 0, which means that the widget will appear immediately after entering the site.

  • Time on the entire website is minimum:

As the previous rule, this rule also allows you to define the time after which the widget will appear. This time, however, the time of the entire visit to the website is taken into account, and not only on a given subpage.

The time should be entered in the appropriate field (8) in seconds and the default value is 0, which means that the widget appears immediately.

  • The user has rewound a percentage of the page (9)

With this feature, you can determine how many percent of the website should be scrolled down to the widget, e.g. 50% if you want the widget to appear in the middle of the scroll.

  • The user has rewound a number of pixels of the page (10)

Here you can set how many pixels vertically must scroll the user to make the widget appear.

If you do not know what pixel size your site has, it’s best to ask the creator of the page code.

  • User scrolled page o to section number (11)

The option allows you to select the number of screens (viewports) that must be scrolled by the user to display the widget. The new approach to website design assumes that each section of the page fills the ViewPort of the browser in 100%. If your site is designed like this, you can use just the section number or screen instead of pixels.

  • The user visited at least:

This rule allows you to define the number of subpages of a given site that the user must first visit during the current visit in order for the widget to be displayed. This means that the widget may appear only if the user visits eg 5 subsequent subpages of the site.

The number of required pages should be entered in the field next to the selected rule (12) and the default value is 0, which means that the widget appears immediately.

 

  • User wants to leave page (13)

Thanks to this rule, you can make sure that the widget is displayed only when the user wants to leave the page – if he moves the cursor out of the upper area of ​​the displayed page.

  • The javascript code will return TRUE

It is also possible to display the widget in case the javascipt code returns TRUE. This allows you to create your own Java code and determine that only in this case our widget will appear on the user’s screen.

Combining rules

You can combine all of the above rules together to create sets of rules. Thanks to this, you can make sure that the widget will be displayed if, for example, only one of the rules works, or only if all defined rules work.

You can choose if you want to combine rules inside one set or combining several sets. For one set, you should just just click the add a new rule icon (15) and then select the desired rule. After selecting the rules, you must decide whether to meet one of the selected conditions for displaying the widget or whether all conditions (16) must be met.

If you want to combine several sets of rules, to add a new set, click Add new rule set (17).

This allows you to add another set of rules that can be freely defined by the user.

After adding several sets of rules, it is also possible to define whether all rules sets are required to display a widget, or if one of them works.

It works on the same principle as in the previous case of rules within a single set. Select the appropriate behavior from the additional field that will appear below the created sets of rules.

Was this article helpful for you?

Thank you for answering