Ad Groups
To create an ad group, you begin by creating an AdGroup object. The AdGroup object specifies the default bid values for each match type; whether the group contains search ads, content ads, or both; and whether to match on keywords or site placement. To specify the countries where the ads display, use location targeting. To determine the elements of the AdGroup object that you must set when you add an ad group, see the Add column of the ad group object’s elements table.
Managing Ad Groups
If you do not specify default bid values for the ad group, the ad group will use default bid values based on the currency of the account, and pricing model, and the bidding model. For more information, see Match Type and Bid Values.
You can optionally specify the status of the ad group. By default, the status is Draft. In the Draft state, you can add keywords and ads to the ad group without editorial review at the time you add them. You would then call the SubmitAdGroupForApproval operation to activate the ad group and send all the keywords and ads through editorial review.
If you set the status to Active or Paused, the keywords and ads will begin editorial review at the time you add them. To activate a paused ad group, you call the ResumeAdGroups operation.
Ad groups belong to campaigns. Before you can add an ad group, you must know the identifier of the campaign that you want to add the ad group to. Typically, when you create a campaign, you store the campaign identifier locally because you will often have to refer to it. However, to get the campaign identifier if you do not store it locally, you must call the GetCampaignsByAccountId operation.
To add one or more ad groups, call the AddAdGroups operation. Set the AdGroups element to the list of ad groups that you want to add, and set the CampaignId element to the identifier of the campaign that will own the ad groups. In addition, you must set the UserName, Password, DeveloperToken and CustomerAccountId header elements. Set the CustomerAccountId header elements to the identifier of the account that owns the ad groups. To get the account identifier if you do not store it locally, call the GetAccountsInfo operation.
The AddAdGroups operation returns the identifiers of the ad groups that you added. You should store them locally for easy access to the ad groups later. For information about why you should store identifiers locally, see Using Bing Ads Services Efficiently.
