Adtoniq for WordPress Product Documentation
Getting Started

Start Here

With a few minutes of your time, you can begin to measure the impact of ad blocking on your site by following these steps:
  1. Install and activate the Adtoniq plugin from the WordPress plugin directory.
  2. Sign up for an Adtoniq Cloud account.
  3. Create an API key for your website(s) and paste them in to Adtoniq.
  4. Start measuring the impact ad blocking has on you.
Once you accurately measure the impact that ad blocking is having on your website and business, then you can go on to:
  1. Design your own strategy for recovering your blocked revenue and services.
  2. Measure the financial success of your ad block strategy and refine as needed.

The Adtoniq Tutorial leads you step by step through the process of setting up Adtoniq, while this online documentation explains how all features work.


To install Adtoniq, follow these steps:
  1. From the plugins page of your WordPress admin, search for Adtoniq in the WordPress plugin directory. Alternatively, you can download Adtoniq from from the WordPress plugin page and then upload it to your server, if your WordPress server permits that.
  2. Click the Install button.
  3. Click the Activate button.
  4. Look for Adtoniq News on your WordPress dashboard. This is updated regularly with the latest news about developments in the world of ad blocking.
  5. Look for the Adtoniq icon on the left side.

Sign up for Adtoniq Cloud

To measure the impact that ad blocking has on your website, you need an Adtoniq Cloud account. This is free for the first month, after which you can see how much you would have paid to get a sense of your monthly charges, and then you pay based on your usage of Adtoniq Cloud services. You can also use our cost calculator to estimate your charges without creating an account.

To sign up for Adtoniq Cloud, follow these steps:

  1. Go to the Adtoniq Cloud sign up form by entering your email address and a password.
  2. Look for an invitation email to validate your email address.
  3. Click the Activate button in the email to activate your account.
  4. Click on the Sign in button on the top of and enter your email address and password.
  5. In the Authorize a new website form, enter the fully qualified domain name of your website, and an optional description, then click the Authorize new website button.
  6. Copy the API key for the new website you just created.
  7. Sign in to your WordPress admin interface and click on the Adtoniq gear icon.
  8. Scroll to the bottom of the page and click on the API Key tab.
  9. Paste your API key and click save changes.

Once you complete the steps above, you have one month of free access to all Adtoniq Cloud services so that you may fully explore their capabilities. Learn more about Adtoniq Cloud.

Ad block analytics

Once you have installed the plugin and added your Adtoniq Cloud key, Adtoniq will begin collecting ad block analytics for your site. Click on the Analytics tab to view Adtoniq's built-in analytics.

On the left, you can view your ad block analytics for the last 30 days. This is a rolling window that always begins exactly 30 days before you load the Adtoniq page in your browser. On the right you can view your ad block analytics for the previous 30 minute window. This information is updated in realtime as you view your analytics, and as people come and go from your site the numbers will go up and down. To minimize load on Adtoniq's realtime analytics servers, if you switch to another browser tab while keeping analytics open, you will see "Paused" display in the 30-minutes graph. As soon as you activate the tab again, realtime updates will resume.

Below the graphs you can read a summary of your last 30 days activity, including the number of users blocking analytics, which is different from the number of users blocking ads because not all ad blockers block analytics. This number is important if you use Google Analytics, because it can help you calculate the impact that ad blockers are having on your analytics.

All page views are broken down in to one of three types:

  1. Green means no ad blocker was detected. This this certainly includes users with no ad blocker installed, it also may include users who have an adblocker but have temporarily disabled it or whitelisted you.
  2. Yellow means the user had an ad blocker configured to allow acceptable ads. Because this is the default setting for the most popular ad blockers, it's likely a significant percentage of your ad blocked users have already opted in to viewing acceptable ads. This is a revenue opportunity you may address by using Adtoniq's shortcode feature to replace your usual ads with acceptable ads, without needing to ask the user for permission. You can do this without paying the whitelisting fee (aka extortion fee) required in some cases.
  3. Red means the user is blocking all ads, including acceptable ads. This is an opportuntity to ask your ad blocked users to opt in to seeing AdSense ads, and/or enabling Google Analytics on your site. Learn more about using Adtoniq to show acceptable ads on your site.

Estimating your ad block losses

Enter your monthly page RPM and Adtoniq does the rest to estimate your losses due to ad blocking. This is how Adtoniq calculates the blocked revenue displayed in the analytics tab.

