Collapse the table of content
Expand the table of content

NegativeKeyword Data Object


Defines a negative keyword with match type. A negative keyword can be added and deleted, but cannot be updated.

You may choose to assign negative keywords to an individual campaign or ad group. An assigned set of negative keywords cannot be shared with other campaigns or ad groups.

Negative keywords can also be added and deleted from a shared negative keyword list. The negative keyword list can be shared or associated with multiple campaigns.

System_CAPS_ICON_note.jpg Note

The same negative keyword and match type can be added to all campaigns, ad groups, and negative keyword lists if you choose. Each instance must be added and associated individually and would be assigned a unique negative keyword identifier.

For more information about managing negative keywords and negative keyword lists, please see the technical guide about Negative Keywords.

<xs:complexType name="NegativeKeyword">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:SharedListItem">
        <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
        <xs:element name="MatchType" type="tns:MatchType" />
        <xs:element name="Text" nillable="true" type="xs:string" />

The NegativeKeyword object derives from the SharedListItem object. For a list of the inherited elements, see Inherited Elements below.

ElementDescriptionData TypeAdd
IdThe unique Bing Ads identifier of the negative keyword.longRead-only
MatchTypeThe type of match to compare the negative keyword and the user's search term.

The supported values for a negative keyword are Exact and Phrase.
TextThe negative keyword text. The text can contain a maximum of 100 characters.stringRequired

The NegativeKeyword object derives from the SharedListItem object, and inherits the following elements.

System_CAPS_ICON_note.jpg Note

The descriptions below are specific to negative keywords, and might not apply to other objects that inherit the same elements from the SharedListItem object.

ElementDescriptionData TypeAddUpdate
ForwardCompatibilityMapThe list of key and value strings for forward compatibility. This element can be used to avoid otherwise breaking changes when new elements are added in future releases.

Note: Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for the SharedListItem object.
KeyValuePairOfstringstring arrayOptionalOptional
TypeThe type of the shared list item. This value is NegativeKeyword when you retrieve a negative keyword. For more information about shared list item types, see SharedListItem Data Object Remarks.stringRead-onlyRead-only

CampaignManagementService.svc v10



Community Additions

© 2016 Microsoft