chevron_right
chevron_right
Ezoic WordPress Plugin JavaScript Integration Guide
How-To/Instructional

Ezoic WordPress Plugin JavaScript Integration Guide

Last Updated a few days ago
Article Navigation
Introduction
Instructions
Contact Information for Further Assistance

Introduction

If you are an existing publisher who has been live with Ezoic for 30+ days, you can quickly set up your site using the default best practices by simply enabling JavaScript integration through the WordPress plugin. This will automatically insert Ezoic placeholders across your site based on proven default configurations. The system will relearn and optimize within 2–3 weeks, potentially delivering even better results. So if you'd prefer not to manually match placeholder IDs, please skip step 3 below.

This guide otherwise helps existing Ezoic publishers migrate to the updated WordPress plugin with JavaScript integration while also retaining top-performing placeholders and avoiding revenue disruption.

 

Instructions


Step 1: Install or Update the Ezoic Plugin

  1. In your WordPress dashboard, go to Plugins > Add New

  2. Search for "Ezoic"

  3. Click Install and then Activate

  4. If you already have the plugin installed, ensure it is updated to the latest version


Step 2: Enable JavaScript Integration

  1. Navigate to Settings > Ezoic > Dashboard tab or the Integration tab

  2. Click "Enable JavaScript Integration" or "Turn On JavaScript Integration"

    • This will inject Ezoic's JavaScript into your site header

    • No manual code or DNS changes are needed

Then check each of the below options:



Step 3: Migrate Placeholder IDs

The plugin creates default WordPress-generated placeholders, but these may not match your top-performing units. Ezoic's AI uses historical data to set dynamic bid floors, so retaining the original placeholder IDs is critical to maintaining revenue.

  1. Open this Big Data Analytics (BDA) report to find:

    • Your best-performing placeholders by location type

    • The correct placeholder ID to use for each ad location, based on the highest revenue or RPM recorded for that type

  2. Only include the highest-performing placeholder for each location type (e.g., if multiple 'under first paragraph' ads exist, use the one with the best RPM). If no data exists for a particular location type on your site, retain the default placeholder ID provided in the Ad Placements section of the plugin.

    Open and make a copy of the Placeholder Mapping Worksheet to document your placeholder selections and organize which IDs will be inserted in the WordPress plugin.

  3. Go to Settings > Ezoic > Ad Placements > Settings > Advanced in WordPress

    • Check 'Enable Placement ID selection', then 'Save Changes'
  4. Go to Settings > Ezoic > Ad Placements in WordPress

    • Locate the matching ad location (e.g., "Under Page Title")
    • Update the placeholder ID to match the one shown in the BDA worksheet



Step 4: Confirm Ads.txt Is Set Up

  1. In WordPress, go to Settings > Ezoic > Ads.txt Setup tab

  2. Enable Automatic Ads.txt Management

If needed, reference this setup guide:
How to Setup Your Ads.txt File



Step 5: Update Your Privacy Policy

To comply with ad partner requirements and maintain transparency with visitors, you must update your site's privacy policy to reflect your relationship with Ezoic.

  • Go to the Privacy section of your Ezoic Dashboard

  • Ensure your Privacy Policy is up to date and compliant. 



Step 6: Finalize Integration by Removing Cloud Integration

Note: This step is not applicable to sites switching from WordPress integration.

Before removing Cloud integration, confirm whether your site currently uses Ezoic's SSL certificate. If your SSL is being managed through Ezoic:

  • You must first install a valid SSL certificate through your origin host or CDN (e.g., Let's Encrypt, Cloudflare, or your web host)

  • Ensure HTTPS continues to function properly before deactivating Ezoic's SSL or switching DNS

Failing to set up an SSL certificate outside of Ezoic may cause your site to go offline or show security warnings.

After verifying that the placeholders are showing up and performing correctly:

If you used Cloudflare through Ezoic:

  • Go to Ezoic Dashboard > Settings > Site Integration

  • Click "Remove Cloudflare"

If you used name server integration:

  • Log into your domain registrar

  • Repoint the name servers back to your host (or original DNS provider)

This completes your transition to plugin integration.

Contact Information for Further Assistance

If you need further assistance with JS integration through the WordPress plugin, please log in via https://support.ezoic.com/ to make use of our dedicated resources for support. We're here to help!

× Enlarged Image

Loading ...