Text Ads Rotator Documentation

Complete guide to integrating and customizing the Text Ads Rotator widget on your website

Live Demo Create Widget

Quick Start

Get your Text Ads Rotator widget up and running in just a few steps:

1. Create Your Widget Instance

Start by creating a new widget instance to manage your ads and settings:

Create New Widget Instance

2. Add Your Ads & Organize Campaigns

Add your text advertisements with titles, descriptions, and call-to-action buttons. Organize them into campaigns for better filtering and management.

3. Customize Appearance & Typography

Configure your widget's appearance, layout, and behavior in the settings panel. Choose from over 100 professional fonts to match your brand.

4. Configure Filtering (Optional)

Use advanced filtering to show specific campaigns or ads containing certain keywords, giving you precise control over displayed content.

5. Get Embed Code

Copy the generated embed code and paste it into your website where you want the ads to appear.

New Features!
  • Advanced Ad Filtering: Filter by campaigns or keywords
  • Professional Typography: 100+ Google Fonts in 9 categories
  • Smart Font Loading: Optimized performance with cross-browser support

Embedding Methods

Choose the embedding method that works best for your website:

1. IFrame Embed (Recommended)

The most reliable method, works on all websites and content management systems:

Basic Embed: <iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=single&layout=card" width="100%" height="200" frameborder="0"></iframe>
With Campaign Filter: <iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=grid&layout=card&filter=campaigns&campaigns=2%2C4" width="100%" height="300" frameborder="0"></iframe>

2. JavaScript Embed

Dynamic loading for modern websites that support external scripts:

Basic Script Embed: <script src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=single&layout=card&format=script"></script>
With Keyword Filter: <script src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=carousel&filter=keywords&include=tech%2Cweb&format=script"></script>

Display Modes

Control how multiple ads are displayed:

Single

Display one ad at a time with optional rotation and animations.

mode=single
Grid

Show multiple ads in a responsive grid layout.

mode=grid
Carousel

Rotating slideshow with navigation controls.

mode=carousel

Layout Types

Choose the visual style for your individual ads:

Card Layout

Full-featured cards with emoji, title, description, and CTA button.

layout=card
Minimal Layout

Compact horizontal layout perfect for sidebars.

layout=minimal
Banner Layout

Wide horizontal banner format for headers and footers.

layout=banner
Compact Layout

Small, square format ideal for tight spaces.

layout=compact

Color Themes

Choose from beautiful pre-designed color schemes:

Ocean Breeze
color_theme=ocean_breeze
Sunset Glow
color_theme=sunset_glow
Forest Green
color_theme=forest_green
Royal Purple
color_theme=royal_purple
Cherry Blossom
color_theme=cherry_blossom
Midnight Blue
color_theme=midnight_blue
Golden Hour
color_theme=golden_hour
Crimson Red
color_theme=crimson_red
Slate Modern
color_theme=slate_modern
Emerald Fresh
color_theme=emerald_fresh
Violet Dream
color_theme=violet_dream
Ruby Passion
color_theme=ruby_passion

URL Parameters

Customize your widget behavior using URL parameters:

Basic Parameters

Parameter Type Description Example
mode Required string Display mode: single, grid, or carousel mode=grid
layout Optional string Ad layout: card, minimal, banner, compact layout=card
color_theme Optional string Color theme name color_theme=ocean_breeze
format Optional string Embed format: iframe (default) or script format=script
filter New string Ad filter type: campaigns or keywords filter=campaigns
campaigns New string Comma-separated campaign IDs (with filter=campaigns) campaigns=1,2,5
include New string Include keywords (with filter=keywords) include=tech,web
exclude New string Exclude keywords (with filter=keywords) exclude=spam,adult
font New string Override widget font with specific font name font=Roboto

Grid Mode Parameters

Parameter Type Description Example
desktop_cols integer Number of columns on desktop (1-6) desktop_cols=3
mobile_cols integer Number of columns on mobile (1-2) mobile_cols=1

Carousel Mode Parameters

Parameter Type Description Example
ads_count integer Number of ads to show (1-10) ads_count=5
speed integer Auto-advance speed in milliseconds speed=3000

Single Mode Parameters

Parameter Type Description Example
refresh_interval integer Ad rotation interval in seconds (0 = no rotation) refresh_interval=10
animation string Transition animation: fade, slide, none animation=fade

Ad Filters

