=== AdVajra - Ad Manager, Ad Inserter & AdSense Plugin ===
Contributors: rahulmanek
Tags: ads, ad manager, monetization, adsense, banner
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The modern WordPress ad manager. Insert ads, manage placements, track performance, and monetize your site - one plugin, zero bloat.

== Description ==

AdVajra is a modern WordPress ad manager built for site owners who want to create ads, place banners, control targeting, and review performance without editing theme files or wrestling with outdated ad plugin interfaces. Whether you monetize with Google AdSense, affiliate networks, or direct sponsors, AdVajra gives you one clean system to manage it all.

Stop using multiple plugins. Run your entire ad setup from one place.

► **[Learn more about AdVajra - The Best WordPress Ad Manager](https://advajra.com/?utm_source=wordpress-org&utm_medium=readme&utm_campaign=description-link)**

Whether you run banner ads, affiliate ads, house ads, sponsor placements, or internal promotions, AdVajra helps you launch cleaner campaigns, control who sees them, and manage ad placement inside WordPress with less friction. Beyond raw reports, AdVajra also helps you spot placement issues, review ad controls, and surface optimization opportunities from your data.

= Why AdVajra =

Most WordPress ad plugins only help you insert ads. **[AdVajra Ad Manager](https://advajra.com/?utm_source=wordpress-org&utm_medium=readme&utm_campaign=why-advajra)** helps you **manage, control, and monetize your entire ad operation**.

✔ No scattered tools — one ad manager for everything
✔ No messy workflows — create, place, and track in minutes
✔ No outdated interfaces — built on React for a fast, modern dashboard

Just one system built for real ad management and real monetization.

= Built for Real Ad Management =

✔ Manage banner ads, affiliate ads, and custom ad code from any network
✔ Insert ads and control ad placement across your entire WordPress site
✔ Track impressions, clicks, and ad performance in real time
✔ Optimize ad delivery and grow your ad revenue
✔ Monetize with Google AdSense, Google Ad Manager, Amazon, Media.net, or any ad network
✔ Replace multiple ad plugins with one complete solution

AdVajra is designed around the problems WordPress site owners actually face when trying to manage advertising well:

* You need a WordPress ad manager that feels modern instead of bloated or outdated.
* You want to place ads in real site positions without touching theme templates every time.
* You want better control over placements, targeting, and delivery from one screen.
* You want an ad manager plugin that can handle banner ads, affiliate ads, and promo blocks cleanly.
* You want impression and click tracking without stitching together multiple plugins and scripts.
* You want basic protection against low-quality traffic, bots, and unwanted visitors.
* You want a cleaner ad placement workflow that saves time as your site grows.
* You want actionable analytics, placement health signals, and optimization guidance instead of raw numbers alone.

== Core Features ==

= Ad Management =

* Create and manage unlimited ads in a clean React-powered WordPress dashboard.
* Build ad creatives for banner ads, affiliate promotions, house ads, sponsored placements, and custom ad code.
* Organize creatives using ad groups and rotation.
* Duplicate, edit, and manage ads from one modern ad manager workflow.

= Placements =

* Insert ads before content, after content, header, footer, or anywhere on your site.
* Control ad placement without editing theme files — no code required.
* Insert ads with placements, widgets, Gutenberg blocks, and shortcodes.
* Preview placements on the real frontend before going live.
* Works with any page builder including Elementor, Divi, and WPBakery.
* Perfect ad placement and ad insertion plugin for WordPress content and layouts.

= Targeting =

* Target ads by post type, category, user role, and device (desktop, tablet, mobile).
* Show the right ads to the right audience at the right time.
* Improve ad performance and monetization using built-in targeting rules.

= Tracking & Analytics =

* Track impressions and clicks in real time.
* Monitor ad, placement, and tracking health from inside WordPress.
* Use built-in impression and click tracking to understand what is actually performing.

= Optimization Insights =

* Get insights into delivery and performance issues.
* Quickly see where inventory is assigned, underfilled, or disabled.
* Use ad controls and system health states to understand what is on, what needs attention, and what is affecting delivery.
* Improve CTR and revenue with actionable data.
* Built for actionable guidance that helps you decide what to fix next.

= Protection & Privacy =

* Reduce bot traffic impact on analytics.
* Block ads for specific IP addresses.
* Use privacy-aware controls for consent-sensitive environments.
* Manage ads.txt directly inside WordPress with advanced builder.

= Advanced Options =

* Add custom header, body, or footer code — insert Google AdSense verification, analytics scripts, or ad network tags without a separate plugin.
* Debug the entire plugin easily whenever you encounter an issue.
* Import/Export settings and data to copy configurations or run test environments.

= Best Use Cases =

AdVajra is perfect for:

* Bloggers monetizing with Google AdSense or affiliate ads
* Publishers managing banner ads, display inventory, and ad campaigns
* Websites and businesses selling sponsored placements or direct ad deals
* WooCommerce stores placing banner ads and promotions inside product pages
* Content sites inserting ads inside articles, sidebars, and footers
* Niche sites using Amazon Associates, Media.net, or any affiliate network
* Growing websites that need a modern advertising and monetization plugin for WordPress without technical clutter

= Supported Ad Networks =

AdVajra works with every ad network and affiliate program. Paste your ad code and let AdVajra handle placement, targeting, and tracking:

* Google AdSense (display ads, in-article, in-feed, auto ads)
* Google Ad Manager (DFP / DoubleClick for Publishers)
* Amazon Associates and Amazon Native Shopping Ads
* Media.net, Ezoic, Mediavine, Raptive, and Monumetric
* BuySellAds, Infolinks, PropellerAds, and any CPM/CPC network
* Any affiliate network: ShareASale, CJ Affiliate, Impact, Rakuten, Awin, and more
* Custom HTML, CSS, or JavaScript ad code from any source

= What You Can Place =

With AdVajra, you can manage and place:

* Banner ads and display ads
* Affiliate ads and affiliate banners
* Google AdSense ads
* House ads and internal promotions
* Sponsor ads and direct-sold placements
* Custom ad code and embed scripts
* Shortcode-driven placements
* Gutenberg block-based placements
* Widget ads for sidebars and footers
* Manual ad placements for reusable ad slots across your site

= What Makes AdVajra Different =

Most ad plugins are:
❌ Complicated — settings pages from 2010
❌ Outdated — jQuery-heavy, slow admin interfaces
❌ Fragmented — need 3 plugins to do what one should

AdVajra gives you:
✔ One system for ads, placements, analytics, monetization, and control
✔ Modern React-powered dashboard — fast, responsive, and built for 2026
✔ Better visibility into what is performing and what needs fixing
✔ Faster ad operations — create, place, and go live in minutes
✔ Works with every ad network — AdSense, Amazon, Media.net, and beyond


= AdVajra Pro =

Ready to maximize your ad revenue? **[Upgrade to AdVajra PRO](https://advajra.com/pricing?utm_source=wordpress-org&utm_medium=readme&utm_campaign=pro-upsell)**.

AdVajra Pro helps you go beyond basic ad management and actually grow your ad revenue. Get stronger protection, deeper optimization, and advanced performance control to maximize monetization.

Unlock advanced features like:

* Advanced analytics, reporting, and revenue tracking
* Lifetime analytics retention and richer trend visibility
* Ad blocker detection and ad blocker recovery
* Performance optimization — lazy load ads, cache control, defer ad scripts
* Click fraud protection to guard your AdSense and ad network accounts
* Deeper revenue optimization and monetization insights
* Advanced monetization tools for professional publishers

== Installation ==

1. Upload the `advajra` folder to `/wp-content/plugins/` or install via WordPress.
2. Activate the plugin.
3. Open `AdVajra` from admin menu.
4. Create your first ad.
5. Create a placement and assign an ad or ad group to it.
6. Display ads using placements, widgets, blocks, or shortcodes.

= Source Code and Contributions =

Want to explore the full source code, improve AdVajra, or contribute fixes and ideas? The public development repository is available here:

https://github.com/rahulmanek/AdVajra

Developers can review the code, open issues, suggest improvements, and send pull requests there. To build the project locally, install Node.js, run `npm install`, then run `npm run build` from the plugin directory. The build uses `@wordpress/scripts`, webpack, PostCSS, and Tailwind CSS as documented in `package.json`.

== Frequently Asked Questions ==

= How do I place ads in WordPress with AdVajra? =

Create ads, assign them to placements, and display using placements, widgets, blocks, or shortcodes. This lets you manage ad placement inside WordPress without repeatedly editing theme files.

= Can I add ads without editing theme files? =

Yes. AdVajra is designed to reduce theme editing by giving you placement-based insertion, widget support, block support, shortcode support, and in-content placement tools.

= Does AdVajra support shortcodes, widgets, and blocks? =

Yes. AdVajra supports shortcodes, widgets, and blocks, along with placement-driven insertion for common ad locations.

= Can I rotate ads in the same placement? =

Yes. Enable the **Ad Groups & Rotation** module, create an ad group, assign multiple ads to it, then assign the group to a placement. AdVajra rotates through the ads automatically.

= Can I track clicks and impressions? =

Yes. AdVajra includes impression and click tracking plus an analytics dashboard for WordPress ad performance review.

= Does AdVajra only show reports, or does it also help me find issues? =

AdVajra is designed to do more than show raw metrics. It also helps you review placement health, tracking status, ad controls, and optimization opportunities so you can understand what to improve next. Learn more about our **[WordPress Ad Analytics](https://advajra.com/#features?utm_source=wordpress-org&utm_medium=readme&utm_campaign=faq-analytics)**.

= Can I manage ads.txt inside WordPress? =

Yes. AdVajra includes a built-in ads.txt manager so you can update and manage your ads.txt file from the plugin.

= Does AdVajra work for affiliate banners, sponsor ads, and internal promotions? =

Yes. AdVajra is suitable for affiliate banners, sponsor placements, house ads, internal promotions, and other custom advertising workflows in WordPress.

= Does AdVajra include targeting? =

Yes. You can target ads by post type, category, user role, and device.

= Will AdVajra slow down my site? =

No. AdVajra is built on a modular architecture, it only loads the code for features you have enabled. The tracking script is lightweight and deferred. The React dashboard only loads in wp-admin, never on the frontend.

= Does AdVajra work with AdSense, Ezoic, Mediavine, or Raptive? =

Yes. AdVajra is ad-network-agnostic. You paste your ad network's HTML/JS code into the ad creative field and AdVajra handles placement, targeting, and tracking. It works with Google AdSense, Google Ad Manager (DFP), Amazon Associates, Media.net, Ezoic, Mediavine, Raptive, Monumetric, BuySellAds, Infolinks, and any network that provides an embed code.

= Does AdVajra work with WooCommerce? =

Yes. You can insert ads on WooCommerce product pages, shop pages, and category pages using AdVajra placements and targeting rules. Use it to place banner ads, affiliate promotions, or cross-sell blocks inside your store.

= Does AdVajra work with page builders like Elementor? =

Yes. AdVajra works with any page builder that supports shortcodes or widgets, including Elementor, Divi, WPBakery, Beaver Builder, and SiteOrigin. You can also use the AdVajra Gutenberg block in the WordPress block editor.

= Does AdVajra work with caching plugins? =

Yes. AdVajra is designed to work with caching plugins. The frontend ad delivery is lightweight and compatible with popular caching solutions like WP Super Cache, W3 Total Cache, WP Rocket, LiteSpeed Cache, and others.

= Is AdVajra GDPR compliant? =

AdVajra does not store personal visitor data or set cookies on its own. The plugin includes privacy-aware controls so you can manage consent-sensitive ad environments. For GDPR, CCPA, or cookie consent requirements, AdVajra works alongside popular consent plugins to ensure your ads comply with privacy regulations.

= Does AdVajra support Google Ad Manager (DFP)? =

Yes. You can paste your Google Ad Manager (formerly DoubleClick for Publishers) ad tags into AdVajra and use placements, targeting, and tracking just like any other ad code.

= Is AdVajra compatible with PHP 8? =

Yes. AdVajra is fully compatible with PHP 8.0, 8.1, 8.2, 8.3, and 8.4. The plugin is actively tested on modern PHP environments.

= What does AdVajra Pro unlock? =

AdVajra Pro adds advanced analytics, longer history, deeper optimization tools, click fraud protection, ad blocker detection and recovery, performance features like lazy loading ads and cache busting, and more advanced premium monetization workflows.

== Screenshots ==

1. Modern WordPress ad manager dashboard — manage ads, placements, analytics, and monetization settings from one clean interface.
2. Create and edit WordPress ads — banner ads, AdSense ads, affiliate promotions — with layout, destination, tracking, and display controls.
3. Insert ads into header, footer, content, widgets, Gutenberg blocks, and shortcodes without editing theme files.
4. Rotate multiple banner ads or affiliate creatives in one placement using ad groups and ad rotation.
5. WordPress ad analytics dashboard — track impressions, clicks, CTR, placement health, and optimization opportunities.
6. Ad protection and privacy settings — bot blocking, IP filtering, GDPR-aware controls, ads.txt management, and delivery configuration.

== Changelog ==

= 1.1.1 =

- improvement: REST API error handling to resolve site configuration conflicts faster
- improvement: ads.txt filesystem compatibility
- improvement: ads.txt handling for subfolder installations

= 1.1.0 =

- feature: Added unsaved changes warning to prevent data loss.
- improvement: Optimized tracking scripts for a faster dashboard.

= 1.0.0 =

- Initial public release of AdVajra.
