An ad group consists of a set of ads and shared criteria for displaying these ads. You can use groups to test different variations of ads and automatically determine which of them is the most attractive for the audience. For more information, see Experimenting with ads in the Help for Yandex.Direct.
Use the AdGroups service for managing groups.
Maximum of 1000 groups per campaign.
The group type must match the campaign type.
Operations with groups are not possible in archived campaigns.
The group type is set when creating an ad group and can't be changed.
The set of group parameters depends on its type.
The parameters common to all types of groups are the name, display region, and shared negative keywords for a group. When creating or editing a group, pass these parameters in the AdGroups structure of the add and update methods. To get these parameters, list the parameter names in the FieldNames input parameter for the get method.
The parameters that depend on the group type are passed in the child structure with the corresponding name.
The following types of groups are currently available:
TEXT_AD_GROUP — A group of text and image ads.
It only has the parameters that are common to all types of groups.
MOBILE_APP_AD_GROUP — A group for advertising mobile apps.
For this type of group, you must additionally specify a link to the app in App Store or Google Play, along with the types of devices, types of internet connection, and earliest OS version that the ad can be displayed on. For more information about advertising mobile apps, see Ads for Mobile Apps in the Help for Yandex.Direct.
When getting group parameters, list the names of parameters that are shared across all group types in the FieldNames input parameter, and list the names of parameters that are specific to this group type in the MobileAppAdGroupFieldNames input parameter of the get method.
DYNAMIC_TEXT_AD_GROUP — A group of dynamic ads. For more information about dynamic text ads, see Dynamic ads in the Help for Yandex.Direct.
There are two subtypes of dynamic ad groups:
WEBPAGE — The data source for generating ads is website pages.
For this subtype, you must additionally specify the advertised domain.
When getting group parameters, list the names of parameters that are shared across all group types in the FieldNames input parameter, and list the names of parameters that are specific to this group type in the DynamicTextAdGroupFieldNames input parameter of the get method.
FEED — The data source for generating ads is a feed (a file with product offers).
Creating and editing this type of group is currently possible only in the web interface.
When getting group parameters, list the names of parameters that are shared across all group types in the FieldNames input parameter, and list the names of parameters that are specific to this group type in the DynamicTextFeedAdGroupFieldNames input parameter of the get method.
The Status parameter reflects the overall result of reviewing keywords. Keywords are submitted for review automatically when one of the group's ads is submitted for review.
|DRAFT||The group has been created but has not yet been submitted for review.|
|MODERATION||The group is under review.|
|PREACCEPTED||The group has been automatically accepted for displays, but will be further reviewed by a moderator.|
|ACCEPTED||At least one of the group's keywords was approved after review (some of them may have been rejected).|
|REJECTED||All keywords were rejected.|
The ServingStatus parameter reflects whether the targeting criteria in the group are eligible for ad serving.
|ELIGIBLE||Eligible for ad serving.|
|RARELY_SERVED||“Rarely served” — With the current settings, ads are rarely served. For example, users don't search for the specified keywords.|