AdGroupNegativeSites Data Object - Campaign Management

Defines an object that contains the negative site URLs of an ad group.

Syntax

<xs:complexType name="AdGroupNegativeSites" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdGroupId" type="xs:long" />
    <xs:element xmlns:q27="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="NegativeSites" nillable="true" type="q27:ArrayOfstring" />
  </xs:sequence>
</xs:complexType>

Elements

The AdGroupNegativeSites object has the following elements: AdGroupId, NegativeSites.

Element Description Data Type
AdGroupId The identifier of the ad group to which the negative site URLs belong. long
NegativeSites A list of URLs of the websites where you do not want your ads displayed.

This element can include a maximum of 2,500 URLs. Each URL must specify the domain name e.g., contoso.com which can include up to three subdomains and two subdirectories. The subdomain count includes the www prefix. For example one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2, and one.two.contoso.co.uk/1/2 are valid URLs, whereas one.two.three.contoso.co.uk/1/2 (too many subdomains) and one.two.three.contoso.com/1/2/3 (too many subdirectories) are not. Duplicate URLs in the list are not added.

You can only exclude websites for syndicated search websites. The ad group's network must be set to either OwnedAndOperatedAndSyndicatedSearch or SyndicatedSearchOnly. For more information about network distribution, see Network. Note: You can exclude Yahoo and Microsoft sites (e.g., MSN.com) from Microsoft Audience Network (MSAN) ads, but not search ads.

Negative site URLs specified at the ad group level are used instead of any negative site URLs specified at the campaign level. 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.

To remove ad group negative site URLs, set this element to null.
string array

Requirements

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

Used By

GetNegativeSitesByAdGroupIds
SetNegativeSitesToAdGroups