Understanding Widget Display Rules

Cavaco AI provides comprehensive controls over when, where, and to whom your site widgets appear. Mastering these display rules ensures your widgets enhance the shopping experience rather than disrupting it.

Every widget in Cavaco AI (whether it's a Sign-Up Form, Content Block, or Recommendation widget) shares a common set of display controls: Timing, Frequency, Devices, and Routing (Segments).

1. Display Timing (Triggers)

Timing controls exactly when a widget appears to a visitor during their session. You can choose from three main approaches:

Immediately

The widget loads as soon as the page renders. This is best for embedded widgets (like product recommendations or inline forms) and critical announcement banners.

Rules-Based Triggers

Rules allow you to delay the widget until the visitor takes a specific action or shows a certain level of engagement. You can combine multiple rules.

• After time delay: Triggers after a specific number of seconds (e.g., show after 8 seconds). Excellent for welcome popups to let the page load first.
• After scroll: Triggers when the visitor scrolls a certain percentage down the page (e.g., 50%). Great for blog posts or long product pages to ensure they are actually reading.
• After visiting pages: Triggers only after the visitor has viewed a set number of pages during their session. Perfect for targeting engaged shoppers rather than immediate bouncers.
• Exiting user (Exit-Intent): Triggers when the visitor's cursor moves rapidly toward the browser tab or close button. The ultimate last-chance conversion tool.

Custom Trigger

Allows you to trigger the widget programmatically using a custom JavaScript event or CSS selector. Ideal for tying a widget to a specific button click on your site (e.g., clicking a "Size Guide" button opens a content popup).

2. Display Frequency

Frequency controls prevent you from annoying your visitors by repeatedly showing them the same popup.

• Show again after days: If a visitor sees the widget, how many days should pass before they see it again? (Set to 0 to show it every session).
• Show again if closed: A critical setting. If a visitor actively clicks the "X" to close a popup, you can choose to respect that dismissal and never show it again, or show it again after the defined days.

3. Device Targeting

You can specify whether a widget should appear on Desktop, Mobile, or both. Because mobile screen real estate is limited, it is highly recommended to design separate, optimized widgets for mobile vs. desktop, especially for popups and flyouts.

4. Routing and Segments

Routing determines who sees the widget. By default, widgets can be shown to all visitors, but Cavaco AI allows you to route different widget variants to specific Audience Segments.

For example, you can configure a single Welcome Popup widget to:

• Show Variant A (15% off) to your "Anonymous / New Visitors" segment.
• Show Variant B ("Welcome back! Check out our new arrivals") to your "Returning Customers" segment.
• Show nothing at all to your "VIP Customers" segment.

You can also apply Schedules to these routes, ensuring specific variants only run during defined date and time ranges (e.g., a Black Friday variant that automatically activates on Friday and turns off on Monday).