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