|
|
Getting Started Guide: ExcludedWordsService Overview
ExcludedWordsService provides operations for creating and managing excluded words for accounts and ad groups.
About Excluded Words
Excluded words are used to filter out unwanted queries. When Sponsored Search with the advanced match type is enabled, Sponsored Search will not serve an ad if a search query matches one of the excluded words you have specified.
Excluded Words Management
ExcludedWordsService provides operations for creating, deleting, and reviewing excluded words.
Create Excluded Words
To create an excluded word for an account, use the addExcludedWordToAccount and addExcludedWordsToAccount operations. The first operation adds one excluded word; the second operation adds one or more excluded words. These excluded words will apply to all campaigns and ad groups under an account.
To create an excluded word for an ad group, use the addExcludedWordToAdGroup and addExcludedWordsToAdGroup operations. Excluded words created at an ad group level are in addition to any excluded words specified at the account level. Duplicates are not allowed. If the excluded word exists at the account level, you cannot add it to the ad group. Moreover, excluded words created at the ad group level apply to the ad group only.
Delete Excluded Words
To delete excluded words, use the deleteExcludedWord and deleteExcludedWords operations.
Review Excluded Words
To get information about excluded words, use the getExcludedWord and getExcludedWords operations.
To get information about the excluded words in a specific account or an ad group, use the getExcludedWordsByAccountID and getExcludedWordsByAdGroupID operations.
Note: The getExcludedWordsByAdGroupID operation returns only those excluded words that are explicitly defined for the specified ad group, and not those inherited from the account. To retrieve a complete list of excluded words for an ad group, you must use both operations.