Adtoniq uses a simple formula to estimate your monthly ad block losses, that relies on you first determining one key number: How much revenue does your website normally generate for each non-blocked pageview? This is expressed as revenue per thousand pageviews, abbreviated as RPM for Revenue Per Mille (thousand). If you use AdSense, this is simply the page RPM you can find in your AdSense reports. If you use other services, you may need to put more time into calculating your RPM. Once you know your page RPM, you may enter it into the RPM box on the Analytics tab. From that point on, Adtoniq will calculate your monthly and realtime blocked revenue based on the RPM you enter.

To determine your monthly ad block losses, Adtoniq multiplies the RPM you enter by your monthly blocked pageviews, and then divide by 1000 to account for the M in RPM. This will approximate the amount of ad revenue you are losing due to ad blockers.

But what about Google Analytics? If that is blocked, how does that affect your revenue, since it's not like an ad network that pays you money for your ad unit inventory? Using Google Analytics correctly should result in increased revenue, as compared with not using it. That should be, after all, a primary reason you use Google Analytics.

To determine the financial impact that ad blockers have on Google Analytics, think about the various ways in which you have used it to improve the performance of your website. If Google Analytics were blocked 100%, how would this impact your ability to optimize your revenue? Did you optimize your website flow because you understand how users are behaving on your site? Did this optimization result in more revenue? How much more revenue?

A simple way to estimate your losses from blocked analytics is to take the total monthly revenue generated by your website, and then divide that by an amount that represents the increased revenue you've generated by using Google Analytics. The ad block loss calculator on the home page of divides your revenue by 350, which is a good average number for websites, but you can choose to use your own number too. For example, if you make $1,000 per month from your website, then on average proper use of Google Analytics can increase your revenue by $1000 ÷ 350 = $2.86 per month.

We need to adjust this number according to the number of users that block Google Analytics. This is not the same as the number of users with ad blockers, because not ad blockers block Google Analytics. Adtoniq tracks the number of users that block Google Analytics and reports this on the analytics tab. If we take that $2.86 and multiply that by your Google Analytics block rate, we can estimate the impact . For example, if 10% of your users block Google Analytics, then you are losing approximately $2.85 ÷ 10 = $0.29 per month due to the affect that ad blockers have on Google Analytics.

What next?

Once you have a handle on your ad block losses, you can easily build a strategy to address your ad blocked audience. To restore Google Analytics or AdSense, use Adtoniq messaging to reach out to your ad block audience and ask them to opt in to re-enabling these services. They will be presented with a button to click on the bottom of your site that permits them to opt in with a simple tap or click. You may use Adtoniq content protection to restrict parts of your site only to ad blocked users as an incentive to opt in. Once they opt in, your services will be restored.

You may also use Adtoniq shortcodes to give you more control over which content on your site is protected, and how and where you communicate with your ad blocked audience. Developers can use the Adtoniq JavaScript API for full control over the ad blocked experience. For working examples showing you different ways you can use Adtoniq, visit our live examples site.

Getting customer support

We have these ways you can reach us for customer support:
  1. Email us at
  2. Call us at +1.415.340.1949.
  3. Use the chat widget on the bottom right of this page.

We staff our customer support channels Monday - Friday, 9-6pm Pacific Standard Time. During non-business hours you may have more of a delay before someone gets back to you.


About Adtoniq Messaging

Adtoniq Messaging lets you present a customized message to your users at the bottom of your site. Typically this message would be something like this: We rely on advertising to pay our bills. Please support us by opting in to ads. You can see a variety of live examples of Adtoniq in action to get a feel for how you can use Adtoniq messaging, in conjunction with other features, to incentivize your users to opt in. You can enter any message you like, using the built-in message editor. You are free to use as much custom HTML, CSS and JavaScript as you wish, using the Text tab of the editor. Or you can use the Visual tab for simple rich text editing.

You choose which of your users see the message (see below). Your chosen users will continue to see the message on every page view until they opt in or opt out of the choices you give them by clicking a button on the bottom of the page.

Once your blocked users opt in, Adtoniq will drop a cookie on their browser to remember their choice, and thereafter automatically bypass their adblocker, even if it is enabled. This has a number of significant advantages over asking the user to whitelist you using their ad blocker, or asking them to disable their ad blocker:

  1. Some mobile ad blocked users, and users behind network based ad blockers often found in large organizations, don't even have the option of disabling their ad blocker, even if they wanted to. Adtoniq allows these users to whitelist you for the first time.
  2. Adtoniq allows your users to effectively disable their ad blocker with a single tap or click on the bottom of your site. Since all ad blockers require two or more clicks in order to whitelist a website, this dramatically increases the success rate of asking users to opt in by reducing the friction involved in doing so.
  3. The friction required to whitelist a site with a mobile ad blocker can be considerable. For example, for an iPhone user using AdBlock Plus, they must exit their browser (never a good thing), go to settings, scroll down to find Content Blockers, and then the steps go on and on. Will your user even remember what they were looking for by the time they're done with all that?

