How-To/Instructional

Using Ezoic’s AI-Assisted Rewarded Ads Setup Tool

Last Updated a few days ago

Introduction

Ezoic’s Rewarded Ads system allows publishers to offer users valuable perks—such as premium content access, downloadable resources, or additional engagement features—in exchange for watching an ad.

The new AI-Assisted Setup Tool makes implementing rewarded ads significantly easier by automatically generating page-specific or generic code based on your site’s structure and your desired reward behavior.

This guide walks you through the full setup process, explains each step in the tool, and shows how to manage your generated scripts using the Script Library.

What Are Rewarded Ads?Rewarded ads are voluntary, user-initiated video or interactive ads. When a user chooses to watch the ad to completion, they receive a benefit—such as unlocked content, a download, or an on-page action.

Common Examples

Unlocking premium articles or blog posts
Accessing downloadable files (PDFs, templates, etc.)
Revealing quiz results or poll outcomes
Watching exclusive videos or content

Benefits for Publishers

Higher engagement rates
Increased revenue with premium rewarded-ad CPMs
Better user retention and satisfaction
Flexible implementation that works with many content strategies

Benefits for Users

Full control over whether they choose to watch a rewarded ad
Clear and immediate value upon completion
Non-intrusive experience that never interrupts their reading or browsing

Getting Started With AI-Assisted Setup

Before You Begin

You must comply with Google's rewarded ad policies. Rewarded ads require clear disclosure to users that they need to watch an ad to continue. Learn more at: Google Ad Manager Rewarded Ads Policies

The Rewarded Ads Dashboard

Click on the EzoicAds tile then the Rewarded Ads subtab
There are 4 categories:

Overview
Examples – These are real, applicable examples to implement rewarded ads.
Settings – This is where the Automatic Content Lock is available. It’s off by default but can be enabled using the toggle. You can also upload your logo image and incorporate your brand colors by inputting the hex codes, so all styling of the rewarded ad implementation match the look and feel of your website.
AI Setup Tools – You’ll go here to get started using the tool.

The AI Assisted Setup (Beta) tool guides you through five simple steps:

URL Submission
Implementation Preferences
Disclosure Options
Settings
Code Generation

Below is an overview of each stage and how to use it.

1. Enter the Page URL

Upload the URL where you want rewarded ads implemented.You can choose between:

Page-Specific Code

Code tailored to the structure and elements of the specific page you entered
Best for complex or unique layouts

Generic Code

Code that works broadly across similar page templates
Best for blogs, article pages, or template-based designs

After selecting an option, click Next. The system will analyze your page and detect what type of content it contains.

2. Describe Your Reward Behavior

The AI needs to understand what you want to lock or reward. You have two options:

Option A: Use AI Recommendations (Easier)

The AI analyzes your page’s structure (if page-specific) and your requirements to create:

Suggested implementation patterns
Recommended triggers
Auto-formatted code snippets

You may adjust inputs and regenerate if needed.

Steps:

Click "Generate Recommendations."
Wait while the AI analyzes your page. This will take a few moments.
Review the suggested implementations.
Click on any recommendation to auto-fill the form below.

Option B: Fill Out Manually

You’ll enter:

1. A description of the feature you're implementingExamples:

“Unlock article content after the user completes a rewarded ad.”
“Gate a downloadable PDF behind a rewarded ad.”
“Trigger a rewarded ad after the 3rd click on the ‘hint’ button.”

2. What triggers the ad?

Button or link click: User clicks a specific button
Provide button details or HTML code
Scroll position: User scrolls to a certain point
"User scrolls to the 4th paragraph"
Custom/other triggers
"After 3rd click on hint button"

3. What should happen after the ad is completed?Examples:

Unlock content
Show a hidden video
Allow downloading a file
Enable a progression element (e.g., quiz question or game move)

4. What should happen if the user declines or skips?Examples:

Keep content locked
Show alternative content
Allow partial access
Show limited preview only

5. Any visual customizations?Optional instructions such as:

“Blur paragraphs 4–8 until the ad is completed.”
“Dim background when overlay appears.”

Click Next to generate recommendations or continue customizing.

3. Disclosures

Rewarded ads must follow Google and Ezoic user experience policies. You must inform users they need to watch an ad. The tool will guide you through settings such as:

Whether you want an overlay or inline ad request
Reward messaging & user disclosures
Fallback behavior when no ad is available

Option A: Use Ezoic's Disclosure Modal

Ezoic automatically shows a professional popup asking users to watch an ad.

Customize the popup text:

Header: Title text (e.g., "Watch Ad to Continue?")
Body: Message lines (each line on new row)

Example: "Support our site by watching a short ad"
Example: "Access premium content for free"

Accept Button: Button text (e.g., "Watch ad")
Cancel Button: Button text (e.g., "Cancel")

Optional - Global Settings (applies to all pages):

Upload Logo: Add your site logo (recommended: 500x100 pixels)
Button Colors: Customize accept button background and text colors
Click "Save Global Settings" when done

Option 2: Add Custom Disclosure

Write instructions for adding your own disclosure message to your site.

Your instructions must include:

Where to place the disclosure (e.g., "above the download button")
What action to take (e.g., "add text", "create button")
The exact message

Good Example:

"Add text below the 'Download' button that says 'Watch ad to unlock your download'. Style it in red (#ff0000) and make it bold."

Bad Example (too vague):

