=== WordPress Ad Manager & AdSense Ads - Ad Inserter ===

Contributors: spacetime
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=LHGZEMRTR7WB4
Tags: ads, adsense, ad rotation, ad manager, amp, amazon, ad blocking detection, header code, banners, adverts, sticky fixed widgets, dfp, DoubleClick for publishers
Requires at least: 4.0
Tested up to: 5.1
Requires PHP: 5.6
Stable tag: 2.4.13
License: GPLv3

Manage ads: Google AdSense ads, Amazon banners, ad rotation, sticky widget ads, AMP ads, DFP ads, PHP, tracking, AdSense header and footer code

== Description ==

Ad management plugin with many advanced advertising features to insert ads at optimal positions.

Supports all kinds of ads including **Google AdSense ads**, **Google Ad Manager** (DFP - DoubleClick for publishers) ads, contextual **Amazon Native Shopping Ads**, **Media.net ads** and **rotating banners.**

This plugin is more than AdSense plugin or plugin for ads. It provides many advanced options to insert opt-in forms, header scripts, AMP ads, Javascript, CSS, HTML, PHP, analytics, tracking or advert code anywhere on the page.

**Ad Inserter can insert ads where other plugins fail**.
It's all about the [settings](https://adinserter.pro/documentation).

Average Rating: 5 out of 5 stars - check <a href="https://wordpress.org/support/plugin/ad-inserter/reviews/">Ad Inserter reviews</a>