Your Message

Your message should succintly explain your value exchange with ad blocked users: To what are you asking your ad blocked users to consent, and What are you offering in exchange? In addition, you can include a link to a page you set up explaining things in more detail. Here are some examples:

  1. We rely on ads to fund our free content. Please support us by allowing ads.
  2. Please opt in to allow ads for best content experience.
  3. Ads allow us to bring you the content you love.
  4. Please opt in to help support our free content.
  5. We show ads on our site to cover our costs for bringing you our content. Please support us by opting in to seeing our ads. Learn more

Formatting and advanced messages

Adtoniq includes a simple visual editor giving you basic rich text formatting options including bold, italic, justification, and links. Your message should pick up your default font. For more advanced formatting, use the Text editor which will let you enter whatever HTML you like for your message.

Opt-In Strategies

You can choose from one of three opt-in strategies:

  1. Opt-in only means Adtoniq will automatically append one button to your message, with customizable text and style, that allows your users to opt in to the choice you present. You implicitly select this option by entering text for your confirm button and leaving the text for the "Reject button text" blank or empty. Your users will continue seeing your message until they opt in. There is no choice to opt out. Once they opt in, Adtoniq will bypass their adblocker to enable Google Analytics, if you use that, and AdSense, if you use that.

    Experience an example of the opt-in only strategy live.

  2. Opt-in or opt-out means Adtoniq will automatically append two buttons to your message, with customizable text and style, that allow your users to opt in or opt out. You implicitly select this choice by filling in some text for both the confirm button and the Reject button text. If they opt in, it's the same as above. If they opt out, Adtoniq will not bypass their ad blocker. You can optionally combine this with content protection to motivate your ad blocked users to opt in, beyond the "be a good guy" appeal. If you use content protection, users that opt out will not see your protected content.

    Experience an example of the opt-in or opt-out strategy live.

  3. No choices means Adtoniq will not append any buttons to your message. This approach does not utilize Adtoniq's one-click consent technology to bypass ad blockers, and instead relies on an appeal to ask your user to disable (whitelist) their ad blocker. The message will be displayed so long as their ad blocker is enabled. Once they disable their ad blocker and refresh the page, your message will no longer be displayed, unless they enable their ad blocker again.

    Experience an example of the no choices strategy live.

Enable alert

Use the Enable alert button as a master control to turn messaging on or off. This allows you turn messaging and protection completely off without losing your settings and content.

Show the message for...

Use the Show message for buttons to select which of your users see the message. You have these choices:

  1. All users shows the message to all visitors of your site, whether they have an ad blocker or not. This is useful if you'd like to get permission from all your users before enabling Google Analytics and AdSense, not just your blocked users. If your audience is particularly sensitive to being tracked and seeing ads, or if you have a high ad block rate, this option may make sense.
  2. Choose Users blocking ads to display the message only to users blocking ads. Use this if you want to enable AdSense for ad blocked users and do not wish to enable Google Analytics. This will show a message only to those users blocking ads, asking them to opt in to seeing your ads.
  3. While all ad blockers block ads, not all of them block analytics. Choose Users blocking ads and analytics to display the message only to users blocking both ads and analytics. Use this if you want to enable Google Analytics for ad blocked users.

A choice you do not have is the choice to show the message only to users blocking analytics. The reason for this lack of choice, is that the way ad blockers work, ad blockers that block analytics always also block ads. That is, there is no case where a user shows up on your site blocking analytics but allowing ads. What does show up is users blocking both ads and analytics, which is the third available choice above. This is the choice to use if you want to enable Google Analytics.

Message Options

Use the Message Options for area to edit the message you show to your users, a message displayed after users opt in, and a different message displayed after users opt out.

Use the pulldown menu to select which of three messages to edit:
  1. Greeting message is the primary message that will be shown to users on your site that meet the criteria you selected in the "Show the message for" area. You may use rich text editing or raw HTML (Text) mode to enter any CSS or JavaScript you wish.
  2. Confirm message is the message that will be shown to users after they tap or click the Confirm or opt-in button. Use this to thank your users for opting in, or otherwise confirm their choice.
  3. Reject message is the message that will be shown to users after they tap or click the Reject or opt-out button. Use this to explain the consequences (such as content protection), if any, for opting out, and otherwise confirm that they have opted out.

Button Options

