Introduction
Integrating your site is the essential first step to unlocking Ezoic’s AI-driven optimization, performance tools, and premium ad demand. Ezoic offers multiple methods to connect your site so you can choose the approach that best fits your technical environment. In addition to JavaScript, WordPress, and Cloud (Name Server or Cloudflare) integrations, Ezoic now provides official, open‑source SDKs for React, Vue, and Angular that simplify integration for single‑page applications.
Steps
JavaScript Integration (Recommended)
JavaScript integration involves placing Ezoic scripts on your site. It is highly compatible with many hosts and CMSs and gives you granular control over ad execution.
Best For: Most sites, including those on specialized hosts or those who want granular control over ad execution without changing DNS settings.
- How it works: Add your Ezoic Header Script and Privacy Script into your site's "<head>" so the Ezoic scripts load for visitors.
- Ad Location Code: Insert ad location placeholders into the body of your pages where you want ads to appear.
- Key Advantage: No DNS or name server changes are required, making it a fast and straightforward path to monetization.
- Setup: View the full JavaScript Integration Guide for implementation details.
WordPress Plugin (JavaScript via Plugin)
Best For: WordPress users who prefer an automated setup without manually editing theme files.
The Ezoic WordPress plugin delivers the JavaScript integration for you so you do not need to paste scripts into your theme.
- Process: Install the Ezoic plugin from the WordPress repository and enable the JavaScript Integration option.
- Ad Placements: Use the plugin's Ad Placements tab to choose where to insert ad location codes without editing site files.
- Advantage: The plugin can manage tasks like script insertion and ads.txt updates from your WordPress dashboard.
- Setup: View the full WordPress JavaScript Integration Guide for implementation details.
Framework SDKs (React, Vue, Angular)
Overview: Ezoic has open‑sourced official SDKs for React, Vue, and Angular under the MIT license. These SDKs are designed for single‑page applications and other sites built with modern frameworks.
Best For: Publishers using React, Vue, or Angular who want built‑in support for ads and SPA routing.
- Install the appropriate Ezoic SDK package for your framework.
- Wrap your application with the provided EzoicProvider component so the SDK can manage ads, routing, and consent across your app.
- Configure ad placements and consent options through the SDK as needed. The SDKs include support for display, rewarded, and video ads, SPA routing, and CMP consent handling.
- Test locally and then deploy. Verify ad rendering and consent behavior in your staging and production environments.
The SDKs simplify integration for framework‑based sites while providing the same ad types and consent handling you get with other Ezoic methods.
Cloud Integration (Name Servers or Cloudflare)
Best For: Publishers seeking server‑level optimization and Ezoic’s CDN.
Cloud integration places Ezoic as an optimization layer between your host and visitors to provide SSL, edge caching, and other server‑level benefits.
Important: While Cloud integration offers powerful performance benefits, JavaScript integration (or the new framework SDKs for SPA sites) is still recommended to ensure the most stable and compatible ad delivery.
Name Server Integration - Steps:
- Log into your Ezoic account and choose the Name Server option under Integrate Your Site or Settings > Connection > Integration.
- Ezoic will display two custom name servers. Keep that tab open.
- In a separate tab, log into your domain registrar and open the DNS or Name Server settings for your domain.
- Replace your existing name servers with the two Ezoic name servers shown in your Ezoic dashboard and save the change.
- Return to Ezoic. After your registrar publishes the new name servers and DNS propagation completes, the integration status will update. Propagation can take from a few minutes up to 24 hours depending on your registrar and TTL settings.
Cloudflare Integration - Steps:
- Ensure you have an active Cloudflare account and that your name servers are pointed to Cloudflare.
- In Ezoic, select the Cloudflare option under Integrate Your Site or Settings > Connection > Integration.
- Click to create the Cloudflare API token. Cloudflare will open with pre‑filled permissions that Ezoic requires (DNS, zone settings, SSL, cache purge, and page rules).
- Review and create the token. Copy the token (it is shown only once), paste it into the Cloudflare API Token field in Ezoic, and connect Cloudflare.
If you have Authenticated Origin Pulls enabled on your Cloudflare zone, disable it before connecting or the integration will fail. You can revoke the Cloudflare token from your Cloudflare account at any time.
FAQs
Does Ezoic replace my web host?
No. Ezoic is an optimization and monetization layer. Regardless of your integration method, your original host remains where your website content and files are stored.
How long does integration take to show as "Complete"?
The Ezoic dashboard status usually updates shortly after integration is detected. For Cloud integration, propagation (the time it takes the internet to recognize DNS changes) can take up to 24 hours.
Will integration take my site offline?
No. All methods are designed to be seamless. If you choose Cloud integration, ensure your DNS records in the Ezoic dashboard match your host's records exactly to ensure traffic routes correctly.
Can I switch methods?
Yes. You can move between integration methods. For example, you can switch from the WordPress plugin to a manual JavaScript integration, adopt one of the new framework SDKs for React/Vue/Angular, or move from Cloud to JavaScript. If switching from Cloud to JavaScript, make sure you have a valid SSL certificate at your host before changing DNS settings.
Are there official SDKs for React, Vue, and Angular?
Yes. Ezoic provides official, open‑source SDKs for React, Vue, and Angular licensed under the MIT license. These SDKs let you install a package, wrap your app in an EzoicProvider, and get support for display, rewarded, and video ads along with SPA routing and CMP consent handling built in.
