Restrictions Context¶

This object allows lists of restrictions on ad responses to be specified including specific content categories, advertisers, ads pertaining to specific apps, or creative attributes.

Restrictions Object Properties¶
Value	Type	Description
bcat	array of strings	Block list of content categories using IDs from the taxonomy indicated in `cattax`
cattax	int	The taxonomy in use for `bcat`, the default is `2` `1` IAB Content Category Taxonomy 1.0. `2` IAB Content Category Taxonomy 2.0: www.iab.com/guidelines/taxonomy `3` IAB Ad Product Taxonomy 1.0.
badv	array of strings	Block list of advertisers by their domains (e.g., `"ford.com"`)
bapp	array of strings	Block list of apps for which ads are disallowed. These should be bundle or package names (e.g., `"com.foo.mygame"`) and should NOT be app store IDs (e.g., not iTunes store IDs).
battr	array of int	Blocked list of creative attributes: `1` Audio Ad (Autoplay) `2` Audio Ad (User Initiated) `3` Expandable (Automatic) `4` Expandable (User Initiated - Click) `5` Expandable (User Initiated - Rollover) `6` In-Banner Video Ad (Autoplay) `7` In-Banner Video Ad (User Initiated) `8` Pop (e.g., Over, Under, or Upon Exit) `9` Provocative or Suggestive Imagery `10` Shaky, Flashing, Flickering, Extreme Animation, Smileys `11` Surveys `12` Text Only `13` User Interactive (e.g., Embedded Games) `14` Windows Dialog or Alert Style `15` Has Audio On/Off Button `16` Ad Provides Skip Button (e.g. VPAID-rendered skip button on pre-roll video) `17` Adobe Flash `18` Responsive; Sizeless; Fluid (i.e., creatives that dynamically resize to environment) `500+` Vendor-specific codes.
ext	object	Additional restriction options, see Restrictions Extension

Restrictions Extension¶

restrictions.ext Object Properties¶
Value	Type	Description
addcat	array of objects	Passes additional taxonomies and categories

Additional Categories¶

restrictions.ext.addcat Object Properties¶
Value	Type	Description
bcat	array of strings	Block list of content categories using IDs from the taxonomy indicated in `addcat.cattax`
cattax	int	The taxonomy in use for `addcat.bcat`: `501` BidSwitch Sensitive Categories, see Sensitive Categories and Rich Media `502` See GumGum Taxonomy 2016 `503` see YieldOne Inventory Category Mapping

Restrictions JSON Example¶

{
    "restrictions":{
        "cattax":1,
        "bcat":[
            "IAB24",
            "IAB25",
            "IAB26"
        ],
        "ext":{
            "addcat":[
                {
                    "cattax":501,
                    "bcat":[
                        "bsw1",
                        "bsw2"
                    ]
                },
                {
                    "cattax":3,
                    "bcat":[
                        "some_product",
                        "example_block"
                    ]
                }
            ]
        },
        "badv":[
            "example.com",
            "example_1.com"
        ]
    }
}