advanced-ads
Last commit date
admin
4 years ago
classes
4 years ago
includes
5 years ago
languages
4 years ago
lib
4 years ago
modules
4 years ago
public
4 years ago
.phpcs.xml
4 years ago
LICENSE.txt
12 years ago
advanced-ads.php
4 years ago
changelog.txt
4 years ago
index.php
12 years ago
readme.txt
4 years ago
wpml-config.xml
7 years ago
readme.txt
349 lines
| 1 | === Advanced Ads – Ad Manager & AdSense === |
| 2 | Contributors: webzunft, advancedads |
| 3 | Tags: ads, ad manager, ad rotation, adsense, banner |
| 4 | Requires at least: 4.9 |
| 5 | Tested up to: 5.8 |
| 6 | Requires PHP: 5.6 |
| 7 | Stable tag: 1.30.1 |
| 8 | License: GPLv2 or later |
| 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | Manage and optimize all ad types. Support for Google AdSense Auto ads, Amazon, image banners, HTML, page builder, ad widget, ad rotations, ads.txt |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | Are you looking for a simple ad manager plugin? These are the top arguments to use Advanced Ads: |
| 16 | |
| 17 | * approved in publishing and ad optimization since 2009 |
| 18 | * works with all ad types and networks, including Google AdSense, Google Ad Manager (formerly Google DoubleClick for Publishers, DFP), Amazon ads, or media.net ads |
| 19 | * most features to test and optimize ads |
| 20 | * unlimited ad units |
| 21 | * ads.txt support |
| 22 | * dedicated ad block for the block editor |
| 23 | * Google AdSense Partner, who implements all technical changes early and in 100% compliance with the Google AdSense policies |
| 24 | * the only advertising solution with *Ad Health* integration and Google AdSense violation checks |
| 25 | * best rated [free support](https://wordpress.org/support/plugin/advanced-ads) |
| 26 | |
| 27 | This is what our users are saying about Advanced Ads: |
| 28 | |
| 29 | > We use this plugin to deliver rotating ads on a community news site, and it’s great. Both feature-rich and reliable, your imagination is the limit when it comes to the product you want to create for your users. We’ve delivered over a million ad impressions since we launched less than a year ago, using a combination of sidebar, top, sticky and in-content placements — both HTML5 and images. Advanced Ads makes it easy for our small team to deliver a good experience to our users and our advertisers. |
| 30 | > mytown304 on wp.org |
| 31 | |
| 32 | Would you like to know if there is a certain feature, what the optimized setup would be, or how to implement your client’s demands? Just [open a thread in the forum](https://wordpress.org/support/plugin/advanced-ads#new-post)! |
| 33 | |
| 34 | Advanced Ads allowed us to grow from 0 to 100 MM monthly ad impressions. Benefit from our experience as a publisher and monetize your website today! |
| 35 | |
| 36 | [Full Feature List](https://wpadvancedads.com/features/). |
| 37 | |
| 38 | = ad management = |
| 39 | |
| 40 | * create and display **unlimited** ad units |
| 41 | * rotate ads |
| 42 | * schedule ads and set start time and expiration date |
| 43 | * target ads by content and user groups |
| 44 | * inject ads into posts and pages automatically without coding |
| 45 | |
| 46 | = ad types = |
| 47 | |
| 48 | choose between different ad types that enable you to: |
| 49 | |
| 50 | * insert ads and banners from all ad and affiliate networks (e.g., Google AdSense, Amazon, BuySellAds, Google Ad Manager (formerly Google DoubleClick for Publishers, DFP), Ezoic, media.net, Booking.com, Tradedoubler, Awin, Getyourguide, The Moneytizer, Infolinks...) |
| 51 | * dedicated support for all types of Google AdSense ads, including text and display ads, native ads (In-article, In-feed, matched content), Auto ads, and Auto ads for AMP |
| 52 | * display images and image banners |
| 53 | * create content-rich ads with the WordPress TinyMCE editor |
| 54 | * insert contextual Amazon Native Shopping Ads |
| 55 | * inject HTML, CSS, Javascript or PHP code |
| 56 | * use shortcodes within ads (to also deliver advertisements from another ad plugin like Ad Inserter, AdRotate, Quick AdSense, WP Bannerize, or the Google AdSense Plugin WP QUADS) |
| 57 | |
| 58 | = display ads for WP = |
| 59 | |
| 60 | * auto-inject ads via placements |
| 61 | * use functions to display ads in template files |
| 62 | * use shortcodes to place ads manually in post content |
| 63 | * show ads in the sidebar and in widgets |
| 64 | * disable all ads on specific pages |
| 65 | * display multiple ads (ad blocks) |
| 66 | * display a customizable ad label, e.g., “Advertisements” above each banner ad |
| 67 | |
| 68 | = display conditions = |
| 69 | |
| 70 | show ads based on conditions like: |
| 71 | |
| 72 | * individual posts, pages, and other post types |
| 73 | * posts by category, tags, taxonomies, author, and age |
| 74 | * archive pages by category, tags, taxonomies |
| 75 | * special page types like 404, attachment and front page |
| 76 | * hide ads on secondary queries (e.g., posts in sidebars) |
| 77 | * display or hide banners within the post feed |
| 78 | * hide all ads from specific page types, e.g., 404 pages, feed |
| 79 | * hide ads from bots and web crawlers |
| 80 | |
| 81 | = visitor conditions = |
| 82 | |
| 83 | serve ads by conditions based on the visitor. [List of all visitor conditions](https://wpadvancedads.com/manual/visitor-conditions/) |
| 84 | |
| 85 | * display or hide a banner by device: mobile and tablet or desktop |
| 86 | * display or hide a banner by role and for logged-in visitors |
| 87 | * advanced visitor conditions: previously visited URL (referrer), user capability, browser language, browser and device, URL parameters included in [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 88 | * display ads by geolocation with the [Geo Targeting add-on](https://wpadvancedads.com/add-ons/geo-targeting/) |
| 89 | * display ads by browser width with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 90 | |
| 91 | > **Fantastic plugin and outstanding support** |
| 92 | > I tried at least three other ad plugins for WordPress and ‘Advanced Ads’ is by and far the best one. Last but not least in the support. The first port of call are a number of excellent tutorials. And finally the hands on support. I don’t quite know how he does it but the speed and depth of responses are absolutely amazing. |
| 93 | > djsawyer on wp.org |
| 94 | |
| 95 | = ad injection | placements = |
| 96 | |
| 97 | Placements to insert ads in pre-defined positions in your theme and content. [List of all placements](https://wpadvancedads.com/manual/placements/) |
| 98 | |
| 99 | * ads after any given paragraph, headline, image, or other HTML element |
| 100 | * ads at the top or bottom of the post content |
| 101 | * ads before closing `</head>` tag |
| 102 | * ads in the footer |
| 103 | * create [split tests and A/B testing](https://wpadvancedads.com/ab-testing-wordpress/) |
| 104 | * many more ad positions with [add-ons](https://wpadvancedads.com/add-ons/) |
| 105 | * automatic insertion of any kind of code into header or footer, not only advertising |
| 106 | |
| 107 | = mobile devices = |
| 108 | |
| 109 | * display ads on mobile and tablets or desktop only |
| 110 | * display responsive image ads |
| 111 | * ads for specific browser sizes only using [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 112 | * inserting ads on AMP pages with [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 113 | |
| 114 | = Google AdSense = |
| 115 | |
| 116 | Amazing features of the most powerful and easy Google AdSense plugin. |
| 117 | |
| 118 | * unlimited Google AdSense ads banners |
| 119 | * pull ad units directly from your Google AdSense account |
| 120 | * show AdSense revenue in WP Admin |
| 121 | * change settings of your Google AdSense ads directly from your WordPress backend |
| 122 | * supports all Google AdSense ad types, including Google AdSense display ads, native ads like In-feed ads, In-article ads, matched content ads, Google AdSense Auto ads, and Google AdSense Auto ads for AMP |
| 123 | * change type and sizes of AdSense ads without going into your Google AdSense account |
| 124 | * hide Google AdSense advertisements on 404 pages by default (to comply with Google AdSense terms) |
| 125 | * insert Google AdSense code for verification and AdSense Auto Ads |
| 126 | * enable AdSense Auto ads on AMP |
| 127 | * easy Ad Health integration and Google AdSense violation checks |
| 128 | * option to remove the Google AdSense background color |
| 129 | * place Google AdSense In-feed ads using the also free [In-feed add-on](https://wordpress.org/plugins/advanced-ads-adsense-in-feed/) |
| 130 | * assistant for exact sizes of responsive Google AdSense ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 131 | * convert Google AdSense ads into AMP ads automatically with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 132 | * ads.txt generated with the correct AdSense information automatically |
| 133 | * works along with Google Site Kit or can replace it if you want to [control your ad placements](https://wpadvancedads.com/place-adsense-ad-unit-manually/) |
| 134 | |
| 135 | https://vimeo.com/577120971 |
| 136 | |
| 137 | Like j4ckson185, there are thousands of happy AdSense users: |
| 138 | |
| 139 | > Your app is awesome, congratulations! Google Adsense suggests using your app on its official website, it’s incredible! |
| 140 | |
| 141 | = ads.txt = |
| 142 | |
| 143 | * generates an ads.txt with custom content |
| 144 | * adds the content for AdSense to the ads.txt automatically |
| 145 | |
| 146 | https://vimeo.com/577170591 |
| 147 | |
| 148 | = ad blocker = |
| 149 | |
| 150 | * basic features to prevent ads from being removed by AdBlock and other ad blockers |
| 151 | * prevent ad blockers from breaking sites where plugin scripts are running |
| 152 | * ad blocking detection: show alternative content to ad block users with [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) and improve the monetization of your website |
| 153 | |
| 154 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 155 | |
| 156 | Thank you for motivating us with your [positive review](https://wordpress.org/support/plugin/advanced-ads/reviews/?rate=5#new-post). |
| 157 | |
| 158 | Localizations: Arabic, Chinese, Czech, Danish, Dutch, English, French, German, Hungarian, Italian, Japanese, Norwegian, Polish, Portuguese, Russian, Slovak, Spanish, Turkish, Vietnamese |
| 159 | |
| 160 | > <strong>Add-Ons</strong> |
| 161 | > |
| 162 | > * all add-ons include priority email support |
| 163 | > * [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) – powerful tools for ad optimizations: cache-busting, more placements, lazy loading, ad blocker module, click fraud protection, and many more |
| 164 | > * [Tracking](https://wpadvancedads.com/add-ons/tracking/) – track ad impressions and ad clicks with local methods or Google Analytics |
| 165 | > * [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) – target ads to specific browser sizes and create ads for AMP |
| 166 | > * [Google Ad Manager Integration](https://wpadvancedads.com/add-ons/google-ad-manager/) – a quick and error-free way to load ad units from your Google Ad Manager (formerly Google DoubleClick for Publishers, DFP) account without touching any ad codes |
| 167 | > * [Geo Targeting](https://wpadvancedads.com/add-ons/geo-targeting/) – display ads based on the geo location of the visitor |
| 168 | > * [Sticky Ads](https://wpadvancedads.com/add-ons/sticky-ads/) – increase click rates with fixed, sticky, and anchor ads |
| 169 | > * [Fixed Widget for WordPress](https://wordpress.org/plugins/q2w3-fixed-widget/) – turn sidebar widgets into performant fixed sticky ads |
| 170 | > * [PopUp and Layer Ads](https://wpadvancedads.com/add-ons/popup-and-layer-ads/) – display ads and other content in layers, popups, and interstitials |
| 171 | > * [Selling Ads](https://wpadvancedads.com/add-ons/selling-ads/) - allows you to sell ads on your website fully automated, including payments and advertiser profiles |
| 172 | > * [Ad Slider](https://wpadvancedads.com/add-ons/slider/) – create a simple slider from your ads |
| 173 | |
| 174 | If you have problems with Advanced Ads, please reach out to [our support](https://wordpress.org/support/plugin/advanced-ads) or open a [new topic](https://wordpress.org/support/plugin/advanced-ads/#new-topic-0) in our forums on wordpress.org |
| 175 | . |
| 176 | |
| 177 | = Integrations = |
| 178 | |
| 179 | Advanced Ads integrates with plenty of other plugins: |
| 180 | |
| 181 | - MailPoet - [How to integrate Advanced Ads in MailPoet Newsletters](https://wpadvancedads.com/mailpoet-newsletters/) |
| 182 | - WPML – [Showing different ads per language with WPML](https://wpadvancedads.com/translating-ads-wpml/) |
| 183 | - WPBakery Page Builder – [Displaying Ads with WPBakery Page Builder (formerly Visual Composer)](https://wpadvancedads.com/visual-composer-ads/) |
| 184 | - Genesis – [Genesis Ads add-on](https://wpadvancedads.com/add-ons/genesis-ads/) |
| 185 | - BuddyBoss – [How to integrate ads into BuddyBoss](https://wpadvancedads.com/manual/buddyboss-ads/) |
| 186 | - BuddyPress – [How to add ads on BuddyPress pages](https://wpadvancedads.com/ads-on-buddypress-pages/) |
| 187 | - bbPress – [How to show ads on bbPress pages?](https://wpadvancedads.com/ads-in-bbpress/) |
| 188 | - Cookie Consent, Borlabs Cookies, Complianz, GDPR Cookie Consent, and other content manager – [How to show ads based on visitors’ consent](https://wpadvancedads.com/manual/ad-cookie-consent/) |
| 189 | - Paid Memberships Pro – [How to manage ads on membership sites running Paid Memberships Pro](https://wpadvancedads.com/paid-memberships-pro/) |
| 190 | - [IAB TCF 2.0 consent](https://wpadvancedads.com/manual/tcf-consent-wordpress/) – hide ads until users give their consent. Integrating with any CMP, Quantcast Choices, iubenda, Google Funding Choices, cookiebot, etc. |
| 191 | |
| 192 | == Installation == |
| 193 | |
| 194 | How to install the plugin and get it working? |
| 195 | |
| 196 | = Using The WordPress Dashboard = |
| 197 | |
| 198 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 199 | 2. Search for 'advanced ads' |
| 200 | 3. Click 'Install Now' |
| 201 | 4. Activate Advanced Ads on the Plugin dashboard |
| 202 | |
| 203 | = Uploading in WordPress Dashboard = |
| 204 | |
| 205 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 206 | 2. Navigate to the 'Upload' area |
| 207 | 3. Select `advanced-ads.zip` from your computer |
| 208 | 4. Click 'Install Now' |
| 209 | 5. Activate Advanced Ads in the Plugin dashboard |
| 210 | |
| 211 | = Using FTP = |
| 212 | |
| 213 | 1. Download `advanced-ads.zip` |
| 214 | 2. Extract the `advanced-ads` directory to your computer |
| 215 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 216 | 4. Activate Advanced Ads in the Plugin dashboard |
| 217 | |
| 218 | == Frequently Asked Questions == |
| 219 | |
| 220 | = How to put ads on WordPress? = |
| 221 | |
| 222 | You can use Advanced Ads to insert ads into your WordPress site without any coding. |
| 223 | |
| 224 | To get started, just take a look at |
| 225 | |
| 226 | * the [general first ad tutorial](https://wpadvancedads.com/manual/first-ad/) |
| 227 | * using [AdSense Auto ads](https://wpadvancedads.com/adsense-auto-ads-wordpress/) in WordPress |
| 228 | * the [AdSense overview page](https://wpadvancedads.com/adsense-ads). |
| 229 | * Ads not showing up? Take a look [here](https://wpadvancedads.com/manual/ads-not-showing-up). |
| 230 | |
| 231 | = What about my users’ privacy and GDPR? = |
| 232 | |
| 233 | The plugin comes with Privacy settings that help you gather consent from users before showing ads to them. The feature works for any ads managed with the plugin, including AdSense Auto ads. |
| 234 | |
| 235 | Once you enable one of the Privacy options, Advanced Ads blocks ads that need consent until it is given. You can disable that check for individual ads as well (e.g., for image ads). |
| 236 | You can also deliver non-personalized AdSense ads when that is legally allowed in your area. |
| 237 | |
| 238 | - [Cookie consent integration](https://wpadvancedads.com/manual/ad-cookie-consent/). |
| 239 | - [IAB TCF 2.0 integration](https://wpadvancedads.com/manual/tcf-consent-wordpress/). |
| 240 | |
| 241 | Advanced Ads itself does neither save personal information (e.g., an IP address) in your database nor cookies in the visitor’s browser. |
| 242 | |
| 243 | You can learn more about how Advanced Ads and its add-ons handles data and privacy of your visitors [on this page](https://wpadvancedads.com/manual/privacy-information-for-users/). |
| 244 | |
| 245 | = Which ad networks are supported? = |
| 246 | |
| 247 | Advanced Ads is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, and also Google Ad Manager (formerly Google DoubleClick for Publishers, DFP), media.net. |
| 248 | |
| 249 | You can also use it to insert additional ad network tags into header or footer of your site without coding. |
| 250 | |
| 251 | AdSense has even a dedicated ad type leveling the specific options this ad network provides. |
| 252 | |
| 253 | = PHP functions and shortcodes = |
| 254 | |
| 255 | You can use functions and shortcodes to display ads and ad groups. |
| 256 | |
| 257 | The integers in this example are the IDs of the elements. |
| 258 | |
| 259 | Use these shortcodes to insert an ad or group into your post/page. |
| 260 | |
| 261 | `[the_ad id="24"]` |
| 262 | `[the_ad_group id="5"]` |
| 263 | |
| 264 | Use these functions to insert an ad or ad group into your template file. |
| 265 | |
| 266 | `<?php the_ad(24); ?>` |
| 267 | `<?php the_ad_group(5); ?>` |
| 268 | |
| 269 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 270 | |
| 271 | `[the_ad_placement id="header-left"]` |
| 272 | `<?php the_ad_placement('header-left'); ?>` |
| 273 | |
| 274 | = Is there a revenue share? = |
| 275 | |
| 276 | There is no revenue share. Advanced Ads doesn’t alter your ad codes in a way that you earn less than you would directly including the ad code in your template. |
| 277 | |
| 278 | = Can I place ads directly in my theme files? = |
| 279 | |
| 280 | Yes. I would add a "Manual" placement into your theme files. It would allow you to change the displayed ads or groups later without changing your code again. |
| 281 | |
| 282 | = Does it work with other ad plugins? = |
| 283 | |
| 284 | Yes. Advanced Ads can be combined with other ad plugins. |
| 285 | Just use their shortcodes in our "Rich Media" ad type to combine both features. |
| 286 | Works with AdRotate, Ad Inserter, Ad Injection, Quick AdSense, Quick AdSense Reloaded (WPQUADS), Simple Ads Manager, and other plugins. |
| 287 | Advanced Ads can be used along Google Site Kit or replace it if you need more control over your ad setup. |
| 288 | |
| 289 | = Is the plugin compatible with page builders? = |
| 290 | |
| 291 | Yes. It works out of the box with all site builders that allow shortcodes or widgets, like Elementor, SiteOrigin, Beaver Builder, WPBakery Page Builder (formerly Visual Composer), [Nimble Page Builder](https://wordpress.org/plugins/nimble-builder/), and others. |
| 292 | There is also a [free add-on to support the WPBakery Page Builder (formerly Visual Composer)](https://wordpress.org/plugins/ads-for-visual-composer/). |
| 293 | |
| 294 | = Will ads show up for ad block users? = |
| 295 | |
| 296 | Visitors who have any ad blocker (e.g., AdBlock Plus) enabled won’t see ads from known external sources (e.g., AdSense). |
| 297 | You can still monetize those spots with custom content. |
| 298 | |
| 299 | Read more about ad blockers and the features Advanced Ads has to deal with them [on this page](https://wpadvancedads.com/manual/ad-blockers/). |
| 300 | |
| 301 | = Does the plugin support an ads.txt? = |
| 302 | |
| 303 | Google AdSense and some other networks ask you to provide an ads.txt. |
| 304 | Advanced Ads can create that file automatically with the correct information for AdSense, when you enable the ads.txt feature in Advanced Ads > Settings > General > ads.txt and enter your AdSense publisher ID in Advanced Ads > Settings > AdSense. |
| 305 | |
| 306 | = I am a developer. Can I customize the plugin? = |
| 307 | |
| 308 | Yes. You can use plenty of [hooks](https://wpadvancedads.com/codex/) to customize Advanced Ads. |
| 309 | |
| 310 | == Screenshots == |
| 311 | |
| 312 | 1. Placements that let you inject ads anywhere into your site without coding (7 in Advanced Ads + 14 through add-ons). |
| 313 | 2. Support for all kinds of ad types, including dedicated AdSense type. AMP is included in the Responsive add-on. |
| 314 | 3. Flexible ad input with the Plain Text ad type and code highlighting. |
| 315 | 4. Align your ads within the content. |
| 316 | 5. Dynamically change AdSense ad options in your WordPress backend. |
| 317 | 6. Choose where to display your ads using many conditions. |
| 318 | 7. Use various conditions to choose who should see ads (basic plugin and more in add-ons). |
| 319 | 8. See AdSense earnings in your WP Backend |
| 320 | 9. Track impressions and clicks (Tracking add-on). |
| 321 | 10. Convert AdSense ads into AMP automatically (Responsive add-on) |
| 322 | |
| 323 | == Changelog == |
| 324 | |
| 325 | = 1.30.1 = |
| 326 | |
| 327 | Fix: copy missing `composer/platform_check.php` |
| 328 | |
| 329 | = 1.30.0 = |
| 330 | |
| 331 | - Improvement: add `advanced-ads-group-taxonomy-params` filter to change ad group taxonomy parameters |
| 332 | - Improvement: add "Manual Placements" to the Advanced Ads block and sidebar widget |
| 333 | - Improvement: update Black Friday promotion |
| 334 | - Fix: enable `Ad Admin` and `Ad Manager` to assign ads to groups from ad edit page and quick edit view |
| 335 | - Fix: disable unavailable ad types on the ad edit page |
| 336 | - Fix: improve AdSense auto ads code warning on ad edit page |
| 337 | - Fix: handle AdSense report API response for accounts without earnings |
| 338 | - Fix: remove `amp-auto-ads` element on non-AMP URLs |
| 339 | - Fix: honor disabling ads settings for AMP pages |
| 340 | - Fix: escape placement selectors for jQuery to allow adding conditions to multibyte placement names |
| 341 | - Fix: ensure correct text domain for translations |
| 342 | - Fix: make the ad list sortable in descending order |
| 343 | - Fix: remove hard-coded `orderby` and `order` for posts list |
| 344 | - Fix: prevent updating ad weights of non-published ads |
| 345 | - Fix: correct Display Conditions meta box video player |
| 346 | - Fix: remove escaped HTML tags in new placement form |
| 347 | - Fix: resolve a conflict with WPML where conditions were not displayed correctly on the placement page |
| 348 | - Fix: move placement of the ad blocker disguise settings |
| 349 |