Ads Management

Overview

The Ads Management module allows you to create, edit, and manage individual advertisements across your application. Support both Google AdSense ad units and custom advertisements (image, text, or HTML). Each ad can be assigned to multiple placements and controlled independently with priority settings and activation status.

Accessing Ads Management

Navigation path: Dashboard > Advertising > Ads

Required permission: manage_ads

Key Features

• Dual Ad Types: Create both AdSense and custom advertisements
• Multiple Custom Formats: Support for image, text, and HTML custom ads
• Priority System: Control which ads display when multiple options exist
• Bulk Operations: Activate, deactivate, or delete multiple ads at once
• Ad Duplication: Quickly create similar ads by duplicating existing ones
• Status Management: Enable or disable ads without deleting them
• Search and Filters: Find ads quickly with advanced filtering options
• Placement Tracking: See how many placements each ad has

Main Interface

List View

The ads list displays all your advertisements with the following information:

Columns:

• Name: Ad name with visual identifier
• Type: AdSense or Custom (with icon)
• Status: Active or Inactive badge
• Priority: Priority level for display order
• Placements: Number of placements using this ad
• Actions: Quick action buttons

Statistics (Header):

• Total ads count
• Active ads count
• AdSense ads count
• Custom ads count

Search and Filters

Available Filters:

• Search: Search by ad name
• Ad Type: Filter by AdSense or Custom
• Status: Filter by Active or Inactive

Bulk Actions

Select multiple ads using checkboxes to perform bulk operations:

• Activate: Enable multiple ads at once
• Deactivate: Disable multiple ads at once
• Delete: Remove multiple ads permanently

Ad Types

AdSense Ads

Google AdSense advertisements that display ads from Google's network.

Configuration Fields:

• Ad Name: Descriptive name for the ad unit
• AdSense Client ID: Your Publisher ID (ca-pub-XXXXXXXXXXXXXXXX)
• AdSense Slot ID: Numeric slot ID from AdSense
• Ad Format: Auto, Rectangle, Vertical, or Horizontal
• Responsive: Toggle for responsive ad behavior

Custom Ads

Self-hosted advertisements with full control over content.

Custom Ad Types:

1. Image Ads

   • Image URL (required)
   • Link URL (optional)
   • Alt Text (optional)

2. Text Ads

   • Text Content (required, max 1000 characters)
   • Link URL (optional)

3. HTML Ads

   • HTML Content (required, max 10,000 characters)
   • Full control over ad appearance and behavior

Common Tasks

Creating an AdSense Ad

1. Navigate to Dashboard > Advertising > Ads
2. Click Create New Ad button
3. Enter an Ad Name (e.g., "Homepage Header AdSense")
4. Select Google AdSense as the ad type
5. Enter your AdSense Client ID (format: ca-pub-XXXXXXXXXXXXXXXX)
6. Enter the AdSense Slot ID (numeric ID from your AdSense account)
7. Select an Ad Format (Auto, Rectangle, Vertical, or Horizontal)
8. Check Responsive Ad if you want the ad to adapt to screen size
9. Set Priority (higher numbers display first)
10. Check Active to enable the ad immediately
11. Click Create Ad
12. Create placements to display the ad on your site

Creating a Custom Image Ad

1. Go to Dashboard > Advertising > Ads
2. Click Create New Ad
3. Enter an Ad Name (e.g., "Sidebar Product Banner")
4. Select Custom Ad as the ad type
5. Choose Image as the custom type
6. Enter the Image URL (full URL to your ad image)
7. Optionally enter a Link URL (where users go when clicking)
8. Optionally enter Alt Text for accessibility
9. Set Priority level
10. Check Active to enable
11. Click Create Ad
12. Set up placements for the ad

Creating a Custom Text Ad

1. Navigate to Dashboard > Advertising > Ads
2. Click Create New Ad
3. Enter an Ad Name (e.g., "Newsletter Signup Text")
4. Select Custom Ad as the ad type
5. Choose Text as the custom type
6. Enter your Text Content (max 1000 characters)
7. Optionally add a Link URL
8. Set Priority and Active status
9. Click Create Ad
10. Create placements to display the ad

Creating a Custom HTML Ad

