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:

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"
        ]
    }
}