Control which ads are displayed in your widget using powerful filtering options:

Filter Types

All Ads

Display all active ads from the instance (default behavior).

No parameters required
Campaign Filter

Show ads from specific campaigns only.

filter=campaigns
Keyword Filter

Include or exclude ads based on keywords.

filter=keywords

Filter Parameters

Parameter Type Description Example
filter string Filter type: campaigns, keywords filter=campaigns
campaigns string Comma-separated campaign IDs (when filter=campaigns) campaigns=1,2,5
include string Include ads containing these keywords (when filter=keywords) include=tech,web,mobile
exclude string Exclude ads containing these keywords (when filter=keywords) exclude=spam,adult,gambling

Filter Examples

Campaign Filter Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=grid&layout=card&filter=campaigns&campaigns=2%2C4%2C7"></iframe>

Shows only ads from campaigns with IDs 2, 4, and 7

Keyword Include Filter Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=single&filter=keywords&include=technology%2Csoftware"></iframe>

Shows only ads containing "technology" or "software" in title, description, or URL

Keyword Exclude Filter Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=carousel&filter=keywords&exclude=adult%2Cgambling%2Cpharmacy"></iframe>

Excludes ads containing "adult", "gambling", or "pharmacy" keywords

Combined Keyword Filter Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=grid&filter=keywords&include=business%2Cmarketing&exclude=mlm%2Cpyramid"></iframe>

Shows business and marketing ads but excludes MLM and pyramid scheme ads

Font Override Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=single&layout=card&font=Roboto"></iframe>

Uses Roboto font instead of the widget's default font setting

Combined Parameters Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=carousel&layout=minimal&filter=campaigns&campaigns=2%2C4&font=Open%2BSans&color_theme=modern_dark"></iframe>

Carousel display with minimal layout, campaigns 2 & 4, Open Sans font, and modern dark theme

Ad Selection Criteria

Control how ads are selected and prioritized for display using intelligent algorithms:

New Feature!

Configure how your ads are selected for display. Choose between weight-based, performance-based, or intelligent hybrid selection algorithms.

Selection Methods

Weight-Based

Selection based purely on ad weight values. Higher weight = higher chance of selection.

selection_criteria=weight
CTR-Based

Selection based on click-through rate performance. Better performing ads get priority.

selection_criteria=ctr
IntelliSelection

Combines weight and performance for optimal ad selection. (Default)

selection_criteria=intelliselection

Selection Formulas

CTR Formula
score = (clicks + 1) / (impressions + 2)

Uses Bayesian smoothing to handle ads with low impression counts fairly.

IntelliSelection Formula
score = (weight + 1) × ((clicks + 1) / (impressions + 2))

Combines advertiser preference (weight) with performance data for balanced selection.

Configuration Options

Instance Settings

Configure the default selection criteria for your widget instance in Manage Settings → Ad Selection Criteria.

  • Applies to all embeds by default
  • Also used for API responses
  • Can be overridden per embed or API call
API Override

Override selection criteria for specific API requests using the selection_criteria parameter:

GET /api/1/ads?selection_criteria=ctr

Usage Examples

API Request with CTR Selection: 
GET https://www.widgetminds.com/widgets/text-ads-rotator/api/1/ads?api_key=YOUR_API_KEY
&selection_criteria=ctr
&limit=5

Returns ads selected based on click-through rate performance

Weight-Based Selection: 
GET https://www.widgetminds.com/widgets/text-ads-rotator/api/1/ads?api_key=YOUR_API_KEY
&selection_criteria=weight
&limit=10

Returns ads selected purely by weight values (traditional method)

IntelliSelection (Default): 
GET https://www.widgetminds.com/widgets/text-ads-rotator/api/1/ads
?api_key=YOUR_API_KEY
&selection_criteria=intelliselection
&limit=5

Uses the hybrid algorithm combining weight and performance data

Selection Behavior
  • Weighted Random: All selection methods use probabilistic selection - every ad has a chance, but higher-scoring ads are more likely to be selected
  • Fresh Ads: New ads with no impressions start with a small boost to ensure they get initial exposure
  • Performance Tracking: Click and impression data is automatically collected for CTR and IntelliSelection algorithms

Font Options

Customize the typography of your ads with professional font choices and styling options:

Font Categories

Popular Fonts

Inter, Roboto, Open Sans, Lato

Sans-Serif

Modern, clean fonts for digital displays