1. Go to Dashboard > Advertising > Ads
2. Click Create New Ad
3. Enter an Ad Name (e.g., "Interactive Product Showcase")
4. Select Custom Ad as the ad type
5. Choose HTML as the custom type
6. Enter your HTML Content (max 10,000 characters)
7. Ensure your HTML is valid and secure
8. Set Priority and Active status
9. Click Create Ad
10. Test the ad thoroughly before deploying

Editing an Ad

1. Navigate to Dashboard > Advertising > Ads
2. Find the ad you want to edit
3. Click the Edit icon (pencil) in the Actions column
4. Modify the ad settings as needed
5. Click Update Ad to save changes
6. Changes take effect immediately on all placements

Duplicating an Ad

1. Go to Dashboard > Advertising > Ads
2. Find the ad you want to duplicate
3. Click the Duplicate icon in the Actions column
4. A copy of the ad is created with "(Copy)" appended to the name
5. Edit the duplicated ad to customize it
6. Create new placements for the duplicated ad

Activating/Deactivating an Ad

Single Ad:

1. Navigate to Dashboard > Advertising > Ads
2. Find the ad you want to toggle
3. Click the Activate/Deactivate icon (play/pause)
4. The ad status changes immediately
5. Inactive ads won't display on any placements

Multiple Ads (Bulk):

1. Go to Dashboard > Advertising > Ads
2. Check the boxes next to ads you want to change
3. Click Activate or Deactivate in the bulk actions bar
4. Confirm the action
5. All selected ads update simultaneously

Deleting an Ad

Single Ad:

1. Navigate to Dashboard > Advertising > Ads
2. Find the ad you want to delete
3. Click the Delete icon (trash can)
4. Confirm deletion in the popup
5. The ad and all its placements are permanently removed

Multiple Ads (Bulk):

1. Go to Dashboard > Advertising > Ads
2. Check the boxes next to ads you want to delete
3. Click Delete in the bulk actions bar
4. Confirm the bulk deletion
5. All selected ads are permanently removed

Viewing Ad Details

1. Navigate to Dashboard > Advertising > Ads
2. Find the ad you want to view
3. Click the View icon (eye) in the Actions column
4. See detailed information including:
   • Full ad configuration
   • All placements using this ad
   • Creation and update timestamps
   • Ad preview (for custom ads)

Ad Configuration Fields

Common Fields (All Ad Types)

Ad Name

• Type: Text Input
• Required: Yes
• Max Length: 255 characters
• Description: Descriptive name for internal identification
• Example: "Homepage Header Banner", "Sidebar AdSense Unit"

Priority

• Type: Number Input
• Default: 0
• Range: 0-100
• Description: Display priority when multiple ads compete for same placement
• Note: Higher numbers display first

Active Status

• Type: Toggle (Checkbox)
• Default: Checked
• Description: Enable or disable the ad
• Impact: Inactive ads won't display anywhere

AdSense-Specific Fields

AdSense Client ID

• Type: Text Input
• Required: Yes
• Format: ca-pub-XXXXXXXXXXXXXXXX
• Description: Your Google AdSense Publisher ID
• Validation: Must start with "ca-pub-"

AdSense Slot ID

• Type: Text Input
• Required: Yes
• Format: Numeric
• Description: Ad unit slot ID from your AdSense account
• Example: "1234567890"

Ad Format

• Type: Select Dropdown
• Options: Auto, Rectangle, Vertical, Horizontal
• Default: Auto
• Description: Ad unit format/shape

Responsive

• Type: Toggle (Checkbox)
• Default: Checked
• Description: Ad automatically adjusts to available space

Custom Ad Fields

Custom Type

• Type: Radio Selection
• Options: Image, Text, HTML
• Required: Yes
• Description: Type of custom advertisement

Image URL (Image Ads)

• Type: Text Input
• Required: Yes (for image ads)
• Format: Full URL
• Description: Direct link to the ad image
• Example: "https://example.com/ads/banner.jpg"

Link URL (Image/Text Ads)

• Type: Text Input
• Required: No
• Format: Full URL
• Description: Destination when ad is clicked
• Example: "https://example.com/product"

Alt Text (Image Ads)