Use the Button Options area to edit the text and appearance of the confirm and reject buttons that appear next to your message, and that allow your users to opt in or opt out.

  1. Confirm button text is text that appears inside the button that allows the user to opt in. This field is optional. Your users must click this button in order for Adtoniq for Google Analytics or Adtoniq for AdSense to work.
  2. Reject button text is optional. If you leave this blank, your users will only have the choice to opt in. If you enter text for the reject button, users will see two buttons next to your message. When combined with a content protection strategy, clicking the Reject button prevents that user from seeing your protected content.
  3. Custom button class is an optional CSS style that will be used to style the confirm and reject buttons. It is up to you to implement the style somewhere, whether that's in an existing style sheet or elsewhere.

The difference between a one-button solution and a two-button solution is significant. The one button solution does not allow the user to opt out of your message, so the message will follow them around the site until they opt in. There is no way to dismiss the message without opting in.

A two button solution gives the user a way to dismiss the message without opting in - by opting out. You may or may not choose to offer your users an incentive for users to opt in. That incentive can take a variety of different forms, including using Adtoniq content protection to reward users who opt in with additional content or features. You may also deliver an incentive in the Confirm message text area, for example a link to a special offer could be placed there.


About Adtoniq Protection

You can potentially increase the number of ad blocked users who opt in to your message, enabling Adtoniq for Google Analytics and Adtoniq for AdSense to bypass your users' ad blockers, by giving them an incentive to do so. Content protection allows you to hold back content or functionality on your site until they opt in. You would typically communicate this incentive using Adtoniq messaging.

See a live example of content protection to understand how this works in real life. In order to experience this example, you must visit the site using an ad blocker that blocks analytics, for example by enabling the easy privacy option in your ad blocker. The purpose of this example is to restore Google Analytics only, not to restore AdSense, so this example will only detect if you are blocking analytics. If you show up with an ad blocker that does not block analytics, you will not see the message, by design.

Site Protection Status

You have three choices for setting your site protection status:
  1. No protection means nothing on your site is protected.
  2. Home page allowed but rest of site protected means that your users can see your home page, but if they visit any other page, they will be redirected to your ad block page (read more about that below). See a live example of home page only allowed.
  3. Entire site is protected means all pages on your site are protected, and users will be redirected to your ad block page. See a live example of entire site protected.

Use the Send adblocked users to this page field to enter the page URL to send your users to when the site is protected. No matter which site protection status you select, your ad block page you enter here is never protected, because this is where you explain that they must opt in to your message in order to see your site.

Short Codes

About Adtoniq Shortcodes

WordPress shortcodes provide a more flexible and powerful way of implementing messaging and protection, than are provided by the built-in Messaging and Protection features. You can place shortcodes anywhere in your pages and posts. To place shortcodes in the WordPress sidebar, you will need to enable shortcodes in your sidebar because they are diabled by default. One way you can do this is by using the Shortcode Widget.

List of Adtoniq Shortcodes

  • adtoniq_protect - Hide content from users with ad blockers until they opt in
  • adtoniq_message_adblocked - Show content to users who are using an ad blocker
  • adtoniq_message_adblocked_noacceptable - Show content to users who have an ad blocker and also have acceptable ads disabled
  • adtoniq_message_adblocked_acceptable - Show content to users who have an ad blocker but have acceptable ads enabled
  • adtoniq_message_nonblocked - Show content to users who have no ad blocker
  • adtoniq_message_blocked_analytics - Show content to users who are blocking analytics
  • adtoniq_clear_choice - Show content to users who are blocking analytics

Each of these shortcodes is described in detail below.


Content inside the [adtoniq_protect] shortcode will only be displayed to these users:
  • Users that have no ad blocker or who have disabled their ad blocker will see content inside this shortcode.
  • Users that have opted in to your message will see content inside this shortcode, even if they have an ad blocker. Adtoniq uses a cookie to track opt in status, so if the user clears their cookie or uses an incognito browser, they will see the message again and will need to opt in again to see content inside this shortcode.
Otherwise, the content is not displayed.

Example: [adtoniq_protect]Put your snazzy video or other protected content here[/adtoniq_protect]


Content inside the [adtoniq_message_adblocked] shortcode will only be displayed to users that are blocking ads. Otherwise, the content is not displayed. Use this to send a message to your ad blocking users.

Example: [adtoniq_message_adblocked]Please opt in to seeing ads by clicking the button below[/adtoniq_message_adblocked]


Content inside the [adtoniq_message_adblocked_noacceptable] shortcode will only be displayed to users with an ad blocker that have acceptable ads disabled. Otherwise, the content is not displayed. Use this to send a message to users when you wish to ask them to opt in to showing acceptable ads.

Example: [adtoniq_message_adblocked_noacceptable]Please enable acceptable ads[/adtoniq_message_adblocked_noacceptable]


