=== WordPress Ads & AdSense plugin - 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 ads, amazon, ad blocking detection, header code, banner, banners, advert, adverts, sticky fixed widgets
Requires at least: 4.0
Tested up to: 5.0
Requires PHP: 5.6
Stable tag: 2.4.2
License: GPLv3

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

== Description ==

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

Supports all kinds of ads including **Google AdSense ads**, contextual **Amazon Native Shopping Ads**, **Media.net ads** and **rotating banner ads.**

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
*   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 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 HTML, CSS, Javascript or PHP code
*   Code generator for banners and placeholders
*   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
*   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)
*   [Black/White-list](https://adinserter.pro/documentation/black-and-white-lists) categories, tags, taxonomies, post IDs, urls, url query parameters, cookies, referers
*   Easy copying and pasting ads or settings using internal clipboard
*   Simple troubleshooting with many debugging functions
*   Function to visualize inserted code 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 of your content 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).

And if you need more ads with page/category specific settings, ad statistics 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):

*   64 code (ad) blocks (64 different insertion configurations for ads)
*   Geolocation using Webnet77 or <a href="http://www.maxmind.com/" target="_blank">MaxMind</a> databases (works also with caching)
*   Black/White-list IP addresses or countries (works also with caching)
*   Ad impression and click statistics (works also with `<iframe>` Javascript ads like Google AdSense)
*   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)
*   Scheduling with fallback option
*   Ad blocking detection - replace ads, protect content
*   Ad blocking statistics
*   Multisite options to limit settings on the sites
*   Individual post/page exception management
*   More custom viewports for client-side desktop/mobile device detection
*   More custom hooks for custom theme insertions
*   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? [Introduce yourself](https://adinserter.pro/contact).

Ad Inserter WordPress plugin is an advanced advertising manager for all kind 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).

**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
*   to insert Amazon Native Shopping ads
*   to insert affiliate ads (CJ Affiliate by Conversant, ClickBank, ShareASale, Rakuten LinkShare, etc.)
*   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 hide ads on specific pages
*   for ad rotation - to rotate different ads in a single ad position
*   for PHP code widgets
*   for sticky (fixed) widgets
*   for widget logic
*   to restrict widgets
*   to detect ad blocking
*   to insert banner ads
*   to insert PHP or HTML code into posts
*   to insert PHP ads
*   to insert tracking, footer or header code
*   to insert PHP, HTML, CSS, shortcodes
*   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,...

Few typical settings are described on the <a href="https://adinserter.pro/documentation/common-settings" target="_blank">Common Settings</a> page. Please make sure you have also read <a href="https://adinserter.pro/documentation/plugin-installation">plugin installation</a> documentation. For more detailed instructions please read <a href="https://adinserter.pro/documentation" target="_blank">Ad Inserter documentation pages</a>.

**Main AdSense Features**

