AdGroupService provides operations for creating and managing ad groups.
An ad group is a collection of related ads and keywords and is associated with a campaign. Values set at the ad group level override corresponding values set at, and inherited from, the campaign level.
AdGroupService provides operations for creating, updating, moving, deleting, reviewing, and checking the status of ad groups.
To create a new ad group, use the addAdGroup and addAdGroups operations. The first operation creates one ad group; the second operation creates one or more ad groups.
Note: You must specify the Sponsored Search and/or Content Match® bids when you create the ad group (even if you enable campaign optimization). If you do not, the addAdGroup and addAdGroups operations will fail.
To update an ad group, use the updateAdGroup and updateAdGroups operations. When the boolean parameter updateAll is set to true, the system performs a full update (all elements are updated).
To move an ad group from one campaign to another, use the moveAdGroup operation. You can move an ad group from a campaign whose status is deleted. However, if the status of the ad group itself is Deleted, you cannot move the ad group.
To delete an ad group, use the deleteAdGroup and deleteAdGroups operations. Once you delete an ad group, you cannot un-delete it (see Deleting Objects).
To get information about an ad group or a list of ad groups, use the getAdGroup and getAdGroups operations. To get a list of ad groups for a specific campaign, use the getAdGroupsByCampaignID operation.
To determine the number of keywords or excluded words in an ad group, use the getAdGroupKeywordCount and getAdGroupExcludedWordsCount operations.
To determine the status of an ad group, use the getStatusForAdGroup operation.
To retrieve all of the ad groups with a specific status in a specific campaign, use the getAdGroupsByCampaignIDByStatus operation.
To change the status of an ad group, use the updateStatusForAdGroup and updateStatusForAdGroups operations.
When you create an ad group, using the addAdGroup and addAdGroups operations, you must enable one of the search tactics, either Sponsored Search and/or Content Match®. If you do not enable at least one of these tactics, then both tactics are enabled by default (see Setting Tactics).
Given this, for each search tactic that is enabled, you must specify the corresponding bid (see Setting Bids). If you do not, the addAdGroup and addAdGroups operations will fail.
To set or review the maximum bid for Sponsored Search, use the setAdGroupSponsoredSearchMaxBid and getAdGroupSponsoredSearchMaxBid operations. To set or review the maximum for the Content Match, use the setContentMatchMaxBid and getContentMatchMaxBid operations. The bids you set at the ad group level will apply to all of the ads and keywords in the ad group.
To review the minimum bid for Sponsored Search use the getSponsoredSearchMinBidForAdGroup and getSponsoredSearchMinBidForAdGroups operations.
Campaign optimization allows you to optimize the spend of a campaign's monthly budget based on the guidelines you set at the campaign, ad group, and keyword levels (see Campaign Optimization).
To set or review optimization guidelines at the ad group level, including the maximum bid limits for Content Match and Sponsored Search, use the setOptimizationGuidelinesForAdGroup and getOptimizationGuidelinesForAdGroup operations.
To review the minimum bids for Content Match and Sponsored Search use the getContentMatchMinBidForAdGroupOptimizationGuidelines and getSponsoredSearchMinBidForAdGroupOptimizationGuidelines operations.
Once campaign optimization is enabled, you will not be able to perform certain ad group operations (see Restricted Actions).
Note: When you set up the ad group optimization guidelines, you have the option to set bid limits. However, you still must specify the Sponsored Search and/or Content Match bids when you initially create the ad group. If you do not, the addAdGroup and addAdGroups operations will fail.