Content inside the [adtoniq_message_adblocked_acceptable] shortcode will only be displayed to users with an ad blocker that have acceptable ads enabled. Otherwise, the content is not displayed. Use this to thank users for supporting acceptable ads.

Example: [adtoniq_message_adblocked_acceptable]Place your acceptable ad tag here[/adtoniq_message_adblocked_acceptable]


Content inside the [adtoniq_message_nonblocked] shortcode will only be displayed to users with no ad blocker.

Example: [adtoniq_message_nonblocked]Thank you for not using an ad blocker[/adtoniq_message_nonblocked]


Content inside the [adtoniq_message_blocked_analytics] shortcode will only be displayed to users with an ad blocker that are also blocking analytics. This is often achieved by subscribing to the easyprivacy list.

Example: [adtoniq_message_blocked_analytics]Please opt in to using analytics by clicking the button below[/adtoniq_message_blocked_analytics]


Content inside the [adtoniq_message_blocked_analytics] shortcode will only be displayed to users with an ad blocker that are also blocking analytics./a>.

Example: [adtoniq_message_nonblocked_analytics]Thanks for not blocking analytics[/adtoniq_message_nonblocked_analytics]


This shortcode displays a button or link that allows the user to clear their Adtoniq choice cookie and then refreshes the page. This will display your message to your ad blocked users again, if they have previously made a choice. This shortcode takes one optional parameter, named 'style', that specifies whether to display a push button or a link.

When using AdSense, you should place this shortcode somewhere on your 'Why am I seeing ads?' page to allow your users to change their mind.

Example: [adtoniq_clear_choice style='button']Clear your choice and choose again[/adtoniq_clear_choice]

JavaScript API

About the Adtoniq JavaScript API

The Adtoniq JavaScript API provides a callback mechanism for your JavaScript code so that you can be alerted of various Adtoniq events. Each function takes one parameter, which is the callback function to invoke. The following functions are available:


The addAdBlockerCallback function is called when the ad block detection phase is completed. The callback function is passed four boolean parameters which indicate the results of the ad block detection phase and give you fine grained control over how you'd like to respond:
  1. blocksNetworkServices is true if the ad blocker blocks network connections to common services such as ad servers
  2. hidesElements is true if the ad blocker hides or collapses elements on the page like ad units or messages
  3. allowsAcceptableAds is true if the ad blocker is configured to allow acceptable ads
  4. allowsAnalytics is true if the ad blocker is configured to allow analytics services such as Google Analytics to run
For example, if your user is preventing ads from running, you might choose a range of responses to that, ranging from asking them to whitelist you, to offering a subscription, or restricting or metering content. If page elements are being hidden on your pages, this is typically ad units on the page that have been hidden. You can choose to dynamically fill these locations with other content, with the understanding that this content may only be displayed to ad blocked users if you so choose. If the ad blocker allows acceptable ads, you may choose to replace your normal ad units with acceptable ads from your choice of ad network. If allowsAnalytics is true, you know that this blocker is allowing analytics services such as Google Analytics to run. If this is false, you may choose to interact with the ad blocked user, offering them an incentive for letting you track them, along with one or more ways to opt out of being tracked.


The addNoAdBlockerCallback function is used to add a callback function when no ad blocker is detected. The callback function is passed no parameters. You could use this function to display a thank you message to your readers for not blocking your content.


The onBlocked function is used to add a callback function as soon as the first ad block detection signal is received. This will usually be much faster than addAdBlockerCallback because it will fire on the first ad block detection signal, as opposed to waiting for all signals to arrive. If you want to interact with your ad blocked audience without waiting for all the signals to come in, you should hook this event. The callback function is passed no parameters.


The onAnalyticsBlocked function is used to add a callback function if the ad blocker is actively blocking analytics from running. If you want to interact with this segment of your ad blocked audience, you should hook this event. The callback function is passed no parameters.


Use the setAdUnitLocator function in conjunction with Adtoniq for AdSense to specify where the ad units are on your page. Alternatively, you can write a CSS Selector and enter that into the AdSense tab. If you have already written a CSS selector, this funciton will override that. The function takes one argument, which is a function which should return the list of ad units on the page.

For example, this would find the AdSense ad units already on your page, and is the default method for locating ad units if you do not otherwise override it:

adtoniq.setAdUnitLocator(function() {return document.querySelectorAll('ins')});

Adtoniq Cloud

About Adtoniq Cloud

Adtoniq Cloud gives you access to additional premium services available in your plugin which includes:
  1. Adtoniq Analytics
  2. Adtoniq for Google Analytics
  3. Adtoniq for AdSense