"Watch ad to unlock content" This example is missing a location and styling details.

Which option makes the most sense for your site? Please consider the information below:

4. Settings

Reward Name

Give your implementation a descriptive name
Example: "Premium Content Access"
Used for analytics and tracking. This is important because this is how you’ll be able to track performance in Ezoic's Big Data Analytics.

Reward On No Fill (Toggle)

Turn ON to grant the reward when an ad doesn't load
If the ad loads, the user must still watch the ad to receive reward. Turning this setting on prevents frustration from technical issues.

Disable Vignette Ads (Toggle - appears if using button trigger)

Prevents other popup ads when a user clicks the rewarded ad button. Recommended: Keep this on for better user experience

Note that having this enabled will not impact any other click etc., on that page

5. Generate Your Script

Click Generate, and the tool will create your final JavaScript implementation. This script is then added directly to your Script Library, where you can:

Preview/edit the code
Activate it through Page Rules
Duplicate or deactivate versions
Manage multiple rewarded-ad implementations across your site

6. Test the Code

Open the provided test URL in your browser

The code is automatically added for testing

Test the rewarded ad functionality

Try triggering the ad
Watch the ad through to completion
Verify the reward is granted correctly

7. Save Your Work

Click "Save to Library"
Enter a descriptive name (e.g., "Gaming Site Rewarded Ads v1.0")
Add description/notes (optional)
After the script is saved, there is an option to “Activate” the script based on the Code Generation Options selected in Step 1.

Activate on Page: Apply only to the specific page you tested
Activate Sitewide: Apply across your entire website

Download Code:

Click "Download Code" to get:

HTML File: Complete code, ready to paste into your website
JavaScript File: Clean JS code for external files

Managing Rewarded Ad Scripts in the Script Library

The Script Library is where all AI-generated or manually added rewarded-ad scripts are stored.

Key actions you can take:

Activate or Deactivate ScriptsUse Manage Script → Activate / Deactivate to control which scripts run on your site.

Edit Your ScriptEvery script is fully editable. You can modify:

Trigger logic
Reward behavior
Custom visual effects
Logging/debugging options

Click "Update or Troubleshoot" to:

Regenerate Code: Modify your settings and create new code
Troubleshoot: Report issues and get improved code using one of the following options below

Describe behavioral problems (what happens vs. what should happen)
Report visual issues (what looks wrong)
Report performance issues (what feels slow)

Assign Activation RulesClick Page Rules to define conditions such as:

Specific URLs
URL patterns
Page types

Duplicate or Delete ScriptsUseful for testing variants or cleaning up your library.

Extras:

The A/B testing tab is where you can test a single script on a certain percentage of traffic (e.g. 50% vs 50% split). Note that you can run multiple tests, but one script cannot be tested across multiple tests.
You can access Rewarded Ad general performance as well as the A/B test groups in BDA > Rewarded Ads

Rewarded Ads Policies & Requirements

Allowed Rewards

Extra lives, hints, in-game currency
Access to premium content
Non-transferable platform-only discounts up to 25%
Free trials or feature unlocks

Prohibited Rewards

Cash or cash-equivalent rewards
Gift cards
Discounts exceeding 25%
Transferable/monetary items

Randomized Reward RulesIf using randomized rewards (loot-box-like):

Odds must be disclosed
Rewards must be accessible
Odds must be greater than 0

Best Practices for Success

User Experience

Clearly communicate what the reward unlocks
Make rewards valuable
Provide fallbacks when ads fail to load
Respect user choice
Use Ezoic's disclosure modal for compliance

Technical Optimization

Test across devices and browsers
Ensure fast ad loading
Use clear error handling

Content Strategy

Integrate rewarded ads naturally
Use sparingly for maximum value
Experiment with trigger placement

Monitoring PerformanceUse the Rewarded Ads Report in your dashboard to track:

Ad completions
User engagement
Revenue performance
Reward effectiveness

This helps you refine your strategy over time.

Common Use Cases

Example 1: Gated Blog Article

Trigger: User scrolls to 3rd paragraph
Success: Unlock rest of article
Failure: Keep content blurred
Disclosure: Ezoic modal with custom message

Example 2: Download Gate

Trigger: Click "Download" button
Success: Start file download
Failure: Show "Please watch ad to continue" message
Disclosure: Text above button: "Watch ad to unlock download"

Example 3: Quiz Results

Trigger: Click "Reveal Results" button
Success: Display quiz score and answers
Failure: Keep results hidden
Disclosure: Change button text to "Watch Ad to See Results"

Conclusion

Ezoic’s AI Assisted Setup Tool streamlines the entire rewarded-ads implementation process—from generating page-specific scripts to deploying them across selected parts of your site. With a few inputs, the tool produces clean, optimized, policy-compliant code that you can manage and customize in your Script Library.

Troubleshooting

Code not working?

Use the Troubleshoot feature to describe the issue
Be specific: "When I click X, Y happens instead of Z"
Let AI generate improved code

Need to change disclosure?

Go back to Step 4 and update your settings
Regenerate the code

Want to apply to multiple pages?

Use "Generic" code generation in Step 1
Or create separate implementations for each page

Contact Information for Further Assistance

If you need further assistance with the AI-Assisted Rewarded Ads Setup Tool, please log in via https://support.ezoic.com/ to make use of our dedicated resources for support. We're here to help!

Was this article helpful?