*   Get code for AdSense ads directly from your [AdSense account](https://adinserter.pro/documentation/adsense-ads#integration)
*   Create code for AdSense AMP ads from normal AdSense ad code
*   Create responsive AdSense code from fixed size AdSense ads
*   Create responsive AdSense code with [fixed ad sizes for differrent devices](https://adinserter.pro/documentation/adsense-ads#responsive)
*   Optionally limit insertion to 3 AdSense ads per page
*   Disable insertion of AdSense ads on Error 404 pages
*   Insert AdSense In-feed or In-article ads between posts or comments
*   Debugging function to label AdSense ad blocks to mark [blank AdSense ads](https://adinserter.pro/documentation/adsense-ads#ads-not-displayed)

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

*   Automatic insertion using standard WP hooks (the_content, the_excerpt, loop_start, loop_end, the_post,...)
*   Automatic insertion using custom WP hooks provided by themes (e.g. using <a href="https://genesistutorials.com/visual-hook-guide/" target="_blank">Genesis Theme Framework Hooks</a>)
*   Server-side or client-side (javascript) insertion before or after **any HTML element on page** (using selectors #id, .class)
*   Manual insertion with shortcodes
*   Insertion with widgets
*   Insertion by placing PHP function calls or custom hooks in your theme files

Ad Inserter is **the only WordPress plugin that can insert any code or ads anywhere on the page**. If standard insertions before/after post, content or paragraph can't be used, you can use advanced insertion [before/after arbitrary HTML element](https://adinserter.pro/documentation/automatic-insertion#before-after-html-element).

If you can create a CSS slector for the page element (#id, .class) then you can insert ads before or after that element. By default this approach uses client-side insertion using Javascript to insert code block after the page loads.

However, if you enable Output buffering (tab &#9881; / tab General) you can select also Server-side insertion which will insert code block the same way as other insertions when the plugin is called and the page is created.

Please note that **Output buffering** may not work with all themes - in such case you can still use client-side insertion.

**Please support plugin development**

If you are using Ad Inserter and you like it, then please write about it and spread the word on the <a href="https://wordpress.org/support/plugin/ad-inserter/reviews/#new-post">review page</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.

Support the advancement of this plugin:

*   Write a short <a href="https://wordpress.org/support/plugin/ad-inserter/reviews/#new-post">review</a>
*   <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
*   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 ==

= I have activated Ad Inserter. How can I use it? =

1. After activation, click "Settings / Ad Inserter" to access the settings page
2. There are 16 code blocks - each block means ad code at some position (or multiple positions in some cases)
3. Put ad (or any other HTML/Javascript/PHP) code into the code window
4. Set automatic insertion option (for example: Before Post)
5. Enable at least one page type (for example: Posts, some insertion options don't work on all page types)
6. Save settings
7. Check also [common Ad Inserter settings](https://adinserter.pro/documentation/common-settings)
8. Check inserted code on the posts
9. 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.

= 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 you configure (blocks 1 - 16, 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 javacript ad code, then this code may generate 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 code blocks is to use **Label blocks** debugging function:
[https://adinserter.pro/documentation/debugging](https://adinserter.pro/documentation/debugging)


= 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/white-listing *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 **white-list the following cookie and value in Url parameter list**:

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

= Settings for widget ads =

*   Nothing needed, just enter the code for ads and save settings - widget is enabled by default
*   Go to Appearance / Widgets, drag Ad Inserter widget to the sidebar or any other widget position, select block and click on Save (button Save might be disabled until you make some change)
*   Optionally you can enable Sticky widget - this means that this widget (and widgets below) will stay fixed in the sidebar when the page is scrolled - Sticky sidebar or Fixed widget feature
*   You can also make other widgets sticky even if you don't use Ad Inserter ads - drag Ad Inserter widget to the sidebar ABOVE the top widget that needs to be sticky, select Dummy Widget for Block, check Sticky and save widget
*   In general plugin settings (tab &#9881;) you can also define Sticky Widget Top Margin to precisely define top position where the first sticky widget will stick

Additional note regarding *Sticky Widgets* - *Sticky Sidebars*:

There are two modes for sticky widgets (or sticky sidebars) available as **Sticky widget mode** in general plugin settings (tab &#9881;):

*   CSS mode - This mode is the best approach but may not work with all themes. CSS mode works by changing sidebar CSS to `position: sticky`. This works with most themes but not all. If your widgets and sidebar aren't sticking as expected you can use **JavaScript mode** described below.
*   JavaScript mode - This mode should work with practically all themes but may reload ads on page load when sticky sidebar is initialized.


= 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.**


= Settings for contextual Amazon Native Shopping Ads =

*   Automatic Insertion: After Content
*   On all Posts checked, other page types unchecked

Sign in to Amazon Associates, go to Widgets/Widget Source, choose ad type and set parameters.
For titles and search terms use tags. For example, the code below would display amazon products related to the post tags - check documentation for all possible tags.

`<script type="text/javascript">
amzn_assoc_placement = "adunit0";
amzn_assoc_search_bar = "true";
amzn_assoc_tracking_id = "ad-inserter-20";
amzn_assoc_search_bar_position = "top";
amzn_assoc_ad_mode = "search";
amzn_assoc_ad_type = "smart";
amzn_assoc_marketplace = "amazon";
amzn_assoc_region = "US";
amzn_assoc_title = "Search Results from Amazon";
amzn_assoc_default_search_phrase = "[adinserter data='smart-tag']";
amzn_assoc_default_category = "All";
amzn_assoc_linkid = "cf1873f027a57f63cede634cfd444bea";
</script>
<script src="//z-na.amazon-adsystem.com/widgets/onejs?MarketPlace=US"></script>`

Use your own tracking id! Please note `[adinserter data='smart-tag']` as default search phrase. This makes this widget contextual. It will show products related to the tags for this post.

You can also use <a href="https://codex.wordpress.org/Custom_Fields" target="_blank">custom fields</a> to make the widget contextual. For example, if you define in posts custom field named `amazon-keyword` you can use `[adinserter custom-field='amazon-keyword']' for `amzn_assoc_default_search_phrase` variable.

You can also try with `[adinserter data='tag']', `[adinserter data='short-title']`, `[adinserter data='category']` or `[adinserter data='short-category']`. For more options check <a href="http://adinserter.pro/documentation#code-block-options" target="_blank">Ad Inserter documentation page</a>.


= 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). Up to 16 blocks can be configured (up to 64 in <a href="https://adinserter.pro/" target="_blank">Ad Inserter Pro</a>)
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.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

= 2.3.21 =
- Added option to force showing admin toolbar when viewing site
- Added additional debugging info for blocks in Ajax requests
- Fix for viewport visibility detection
- Fix for rotation with non-ASCII characters
- Few minor bug fixes, cosmetic changes and code improvements

= 2.3.20 =
- Improved loading of settings
- Fix for content processing in some ajax calls
- Few minor bug fixes, cosmetic changes and code improvements

= 2.3.19 =
- Improved code for client-side insertion
- Fix for rotation with shortcodes
- Few minor bug fixes, cosmetic changes and code improvements

= 2.3.18 =
- Added support to schedule insertion for N days after publishing
- Added support to schedule insertion only for posts published inside/outside time period (Pro only)
- Added support to prevent activation of free Ad Inserter while Pro is active
- Added url parameter to show block code
- Improved Header/Footer code debugging
- Few minor bug fixes, cosmetic changes and code improvements

= 2.3.17 =
- Added shortcode for ad blocking detection action
- 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.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

= 2.3.21 =
Added option to force showing admin toolbar when viewing site;
Added additional debugging info for blocks in Ajax requests;
Fix for viewport visibility detection;
Fix for rotation with non-ASCII characters;
Few minor bug fixes, cosmetic changes and code improvements

= 2.3.20 =
Improved loading of settings;
Fix for content processing in some ajax calls;
Few minor bug fixes, cosmetic changes and code improvements

= 2.3.19 =
Improved code for client-side insertion;
Fix for rotation with shortcodes;
Few minor bug fixes, cosmetic changes and code improvements;

= 2.3.18 =
Added support to schedule insertion for N days after publishing;
Added support to schedule insertion only for posts published inside/outside time period (Pro only);
Added support to prevent activation of free Ad Inserter while Pro is active;
Added url parameter to show block code;
Improved Header/Footer code debugging;
Few minor bug fixes, cosmetic changes and code improvements

= 2.3.17 =
Added shortcode for ad blocking detection action;
Few minor bug fixes, cosmetic changes and code improvements