Configuring Content Rules

After setting up your placement's basic information, navigate to the Content Rules tab to define which content appears on which pages of your website.

Content rules define which content appears based on URL patterns. Each placement can have multiple rules, evaluated in priority order (top to bottom).

The Content Rules Tab

From the placement editor, click on the Content Rules tab to access the rule configuration interface.

The Content Rules tab displays:

• A description: "Configure what content will be shown in this placement based on URL patterns and conditions"
• A list of existing content rules (if any)
• The + Add Content Rule button to create new rules

Understanding the Rules List

Each rule in the list shows:

Element	Description
Priority number	The order in which rules are evaluated (1 is first). Use the up/down arrows to reorder.
Rule name	The descriptive name you gave the rule
Pattern summary	Shows the URL pattern and match type (e.g., "/ (exact)")
Expand/collapse icon	Click to view or hide the full rule configuration
Delete icon (×)	Remove the rule from the placement

Adding a New Rule

1. Click + Add Content Rule
2. The rule editor will expand, showing all configuration options

Rule Configuration

The Rule Configuration section allows you to define URL patterns to match pages where this content rule applies.

Rule Configuration Fields

Rule Name (Required)

• A descriptive name to identify this rule in the list
• Example: "Product Category Pages", "Checkout Flow", "Front page"

Match Type (Required)

• How the pattern is matched against page URL paths
• Options: Exact, Prefix, Wildcard, or Regex

URL Pattern (Required)

• The URL path that will trigger this content rule
• Example: /products/page or https://example.com/products/page

URL Pattern Matching

URL pattern matching determines which pages trigger your content. There are four match types available:

1. Exact Match

Matches the URL path exactly as specified.

Field	Description
Pattern	The exact URL path to match
Example	/products/shoes
Matches	https://yoursite.com/products/shoes
Does Not Match	https://yoursite.com/products/shoes/red

Include Query Parameters (Optional)

• When enabled, the query string must also match exactly
• Pattern /search?q=test will only match URLs with that exact query string

2. Prefix Match

Matches any URL that starts with the specified pattern.

Field	Description
Pattern	The URL prefix to match
Example	/products/
Matches	/products/shoes, /products/shoes/red, /products/123
Does Not Match	/product/shoes (different path)

This is useful for matching entire sections of your website.

3. Wildcard Match

Uses glob-style patterns with special characters:

• * matches any sequence of characters
• ? matches a single character

Field	Description
Pattern	A glob-style pattern
Example	/products/*/reviews
Matches	/products/shoes/reviews, /products/123/reviews
Does Not Match	/products/reviews (missing middle segment)

More Examples:

• /blog/202?/* matches /blog/2024/my-post, /blog/2025/another-post
• /api/v*/users matches /api/v1/users, /api/v2/users

4. Regular Expression (Regex)

Uses full regular expression syntax for complex matching.

Field	Description
Pattern	A valid regex pattern
Example	^/products/[0-9]+$
Matches	/products/123, /products/456789
Does Not Match	/products/shoes (not numeric)

Regex Examples:

• ^/blog/\d{4}/\d{2}/ - Matches blog posts with date structure
• ^/(en|fr|de)/products - Matches products in multiple languages
• .*\.(html|htm)$ - Matches URLs ending in .html or .htm

Tip: The pattern is validated in real-time. Invalid regex patterns will show an error message.

URL Exclusions

Below the URL Pattern field, you'll find the URL Exclusions section. URLs matching these patterns will be excluded even if they match the main pattern.

Adding an Exclusion

1. In the Rule Configuration section, find URL Exclusions
2. Click + Add Exclusion
3. Configure the exclusion pattern:
   • Pattern: The URL pattern to exclude
   • Match Type: Choose Exact, Prefix, Wildcard, or Regex
   • Include Query Parameters: (For Exact match only)

Exclusion Examples

Main Pattern: /products/* (Prefix) Exclusion: /products/sale (Exact)

This setup matches all product pages except the sale page.

Testing Your URL Pattern

Before saving your rule, test it with real URLs:

1. Find the Test URL field in the rule editor
2. Enter a full URL path (e.g., /products/shoes/red)
3. See instant feedback:
   • Green checkmark: URL matches the rule
   • Red X: URL does not match

The tester considers both the main pattern AND any exclusions you've configured.

Content Types

After configuring URL matching, choose what content to display. There are three content types:

Direct Content

Display a single videobot or widget directly.

When to use: When you always want the same content on matching pages.

Configuration

1. Select Direct as the content type

2. Choose the content type:

   • Videobot: An interactive video bot
   • Widget: A static widget component

3. For Videobots, select the display type:

   • Widget: Appears as a floating widget on the page
   • Iframe: Embeds as an inline iframe element

4. Select the specific content from the dropdown

   • Only published videobots/widgets appear in the list
   • Use the search box to filter by name

Scheduled Content

Display different content based on time schedules. Perfect for promotional campaigns, seasonal content, or time-sensitive messaging.

When to use: When you need different content at different times.

The Calendar Interface

The scheduler uses a full calendar interface with multiple views:

• Month: See an overview of all scheduled entries
• Week: Detailed view of one week
• Day: Detailed view of a single day
• List: Agenda-style list of upcoming events

Creating a Schedule Entry

1. Select Schedule as the content type
2. Click on a time slot in the calendar or click Add Event
3. Fill in the schedule entry form:

Basic Information:

Field	Description
Title	A name for this schedule entry (e.g., "Summer Sale Bot")
All Day	Toggle for full-day events (hides time selection)
Start Date	When the entry begins
End Date	When the entry ends
Start Time	Time of day to start (if not all-day)
End Time	Time of day to end (if not all-day)

Recurring Events:

• Toggle Recurring to make the entry repeat
• Select which days of the week it should recur
• The entry will repeat on selected days within the date range

Content Selection:

Field	Description
Content Type	Videobot or Widget
Display Type	Widget or Iframe (for videobots)
Content	Select the specific bot/widget to display

Handling Schedule Conflicts

When two schedule entries overlap, you must assign priorities:

1. The system automatically detects overlapping entries
2. A warning appears showing which entries conflict
3. Assign a priority number to each conflicting entry
4. Higher numbers = higher priority (priority 10 beats priority 5)
5. When schedules overlap, the higher-priority content displays

Important: You cannot save a placement with unresolved schedule conflicts.

Fallback Content

Set a default content to display when no schedule entry matches:

1. Click Add Fallback Content below the calendar
2. Configure it like Direct content
3. This displays during any "gaps" in your schedule

A/B Test Content

Split traffic between multiple content variants to test which performs better.

When to use: When you want to compare different videobots or widgets.

Configuration

1. Select A/B Test as the content type
2. Choose an allocation method:
   • Random: Each visitor randomly receives a variant
   • Sticky Session: Same variant for the visitor's entire session

Setting Up Variants

You need at least 2 variants. Each variant requires:

Field	Description
Variant Name	A descriptive name (e.g., "Control", "New Design")
Content Type	Videobot or Widget
Display Type	Widget or Iframe (for videobots)
Content	The specific bot/widget for this variant
Weight	Traffic allocation (1-100)

Traffic Allocation (Weights)

The weight bar shows how traffic is distributed:

• Each variant has a weight value (1-100)
• The percentage is calculated as: (weight / total weights) x 100
• Drag the dividers between segments to adjust weights
• Click Reset to distribute weights equally

Example:

• Variant A: Weight 60 → 60% of traffic
• Variant B: Weight 40 → 40% of traffic

Once you've configured your content rules, proceed to publishing your placement.