Advanced
Overview 🔗
EzoicAds provides advanced features that allow publishers to fine-tune the behavior of the ad library. These features can be used to customize the behavior of the ad library to better suit the needs of your site.
Configurable Options 🔗
There are configurable options available in EzoicAds that can be used to customize the behavior of the ad library. These options can be set using the ezstandalone.config()
function.
Setting Configuration Options 🔗
To set configuration options, use the following syntax:
1ezstandalone.cmd.push(function() {
2 ezstandalone.config({
3 // Configuration options go here
4 });
5});
Place this code after the EzoicAds header script, but before calling ezstandalone.enable()
or ezstandalone.showAds()
.
Available Options 🔗
Option | Type | Default | Description |
---|---|---|---|
limitCookies |
Boolean | false |
Enables more precise control over cookie usage on your site. |
anchorAdPosition |
String | bottom |
Change the position of the anchor ad to be at the top or bottom of the page. |
Limit Cookies 🔗
When enabled, the Limit Cookies feature ensures that only essential cookies required by Ezoic are included by default. This provides greater control over user privacy and helps with compliance to various data protection regulations.
To enable Limit Cookies:
1ezstandalone.cmd.push(function() {
2 ezstandalone.config({ limitCookies: true });
3});
Anchor Ad Position 🔗
Allows you to change the position of the Anchor Ad to be at the top or bottom of the page. Acceptable values are 'top' or 'bottom'. The Anchor Ad will be located at the bottom of the page by default.
For example to set the anchor ad position to be at the top of the page:
1ezstandalone.cmd.push(function() {
2 ezstandalone.config({ anchorAdPosition: "top" });
3});
More options will be added in the future. Please check back for updates.
Tracking Data 🔗
If you would like to track data even on pages that are not showing ads you can include the script below. This is specifically helpful in the starting stages of testing when you are not ready to show ads yet.
1<script src="//ezoicanalytics.com/analytics.js"></script>
Splitting Traffic 🔗
Unlike our other integration methods, splitting traffic happens clientside.
Using the ezstandalone.isEzoicUser
function, you can split traffic on a percentage of your traffic.
isEzoicUser
function splits based on a user's session, not pageviews.
Example 🔗
Below is an example of splitting 50 percent of your traffic with Ezoic.
1<script type="text/javascript">
2 ezstandalone.cmd = ezstandalone.cmd || [];
3 ezstandalone.cmd.push(function() {
4 var percentageToRunEzoic = 50;
5 if(ezstandalone.isEzoicUser(percentageToRunEzoic)) {
6 ezstandalone.showAds(100,101);
7 } else {
8 // Normal ad code execution
9 }
10 });
11</script>