• Type: Text Input
• Required: No
• Max Length: 255 characters
• Description: Accessibility text for screen readers

Text Content (Text Ads)

• Type: Textarea
• Required: Yes (for text ads)
• Max Length: 1000 characters
• Description: The text content of the ad

HTML Content (HTML Ads)

• Type: Textarea (Code Editor)
• Required: Yes (for HTML ads)
• Max Length: 10,000 characters
• Description: Custom HTML code for the ad
• Warning: Ensure HTML is safe and doesn't contain malicious code

Permissions

The following permission is required to access and manage ads:

• manage_ads: Full access to create, edit, delete, and manage all advertisements

Users without this permission will see an "Access Denied" message.

Tips and Best Practices

Ad Naming

• Use descriptive names that indicate purpose and location
• Include ad type in the name (e.g., "Header AdSense", "Sidebar Custom")
• Use consistent naming conventions across all ads
• Avoid generic names like "Ad 1", "Ad 2"

Priority Management

• Use priority 100 for most important ads
• Use priority 50 for standard ads
• Use priority 0 for fallback ads
• Leave gaps between priorities for future additions

AdSense Best Practices

• Verify Client ID and Slot ID are correct before saving
• Use responsive ads for better mobile experience
• Choose appropriate ad formats for each placement
• Monitor AdSense dashboard for performance metrics

Custom Image Ads

• Use high-quality images optimized for web
• Ensure images are hosted on reliable servers
• Use appropriate image dimensions for placements
• Include alt text for accessibility
• Test images on different screen sizes

Custom Text Ads

• Keep text concise and compelling
• Include a clear call-to-action
• Test different messaging to find what works
• Ensure text is readable on all backgrounds

Custom HTML Ads

• Validate HTML before saving
• Test thoroughly on different browsers
• Avoid inline scripts that might be blocked
• Keep file size reasonable for performance
• Ensure responsive design for mobile devices

Performance Optimization

• Don't create too many active ads
• Deactivate unused ads instead of deleting
• Use priority system to control display order
• Monitor ad performance and adjust accordingly

Troubleshooting

AdSense Ad Not Displaying

Problem: AdSense ad is created but not showing on site

Solutions:

1. Verify the ad is set to Active
2. Check that AdSense Client ID is correct
3. Confirm AdSense Slot ID matches your AdSense account
4. Ensure placements are created and active for this ad
5. Check that AdSense is enabled in Advertising Settings
6. Verify your AdSense account is approved
7. Check browser console for JavaScript errors

Custom Image Ad Not Loading

Problem: Custom image ad shows broken image icon

Solutions:

1. Verify the Image URL is correct and accessible
2. Check that the image file exists at the specified URL
3. Ensure the image URL uses HTTPS (not HTTP)
4. Test the image URL in a browser directly
5. Check image file permissions on the server
6. Verify the image format is supported (JPG, PNG, GIF, WebP)

Ad Priority Not Working

Problem: Lower priority ads are showing instead of higher priority ones

Solutions:

1. Verify priority numbers are set correctly (higher = first)
2. Check that higher priority ads are Active
3. Ensure higher priority ads have valid placements
4. Clear application cache
5. Check placement rules and targeting
6. Verify no JavaScript errors are preventing ad display

Bulk Actions Not Working

Problem: Bulk operations fail or don't affect all selected ads

Solutions:

1. Ensure you have selected ads using checkboxes
2. Check that you have manage_ads permission
3. Verify no browser extensions are blocking the action
4. Try with fewer ads selected
5. Check browser console for errors
6. Refresh the page and try again

HTML Ad Not Rendering Correctly

Problem: Custom HTML ad displays incorrectly or not at all

Solutions:

1. Validate your HTML code for syntax errors
2. Check for conflicting CSS with site styles
3. Ensure all resources (images, scripts) use HTTPS
4. Test HTML in isolation before adding to ad
5. Check browser console for JavaScript errors
6. Verify HTML doesn't exceed 10,000 character limit

Related Modules

• Advertising Settings: Configure global advertising system settings
• Ad Placements: Control where ads appear on your site
• Media Library: Upload and manage images for custom ads
• Adblock Logs: Monitor ad-blocking software usage