Serif

Traditional, elegant fonts for readability

Display

Eye-catching fonts for headlines

Font Configuration

Fonts are configured in your widget settings and automatically loaded from Google Fonts. The widget supports over 100 carefully curated fonts organized in the following categories:

Default Font: Inter is set as the default font for its excellent readability and modern appearance across all devices and browsers.

Font Categories Available

Category Description Example Fonts Best For
⭐ Popular Most widely used and tested fonts Inter, Roboto, Open Sans, Lato General purpose, high readability
📱 Sans-Serif Clean, modern fonts without serifs Source Sans Pro, Nunito, Montserrat Digital screens, modern brands
📰 Serif Traditional fonts with decorative strokes Merriweather, Playfair Display, Lora Formal content, traditional brands
🎨 Display Eye-catching fonts for headlines Oswald, Bebas Neue, Righteous Headlines, attention-grabbing text
💼 Corporate Professional business fonts IBM Plex Sans, Work Sans, Barlow Business content, professional sites
🌍 International Fonts with extended character sets Noto Sans, Source Sans Pro, Libre Franklin Multi-language content
💻 Monospace Fixed-width fonts for code/tech Source Code Pro, JetBrains Mono, Fira Code Technical content, code snippets
🎭 Creative Artistic and unique fonts Pacifico, Dancing Script, Amatic SC Creative projects, artistic brands
📜 Vintage Classic and retro-style fonts Crimson Text, EB Garamond, Vollkorn Heritage brands, classic designs

Font Loading & Performance

Smart Loading
  • Fonts loaded only when needed
  • Optimal font weights selected automatically
  • Variable font support where available
  • Font display optimization for fast rendering
Cross-Browser Support
  • Fallback fonts for all browsers
  • System font fallbacks included
  • Font Loading API integration
  • Iframe-safe font rendering
Font Configuration Options:
  • Widget Settings: Configure default font through your widget settings panel
  • Embed Code Override: Use the font selection in embed code generator
  • URL Parameter: Pass font=FontName parameter for dynamic font changes

Font Parameter Usage

You can override the widget's font setting by using the font URL parameter:

Font Parameter Example: 
<iframe src="https://www.widgetminds.com/widgets/text-ads-rotator/embed/1?mode=single&font=Roboto"></iframe>

Available font names: Inter, Roboto, Open Sans, Lato, Montserrat, Source Sans Pro, and 90+ more

Font Validation: Only fonts from our curated list are accepted. Invalid font names will fallback to the widget's default font setting.

Animations

Add smooth transitions and effects to enhance user engagement:

Fade

Smooth opacity transition between ads.

animation=fade
Slide

Horizontal sliding transition effect.

animation=slide
None

Instant switching with no animation.

animation=none

Responsive Design

The widget automatically adapts to different screen sizes:

Breakpoints

  • Mobile (< 768px): Single column layout, compact controls
  • Tablet (768px - 1024px): Responsive grid, medium-sized elements
  • Desktop (> 1024px): Full grid layout, optimal spacing

Grid Responsiveness

Grid mode automatically adjusts columns based on screen size. You can control this behavior:

// Always 1 column on mobile, 3 columns on desktop mode=grid&desktop_cols=3&mobile_cols=1

Troubleshooting

Common Issues

  • Check that your widget instance ID is correct
  • Ensure you have active ads in your widget
  • Verify the embed URL is accessible
  • Try using iframe format instead of script format

  • Use iframe format to isolate widget styles
  • Check for CSS conflicts with your site's styles
  • Try a different color theme
  • Adjust the container width/height if needed

  • Limit the number of ads in carousel mode
  • Use appropriate refresh intervals (not too fast)
  • Consider using minimal or compact layouts for better performance
  • Test on different devices and connections

  • Ensure Google Fonts can be loaded (check firewall/ad blockers)
  • Try using iframe format for better font isolation
  • Check if the selected font supports your language/characters
  • Fallback fonts are automatically applied if web fonts fail
  • Font loading may take a moment on slow connections

  • Verify campaign IDs are correct and active
  • Check that filtered ads actually exist and are active
  • Ensure keyword matches are in title, description, or URL
  • Keywords are case-insensitive and partial matches work
  • If no ads match filters, dummy ads may be shown
  • Test filters without iframe to debug parameter passing

Need More Help?

Still having issues? Try these resources:

View Live Demo Create Test Widget