Data Ad Block Types · Documentation

Using Dynamic Ad Type Exclusion

This new optional parameter, data-block-ad-types, allows publishers to specify one or more Ad Type IDs. When this parameter is present with a value, our ad-serving algorithm will exclude all campaigns labeled with the corresponding Ad Type(s) from being displayed, in addition to any ad types already blocked at the account level.

This feature provides granular control, enabling publishers to instantly adjust ad content based on real-time needs or specific page contexts.

Putting Block Ad Types into your ad zone code

Once you have configured your ad zone and are presented with its code, you can implement the Dynamic Ad Type Exclusion feature.

To use this feature, you add the parameter data-block-ad-types to your ad zone code. Following this parameter, you will provide a comma-separated list of the Ad Type IDs you wish to exclude from displaying in that specific ad zone.

How it Works

Publisher Specifies IDs: The publisher adds the data-block-ad-types parameter to their ad zone code, providing a comma-separated list of Ad Type IDs they wish to block.
Ad Serving Process: During the ad-serving process, our system checks for the presence and value of data-block-ad-types.
Ad Type Exclusion: Any campaigns tagged with the specified Ad Type IDs will be immediately excluded from the pool of eligible ads for that impression.
Ad Delivery: Only ads that do not match the blocked Ad Type IDs (and meet all other targeting criteria) will be served.

Example

Let's say a publisher has a banner ad zone on a page where they want to avoid displaying "NSFW" (Not Safe For Work) content. If "NSFW" corresponds to Ad Type ID 101, the publisher would include:

<ins class="adsbynetwork" data-zoneid="3553853" data-block-ad-types="101"></ins>

When this data-block-ad-types=101 parameter is received for an impression, all ads labeled with the "NSFW" Ad Type (ID 101) will be excluded, ensuring that only SFW (Safe For Work) ads are displayed.

Implementing `data-block-ad-types` Across Ad Formats

The data-block-ad-types parameter follows similar implementation patterns to existing tag-based parameters like data-keywords , adapting to the specific syntax required by each ad format.

Note: When using multiple Ad Type IDs, separate them with commas (e.g., data-block-ad-types="101,102,105").

Async Snippet Tag

<script async type="application/javascript" src="https://ads.examplesite.com/ad-provider.js"></script>
 <ins class="adsbynetwork" data-block-ad-types="101,10"></ins>
 <script>(AdProvider = window.AdProvider || []).push({"serve": {}});</script>

VAST Endpoint

https://syndication.exads.rocks/v1/vast.php?idzone=5478789&block_ad_types=101&context=1&debug=1