PlacementExclusionList Data Object - Campaign Management

Article
03/20/2023

Defines a website exclusion list in the manager account (customer) shared library.

A manager account can own up to three website exclusion lists. Each list can contain up to 10,000 negative sites.

A list can be associated with ad accounts owned by the manager account, or linked in the account hierarchy under the manager account that owns the list. A list cannot be shared above or outside of the account hierarchy.

If you associate any website exclusion lists with an ad account, the list of negative sites are used in addition to the campaign negative sites or ad group negative sites. Negative site URLs specified at the ad group level are used instead of any negative site URLs specified at the campaign level.

For more information about managing negative sites and website exclusion lists, see the Negative Sites technical guide.

Syntax

<xs:complexType name="PlacementExclusionList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:SharedList">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The PlacementExclusionList object has Inherited Elements.

Inherited Elements

Inherited Elements from SharedList

The PlacementExclusionList object derives from the SharedList object, and inherits the following elements: ItemCount. The descriptions below are specific to PlacementExclusionList, and might not apply to other objects that inherit the same elements from the SharedList object.

Element	Description	Data Type
ItemCount	The number of SharedListItem objects that are added to this shared list. Add: Read-only Update: Read-only	int

Inherited Elements from SharedEntity

The PlacementExclusionList object derives from the SharedEntity object, and inherits the following elements: AssociationCount, ForwardCompatibilityMap, Id, Name, Type. The descriptions below are specific to PlacementExclusionList, and might not apply to other objects that inherit the same elements from the SharedEntity object.

Element	Description	Data Type
AssociationCount	The number of active associations between this shared entity and another entity such as campaign or ad account. For a NegativeKeywordList, the maximum number of active associations between the negative keyword list and campaign is 20. For a PlacementExclusionList, the maximum number of active associations between the website exclusion list and ad account is undefined. Add: Read-only Update: Read-only	int
ForwardCompatibilityMap	The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version. Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for this object.	KeyValuePairOfstringstring array
Id	The unique Microsoft Advertising identifier of the shared entity. Add: Read-only Update: Required	long
Name	The name of the shared entity. The maximum string length is 255. Add: Optional Update: Optional	string
Type	The type of the shared entity. This value is NegativeKeywordList when you retrieve a NegativeKeywordList. This value is PlacementExclusionList when you retrieve a PlacementExclusionList. This value is AccountNegativeKeywordList when you retrieve an AccountNegativeKeywordList. For more information about shared entity types, see SharedEntity Data Object Remarks. Add: Read-only Update: Read-only	string

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Share via