NegativeSite Data Object - Campaign Management

Artikkeli
11/13/2024

Defines a website URL where you do not want your ads displayed.

Note

You can only view website exclusion lists in the redesigned Microsoft Advertising UI i.e., via Tools -> Shared Library -> Website exclusion lists. If you don't see it, look for the "Try the new Microsoft Advertising" prompt when you sign in. To use the redesigned Microsoft Advertising you must also be in the UI pilot (GetCustomerPilotFeatures returns 522).

A negative site can be added and deleted from a PlacementExclusionList (website exclusion list), but cannot be updated.

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.

<xs:complexType name="NegativeSite" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:SharedListItem">
      <xs:sequence>
        <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="Url" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Type": "NegativeSite",
  "Id": "LongValueHere",
  "Url": "ValueHere"
}

Elements

The NegativeSite object has the following elements: Id, Url.

Element	Description	Data Type
Id	The unique Microsoft Advertising identifier of the negative site. Add: Read-only Delete: Required	long
Url	The URL of the website where you do not want your ads displayed. 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 a website exclusion list are not allowed. You can only exclude websites for syndicated search websites. The ad group's network must be set to OwnedAndOperatedAndSyndicatedSearch. For more information about network distribution, see Network. 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. Add: Required Delete: Optional	string

The NegativeSite object has Inherited Elements.

Inherited Elements

Inherited Elements from SharedListItem

The NegativeSite object derives from the SharedListItem object, and inherits the following elements: ForwardCompatibilityMap, Type. The descriptions below are specific to NegativeSite, and might not apply to other objects that inherit the same elements from the SharedListItem object.

Element	Description	Data Type
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
Type	The type of the shared list item. This value is NegativeSite when you retrieve a negative site. For more information about shared list item types, see SharedListItem Data Object Remarks. Add: Read-only Delete: Read-only	string

Requirements

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

Jaa