Documentation

Ad group

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.

Service

Use the AdGroups service for managing groups.

Methods

add | update | delete | get

Restrictions

Maximum of 1000 groups per campaign.

The group type must match the campaign type.

Operations with groups are not possible in archived campaigns.

Ad group type

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.

    A group can have child objects — ads, keywords, and audience targets. Bid adjustments can be set for a group.

  • 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.

    To create or edit a group, the parameters specific to this type of group must be passed in the MobileAppAdGroup structure for the add or update method.

    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.

    A group can have child objects — ads, keywords, and audience targets. Bid adjustments can be set for a group.

  • 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.

      To create or edit a group, the parameters specific to this type of group must be passed in the DynamicTextAdGroup structure for the add or update method.

      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.

      A group can have child objects — ads and ad targets. Bid adjustments can be set for a group.

    • 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 group can have child objects: ads and filters for selecting product offers from the feed. You must use the web interface for managing filters. Bid adjustments can be set for a group.

Ad group status

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.

StatusDescription
DRAFTThe group has been created but has not yet been submitted for review.
MODERATIONThe group is under review.
PREACCEPTEDThe group has been automatically accepted for displays, but will be further reviewed by a moderator.
ACCEPTEDAt least one of the group's keywords was approved after review (some of them may have been rejected).
REJECTEDAll keywords were rejected.

Ad group serving status

The ServingStatus parameter reflects whether the targeting criteria in the group are eligible for ad serving.

Serving statusDescription
ELIGIBLEEligible 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.