When you sign up for Adtoniq Cloud, you get one month of service for free, so that you can see if Adtoniq Cloud is right for you. We'll also tell you what your bill would have been, so you can understand what your actual charges might be. After your one month trial, you must enter a credit card to continue Adtoniq Cloud services, or contact us to extend your free trial.

Signing In

To sign in to Adtoniq Cloud, go to the top of and click the Sign In button on the top right. Enter the email address and password you entered when registering and click SIGN IN.

If you've forgotton your password, click the Forgot sign in details? link to receive a password reset by email, at the email address you used when registering.

Authorizing websites

To use Adtoniq Cloud, you must authorize each website using Adtoniq Cloud services. To authorize a website, enter the fully qualified domain name for your website, for example Once you authorize your site, Adtoniq will generate a unique Cloud Key for you, which you then copy and paste into the Adtoniq Cloud tab of the WordPress plugin.

To de-authorize a website you are no longer using, select the website and click the Delete button.

Please note that localhost is not a fully qualified domain name. If you wish you use a private server, use an FQDN like localhost.your-local-domain.

Enhanced analytics

While you can see most analytics from within the WordPress plugin, you can see more advanced analytics from within Adtoniq Cloud. To see advanced analytics, select the website you which to view and then click the Analytics button.

In addition to the basic ad block analytics you can also see the number of pageviews of ad blocked users who have opted in or out of your messaging, and the revenue you have recovered in the last 30 days, based on the Page RPM you entered. This information is only recorded for ad blocked pageviews. Non-blocked pageviews are not counted. Every time an ad blocked user who has opted in generates a pageview, that increments the Opt In counter. Every time an ad blocked user who has opted out generates a pageview, that increments the Opt Out counter. Every time an ad blocked user who has neither opted in nor out generates a pageview, that increments the No Choice counter.

If your messaging only has one opt in button in it, you should only see the number of Opt Ins increasing. If you have both opt in and opt out buttons, you should see both numbers increasing. If you have no buttons in your messaging, your should see neither opt ins nor opt outs. From a mathematical perspective:

No choice + Opt In + Opt Out = Acceptable ads only + Full ad block


After your initial one month free trial, you are billed monthly based on usage. To learn how much Adtoniq cloud services cost and estimate your monthly bill, use our cost calculator to estimate your monthly charges.

Adtoniq automatically gives you a volume discount as you use Adtoniq Cloud more. This discount is aggregated across all your websites, and caps out at 80%.

Google Analytics

About Adtoniq for Google Analytics

Google Analytics is the most popular analytics tool on the planet and is used to gain insights into your website's audience demographics and behavior, for the purpose of improving website and business goals. Adtoniq for Google Analytics leverages this platform to give you insight into your ad blocked audience to help you better understand and monetize them. It can help you answer questions like:
  1. How does your ad blocked audience behave differently from your non-blocked audience?
  2. What are the demographic differences?
  3. What is the impact of your blocked audience on your revenue, KPIs, and website goals?
  4. How much of your audience has opted into acceptable advertising?

You must have a Google Analytics account in order to use Adtoniq's Google Anlyatics service. Click here to learn how to get a Google Analytics account. You will need to create a Google Analytics property for your website, which in turn will assign a unique tracking ID for that site which you must paste into Adtoniq's Google Analytics settings.

Once you enter your Google Analytics tracking ID into Adtoniq, Adtoniq will record ad block data about your users on every single page view, using custom dimensions which you must set up in your property. You can import Adtoniq's segments and dashboards from the Google Analytics solution gallery to view your analytics, and you can use all of Google Analytics other reporting tools as well.

If a user blocks Google Analytics and you have a messaging strategy targeting these users, once those users opt in, Adtoniq will begin sending data for these users as well, even if their ad blocker is configured to block Google Analytics. In this way, Adtoniq increases the number of users for whom you are gathering analytics data, giving you higher quality data.

Analytics are worthless unless they are used to make measurable improvements to your website or business based on information and insights gleaned. Armed with this knowledge, the next step after answering these questions is to design a plan to better monetize your blocked audience which should start with a thorough understanding of their needs, behavior, and potential value if you treat them "right". Such a plan to monetize your blocked audience might include using Adtoniq shortcodes or the Adtoniq JavaScript API to engage with your blocked audience, offer them choices, as well as protect content, offer subscriptions, and ask users to whitelist you.

Google Analytics Settings

Once you create a property in Google Analytics, you will be assigned a tracking Id for that website. Enter your full Google Analytics tracking ID into Adtoniq. If your website exceeds Google Analytics limits, you can use Adtoniq's optional traffic splitting feature to stay within your quota.

