Page tree


Note: This document supports a set of APIs for older integrations.


Publishers can have controls available at specific site level or across all sites, so that they can block advertisers who are either competitors or advertisers who are being directly sold by the publisher’s own sales force.
Publishers can have following lists for blocking:
URL List:
This contains list of Landing Page Domain to be filtered from bidding. (Example: att.com, and so on.)
Creative Attributes List:
This contains list of Creative Attributes to be controlled (Example: Expandable Ads, ..)
Creative Categories List:
This contains list of Creative Categories to be controlled (Example: Political, …)


Example:


POST /adapters/pubmatic?requestId=123&… HTTP/1.1
User-Agent: curl/7.19.0 (i686-pc-linux-gnu) libcurl/7.19.0 OpenSSL/0.9.7a zlib/1.2.1.2 c-ares/1.5.3 libidn/0.5.6
Host: demand.partner.com
Accept: */*
Content-Type: application/json
Content-Length: <length>
{"exclude": {
  "creative_attributes" : [2,4,7,9,12],
  "creative_categories" : [2,4,8,14,18],
  "urls": ["www.spyware.com", "www.zwinky.com"],
  } 
}‍‍‍‍‍‍‍‍‍‍‍‍

Publisher Block List Parameters

                                 

PropertyMandatoryMulti ValuedDescription
creative_attributesNoYes

List of blocked creative category IDs separated by ‘,’. 
For details on the values passed and the corresponding category names, refer to the Creative Attributes table in the Reference section of this document.

creative_categoriesNoYes

List of blocked advertiser category IDs separated by ‘,’. 
For details on the values passed and the corresponding category names, refer to the Creative Categories table in the Reference section of this document.

urlsNoYes

List of blocked advertisers’ top level domains separated by ‘,’.
Note: A maximum of 40 domains can be passed in this parameter.

bcatNo YesList of blocked IAB categories category IDs separated by ‘,’.  
For example, IAB7,IAB128,IAB18
Note:  A maximum of 20 IAB Categories can be passed in this parameter.


Example:


{"exclude": {
  "creative_attributes" : [<List of Creative Attributes>],
  "creative_categories" : [List of Creative Categories],
  "urls" : [<List of urls>]
  "bcat" : [<List of IAB Categories>]
  }
}‍‍‍‍‍‍‍

Example:


{"exclude": {
  "creative_attributes" : [2,4,7,9,12],
  "creative_categories" : [2,4,8,14,18],
  "urls": ["www.spyware.com", "www.zwinky.com"]
  "bcat" : [“IAB7”, “IAB128”, “IAB18”]
  )
)‍‍‍‍‍‍‍

Publisher Block List Rules

  1. List maybe fetched for the site context if it’s available.
  2. List maybe fetched for the Publisher context if it’s not available at site level.
  3. Only Numeric IDs shall be sent for the creative_attributes and creative_categories lists.
  4. URL list shall be sent as strings enclosed in quotes.
  5. All lists shall contain only top N items (Example: 20).
  6. Demand Partners can specify to receive only the specific block lists out of {creative_attributes, creative_categories, urls}.
  7. If the complete lists are needed, Demand Partners should use the Creative Control data sharing API via open RTB. More information on PubMatic’s openRTB capabilities can be found in this document.