My favorites | English | Sign in

Faster apps faster - GWT 2.0 with Speed Tracer New!

Documentation for the requested version is not available.Documentation for the requested diff is not available.

SiteFilterService

Link to this version

Publishers may not wish to display certain ads, such as their competitors' ads, on their website. SiteFilterService lets you specify site filters to identify such sites. Ads that link to sites on the filter list will not appear on the publishers' content pages.

Adding Site Filters to a Website

To add a site filter, use the addSiteFilters operation, specifying synServiceId with a list of website URLs you want to filter out. The operation setSiteFilters is similar but clears the filter list before adding the specified sites. Similarly, you can remove specific sites from the list.

Note that by entering a top level domain such as www.example.com, publishers will block all ads that link to subdirectories below that domain. The following rules apply to the competitive ad filter:

  • Entering example.com will block ads to example.com and example.com/sub
  • Entering example.com will also block ads to www.example.com and forums.example.com
  • www.example.com will block ads to www.example.com but not to forums.example.com or example.com
  • example.com/sub will not block ads to example.com/products or example.com/sub/index.html

Requests

addSiteFilters

Adds a collection of site filters for a syndication service.

Parameters

synServiceId string
the syndication service ID
siteFilters string[]
a collection of URLs that should be filtered

Response

(none)

Errors

201 if synServiceId is not valid
601 before adding any site filters if an element of siteFilters is malformed
602 if siteFilters is empty
603 before adding any site filters if there are duplicate filters in siteFilters
605 before adding any site filters if a filter in siteFilters is already active
606 before adding any site filters if adding all the specified filters would exceed the site filter limit

getSiteFilters

Gets the site filters for a syndication service.

Parameters

synServiceId string
the ID of the syndication service

Response

string[] the collection of site filters associated with the service ID

Errors

201 if synServiceId is not valid

removeSiteFilters

Removes a collection of site filters from a syndication service.

Parameters

synServiceId string
the syndication service ID
siteFilters string[]
a collection of URLs that should no longer be filtered

Response

(none)

Errors

201 if synServiceId is not valid
601 before deleting any site filters if an element of siteFilters is malformed
602 if siteFilters is empty
603 before deleting any site filters if there are duplicate filters in siteFilters
604 before deleting any site filters if a filter in siteFilters is not a current site filter

setSiteFilters

Sets the site filters for a syndication service.

Parameters

synServiceId string
the ID of the syndication service
siteFilters string[]
a collection of URLs that should be filtered

Response

(none)

Errors

201 if synServiceId is not valid
601 before setting any site filters if an element of siteFilters is malformed
603 before setting any site filters if there are duplicate filters in siteFilters
606 before setting any site filters if setting all the specified filters would exceed the site filter limit