Adding custom dimensions

In your Google Analytics account, use an existing property or create a new property for Adtoniq. In the Admin area, you will need to add custom dimensions as shown in the screen snapshot below. Important: If your property already has custom dimensions, you must create a new property rather than use your existing property, because custom dimension numbers in Google Analytics are hard coded natural numbers that must start with dimension #1.

Here's a video showing you how to set up your custom dimensions:

When you are finished setting up your custom dimensions, they should look like this:

Pay careful attention to ensure that you create the custom dimensions in the correct order — that the Index number matches what you see in the screen snapshot.

Also pay special attention to ensure that you create dimensions 6 and 7 with session and user scope respectively, as shown.

Importing Adtoniq segments and dashbaords

Adtoniq publishes custom dashboards and segments in the Google Analytics Solutions Gallery. These are designed to give you best practice reports on ad blocking, based on our industry experience understanding how best to analyze your ad blocked web. Learn more about Google Analytics segments. Learn more about Google Analytics custom dashboards.

To access Adtoniq custom dashboards and segments, follow these steps outlined in more detail below.

  1. Go to Adtoniq's page in the Google Analytics Solution Gallery and click Import button.
  2. Select the views to import Adtoniq
  3. Optionally deselect objects you do not want to import
  4. Click Create

1. Go to Solution Gallery and click import

Adtoniq custom dashboards and segments can be imported from the Adtoniq page in the Google Analytics Solutions Gallery. Click the Import button to import Adtoniq custom segments and dashboards into your Google Analtyics account. .

2. Select Views

On the import screen, select any view to import items to all account views, or select the appropriate view from the drop-down for a specific view. Note: custom segments and dashboards will only be available from the view you select in this step. .

3. Select object configurations to import

You may optionally select or deselect custom segments/dashboards as appropriate, or leave them all selected by default. .

4. Click Create

Finally, click the Create button to complete the import process. After the import is completed, you can then view Adtoniq's custom segments and dashboards as described in the next sections. .

Viewing Adtoniq segments

From any report or dashboard screen, click "+ Add Segment," and select appropriate segment(s) to compare or filter your data as desired.




View Adtoniq dashboards

Go to Customization > Dashboards, and select any of the imported custom dashboards.



About Adtoniq for AdSense

Please note this feature is currently in closed beta. If you wish to participate in the closed beta, contact us at or use the chat widget on the lower right.

Adtoniq for AdSense can significantly increase your ad revenue by showing fully functional AdSense ads to your ad blocked users, once they opt in to your custom message to get their permission. If your ad blocked users do not opt in, Adtoniq for AdSense will not display ads to those users. This feature does not alter the way your non-blocked users experience your site, and only activates for your ad blocked users. You will need an AdSense account in order to use this feature. If you do not have an AdSense account, you can get a free AdSense account here.

Before using Adtoniq for AdSense, you must already be delivering AdSense ad impressions to your site for your non blocked users. You can use a number of different tools to do this. See the links in the additional resources section below for help on adding AdSense to your site.

When ad blocked users opt in to your messaging, Adtoniq will automatically find the AdSense ad units you have placed on your site, make them visible again, and then deliver fully functional AdSense ads to those ad units. If you rely on Google's autoads feature to automatically find locations for ads on your site, Adtoniq will not be able to find ad units on your site. You can still use Adtoniq with autoads, but you will have to do a little more work to teach Adtoniq where to place your ads. This is discussed in more detail below.

If you display another type of advertising on your website in addition to AdSense, those ads will likely be blocked by ad blockers, and Adtoniq does not restore those ads from those ad networks. For example, if you display ads from your DoubleClick account or Media.Net, those ads may be blocked. With Adtoniq for AdSense, you can use an ad replacement strategy to replace your other ads with AdSense ads, only for your ad blocked audience that opts in to your messaging.

Overview of set up steps

You will need to go through the following steps to set up Adtoniq for AdSense, described in more detail below. If you have a test server available to you, you may want to install Adtoniq on your test server first to experiment with it to see how it works.

  1. If you haven't already, Install Adtoniq, get an Adtoniq Cloud account, and authorize your website with Adtoniq. If you've already installed Adtoniq, make sure you are updated to the latest version.
  2. Get a Google AdSense account if you don't already have one and ensure you can show AdSense ads on your site for non-blocked users.
  3. Request access to Adtoniq's Adsense beta ( or our chat widget) if you haven't already been accepted.
  4. Go through the Adtoniq for Adsense settings to configure Adtoniq for your site.
  5. Set up the why-am-i-seeing-ads page.
  6. Create a message to show to your ad blocked users, asking them to opt in to seeing ads on your site. If you also wish to restore Google Analytics, your message should ask the user to opt in to both ads and analytics.
  7. Choose an opt-in strategy
  8. Decide whether you want to use content protection
  9. When everything is ready, deploy
