How to work with display campaigns

Display campaigns are ad campaigns where payment is based on Yandex Direct impressions (not clicks). Ads are displayed in the Yandex Advertising Network on desktops and mobile devices, as well as on digital billboards.

A display campaign can include ad groups with different formats. The Yandex Direct API currently supports display banners and video display ads. For more information about these formats, see Display banners and Video advertising in Yandex Direct Help.

Manage campaigns

Alert

To design creatives in Ad Builder or upload creatives, you must use the web interface at this time.

Create a campaign with the CPM_BANNER_CAMPAIGN type: pass the CpmBannerCampaign structure in the Campaigns.add method.

For details about working with this type of campaign, see the section Campaign type.

For information about available display strategies, see the section Display strategies.

For information about other campaign parameters, see the section Campaign parameters.
You can add groups of display banners and groups of video ads to a display campaign.

Display banners

Create an ad group.

In a group of display banners, you can use either a user profile target or keywords. Depending on what impression criteria you plan to add, choose the group subtype:
- To create a group with an audience target based on a user profile, use the AdGroups.add method to pass an empty CpmBannerUserProfileAdGroup structure.
Note

Negative keywords are not allowed in a group with an audience target based on a user profile.
- To create a group with keywords, use the AdGroups.add method to pass an empty CpmBannerKeywordsAdGroup structure.
You cannot change the group subtype in the future.
Add impression criteria to the group.
User profile

Keywords
1. Get reference lists of Crypta segments based on demographic and behavioral characteristics, as well as lists of Crypta user interest segments: use the Dictionaries.get method and specify AudienceDemographicProfiles and AudienceInterests in the request.
2. Create a user profile: use the RetargetingLists.add method.
  
  The user profile is implemented as a retargeting list of the AUDIENCE type. For more information about the profile, see the section Retargeting list (RetargetingList).
3. Add a user profile to the ad group: the AudienceTargets.add method.
  
  If a manual display strategy is selected in the campaign, you can set a bid on the user profile immediately when adding the profile to an ad group or later using the AudienceTargets.setBids method.
Add keywords: use the Keywords.add method.

You can set bids and priorities immediately when creating keywords, or later using the KeywordBids.set or KeywordBids.setAuto method.

Aautotargeting can't be added to a group of display ads.
Add ads to the group:
1. Design creatives in Ad Builder or upload existing creatives in the Yandex Direct web interface. See How to launch a display campaign in the Help for Yandex Direct.
2. Get IDs of available creatives with the HTML5_CREATIVE and IMAGE_CREATIVE type: use the Creatives.get method.
3. Add one or more ads with the CPM_BANNER_AD type to the group by using the Ads.add method. Pass the ad parameters in the CpmBannerAdBuilderAd structure.
Submit ads for review: the Ads.moderate method.

Video ads

Create an ad group: use the Groups.add method to pass an empty CpmVideoAdGroup structure.
Add a user profile target to the group.
1. Get reference lists of Crypta segments based on demographic and behavioral characteristics, as well as lists of Crypta user interest segments: use the Dictionaries.get method and specify AudienceDemographicProfiles and AudienceInterests in the request.
2. Create a user profile: use the RetargetingLists.add method.
The user profile is implemented as a retargeting list of the AUDIENCE type. For more information about the profile, see the section Retargeting list (RetargetingList).
1. Add a user profile to the ad group: the AudienceTargets.add method.
If a manual display strategy is selected in the campaign, you can set a bid on the user profile immediately when adding the profile to an ad group or later using the AudienceTargets.setBids method.
Add ads to the group:
1. Design creatives in Ad Builder in the Yandex Direct web interface. See Video advertising / How to launch in Yandex Direct Help.
2. Get IDs of available creatives with the CPM_VIDEO_CREATIVE type: use the Creatives.get method.
3. Add one or more ads with the CPM_VIDEO_AD type: use the Ads.add method. Pass the ad parameters in the CpmVideoAdBuilderAd structure.
Submit ads for review: the Ads.moderate method.

Getting statistics

To get statistics for display campaigns, use Reports. The report can provide the average CPM, the average frequency of impressions per user, and the number of unique users who were shown a banner.

In the report request, specify:

In the Type parameter — the REACH_AND_FREQUENCY_PERFORMANCE_REPORT report type.
In the Filter structure — one or multiple IDs of display campaigns. A filter by campaign is required for this type of report.
In the FieldNames array, add the CampaignId, AvgCpm, AvgImpressionFrequency, and ImpressionReach values.

Request example

curl \
  -H 'Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f' \
  -H 'Accept-Language: en' \
  -H 'Client-Login: agrom' \
  -H 'returnMoneyInMicros: false' \
  -d '{
    "params": {
      "SelectionCriteria": {
        "Filter": [{
          "Field": "CampaignId",
          "Operator": "IN",
          "Values": [ "10012", "10017" ]
        }]
      },
      "FieldNames": [ "CampaignId", "Impressions", "Clicks", "Cost", "AvgCpm", "AvgImpressionFrequency", "ImpressionReach" ],
      "OrderBy": [{
        "Field": "CampaignId"
      }],
      "ReportName": "Display campaigns",
      "ReportType": "REACH_AND_FREQUENCY_PERFORMANCE_REPORT",
      "DateRangeType": "LAST_WEEK",
      "Format": "TSV",
      "IncludeVAT": "YES",
      "IncludeDiscount": "YES"
    }
  }' \
  https://api.direct.yandex.com/json/v5/reports

Was the article helpful?

Statistics and analysis

How to work with dynamic ads