> One of the best adsense plugins [...](https://wordpress.org/support/topic/one-of-the-best-adsense-plugins/)
> Most comprehensive Ad plugin available [...](https://wordpress.org/support/topic/most-comprehensive-ad-plugin-available/)
> Better than the old Google adsense plugin [...](https://wordpress.org/support/topic/better-than-the-old-google-adsense-plugin/)
> The best WP Ad management plugin [...](https://wordpress.org/support/topic/the-best-wp-ad-management-plugin/)
> Very flexible and excellent documentation [...](https://wordpress.org/support/topic/very-flexible-and-excellent-documentation/)
> Excellent Ad Plugin [...](https://wordpress.org/support/topic/excellent-ad-plugin-2/)
> Easy to use and also does more than I need [...](https://wordpress.org/support/topic/easy-to-use-and-also-does-more-than-i-need/)
> Exactly what I needed to sell advertising spots [...](https://wordpress.org/support/topic/exactly-what-i-needed-to-sell-advertising-spots-on-our-site/)
> Awesome Plugin and Super Support! [...](https://wordpress.org/support/topic/awesome-plugin-and-super-support/)
> Lots of options and easy to use [...](https://wordpress.org/support/topic/lots-of-options-and-easy-to-use/)
> Crazy flexible [...](https://wordpress.org/support/topic/crazy-flexible/)
> Great plugin that makes it simple [...](https://wordpress.org/support/topic/great-plugin-that-makes-it-simple/)
> Superb Plugin and Support team also so good [...](https://wordpress.org/support/topic/superb-plugin-and-support-team-also-so-good/)
> Best in same kind of plugins [...](https://wordpress.org/support/topic/best-in-same-kind-of-plugins/)
> Must Have Plugin for Each WP Site [...](https://wordpress.org/support/topic/must-have-plugin-for-each-wp-site/)
> Best Ad Placement Plugin [...](https://wordpress.org/support/topic/best-ad-placement-plugin/)
> Best Solution for Advertisement Management [...](https://wordpress.org/support/topic/best-solution-for-advertisement-management/)
> Comprehensive, flexible and well supported [...](https://wordpress.org/support/topic/comprehensive-flexible-and-well-supported/)
> God bless these guys! [...](https://wordpress.org/support/topic/god-bless-these-guys-2/)
> PRO for Free [...](https://wordpress.org/support/topic/pro-for-free/)

Looking for AdSense plugin with simple setup for ads at best positions? A plugin for Amazon ads and Google Analytics code in the header?

**Features** - check [documentation](https://adinserter.pro/documentation/features) for the complete list

*   Enable [AdSense integration](https://adinserter.pro/documentation/adsense-ads) and get powerful AdSense plugin
*   Support for [Google Ad Manager](https://adinserter.pro/documentation/ad-manager-ads) (DoubleClick for publishers) ads
*   Syntax highlighting [editor](https://adinserter.pro/documentation/code-editing)
*   Code preview with visual CSS editor
*   Automatically inserts ads on posts and pages
*   Insert ads before or after post
*   Insert ads before or after content
*   Insert ads before or after paragraph
*   Insert ads before or after random paragraph
*   Insert ads before or after multiple paragraphs
*   Insert ads before or after image
*   Insert ads before or after comments
*   Insert ads before or after excerpt
*   Insert ads near any element on the page (using CSS selectors)
*   Insert ads above the header (after `<body>` tag)
*   Insert ads in the footer (before `</body>` tag)
*   Insert ads at relative positions in posts
*   Insert ads between posts on blog pages (in-feed AdSense ads)
*   Insert ads between excerpts on blog pages
*   Insert ads between comments
*   Insert ads at custom hook positions (`do_action ()` WP function)
*   Insert ads before or after any HTML element using CSS selectors
*   Visual HTML element selector (DOM explorer)
*   Avoid inserting ads near images or headers (AdSense TOS)
*   Disable ads on individual posts or pages
*   Insert header (`<head>` section) and footer code
*   Insert raw HTTP response header lines
*   Insert Google Analytics, Matomo (Piwik) or any other tracking code
*   Insert images, HTML, CSS, Javascript or PHP code
*   Code generator for banners and placeholders
*   Code generator for AdSense ads
*   Visual advert editor - create ads from scratch
*   Manual insertion: widgets, shortcodes, PHP function call
*   Sticky (fixed) widgets (sticky sidebar - the sidebar does not move when the page is scrolled)
*   Custom alignments and styles for ads
*   Insert ads (different ad code) on AMP pages
*   Custom CSS class name for wrapping divs to avoid ad blockers
*   Use shortcodes from other plugins
*   Use custom fields as defined in posts
*   Use post title, tags or category names to create contextual ads
*   PHP code processing
*   Ad labels - show customized label above ads
*   ads.txt editor
*   Ad rotation (server-side and client-side - works with caching)
*   Timed ad rotation - define times to rotate ads in a single ad block
*   Create rich media ads with standard WordPress TinyMCE editor
*   Ad blocking detection - popup message, page redirection
*   Desktop/mobile device detection (server-side and client-side - works with caching)
*   [Blacklist/Whitelist](https://adinserter.pro/documentation/black-and-white-lists) categories, tags, taxonomies, post IDs, urls, url query parameters, cookies, referrers
*   Easy copying and pasting ads or settings using internal clipboard
*   Simple troubleshooting with many debugging functions
*   Function to visualize inserted blocks and ads
*   Function to visualize AdSense ads with ad names and IDs
*   Function to visualize available insertion positions
*   Function to visualize HTML tags
*   You name it :)

[Ad Inserter review](https://wpmayor.com/ad-inserter-review-the-best-wordpress-ad-management-plugin/) on WP Mayor

> The Best WordPress Ad Management Plugin?

[Ad Inserter review](https://www.shoutmeloud.com/ad-inserter-review.html) on ShoutMeLoud

> Both Google and Amazon recommend this plugin for inserting ads, which is a testament to its quality

**Endorsed by Google**

Google lists Ad Inserter plugin as possible solution to place code for AdSense ads into your WordPress site.

Ad Inserter is a perfect plugin to place code for Google AdSense ads at top positions for optimal monetization of your website: ordinary AdSense ads (ad units), AMP ads, Auto ads (page level ads), In-feed ads, in-article ads, responsive ads, AdSense ads that need page-specific header code, etc.

> If you're new to AdSense, one of your first tasks is to connect your site to AdSense. This requires you to copy the code on your AdSense homepage and paste it into the HTML of your page, between the `<head>` and `</head>` tags.

Check [How to insert ad code in your WordPress site](https://support.google.com/adsense/answer/7527509). Advanced users can enable [AdSense integration](https://adinserter.pro/documentation/adsense-ads#integration): import AdSense ads from the plugin settings page - no need to copy codes for AdSense ads from the AdSense admin pages. List ad units, preview AdSense ads and get ad codes where you need them.

**Endorsed by Amazon**

Amazon suggests to use Ad Inserter to add Native Shopping Ads to Wordpress posts.

> Native Shopping Ads provide highly relevant and dynamic product recommendations in a stylishly designed and responsive ad unit that can be placed at the end or within your content to create a more compelling visitor experience and shopping opportunity.

Check <a href="https://affiliate-program.amazon.com/help/topic/t405" target="_blank">Wordpress Integration Guide for Native Shopping Ads</a>. Ad Inserter supports also advanced contextual ads: check settings for <a href="https://adinserter.pro/documentation/common-settings#amazon">contextual Native Shopping Ads</a> that show ads with items related to the post content (using post tags).

If you need statistics for ads and metrics for impressions and clicks, A/B testing, lazy loading ads, sticky ads, slider ads, pop-up ads, geotargeting or geolocation to serve country-specific ads, functions to protect content from users using ad blockers, functions to serve different ads for users using ad blockers, multisite options to limit settings for ads, to block some IP addresses, to schedule ads, there is **Ad Inserter Pro** - all-in-one WordPress ad management plugin with many [advanced features](https://adinserter.pro/documentation/features):

*   Geolocation using Webnet77 or [MaxMind](http://www.maxmind.com/) databases (works also with caching)
*   Country, state, region and city level geotargeting
*   Blacklist/Whitelist IP addresses or countries/cities (works also with caching)
*   Ad impression and click statistics (works also with `<iframe>` Javascript ads like Google AdSense)
*   Statistics reports for clients in PDF format or public web pages
*   External tracking via Google Analytics or Matomo (Piwik)
*   A/B testing - discover ads and settings that perform best
*   Lazy loading ads (works with AdSense ads)
*   [Sticky ads](https://adinserter.pro/documentation/alignments-and-styles#sticky-ads) with optional close button
*   Sticky sidebar ads (stick to the screen or to the content)
*   Floating slide-in banner ads
*   [Sticky (floating) ads](https://adinserter.pro/documentation/alignments-and-styles#sticky-ads) with animations (fade, slide, turn, flip, zoom)
*   Animation trigger for sticky ads (page scroll in % or px, HTML element becomes visible)
*   Support for sticky ad bar
*   Support to schedule ads with fallback option
*   Support for ads in iframes
*   Ad blocking detection - replace ads, protect content
*   Ad blocking statistics
*   Multisite options to limit settings on the sites
*   Individual post/page exception management
*   Export and import of settings
*   No ads on the settings page
*   Support via email

Run a WordPress related blog? Have experience with AdSense ads? Interested in reviewing Ad Inserter Pro or would like to become Ad Inserter Pro affiliate? [Introduce yourself](https://adinserter.pro/contact).

Have experience with WordPress theme or plugin translation? We are looking for translators! [Contact us](https://adinserter.pro/contact).

Ad Inserter WordPress plugin is an advanced advertising manager for all kinds of ads - it has many features and options to automate placing ads in order to optimally monetize your website on desktop, tablet and phone displays. It provides many simple ways to insert any kind of ads, Javascript, HTML, PHP or advert code anywhere on the page. For best placement of ads please read the user manual to get the most of the plugin.

Check [Ad Inserter documentation pages](https://adinserter.pro/documentation) for detailed description of all the features and some [common settings](https://adinserter.pro/documentation/common-settings) for quick start.

You can also use shortcodes from other plugins (for example, to insert ads from other ad plugins like AdRotate, Advanced Ads, Quick Adsense, AdSense Plugin WP QUADS, Insert Post Ads).

Ads are not showing? Check [Blank AdSense ads](https://adinserter.pro/documentation/adsense-ads#ads-not-displayed) and [troubleshooting guide](https://adinserter.pro/documentation/troubleshooting#ads-not-displayed) to find out what to check.

**Ad Inserter can insert ads where other plugins fail**.
It's all about the settings.

**Ad Inserter - WordPress Ad Manager**

*One Plugin for All Ads*

Ad Inserter is not just another plugin for WordPress ads. Do you enjoy finding the right plugin to solve a particular problem on your site? For example:

*   for ad management and ad injection
*   to insert Google AdSense ads or Media.net ads
*   for Google Ad Manager / DoubleClick for Publishers (DFP) ads
*   to insert Amazon Native Shopping ads
*   to insert affiliate ads (CJ Affiliate by Conversant, ClickBank, ShareASale, Rakuten LinkShare, etc.)
*   to insert ads form BuySellAds, Chitika, Ezoic, Booking.com, Tradedoubler, Awin, Getyourguide
*   to insert ads between paragraphs
*   to insert ads between posts
*   to insert ads between comments
*   to insert ads on custom posts
*   to insert AMP ads on AMP pages
*   to insert different ads for mobile devices
*   to insert ads at custom action hooks (e.g. using <a href="https://genesistutorials.com/visual-hook-guide/" target="_blank">Genesis Theme Framework Hook Guide</a>)
*   to edit ads.txt file
*   to hide ads on specific pages
*   for ad rotation - to rotate different ads in a single ad position
*   for PHP code widgets and PHP ads
*   for sticky (fixed) widgets
*   to detect ad blocking
*   to insert banners
*   to insert Google analytics code
*   to insert various opt-in forms (MailChimp, AWeber, GetResponse, etc.)

Maintaining several plugins (often from different vendors) is not easy. And each plugin is slowing down the speed of your website.

**Speed Up Your WordPress: Replace them all with free Ad Inserter!**

**Quick Start**

To become familiar with the plugin check [Quick Start](https://adinserter.pro/documentation/quick-start) to display ads on your website.

To learn how to configure the most advanced WordPress AdSense plugin check documentation for [AdSense ads](https://adinserter.pro/documentation/adsense-ads): AdSense ad units, AdSense Auto ads, AdSense in-feed ads, AdSense in-article ads, AdSense AMP ads,...

Please note that code for AdSense ads may in some cases display blank ad blocks - no ads. This has nothing to do with the plugin. After AdSense code is inserted, Google needs some time (hours) to check pages before it starts to serve ads. Blank AdSense ad block means that AdSense code is inserted properly and AdSense code is running, only it doesn't display anything (yet). Typical reasons for blank AdSense ads are the following:

*   Your AdSense account is not fully approved yet
*   Your website or page was not approved for AdSense ads
*   Google has not checked and approved to serve ads to your website (yet)
*   Your AdSense account is banned
*   No ads available for your website
*   Wrong AdSense publisher ID or slot ID - check or regenerate ad code
*   Errors in ad code - check browser console for error messages

**Main AdSense Features**

To show AdSense ads you need to place code for AdSense ads on your website - you need WordPress AdSense plugin. Ad Inserter is a perfect tool to automatically insert code for AdSense ads on any page. AdSense integration and clearance options to make sure that your page will comply with the AdSense program policies, are just two advanced features that will help you to monetize your website with AdSense ads.

*   Get code for AdSense ads directly from your [AdSense account](https://adinserter.pro/documentation/adsense-ads#integration)
*   Code generator for AdSense ads
*   Create code for AdSense AMP ads from normal AdSense ad code
*   Convert standard AdSense text & display ads to AdSense link ads or vice versa
*   Convert fixed size AdSense ads to responsive AdSense ads
*   Convert responsive AdSense ads to fixed size AdSense ads
*   Create responsive AdSense ads with [fixed ad sizes for differrent devices](https://adinserter.pro/documentation/adsense-ads#responsive)
*   Support for AdSense Auto ads
*   Support to exclude AdSense Auto ads [on specific pages](https://adinserter.pro/documentation/plugin-settings#page-specific-header-footer)
*   Optionally limit insertion to 3 AdSense ads per page
*   Disable insertion of AdSense ads on Error 404 pages
*   Insert AdSense In-feed ads or In-article ads between posts or comments
*   Simple troubleshooting when AdSense ads are not displayed
*   Debugging function to label AdSense ad blocks to mark [blank AdSense ads](https://adinserter.pro/documentation/adsense-ads#ads-not-displayed)

*AdSense dictionary*

Ad Inserter is also a powerful AdSense plugin. However, AdSense ads require some knowledge of ad terminology in order to use the right code for ads and to place them properly. This is a short list of commonly used terms:

*   Google AdSense: a program run by Google that allows publishers in the Google Network of content sites to serve automatic text ads, image ads, video ads or interactive media ads. Google AdSense provides the right ads for any audience: ads are reviewed to ensure they're high quality and relevant to your content or audience, even when viewed on smartphones and tablets. Block ads you don't like, customize where ads appear, and choose which types of ads fit your site best
*   AdSense text ads: ad with a title that's also a clickable link to a webpage, one or two lines of text, and a website address
*   AdSense display ads: graphical ads offered in several formats
*   AdSense video ads: one type of ads that can appear on AdSense sites - they can show on your pages if you have chosen to display image ads and are using supported ad size
*   AdSense richer text ads: a form of text ads supplemented with advertiser images that are displayed as "display-like" ads
*   AdSense ad unit: a set of Google ads displayed as a result of one piece of AdSense ad code - for AdSense publishers who want full control over the placement of their ads
*   AdSense ad code: a snippet of HTML that when placed on any page of an approved site shows Google AdSense ads in a specific ad layout and format
*   AdSense ad format: the way AdSense ads are shown to the users on your site - different ad formats can support different ad types, such as text ads, display ads, video ads
*   Responsive AdSense ads: ads will resize to fill available width
*   Fixed size AdSense ads: you define width and height of ads
*   AdSense In-feed ads: ads between similar-looking content blocks that repeat one after the other
*   AdSense In-article ads: ads that fit seamlessly in between the paragraphs of your pages
*   AdSense Auto ads: a code that you insert on every page once and it will automatically display AdSense ads **on positions chosen by the Auto ads code** - a fast and easy way for AdSense publishers to get up and running with ads
*   AdSense ads on AMP pages: AMP pages need different code for AdSense ads. Each Ad Inserter code block can be configured to insert different codes on AMP pages - you can use use built-in AdSense code generator to generate code for AMP AdSense ads
*   Blank AdSense ads: blank (empty) ad blocks when Google for some reason does not display ads
*   AdSense integration: connection between plugin and your AdSense account
*   AdSense Program policies: all publishers using AdSense ads are required to adhere to AdSense Program policies - if you fail to comply with these policies, Google reserves the right to disable ad serving to your site (you get blank AdSense ads) and/or disable your AdSense account at any time
*   Personalized AdSense ads: Google considers AdSense ads to be personalized when they are based on previously collected or historical data to determine or influence ad selection, including a user's previous search queries, activity, visits to sites or apps, demographic information, or location
*   Non-personalized AdSense ads: ads that are not based on a user's past behavior. Non-Personalized AdSense ads allow publishers to present EEA users with a choice between personalized ads and non-personalized ads, or to choose to serve only non-personalized ads to all users in the EEA. Non-Personalized AdSense ads only use contextual information, including coarse general (city-level) location.

**Insert Any Code Anywhere on the Page - Automate Insertion of Ads**

*   Automatic insertion of ads using standard (the_content, the_excerpt, loop_start, loop_end, the_post,...) or custom WP hooks
*   Server-side or client-side (javascript) insertion before, after or inside **any HTML element on page** (using CSS selectors #id, .class)
*   Manual insertion of ads with shortcodes
*   Insertion of ads with widgets or PHP function calls from child theme

**Please support plugin development**

Support the advancement of this plugin:

*   Write a short <a href="https://wordpress.org/support/plugin/ad-inserter/reviews/#new-post">review</a> - positive reviews are a great way to show your appreciation for my work. Besides being an incredible boost to my morale, they are also a great incentive to fix any bug found in the software and to add new features for better monetization of your website.
*   <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=LHGZEMRTR7WB4">Donate</a> if Ad Inserter helps you to make money with ads
*   Register for [Ad Inserter Pro Affiliate](https://affiliate.adinserter.pro/), promote the plugin on your website and earn commission for each purchase you refer
*   Buy license for [Ad Inserter Pro](https://adinserter.pro/) - Top WordPress plugin for ads

== Installation ==

[Ad Inserter installation](https://adinserter.pro/documentation/plugin-installation)

**Online Documentation**

*   [Ad Inserter Documentation](https://adinserter.pro/documentation)
*   [Ads not displayed](https://adinserter.pro/documentation/troubleshooting#ads-not-displayed)
*   [Troubleshooting](https://adinserter.pro/documentation/troubleshooting)
*   [Code Editing](https://adinserter.pro/documentation/code-editing)
*   [Common Settings](https://adinserter.pro/documentation/common-settings)
*   [Automatic Insertion](https://adinserter.pro/documentation/automatic-insertion)
*   [Block Alignment and Style](https://adinserter.pro/documentation/alignments-and-styles)
*   [AdSense Ads](https://adinserter.pro/documentation/adsense-ads)
*   [WordPress Page Types](https://adinserter.pro/documentation/wordpress-page-types)
*   [Black and White Lists](https://adinserter.pro/documentation/black-and-white-lists)
*   [Post and Page Exceptions](https://adinserter.pro/documentation/individual-post-and-page-exceptions)
*   [Debugging](https://adinserter.pro/documentation/debugging)


== Frequently Asked Questions ==

= Settings for ads ... =

Check <a href="https://adinserter.pro/documentation/common-settings" target="_blank">common Ad Inserter settings</a>

= Does Ad Inserter insert any internal ads? =

No revenue sharing and no such thing as "internal ads" or "our ads" on your website. Period. What you configure is what will be inserted (+ some internal scripts for plugin features).
Ad Inserter is free, open source plugin and inserts only the code or ads you configure (blocks, Header, Footer). The code you see is the code that will be inserted. Please check page source code before you make any conclusion.
Of course, if you configure code block with some JavaScript ad code, then this code may insert some additional code or show ads. But please, don't blame the plugin for this.
You can also use Ad Inserter to insert code for AdSense Auto ads on each page (usually in the header). However, **the exact placement of ads will be done by the ad code, not Ad Inserter!**
[https://adinserter.pro/documentation/adsense-ads#auto-ads](https://adinserter.pro/documentation/adsense-ads#auto-ads)

The easiest way to check Ad Inserter blocks is to use **Label blocks** debugging function:
[https://adinserter.pro/documentation/debugging](https://adinserter.pro/documentation/debugging)

Please note that when you disable Ad Inserter you also disable insertion of all codes and blocks you have configured.
Therefore, if your issues go away when you disable the plugin THIS DOES NOT INDICATE any issue with the plugin! You need to try to [disable individual codes](https://adinserter.pro/documentation/debugging#back-end) to see which one is causing trouble.

= I have installed code for AdSense ads and I see ads placed at random positions. =

You are probably using code for [AdSense Auto ads](https://adinserter.pro/documentation/adsense-ads#auto-ads).

AdSense Auto ads (known also as AdSense Page Level Ads) is a code that you insert on every page once and it will automatically display AdSense ads on positions chosen by the code.
AdSense Auto ads use Google's machine learning to pick the best placements on your pages to show ads. You only need to add one piece of code to all your pages, and let Google take care of the rest.

AdSense Auto ads may not be suitable for some WordPress themes or layouts. In such cases it is easier to place ads at wanted locations by using [normal AdSense code](https://adinserter.pro/documentation/adsense-ads#ad-unit) and specifying exact locations where the code should be inserted.

= I have installed code for AdSense ads but the ad blocks are blank. =

Blank AdSense ad block means that the code is inserted properly only the ad code doesn't display ads. Typical reasons for this are the following:

*   After the ad code is inserted Google needs some time (hours) to check the pages before it starts to serve ads.
*   AdSense account is not fully approved yet - if your account is new you need to wait until Google checks ad codes on your website and and confirms your account. Usually this takes few days.
*   Your website or page is not approved yet - you need to wait until Google web crawlers check your pages.
*   Your website or page was not approved for AdSense ads
*   Your AdSense account is banned
*   No ads available for your website
*   Errors in ad code - check or regenerate ad code
*   You are using ad blocker

In such case you can try other ad networks for contextual ads. Check <a href="https://adinserter.pro/documentation/troubleshooting#ads-not-displayed">Ads Not Displayed</a> for more information.

= What is GDPR? =

The GDPR (General Data Protection Regulation) is a regulation in European Union (EU) on data protection and privacy for all individuals within the EU and the European Economic Area (EEA) that was designed to harmonize data privacy laws across Europe. If you collect personal information from any EU citizen (within or outside the EU), you must first obtain explicit and unambiguous consent.

= GDPR compliance: What cookies does the plugin use =

Ad Inserter itself does not use cookies except for ad blocking detection when you use delayed action.

In this case 3 cookies may be used (to store pageviews and action settings): `aiADB`, `aiADB_PV` and `aiADB_PR`. However, no personal data is stored in the cookies.

Of course, the ads you may insert with the plugin may use own cookies - please check with ad networks for details.

= How to display a GDPR compliant cookie message? =

You can use any plugin for GDPR compliance / cookie consent. For example:

*   [Cookie Notice for GDPR](https://wordpress.org/plugins/cookie-notice/)
*   [Cookie Consent](https://wordpress.org/plugins/uk-cookie-consent/)
*   [GDPR Cookie Consent](https://wordpress.org/plugins/cookie-law-info/)

PLEASE NOTE: Installing GDPR plugin alone does not make your site GDPR compliant. Since ads you insert may use various cookies, you may need to make sure you have necessary configurations in place. Please check next question regarding showing ads based on visitor's consent.

= How to show ads based on visitor's consent? =

Ad Inserter supports inserting (showing) ads based on cookies or cookie values. You can define cookie conditions by black/whitelisting *Url parameters* (where also [cookies are checked](https://adinserter.pro/documentation/black-and-white-lists#cookies)).

PLEASE NOTE: If you are using caching (very likely) you also need to set **Dynamic blocks** to **Client-side insert** (tab &#9881; / tab General) in order to check cookies in visitor's browser and not when the page is generated.

For example, If you are using one of the following plugins for cookie consent you need to **whitelist the following cookie and value in Url parameter list**:

*   [GDPR Cookie Consent](https://wordpress.org/plugins/cookie-law-info/) - Whitelist `viewed_cookie_policy=yes`
*   [Cookie Notice for GDPR](https://wordpress.org/plugins/cookie-notice/) - Whitelist `cookie_notice_accepted=true`
*   [Cookie Consent](https://wordpress.org/plugins/uk-cookie-consent/) - Whitelist `catAccCookies=1`

= What is plugin usage tracking? =

When enabled, the information regarding WordPress environment and Ad Inserter usage will be collected and sent to plugin developers (once per month and on events like plugin activation/deactivation).

This is completely optional and can be disabled at any time. So if you have opted in (by clicking Allow when asked for permission) and now you would like to disable tracking, you should go to tab &#9881; / tab General, select **Disable** for Plugin usage tracking and save settings.

If this setting is not available then you have not selected any option yet - **tracking is disabled unless explicitly enabled** by clicking Allow when asked for permission (or when this setting is set to Enable).

What data is collected: Ad Inserter version, activation status, number of active blocks, date of installation, date of last saved settings, status of review notice and remote debugging, block class name, location, website url and name, WordPress version, language, text direction, charset, number of posts, active theme and version, list of installed plugins, PHP version, server name, IP address (used to determine country), site count for multisite installations, deactivation reasons and details (if provided).

Ad Inserter is only a plugin for WordPress content management software. It works together with WordPress, other installed plugins and selected theme.

This data provides information to make the plugin to be compatible with as many environments as possible, to test the plugin with commonly used plugins and themes, to understand why users deativate (and uninstall) the plugin and to get ideas to make improvements to the plugin.

If you are not happy to reveal this information and you have opted in, simply disable usage tracking as described above.

**Your decision will be respected.**


= I wish to show ads side by side but not in the same block. How do I do this? =

Configure block 1 and 2 with ads using:

*   Automatic Insertion: Disabled
*   Block Alignment and Style: No Wrapping
*   Enable shortcode: checked

Configure block 3 with

`[adinserter code="1" ignore="page-type"]
[adinserter code="2" ignore="page-type"]`

and use block 3 to insert ads.


= I use After Content insertion position but the ads are inserted after the stuff provided by other plugins. How can I insert ads directly after post content?

This happens because Ad Inserter processes posts last and therefore "sees" also content added by other plugins.

Try to set Ad Inserter plugin priority to 10 (early processing, Ad Inserter settings - tab &#9881; / tab General).


= How can I add some title or label (e.g. Advertisements) above AdSense ads? =

If this is a sidebar widget then you can simply name the widget.

For each code block you can also show a label above each ad. Default text (or HTML code) for ad labels can be set on the general plugin settings tab (tab &#9881; / tab General / **Ad label**.
To enable ad label above the ad go to code block for this ad, click on the Misc button and then on the Display tab check **Ad label**.

If you configured only text for ad label then the following code will be added above ad code: `<div class="code-block-label">AD_LABEL_TEXT</div>` (`code-block` is the block class name used, AD_LABEL_TEXT is the text for Ad Label).
You can then style the label using CSS for class `.code-block-label` (the best place for this code is Header section). If HTML code is configured for ad label then this code will be used (instead of the div code above).

In case you need a different label for some ad you can simply add label HTML code above the ad code. For example:

`<h3>Advertisements</h3>

AD_CODE`

Ad lables can be inserted only above ads (blocks) inserted by Ad Inserter - AdSense Auto ads are automatically inseted by AdSense Auto ads code.

= How can place ads below Read More tag? =

Configure ad block with the following options:

*   Automatic Insertion: After Paragraph
*   Paragraph Number: 1
*   Count only paragraphs that CONTAIN: `<span id="more-`

Check source code of your website for proper "read more" tag.


= How can I rotate between different alignments so I can test an ad aligned to the right against an ad aligned to the left? =

Set Block Alignment and Style to "No Wrapping" and create manual wrapping around both ads separated with [ADINSERTER ROTATE]:

`<div style="float: left; margin: 0 8px 8px 0;">
AD CODE LEFT
</div>

[ADINSERTER ROTATE]

<div style="float: right; margin: 0 0 8px 8px;">
AD CODE RIGHT
</div>`

Please note that responsive AdSense ads can not work with floating alignments (ad container width is not known) - either use AdSense code with fixed ad sizes or don't use floating alignment.

== Screenshots ==

1. Settings for one code block (Before content).
2. Code preview with visual CSS editor
3. Code preview with visual CSS editor - highlighted code
4. Post / Page Ad Inserter Individual Exceptions
5. Some <a href="https://adinserter.pro/" target="_blank">Ad Inserter Pro</a> features: IP address and country lists, Scheduling between dates with fallback
6. Ad Inserter plugin settings
7. Visualization of HTML tags in post
8. Visualization of positions for automatic insertion in post
9. Visualization of inserted block in post
10. Automatic insertion, Alignment and Style settings
11. Rotation code editor and banner code generator
12. Settings for automatic insertion before/after paragraphs
13. Settings for custom hooks
14. Settings automatic insertion at custom hook positions
15. Settings ad blocking detection
16. AdSense code generator
17. Complete settings for one code block (Before Paragraph)


== Changelog ==

= 2.4.13 =
- Added shortcode to disable ad blocking detection code
- Added options to disable ad blocking actions for administrators or logged in users
- Added option to change PDF report footer (Pro only)
- Added support for public ad impression and click reports (Pro only)
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.12 =
- Added ads.txt editor
- Added option to prevent disabling caching for logged in administrators
- Improved compatibility with PHP 7.2
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.11 =
- Fix for saving code with slashes
- Fix for rotation editor code import
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.10 =
- Added support for counter shortcodes
- Added support for code separator selection for code preview
- Added support for group rotations
- Added support for CHECK separator (Pro only)
- Added links to test pages for check for available positions
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.9 =
- Added support for HEAD separator
- Added support for DoubleClick for Publishers (DFP) ads
- Added support to generate statistics reports in PDF format (Pro only)
- Fix for ad label when using AMP separator
- Fix for AdSense code fixed by viewport
- Fix for error when checking for available positions
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.8 =
- Added support for automatic insertion before/after image
- Added support for theme checker for available positions for automatic insertion

= 2.4.7 =
- Fix for lazy loading in Ajax calls (Pro only)
- Fix for country list editor (Pro only)
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.6 =
- Improved ad blocking detection (detects Firefox content blocking)
- Added support for wildcards for referrers (domains)
- Added debugging notice when JavaScript errors are detected
- Added support to load blocks in iframes (Pro only)
- Added geolocation support for country subdivisions and cities (Pro only)
- Added option to hide license key on client websites (Pro only)
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.5 =
- Added support for AMP WP - Google AMP For WordPress
- Added support to individually disable insertions for debugging purposes
- Improved HTML element selection tool
- Fix for Call to undefined function wp_get_current_user()
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.4 =
- Fix for Fatal error: Call to undefined function mb_strtoupper()

= 2.4.3 =
- Added support for insertion before/after every N paragraphs (%N)
- Added support for i18n
- Fix for insertion on admin pages
- Fix for client-side cookie check
- Fix for loaded styles from other plugins/themes on the settings page
- Fix for client-side insertion near HTML elements using :eq selector
- Fix for deactivation feedback form not closing
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.2 =
- Added support for visual HTML element selection
- Fix for client-side insertion inside HTML elements
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.1 =
- Added option to insert into HTML element (prepend, append, replace content)
- Added option to remove HTML element
- Added option to not show deactivation feedback form
- Added support for negative relative positions for paragraph counting
- Few minor bug fixes, cosmetic changes and code improvements

= 2.4.0 =
- Improved code for client-side insertion
- Added support for usage tracking
- Fix for compatibility with older PHP versions (below 5.4)
- Few minor bug fixes, cosmetic changes and code improvements


= Earlier versions =

For the changelog of earlier versions, please refer to the separate changelog.txt file.

== Upgrade Notice ==

= 2.4.13 =
Added shortcode to disable ad blocking detection code;
Added options to disable ad blocking actions for administrators or logged in users;
Added option to change PDF report footer (Pro only);
Added support for public ad impression and click reports (Pro only);
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.12 =
Added ads.txt editor;
Added Added option to prevent disabling caching for logged in administrators;
Improved compatibility with PHP 7.2;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.11 =
Fix for saving code with slashes;
Fix for rotation editor code import;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.10 =
Added support for counter shortcodes;
Added support for code separator selection for code preview;
Added support for group rotations;
Added support for CHECK separator (Pro only);
Added links to test pages for check for available positions;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.9 =
Added support for HEAD separator;
Added support for DoubleClick for Publishers (DFP) ads;
Added support to generate statistics reports in PDF format (Pro only);
Fix for ad label when using AMP separator;
Fix for AdSense code fixed by viewport;
Fix for error when checking for available positions;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.8 =
Added support for automatic insertion before/after image;
Added support for theme checker for available positions for automatic insertion

= 2.4.7 =
Fix for lazy loading in Ajax calls (Pro only);
Fix for country list editor (Pro only);
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.6 =
Improved ad blocking detection (detects Firefox content blocking);
Added support for wildcards for referrers (domains);
- Added debugging notice when JavaScript errors are detected
Added support to load blocks in iframes (Pro only);
Added geolocation support for country subdivisions and cities (Pro only);
Added option to hide license key on client websites (Pro only);
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.5 =
Added support for AMP WP - Google AMP For WordPress;
Added support to individually disable insertions for debugging purposes;
Improved HTML element selection tool;
Fix for Call to undefined function wp_get_current_user();
Few minor bug fixes, cosmetic changes and code improvements;

= 2.4.4 =
Fix for Fatal error: Call to undefined function mb_strtoupper()

= 2.4.3 =
Added support for insertion before/after every N paragraphs (%N);
Added support for i18n;
Fix for insertion on admin pages;
Fix for client-side cookie check;
Fix for loaded styles from other plugins/themes on the settings page;
Fix for client-side insertion near HTML elements using :eq selector;
Fix for deactivation feedback form not closing;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.2 =
Added support for visual HTML element selection;
Fix for client-side insertion inside HTML elements;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.1 =
Added option to insert into HTML element (prepend, append, replace content);
Added option to remove HTML element;
Added option to not show deactivation feedback form;
Added support for negative relative positions for paragraph counting;
Few minor bug fixes, cosmetic changes and code improvements

= 2.4.0 =
Improved code for client-side insertion;
Added support for usage tracking;
Fix for compatibility with older PHP versions (below 5.4);
Few minor bug fixes, cosmetic changes and code improvements