The rest of this page provides details for these steps.


AdSense Publisher ID

Enter your AdSense Publisher ID assigned to your account. Learn how to find your AdSense publisher ID. Ads will be served from this account and all ad revenue will accrue to this account.

AdSense ad unit code snippet

If you leave this field blank, Adtoniq will deliver ads to your existing AdSense ad units using the AdSense ad units (ad slots) you already have on your page. To use Adtoniq on non AdSense ad units, or to calculate how much revenue Adtoniq generates for you, you will need to paste the AdSense ad unit code snippet you wish to use in this field.

You get your ad unit code snippet from your Google AdSense account. When Adtoniq delivers ads on your page, it uses the information inside your ad unit code snippet. While you can use an existing ad unit, Adtoniq recommends creating a new ad unit so that you can measure the precise financial benefit you are receiving from Adtoniq. You will not manually place this new ad unit on your site the way you would place other ad units on your site. Instead, you paste the ad unit code snippet here and Adtoniq will create your ad units from that. To get your AdSense ad unit code snippet, follow these steps:

  1. Sign in to your AdSense account. Tip: If you use an ad blocker, you'll need to disable your ad blocker to sign in to your AdSense account.
  2. Click on the "My Ads" section.
  3. Click on the "Ad units" link. Note: Adtoniq for AdSense does not work with Auto ads at this time.
  4. Click on the "+New ad unit" button to create a new ad unit. Alternatively, you can skip the steps to create a new ad unit, but then you won't be able to calculate how much revenue your Adtoniq solution is generating for you.
  5. Choose one of the available ad types.
  6. Name your ad unit and configure other options as needed.
  7. Click the "Save and get code" button to get your ad unit code snippet.
  8. Copy / paste your ad unit code snippet into Adtoniq into the field indicated.

CSS Selector

If you leave the CSS Selector field blank, Adtoniq will automatically discover the AdSense ad units you have on your site, make them visible, and deliver fully functional ads in those ad units. Adtoniq will not find other locations on your site to place ads, for example your non AdSense ad units.

To target additional ad units on your site, you can enter a CSS selector to specfy the HTML elements on your page that are your ad units. AdSense ads will only be placed inside those specified ad units.

The default CSS selector actually used by Adtoniq if you leave this field blank is ins, which targets the <ins/> elements used by AdSense ad units. You can combine multiple CSS selectors together by separating them with a comma, so if you want to include all existing AdSense ad units on your page and additional ad units, you will need to include ins in your CSS selector. For example, let's say you have a non AdSense ad unit designed for leaderboard ads at 728x90, and it looks like this on your site:

<div id="big-leader"/></div/>

To target this non AdSense ad unit in addition to your existing AdSense ad units, you would use this CSS selector:


Breaking this down, the ins part of the selector picks up your existing AdSense ad units, the comma separates that from the next CSS Selector, and the #big-leader selects your non AdSense leaderboard ad unit.

Adtoniq checks the CSS selector you enter for errors and will validate your CSS selector syntax to ensure you enter a valid CSS selector.

Here are some resources on writing CSS Selectors:

Maximum Ad Units

Specify the maximum number of AdSense ad units that Adtoniq should display per page. This affects ad blocked users only.

Enable adblock bypass

Enable Adtoniq for AdSense by checking the box labeled Enable adblock bypass. When enabled, Adtoniq will show AdSense ads to your ad blocked users, with their permission.

Additional resources

Here are some resources on properly adding AdSense to your WordPress site:

Creating the why-am-i-seeing-ads page

When Adtoniq shows ads to your ad blocked users, it inserts a link to allow users to understand why they are seeing ads on your site, despite the fact that their ad blocker is enabled. The link looks like this:

You must create a new top level page for ad blocked users with the permalink why-am-i-seeing-ads, where they can learn more about what they are opting in to. On this page, use the adtoniq_clear_choice shortcode to let your users change their mind and choose over again. For example, you might use this:  [adtoniq_clear_choice style="anchor"]click here to change your mind[/adtoniq_clear_choice].

Here's a simple example of a why-am-i-seeing-ads page. You could add however much additional content you like. Here's another example showing a different wording.

Live Examples

You can view these live examples to see Adtoniq for AdSense in action::

  1. The Opt-in to usng AdSense example demonstrates a simple approach that is easy to set up.
  2. The Protecting Premium Content is more advanced and uses content protection to motivate the reader to opt in to seeing ads.