> For the complete documentation index, see [llms.txt](https://docs.exads.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exads.com/publishers/sites-and-zones/create-zone.md). # Creating a Zone This page is for Publishers. It shows you how to create an ad zone, set it up for your chosen format, and add the ad zone code to your site. ## Step 1: Creating a New Zone To create an ad zone, click on the **Sites & Zones** tab, and then the **New Zone** button. ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FXV4UC7KowaGPWzZOrgBZ%2FAdd-New-Zone.png?alt=media\&token=e7f00585-16e6-41b0-a68a-58f7ab163ad0) When you click the **New Zone** button, select the website(s) where the ad zone is added. If there are multiple sites available, they appear in a drop-down. The left side lists all the available ad zone formats. Select the one you wish to use and click **Next** at the bottom of the page. ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FpreKGZQ8jRbIp5wZQCVF%2Fcreate-zone-step1.gif?alt=media\&token=aa43c53b-5383-4122-b49d-c92951c3634c) {% hint style="info" %} **Note**: There is a limit (set per network) to how many active zones an account can have. There is no limit to the number of archived zones. {% endhint %} ## Creating RTB Ad Zones {% hint style="info" %} **Note**: This feature is only available to advanced users. {% endhint %} ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FqYgKfxlwxNwFAQNWqybe%2Fselect-partner-ad-zone.png?alt=media\&token=11bcb727-74ed-43cc-83ee-dba7346b52d9) If you choose to create any of the RTB ad zones, choose which Ad Partner to use from the **Select a Partner** drop-down. The template for the ad is chosen automatically according to the ad partner you choose. ## Step 2: Setting Up Your Chosen Format After you click **Next**, fill in the details for the new ad zone. The options available depend on which format you select. ## Web ### Banner ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FpKRWJfMjEXEgTBH345lc%2Fzone_banner.png?alt=media\&token=49bc91eb-8d51-41d7-bc23-e25557678a33) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Format** | Choose which format of banner you wish to use. | | **Ad Refresh** | Allows you to refresh the ad up to 10 times per unique user. Available only for **Asynchronous script**. Ad refresh can be configured at intervals of 30, 60, 90 and 120 seconds. | | **Border** | Choose a width for a border for the banner ad, from **No Border** to 5 pixels. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](/publishers/sites-and-zones/create-zone.md#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Responsive Display Ads** | This option is available only for Ad Servers with Responsive Display Ads (RDA) enabled. It supports standard banner sizes (e.g. 300x250, 728x90, 160x600) and fullpage interstitials (mobile and desktop), including sticky and mobile variants where applicable. When activated, eligible placements receive demand from Native Ad campaigns through the bidding auction. Winning campaigns are rendered responsively within the format's layout. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Count Only Viewed Impressions** | With this option, define whether the impressions on a specific zone are tracked when the ad is **rendered (if the toggle is off)** or **viewed (if the toggle is on)**. The default value is off, meaning the impressions are tracked when the ad is rendered. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | When you have filled in the details for the new zone, click **Create**. On the **Your Zone HTML Tag** screen you can then choose the tag type which you wish to use: * iFrame * Asynchronous Script **Using the Asynchronous Script** When creating a **Banner** (or **Mobile Banner**) zone, you can use this tag to ensure that zones are loaded on to the page asynchronously. This means other content can load while the ads are loading. You can also use it to place multiple zones on the same page. **Single Zone** To use the script for a single zone, simply copy the code onto your site as normal. {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} **Multiple Zone** You can also use this script to put multiple existing banner zones onto a single page. To use this script for multiple zones, copy the code onto your site, and repeat the middle section for each zone you wish to put on the page. Replace the `data-zoneid` with the id for these existing zones (e.g. 111, 222, 333): {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} You can also add [tags](/publishers/sites-and-zones/using-tags.md) and [Sub IDs](/publishers/sites-and-zones/subids.md#multi-format) to your asynchronous scripts. Asynchronous scripts support the `el` parameter, which returns the Base64-encoded email of the user, as in this example: {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} **Lazy Load** Visibility is not tracked for Asynchronous Tags out of the box at the moment. However, you can create a callback function based on the ad snippet, like **lazyLoadAd** in the example below. This function can then be used in a callback to display the ad when the visibility detection code triggers an event. {% code overflow="wrap" expandable="true" %} ```html
``` {% endcode %} ### Popunder ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2F1O0gSeykhty1HW4LB4rU%2Fzone_popunder.png?alt=media\&token=439a0a08-db9b-4f81-8900-5f4f3f46aa13) | Option | Explanation | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Capping** | Choose this option to enable capping (display frequency) for popunder. | | **Return URL** | This is a secondary URL that the popunder can direct to, if it does not generate enough revenue. | | **Frequency**/**Every** | Set how often you wish the ad to appear. | | **Delay Between Executions** | Set a delay in the Popunders execution to prevent them from executing on consecutive clicks and in a case where there are multiple actions in the period. This can only be used when Frequency is more than 1. | | **Force Pop-Up** | Choose this option to always show a popup instead of a popunder. | | **Fallback to Popup** | If there are any difficulties showing a popunder (due to browser for example), choose this option to fallback to a popup. | | **New Tab** | This option makes popunders appear in a tab instead of a window. It has no effect on browsers that already open popunders in a tab by default, such as Chrome. | | **Trigger Method** | Choose what action on the user's part causes the popunder to show: clicking anywhere on the page, on links, only when clicking on a specific class, or anywhere on the page, excluding specific classes. | | **Chrome Enabled** | Enabled: popunders show on all browsers. Disabled: popunders do not show on Chrome. | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | When you create your **Popunder Zone HTML** tag, you can choose from two options: * **Inline + Remote Script (Recommended)**: This is the recommended format, as it enables popunders to continue working when some ad blockers are installed. This is the combined implementation. It attempts to load remote script first, but if the remote script doesn't load (possibly due to an ad blocker) it falls back to a fully inline implementation. * **Remote Script only**: This script does NOT allow you to recover AdBlock traffic. Remote script URL is often present in different blocklists and may not be loaded at all in such cases. ### Instant Message ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FaWTjzGyAKhnV072Nbg81%2Fzone_instant_message.png?alt=media\&token=d17654cc-cc14-43e8-b116-3a3dc6d11042) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Once closed, hide for** | Set the length of time that the ad is hidden for once it is closed. | | **Ad Refresh** | Allows you to refresh the ad up to 10 times per unique user. Available only for **Asynchronous script**. Ad refresh can be configured at intervals of 30, 60, 90 and 120 seconds. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Responsive Display Ads** | Switching on this option opens up instant message zones to demand from Native Ad campaigns. These campaigns are then added to the bidding auction for these zones. The content from winning Native campaigns is then served to responsively display within the allocated instant message zone. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ### Direct Link ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FNx2xGoD8m76789NNXUSu%2Fzone_direct_link.png?alt=media\&token=cf0e2748-4233-4675-afe4-95cc292493a5) | Option | Explanation | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Click Postback** | Switching on this option allows you to provide the click ID and postback information for Direct Link. **Click Postback URL;** Takes four tokens: **cpc**, **pcid**, **is\_internal**, and **sub**. Where **cpc** is the value paid to you, in your currency, **pcid** is your click ID parameter, as received with the click, **is\_internal** is for internal campaigns, and **sub** indicates the number of the Sub ID you want to use. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can block certain adverts from your website(s). The six categories range from **Adult** to **Utilities**, allowing you to block these types of products. **Note**: When adding blocks you are also restricting revenue potential, so you are strongly advised only to block when necessary. | **Using the Click Postback URL** ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FBK70pItqJWTVILnItLO0%2Fclick_postback_zoneform.png?alt=media\&token=eb095a39-adf1-4dff-8f4e-ef870c91105b) When creating a Direct Link or Email Click zone, you can enable the Click Postback URL setting that allows you to provide a URL for tracking all the clicks happening in your zone. In addition to the URL, you can also provide tokens such as: * **cpc**: Cost per click, the value paid to you by the campaign winning the zone. * **pcid**: A click ID parameter specified by you and sent in the postback URL when the click happens. * **is\_internal**: For internal campaigns. * **sub**: Indicates the number of the Sub ID you want to use. When you have filled in the details for the zone with this setting enabled, on the zone preview page, the zone snippet includes the pcid that you can edit to add the value you want to send and place the code in the body of your site. Every time any user clicks any of the ads on this zone, they are redirected to the ad's URL and at the same time you are also notified through the postback URL. ### Sticky Banner ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FAB89olp9ZRhJDur6rIrY%2Fzone_sticky_banner.png?alt=media\&token=97b8aafc-0eb5-406e-9553-017438d8882f) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Format** | Choose a format for the sticky banner. | | **Border** | Choose a width for a border for the banner ad, from **No Border** to 5 pixels. | | **Once closed, hide for** | The length of time that the ad is hidden for once it is closed. | | **Sticky Vertical Position** | The vertical position for the sticky banner. | | **Sticky Horizontal Position** | The horizontal position for the sticky banner. | | **Ad Refresh** | Allows you to refresh the ad up to 10 times per unique user. Available only for **Asynchronous script**. Ad refresh can be configured at intervals of 30, 60, 90 and 120 seconds. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Responsive Display Ads** | Switching on this option opens up Sticky Banner zones to demand from Native Ad campaigns. These campaigns are then added to the bidding auction for these zones. The content from winning Native campaigns is then served to responsively display within the allocated Sticky Banner zone. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ### Email Clicks ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FPZ32TEyysXUzvwbK1B55%2Fzone_email_clicks.png?alt=media\&token=a01987c2-6d22-4509-b813-7082137f4ed2) | Option | Explanation | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Click Postback** | Switching on this option allows you to provide the click ID and postback information for Email Clicks. **Click Postback URL;** Takes two tokens: **cpc** and **pcid**. Where **cpc** is the value paid to you, in your currency, **pcid** is your click ID parameter, as received with the click. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can block certain adverts from your website(s). The six categories range from **Adult** to **Utilities**, allowing you to block these types of products. **Note**: When adding blocks you are also restricting revenue potential, so you are strongly advised only to block when necessary. | ### Desktop Fullpage Interstitial ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FPRda78K5Rt612QsIOQ8e%2Fzone_DFPI.png?alt=media\&token=da23a788-64c2-4202-b4c0-4ae6c7d5dd04) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Capping** | Choose this option to enable capping (display frequency) for Desktop Fullpage Interstitial. | | **Frequency** | In this section you set how often you wish the ad to appear. You can choose whether to do this based on **Clicks** or **Time** using the radio button. | | **Time** | If you choose **Time**, you can set how often the ad appears when a user is browsing the site. Simply set the number of times it shows per minute or hour, by entering two numbers and choosing **Hours** or **Minutes** from the drop-down. | | **Clicks** | If you choose **Clicks**, you can set how many clicks it takes to show the ad for the first time, and how many clicks make it appear every time after that. Type a number into the field following **1st time after** to set how many clicks cause the ad to appear. Then enter a number into the field following **then after every**, to set how many clicks cause the ad to repeat from then onwards. | | **Trigger Method** | Set what action should cause the ad to occur: Clicking anywhere on the page, on links with a specific class (Google Compliant), only when clicking on a valid link, or anywhere on the page, excluding specific classes. | | **Trigger Classes** | Here you indicate the class name that HTML elements need to have to trigger an ad. | | **Browser Settings** | Choose whether to show this format on **All** browsers, **Chrome only**, or **Non-Chrome Only**. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Responsive Display Ads** | Switching on this option opens up Desktop Fullpage Interstitial to demand from Native Ad campaigns. These campaigns are then added to the bidding auction for these zones. The content from winning Native campaigns is then served to responsively display within the allocated Desktop Fullpage Interstitial zone. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Preloading** | Preloading allows the ad to load as soon as the user goes into the page and this can lead to higher click/conversion rates. Note the ad may display later after loading based on the "Trigger Method" set on the zone. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ### Email Banner ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FilMc04Thhj2v2UtXNCTy%2Fzone_email_banner.png?alt=media\&token=96ad522e-ed25-4bc2-8797-ce16378ddbb9) | Option | Explanation | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Format** | Choose which format of banner you wish to use. | | **Border** | Choose a width for a border for the banner ad, from **No Border** to 5 pixels. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | When you have filled in the details for the new zone, click **Create**. On the **Your Zone HTML Tag** screen you can see a **Simple Image Tag**. Place this tag in the body of your email. You can also add [Tags](/publishers/sites-and-zones/using-tags.md#email-banner) and [Sub IDs](/publishers/sites-and-zones/subids.md#email-banner) to your simple image tag along with a few other parameters as explained below to prevent caching and proxying. **Prevent Caching and Proxying** When creating an **Email Banner** zone, you can use this tag in your email content to monetize your email subscribers. Make small modifications to the tag to prevent caching and proxying by the email servers. * **Preventing Caching**: When a URL is viewed multiple times for email ads, the browsers and mail clients cache the images. For this reason, make the URLs of the tags unique to avoid caching. Add the parameter "idnewsletter" with a unique value to the tag. An example of a value using this parameter would be `idnewsletter=newsletter20250321`. * **Prevent Proxying**: When email ads are served through certain Email Service Providers, they may proxy calls to images. That is, they use their IP addresses in place of the recipient's unique IP address. Hence, pass a custom value unique to each recipient to avoid proxying. Add the parameter iduniq to the tag. An example of a value using this parameter would be `iduniq=456`. {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} In addition **coun** can also be added as a parameter where you can pass a single country to serve ads relevant to the advertiser location. {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} ## Video ### In-Stream Video (VAST) ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FtlYBiqrq8h9QimGtesDs%2Fzone_in_stream_video.png?alt=media\&token=a681aa4d-d0d8-427a-9a29-25963afd103f) | Option | Explanation | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Frequency** | Set how often you wish the ad to appear. | | **Skip Button** | Here you can set the number of seconds that elapse before the **Skip** button becomes active. The default is **Disabled**, or you can set with **No Delay** or **Custom Delay** in seconds. | | **VAST Version** | Choose a VAST version between 3.0 (default) and 4.3. | | **VAST Wrapper Support** | You can disable VAST Wrapper Support if your video player does not support third-party VAST tags (VAST Wrappers). | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | {% hint style="info" %} **Note**: See [VAST Tag](/publishers/vast/vast-tag.md) related documentation. {% endhint %} ### In-Video Banner (VAST) ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2F0VxTkrngkbVOgG5v6a0I%2Fzone_in_video_banner.png?alt=media\&token=d02e46e1-b8ff-4164-ae11-6b794ab89579) | Option | Explanation | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Format** | Choose a format for the In-Video Banner. | | **Vertical Alignment** | Choose whether to put the banner at the top, middle or bottom. | | **Trigger Type** | Select between Pre-Roll (at the start of the video), Pause (when the video is paused), Post roll (at the end of the video), or custom. If you select "Custom" as your trigger, you can decide precisely when in the video stream to show the advert. Choose between setting seconds or a percentage of the video before the ad appears. | | **VAST Version** | Choose a VAST version between 3.0 (default) and 4.3. | | **Show Ad** | Choose whether to show ad until the video ends (unless closed by visitor) or hide it after a defined number of seconds. | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | {% hint style="info" %} **Note**: See [VAST Tag](/publishers/vast/vast-tag.md) related documentation. {% endhint %} ### Vertical Video (VAST) ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FQM7FQ1ET9zfOshfFxdPx%2Fvertical-video-reel%20.png?alt=media\&token=79bcd76e-89e7-4ad3-8098-d1e97761a813) Vertical Video (VAST) is designed for short-form vertical video feeds (Reels/Shorts-style). For optimal performance, integrate this format into a short-form video feed containing **at least 20 organic video items** (not ads), inserting the ad between two organic videos and following the same swipe/scroll behavior as the surrounding content. The zone produces a **VAST tag URL** that you pass to your own video player. Your player owns all rendering, playback, and interaction logic. The ad server does not provide a built-in player for this zone type. For implementation details, see the [VAST Tag](/publishers/vast/vast-tag.md) related documentation. | Option | Explanation | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Frequency** | Set how often you wish the ad to appear | | **Skip Button** | Here you can set the number of seconds that elapse before the Skip button becomes active. The default is Disabled, or you can set with No Delay or Custom Delay in seconds. | | **VAST Version** | Choose a VAST version. 3.0 is the default. | | **VAST Wrapper Support** | You can disable VAST Wrapper Support if your video player does not support third-party VAST tags (VAST Wrappers). | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | **Block Specific Products** | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | {% hint style="info" %} **Note**: VMAP is not available on Vertical Video (VAST) zones. Reels/Shorts-style environments almost never support VMAP ingestion (ad breaks are platform- and player-controlled), so it is not part of this zone setup. {% endhint %} **Ad-serving eligibility** A Vertical Video (VAST) zone receives bids only from campaigns targeting the **Vertical Video** ad format. If no eligible campaign is available, the VAST response behaves the same as existing Video (VAST) zones (e.g. no-fill or empty response, following existing conventions). **Recommended integration pattern** * Insert the ad between two organic video items in the feed. * Use the same swipe/scroll navigation as the surrounding content. * Allow the ad to be swiped away from 0 seconds. * Autoplay on mute when visible, pause when out of view. * When a user scrolls back to a previously served ad in the same session, replay the cached creative locally rather than requesting a new VAST ad. ### Outstream Video ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FlOcqgd68XoFC7yJWwwkU%2Fzone_outstream_video.png?alt=media\&token=a9a972c5-67e2-46b5-bbd1-d0f7c0228130) | Option | Explanation | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Maximum Width** | Select **Responsive** to allow the ad to respond to the container size, or choose **Custom Width** and enter a custom width from 200 - 1080 pixels in the field that appears. | | **Once closed, hide for** | Select how long ads stay hidden once the user closes the ad. **Show on every page** (default) means the ad always shows. | | **Branding** | Use this switch to turn on/off the branding that appears on the ad. | | **CTA Overlay** | Use this switch to turn on/off the call-to-action text that appears on the ad. | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | ### Video Slider ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FTCKOcbplVmNimAwGQlzo%2Fzone_video_slider.png?alt=media\&token=1f40ae2e-6e97-4e4b-8032-e4f7373a164d) | Option | Explanation | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Once closed, hide for** | Select how long ads stay hidden once the user closes the ad. | | **Close Button Delay** | Here you can set the number of seconds that elapse before the **Skip** button becomes active. The default is **No Delay**, or you can set a **Custom Delay** in seconds. | | **Maximum Density** | This drop-down sets the maximum percentage of the screen that can be taken up by the ad zone. Choose a percentage between 20 and 30. This option ensures that the ad zone displays well on all screen sizes. | | **Sound** | This option means that ads attempt to play with sound, and if that fails they play with no sound. | | **Branding** | Turning this on shows the network's branding on your ad. | | **CTA Overlay** | Use this switch to turn on/off the call-to-action text that appears on the ad. | | **Hide on Complete** | If enabled, the video slider closes when it is finished. If disabled, it stays visible with a repeat button. | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | {% hint style="info" %} **Note:** If you want to disable CTA, make sure to update your code on the site in order to apply the corresponding ad zone setting. {% endhint %} ## Mobile ### Mobile Banner ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FlRLMSp6TEhhm0h1Cw8Ue%2Fzone_mobile_banner.png?alt=media\&token=550c645a-3a01-46aa-abc6-ca36c9e6cf3e) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Format** | Choose a format for the Mobile Banner. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Responsive Display Ads** | Only available for Mobile banner zones and Ad Servers where Responsive Display Ads are enabled. Switching on this option opens up Mobile banner zones to demand from Native Ad campaigns. These campaigns are then added to the bidding auction for these zones. The content from winning Native campaigns is then served to responsively display within the allocated banner zone. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | When you have filled in the details for the new zone, click **Create**. On the **Your Zone HTML Tag** screen you can then choose the tag type which you wish to use: * Asynchronous Script * iFrame **Using the Asynchronous Script** When creating a **Banner** (or **Mobile Banner**) zone, you can use this tag to ensure that zones are loaded on to the page asynchronously. This means other content can load while the ads are loading. You can also use it to place multiple zones on the same page. **Single Zone** To use the script for a single zone, simply copy the code onto your site as normal. {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} **Multiple Zone** You can also use this script to put multiple existing banner zones onto a single page. To use this script for multiple zones, copy the code onto your site, and repeat the middle section for each zone you wish to put on the page. Replace the `data-zoneid` with the id for these existing zones (e.g. 111, 222, 333): {% code overflow="wrap" expandable="true" %} ```html ``` {% endcode %} **Lazy Load** Visibility is not tracked for Asynchronous Tags out of the box at the moment. However, you can create a callback function based on the ad snippet, like **lazyLoadAd** in the example below. This function can then be used in a callback to display the ad when the visibility detection code triggers an event. {% code overflow="wrap" expandable="true" %} ```html
``` {% endcode %} ### Mobile Popunder ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FRiYvpekFiKMq36gLKRlk%2Fzone_mobile_popunder.png?alt=media\&token=b369fd5f-666c-49ef-a6d6-4913c892df1b) | Option | Explanation | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Capping** | Choose this option to enable capping (display frequency) for popunder. | | **Return URL** | This is a secondary URL that the popunder can direct to, if it does not generate enough revenue. | | **Frequency**/**Every** | Set how often you wish the ad to appear. | | **Delay Between Executions** | Set a delay in the Popunders execution to prevent them from executing on consecutive clicks and in a case where there are multiple actions in the period. This can only be used when Frequency is more than 1. | | **Force Pop-Up** | Choose this option to always show a popup instead of a popunder. | | **Fallback to Popup** | If there are any difficulties showing a popunder (due to browser for example), choose this option to fallback to a popup. | | **New Tab** | This option forces the popunder to show in a new tab. | | **Trigger Method** | Choose what action on the user's part will causes the popunder to show: clicking anywhere on the page, on links, only when clicking on a specific class, or anywhere on the page, excluding specific classes. | | **Fallback URL** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the URL, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative URL** | Paste the alternative URL tag to show if the floor is not met. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | When you create your **Popunder Zone HTML** tag, you can choose from two options: * **Inline + Remote Script (Recommended)**: This is the recommended format, as it enables popunders to continue working when some ad blockers are installed. This is the combined implementation. It attempts to load remote script first, but if the remote script doesn't load (possibly due to an ad blocker) it falls back to a fully inline implementation. * **Remote Script only**: This script does NOT allow you to recover AdBlock traffic. Remote script URL is often present in different blocklists and may not be loaded at all in such cases. ### Mobile Instant Message ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2Fv39D78GRRBQPYvzSnIdu%2Fzone_mobile_instant_message.png?alt=media\&token=fa9e723b-3fb2-4901-9016-dec87c06d491) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Once closed, hide for** | Set the amount of time that the ad is hidden for once the user closes it. | | **User Capping** | Here you can set a limit to how many times a single user sees this zone, to avoid annoying them. | | **Ad Refresh** | Allows you to refresh the ad up to 10 times per unique user. Available only for **Asynchronous script**. Ad refresh can be configured at intervals of 30, 60, 90 and 120 seconds. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Responsive Display Ads** | Switching on this option opens up mobile instant message zones to demand from Native Ad campaigns. These campaigns are then added to the bidding auction for these zones. The content from winning Native campaigns is then served to responsively display within the allocated mobile instant message zone. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ### Mobile Fullpage Interstitial ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2Flz4XR7LkeTuQKHTxoOGF%2Fzone_MFPI.png?alt=media\&token=be94476c-ab47-489e-911e-32600f8459c3) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Capping** | Choose this option to enable capping (display frequency) for Mobile Fullpage Interstitial. | | **Frequency** | In this section you set how often you wish the ad to appear. You can choose whether to do this based on **Clicks** or **Time** using the radio button. | | **Time** | If you choose **Time**, you can set how often the ad appears when a user is browsing the site. Simply set the number of times it shows per minute or hour, by entering two numbers and choosing **Hours** or **Minutes** from the drop-down. | | **Clicks** | If you choose **Clicks**, you can set how many clicks it takes to show the ad for the first time, and how many clicks make it appear every time after that. Type a number into the field following **1st time after** to set how many clicks cause the ad to appear. Then enter a number into the field following **then after every**, to set how many clicks cause the ad to repeat from then onwards. | | **Trigger Method** | Set what action should cause the ad to occur: Clicking anywhere on the page, on links with a specific class (Google Compliant), only when clicking on a valid link, or anywhere on the page, excluding specific classes. | | **Trigger Classes** | Here you indicate the class name that HTML elements need to have to trigger an ad. | | **Browser Settings** | Choose whether to show this format on **All** browsers, **Chrome only**, or **Non-Chrome Only**. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Responsive Display Ads** | Switching on this option opens up Mobile Fullpage Interstitial zones to demand from Native Ad campaigns. These campaigns are then added to the bidding auction for these zones. The content from winning Native campaigns is then served to responsively display within the allocated Mobile Fullpage Interstitial zone. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ## Native ### Recommendation Widget ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FJRARpZ7eGdsjVsLFiB6s%2Fzone_rec_widget.png?alt=media\&token=18f8ec07-1857-4f82-bd4d-d7efbb9e2bfe) | Option | Explanation | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Ad Refresh Rate** | Allows you to refresh the ad up to 10 times per unique user. Available only for Asynchronous script. Ad refresh can be configured at intervals of 30, 60, 90 and 120 seconds. For Recommendation Widget zones, all ads in the widget refresh together on each cycle, and a refresh only occurs when there are enough ads available to fill every slot in the widget. Otherwise the current ads remain in place until the next refresh. Ad Refresh is available for all Recommendation Widget layouts. | | **Video Thumb** | Enabling this option shows a video preview on touch/hover of the ad when available. | | **Fallback HTML** | Switching on this option opens a few more options for your zone. **Floor CPM**: Here you can set a minimum price (floor) that the ad zone accepts for traffic. **Type**: A **Soft Floor** means the ad server also runs CPC and CPA campaigns that could have an average eCPM higher than your floor CPM, so the floor is not 100% guaranteed. A **Hard Floor** means only CPM and Smart CPM campaigns run on this zone, so the floor is 100% guaranteed. You can also click **+Add Tokens** to add dynamic tokens to the HTML, for items such as {country} or {region}. A full list of tokens and how they work are listed in the table at the [bottom of this page](#adding-tokens). | | **Alternative HTML tag** | Paste the alternative HTML tag to show if the floor is not met. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Count Only Viewed Impressions** | With this option, define whether the impressions on a specific zone are tracked when the ad is **rendered (if the toggle is off)** or **viewed (if the toggle is on)**. The default value is off, meaning the impressions are tracked when the ad is rendered. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ## Push Notifications ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FhDJOJl8OqsFbQbRysJ0t%2Fzone_push_notif.png?alt=media\&token=024c329a-b5d4-4a47-9d53-f39f953f0455) | Option | Explanation | | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Push Notification Integration Method** | Choose from Direct or Hosted. Direct Push Notifications are sent from YOUR domain. Hosted Push Notifications are sent from the ad server's domain. | | **Soft-Ask Prompt** | Enable the **Soft-Ask Prompt** switch to show soft prompts. If you choose to **Use Default**, the prompt uses the browser default. If you choose **Enable Call to Action** you can then define the soft-ask prompt yourself. | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | ## In-Page Push Notifications ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FH1FpmzXzAImrQnccelGf%2Fzone_in_page_push_notif.png?alt=media\&token=2f78bd57-1cba-4853-a240-0a9187f3f979) | Option | Explanation | | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Enter a name for the ad zone. | | **Site** | Enter a name for the site the ad zone is on. | | **Category** | Choose a category for the ad zone. | | **Subcategory** | Choose a subcategory for the ad zone. | | **Vertical Position** | Choose whether to display the Push Notifications at the top, middle or bottom of the page. | | **Horizontal Position** | Choose whether to display the Push Notifications at the right, center or left of the page. | | **Delay for 1st Notification** | Set the time delay in seconds for the 1st Push Notification to appear. | | **Max Number of Notifications on Page** | Set the maximum number of Push Notifications to display on the page. | | **Delay between 1st and 2nd notification** | Set the time delay in seconds between the 1st and 2nd Push Notifications displaying on the page. | | **Once closed, hide for** | Set the amount of time that the Push Notification is hidden for once the user closes it. | | **User Session Capping** | Set a limit on how many times a single user sees Push Notifications display in a single session. | | **Enable Ad Transparency Dialog**\* | Keep this option enabled to remain compliant with the [EU Digital Services Act](https://app.gitbook.com/s/QpBCwTiJQ0YOSGpcC0AH/dsa). | | **Filter Ads** | In the **Block Ad Types** section you can block certain types of ads, or specific target audiences by simply clicking the types of ad or target audiences that you wish to block. | | | In the **Block Specific Products** section, you can restrict certain advertisements from appearing on your website(s). Blocking of products allows you to control the types of products displayed. **Note**: Blocking ads may also limit revenue potential, so use this feature only when necessary. | \*By default this feature is configured off on all Ad Servers. Contact your EXADS representative to enable Ad Transparency (DSA). ## Multi-Format | Option | Explanation | | -------- | ------------------------------------------ | | **Name** | Enter a name for the Multi-Format ad zone. | | **Site** | Choose the site to create the ad zone on. | Whichever site you choose, the list below shows the **Banner** and **Native** (**Recommendation Widget**) ad zones you have already created. This list shows only the individual zones that are eligible to be used in your Multi-Format zone (you won’t see all the zones on the site). ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FNZNMFrDpjIGHmLkWnAW5%2Fcreate-zone-multi-format-zone.png?alt=media\&token=3b3888d0-feaa-45da-8caf-fed0befd30ac) **Adding Zones to your Multi-Format zone** ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FIHUSrvwhemp6Fi8PGd2l%2Fcreate-zone-multi-zone-tick-box.png?alt=media\&token=6d8fc3f6-f373-411f-8fa3-4726f5343960) To add zones to your Multi-Format ad zone, tick the box on the left side of them. Once you’ve selected multiple zones, you are essentially setting these zones to compete against each other to show in the Multi-Format ad zone. The zone that gets the highest eCPM is the one that displays. For this, you can select both Banners and Natives. **Selecting the layout for your Multi-Format zone** ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FOMEwLoAROeEFCUuDtU7B%2Fmulti-format-drop-down.png?alt=media\&token=7972fa54-7058-44e0-85e3-3b5e1dbed61e) Then in the **Multi-Zone Layout** drop-down, you select how the winning ad zone displays: * Choose **Single Zone** to show the winning zone only once in the Multi-Format ad zone. * The other options show the winning zone multiple times horizontally or vertically. {% hint style="info" %} **Note**: As you can see, these layout options only apply to Banner Ads. Native Ads are marked **N/A**. If they get the winning bid, they always display just once, as a Single Zone. {% endhint %} **Example Setups** ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2F43JBdEo2uP8IpnmN24Gc%2Fmulti-format-single-zone.png?alt=media\&token=31ee1551-d6b0-4ca5-a18e-7957da6d5897) Here, three banners compete against each other. The winning zone displays once as a **Single Zone**. ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FY71BiTKrhylfMJRErTW9%2Fmulti-format-beside-above.png?alt=media\&token=a0e608a5-8445-48ca-a900-8c52ff8de8c4) Here, three banners also compete against each other. If **banner1** wins, it displays twice horizontally in the zone; if **banner3** wins, it displays three times horizontally. ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FQmvd9yKLtvhbPGxGdcQg%2Fmulti-format-banner-native.png?alt=media\&token=ddbfb559-f4ea-414c-9542-4199fc6e2a02) Here, a Native ad competes against a Banner. If the Native ad wins, it displays once. If the Banner wins, it displays according to the **Multi-Zone Layout** setting. **How Multi-Format ad zone bidding works** ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2Fh7duaSYtBBo2Pv7uUxQ2%2Fmulti-format-banner-cpm.png?alt=media\&token=61a84c03-58b8-45c0-a2f8-296cbaf501b1) When you select multiple zones to compete against each other, the zone that shows is the one that gets the highest eCPM price. * In the case of Native ads, this eCPM price is the sum of the prices for each ad in the native widget. * Similarly, for Banners, when a Multi-Zone layout is used, the eCPM price is the sum of the price for each ad zone in the Multi-Format ad zone: * e.g. if you select **Horizontal x 3**, the eCPM price that wins is the sum of the eCPM price for each of the three ad zones that display. * When a Banner ad zone using one of the Multi-Zone layouts wins the bid to display in the Multi-Format ad zone, the ads that display are the two, three, or four ads with the highest eCPM price. **Show Selected Only** ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FYMLn1jtjWuZJDupbpKnR%2Fmulti-format-show-selected.png?alt=media\&token=65393183-fabf-41ba-91de-79bbbdeff59b) Of course, you might have a lot of zones across multiple pages here, so you can tick the **Show Selected** checkbox to only show them and exclude everything else. ## Step 3: Creating the Ad Zone Code Whichever format you choose, once you have filled in the details, click **Create**. You then see your zone HTML tag, which you use on your site. You also have the option to choose the tag type you want to use and add any of the available tokens. This code should then be placed into the 'body' of your site. Once the code is implemented the traffic should start within a few minutes. ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FUY04ePIUbVlbKgPpkPtg%2Fczone6.png?alt=media\&token=a3b983ae-2554-47d1-8a3d-3400aa64166e) {% hint style="info" %} **Note**: Implement the ad zone code as provided by the system. Modifying the ad zone code can affect the functionality of the ad zone. {% endhint %} ### Client Hints Meta Tag Additionally, you have the option to add the Client Hints Meta Tag. Place this tag in the 'head' of the webpage where this zone sits. The Client Hints Meta Tag is required only once per page for each relevant Ad Serving Domain, which is highlighted for you in the implementation instructions. At times, the ad serving domain can change. The date of the last update is displayed under the tag. Always update the tags on your web pages with the latest ad serving domain. We recommend adding this tag to the head section of the webpage as it ensures effective communication with the ad server using Client Hints. Client Hints allow the browser to selectively provide certain information about the device and environment, such as device type, browser name, version, and platform. By using Client Hints, you can enhance the accuracy of device detection, leading to better ad targeting and a more personalized user experience. This approach directly addresses privacy concerns. Instead of exposing detailed user-agent strings, Client Hints offer a more privacy-conscious way to communicate essential information. As a result, advertisers and publishers can access just the necessary data to optimize ad delivery, without gathering excessive user information that may raise privacy issues. Thus, implementing this tag supports both effective ad serving and user privacy compliance. ## Step 4: Adding Tags (Optional) In many cases your URL does not match a category precisely. In these cases, you can insert 'tags' into the code in your ad zones to manually match them to the type of advertising you want. For example, you could insert the tags 'general' and 'humour' into your ad zone code, to ensure that you receive this type of advertising. For more on adding tags, see [Using Tags](/publishers/sites-and-zones/using-tags.md). ## Step 5: Adding Sub IDs (Optional) You can also add Sub IDs to the ad zone code to segment the traffic, such as by traffic source, for example. This information then appears in the **Statistics** tab, in the **Sub IDs** sub-tab. For more on Sub IDs, see [Using Sub IDs](/publishers/sites-and-zones/subids.md). ## Step 6: Adding Display Notification Events for Fullpage Interstitials (Optional) {% hint style="info" %} **Note**: This is only available for the **Desktop Fullpage Interstitial** and **Mobile Fullpage Interstitial** (*DFI/MFI*) Ad Formats. {% endhint %} Once you have created your zone, you can add an event listener to catch the event ‘creativeDisplayed’. This event is suffixed with a zone ID that is triggered when the ad is displayed to the user. By adding an event listener to the event ‘creativeDisplayed’, you are able to programmatically execute any action you may need on your website, such as pause a playing video when the Fullpage Interstitial is being displayed to the user. For more, see [Adding Display Notification Events for Fullpage Interstitials](/publishers/sites-and-zones/dfi-mfi-display-notification-events.md) and [Adding HTML Events for Fullpage Interstitials](/publishers/sites-and-zones/dfi-mfi-html-events.md). ## Reasons Why No Ads Are Showing Once you have created your ad zone, it should begin to continuously generate earnings for you. This might not happen for several reasons: * Since ads are geo-targeted, sometimes there may be no advertising running for your ad zone format, device or country. Check from a different device/country, or wait a few hours to see if ads appear. * Your site was rejected. * You didn't implement the ad code correctly, or you modified it. Please check your source code to make sure you followed all the steps correctly. * You restricted too many products or you blocked too many ad types. * Check that there is no ad blocking software running on the system. To see which ad types and products are blocked for a zone, select the zone in the [**Sites & Zones**](/publishers/sites-and-zones/publisher-sites-and-zones.md) page and edit it. In the **Filter Ads** section, under **Block Ad Types** and **Block Specific Products** you can see what is blocked for this zone. ## Examples of Problematic Blocking **Example 1** If your ad zone is 'lifestyle', but you block all lifestyle products, you are unlikely to get global advertising to your ad zone. ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FEVZDmj9pkjNHq0UzW7Vf%2Flifestyle-block.png?alt=media\&token=d44546d9-1e93-4c37-a065-4c192a7551e9) **Example 2** If you've utilized the advanced options and you have set conflicting or unrealistic options this also restricts or blocks advertising. In this case you have set too high a floor for your CPM and so you do not receive any ads: ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2F6OLMl4QDngTUSW1cR9Ah%2Fpub2.png?alt=media\&token=c2d101af-085f-458f-af2b-edce77ecb565) ## Using Trigger Classes ![](https://2421941036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoiffCg2y27CXM9bLruG3%2Fuploads%2FiT563AdHHGDTIORtIbSj%2Ftrigger-class-dropdown.png?alt=media\&token=8013364c-01e7-47f8-906c-ba59f9dbcd23) For some ad formats, you can choose to trigger the ad when any clickable element of a specific class is clicked on, by choosing **Clicking on a specific class** and choosing a class. You can do this for: * Popunder/Mobile Popunder * Desktop Fullpage Interstitial/Mobile Fullpage Interstitial * Native: Interstitial Widget Remember that trigger classes work on any clickable element, so be careful how you use them: * For example, you could set up a Fullpage Interstitial ad in the Admin Panel and set it to trigger with the same class you used in the container of an Outstream Video ad. Doing this can interfere with the click URL destination of the Outstream Ad. ## Adding Tokens You can click **+Add Tokens** to add dynamic tokens to the URL or HTML, for items such as {country} or {region}. **Available dynamic tokens** | Token | Explanation | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **{category\_id}** | The ID of the category detected. | | **{country}** | The 3-character country code of the visitor. | | **{email\_encoded}** | Used to insert the emails of logged-in users. | | **{format}** | The ad format size. Example: 300×250. | | **{gdpr\_consent}**\* | This is the GDPR consent string required by the IAB standards (only available on RTB). | | **{gdpr}**\* | This is 0 if the user is not under GDPR, and 1 if the user is under GDPR (only available on RTB). | | **{keyword}** | The keyword that was matched in case of targeting specific keywords. This is empty if there is no match. | | **{language}** | The language of the visitor. | | **{referer}**\* | Address of the web page from which the resource has been requested. | | **{site\_id}** | The ID number of the site where the ad is displayed. | | **{src\_hostname}** | The site name you submitted for displaying ads, not including the HTTP protocol at the beginning (e.g. examplesite.com). | | **{sub}** | Your Sub ID. | | **{tags}** | The list of keywords that have been identified for that ad impression. | | **{time}** | The timestamp, which is used as a cache buster. | | **{url}** | The full URL of the site you submitted to the Admin Panel for displaying ads, including the HTTP protocol (e.g. [https://examplesite.com](https://examplesite.com/)). Note: This token does not display the URL where the ad was displayed to the user; only the URL registered in the platform. | | **{user\_agent}**\* | The User Agent string of the visitor. | | **{user\_ip}**\* | The User IP of the visitor. | | **{user\_remote\_addr\_ip}**\* | The remote User IP of the visitor. | | **{user\_x\_forwarded\_for\_ip}**\* | The User IP of the visitor connecting to a web server through a proxy server. | | **{zone\_id}** | The ID of the ad zone where the ad is displayed. | \*Only available to Advanced Users **Available dynamic tokens (Available only for Native format)** | Token | Explanation | | ----------------------- | ----------------------------------------------- | | **{browser}** | The browser being used by the visitor. | | **{carrier}** | The carrier to which the visitor is connected. | | **{city}** | The city in which the visitor is located. | | **{country\_name}** | The 3-character country code of the visitor. | | **{device}** | The device which the visitor is using. | | **{language\_name}** | The language of the visitor. | | **{operating\_system}** | The operating system being used by the visitor. | | **{region}** | The region in which the visitor is located. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exads.com/publishers/sites-and-zones/create-zone.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.