Ad Management

PaywallWP Pro includes a built-in ad management system that displays advertisements to non-subscribers while hiding them for paying members. This "ad-free experience" is a common premium benefit.

How It Works

1. Configure ad zones with your ad code
2. Set visibility rules based on subscription level
3. Subscribers see clean, ad-free content
4. Non-subscribers see ads in designated zones

Benefits

For Publishers:

• Monetize non-paying visitors
• Incentivize subscriptions
• Manage ads centrally

For Subscribers:

• Ad-free reading experience
• Faster page loads
• Premium feel

Ad Zones

PaywallWP Pro supports multiple ad placement zones:

Zone	Placement	Shortcode Required
Auto Ads	Page head (script injection)	No (automatic)
Header	Top of page	Yes
Sidebar	Widget area	Yes
In-Content	Within post body	No (automatic)
After Content	After post content	No (automatic)
Footer	Bottom of page	Yes

Automatic Zones

• Auto Ads — Scripts injected in page <head> for ad networks that auto-place ads (like AdSense Auto Ads)
• In-Content — Ads inserted at specific paragraph positions within posts
• After Content — Ads appended after post content

No shortcodes needed for these zones.

Manual Zones

Header, Sidebar, and Footer zones require shortcodes:

[paywp_ad zone="header"]
[paywp_ad zone="sidebar"]
[paywp_ad zone="footer"]

Configuration

Enable Ad System

1. Go to PaywallWP → Settings → Ads
2. Toggle Enable Ads to on
3. Configure Hide Ads for Subscribers
4. Set Minimum Access Level to hide ads
5. Save Settings

Configure Ad Zones

For each zone:

1. Enable the zone
2. Paste your ad code (HTML/JavaScript)
3. Set position options (if available)
4. Save

Ad Code Example

Paste your ad network code directly:

<!-- Google AdSense -->
<ins
	class="adsbygoogle"
	style="display:block"
	data-ad-client="ca-pub-XXXXXXXXXX"
	data-ad-slot="XXXXXXXXXX"
	data-ad-format="auto"
></ins>
<script>
	(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Visibility Settings

Hide Ads for Subscribers

Setting	Description
Hide Ads	Enable/disable ad hiding
Minimum Level	Access level required to hide ads

Example configurations:

Access Level	Who Sees Ads
1	All subscribers ad-free
3	Only Level 3+ subscribers ad-free
5	Only Premium/VIP ad-free

Per-Plan Ad Settings

You can make "ad-free" a feature of specific plans:

Basic Plan (Level 2):

• Access to basic content
• Still sees ads

Premium Plan (Level 5):

• Access to all content
• Ad-free experience

Set the minimum level to 5, and only Premium subscribers get ad-free.

In-Content Ads

Automatic Placement

In-content ads are inserted automatically:

Setting	Description
Position	After X paragraphs
Repeat	Insert multiple times
Min Content Length	Only for longer posts

Configuration

1. Go to Settings → Ads → In-Content
2. Set Insert After Paragraph (e.g., 3)
3. Enable Repeat to insert multiple times
4. Set spacing between ads
5. Save

Using the Shortcode

Basic Usage

[paywp_ad zone="sidebar"]

In Widgets

Add to a Text widget or Shortcode widget:

[paywp_ad zone="sidebar"]

In Theme Templates

<?php echo do_shortcode('[paywp_ad zone="header"]'); ?>

Multiple Ad Networks

You can use different ad networks per zone:

Zone	Ad Network
Header	Google AdSense
Sidebar	Custom sponsor
In-Content	Native ads
Footer	Affiliate banner

Best Practices

Ad Placement

1. Don't Overload — 3-4 ads per page maximum
2. Above the Fold — At least one ad visible immediately
3. Natural Flow — Ads shouldn't interrupt reading
4. Mobile First — Test ad appearance on mobile

Performance

1. Lazy Load — Use lazy loading for below-fold ads
2. Async Scripts — Load ad scripts asynchronously
3. Minimize Count — Fewer ads = faster pages

User Experience

1. Clear Labeling — Ads should be identifiable
2. Non-Intrusive — Avoid popups and interstitials
3. Consistent Sizes — Use standard ad dimensions
4. Quality Ads — Avoid deceptive or low-quality ads

Ad-Free as a Selling Point

Market ad-free as a premium benefit:

On Pricing Page

Premium Plan Features:
✅ Access to all content
✅ No advertisements
✅ Faster page loads
✅ Clean reading experience

On Paywall

Subscribe for ad-free reading

Testing Ads

Test as Non-Subscriber

1. Open incognito browser
2. Visit your site
3. Verify ads appear in correct zones

Test as Subscriber

1. Log in as a test subscriber
2. Verify ads are hidden
3. Check console for errors

Common Ad Networks

Test with these popular networks:

• Google AdSense
• Media.net
• Ezoic
• Mediavine
• AdThrive

Troubleshooting

Ads Not Showing

• Verify ad zone is enabled
• Check ad code is valid
• Disable ad blockers for testing
• Check console for JavaScript errors

Ads Showing for Subscribers

• Verify subscriber access level
• Check minimum level setting
• Clear cache
• Log out and log in again

Ads Breaking Layout

• Check ad code for errors
• Verify responsive settings
• Test on multiple screen sizes
• Use appropriate ad sizes

Ad Blockers

Some users use ad blockers. Options:

1. Accept It — Ad-free subscribers don't care
2. Detect — Show message asking to whitelist
3. Paywall — Offer subscription as alternative

Analytics

Track ad performance:

Metric	Why It Matters
Ad Impressions	Revenue potential
Click Rate	Ad engagement
Revenue per User	Compare to subscription value
Ad-Free Conversions	Subscribers motivated by ads

Next Steps

• General Settings for global options
• Subscription Plans for ad-free tiers
• Shortcodes Reference for ad shortcode details