Report content

The report is generated in TSV format.

The first row in the report contains the report name that is set in the ReportName parameter, along with the start and end dates of the reporting period. This row is not included in the report if the request specifies the HTTP header skipReportHeader: true.

The second row contains the names of the fields (columns) that are set in the FieldNames parameter. This row is not included in the report if the request specifies the HTTP header skipColumnHeader: true.

The following rows contain the statistics (the values for the fields).

The last row in the report contains the number of rows with statistics. This row is not included in the report if the request specifies the HTTP header skipReportSummary: true.

The fields are described in the table below.

Field Description
AdFormat

Format of the ad impression:

  • IMAGE — Image ad.
  • TEXT — Text ad.
  • VIDEO — Video ad.
  • SMART_MULTIPLE — Smart banner.
  • SMART_SINGLE — Smart ad.
  • ADAPTIVE_IMAGE — Adaptive image ad.
  • SMART_TILE — Smart tile.
AdGroupId

ID of the ad group.

It's not shown in the report on campaigns created in the Campaign Wizard.

AdGroupName

Name of the ad group.

It's not shown in the report on campaigns created in the Campaign Wizard.

AdId

The ad ID.

It's not shown in the report on campaigns created in the Campaign Wizard.

AdNetworkType

The type of advertising place where the ad is shown:

  • SEARCH — In search results.

  • AD_NETWORK — On ad networks.

Age

The user's age group: one of the values AGE_0_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45, AGE_45_54, AGE_55 or UNKNOWN.

Statistics for periods up through 21.08.2018 output the AGE_45 value, and after this date the values AGE_45_54 and AGE_55 are shown. The statistics for a period that includes 21.08.2018 might show some with the AGE_45 value and some with AGE_45_54 or AGE_55.

AvgClickPosition Average position where the ad was clicked. Calculated using only clicks on the first page of Yandex search results. The top position is assigned the number 1.
AvgCpc Average cost per click.
AvgCpm

Average price per thousand impressions.

Data is only available for display campaigns.

AvgEffectiveBid Average bid per click with all adjustments.

Data is only available for pay-per-click campaigns.

AvgImpressionFrequency

Average impression frequency per user, up to two decimal places.

Data is only available for display campaigns.

AvgImpressionPosition Average display position of the ad. Calculated using only displays on the first page of Yandex search results. The top position is assigned the number 1.
AvgPageviews The average session depth on the site: that is, the number of pages viewed (according to Yandex Metrica data).
AvgTrafficVolume The average volume of traffic from positions that had ad impressions.
BounceRate The percentage of bounces in the total number of sessions (according to Yandex Metrica data).
Bounces The number of bounces (according to Yandex Metrica data).
CampaignId The campaign ID.
CampaignName The campaign name.
CampaignUrlPath The URL specified in the ad campaign settings.
CampaignType

The type of campaign:

  • TEXT_CAMPAIGN
  • MOBILE_APP_CAMPAIGN
  • DYNAMIC_TEXT_CAMPAIGN
  • SMART_CAMPAIGN
  • MCBANNER_CAMPAIGN
  • CPM_BANNER_CAMPAIGN
  • CPM_DEALS_CAMPAIGN
  • CPM_FRONTPAGE_CAMPAIGN
  • CPM_PRICE

See Campaign type.

CarrierType

The type of connection:

  • CELLULAR — Mobile connection.
  • STATIONARY — Wi-Fi or wired internet access.
  • UNKNOWN — The type couldn't be detected.
Clicks The number of clicks.
ClickType Which part of the ad was clicked by the user:
  • TITLE — The ad title. A click on the display link is considered a click on the ad.

    Note.

    For image ads, smart banners, display banners, and search banners, any click on an ad is considered a title click.

  • SITELINK1, SITELINK2, ..., SITELINK8 — Sitelinks.

  • VCARD — The virtual business card.

  • CHAT — Live chat with an operator.
  • PHONE — Phone number.

  • MOBILE_APP_ICON — The app icon (for mobile app ads).

  • BUTTON — The download or install button (for mobile app ads).

  • PRODUCT_EXTENSIONS — Product extensions.

  • MARKET — Yandex.Market.

  • UNKNOWN.

ClientLogin Username of the client's chief representative.
ConversionRate

The ratio of the number of converted sessions to the number of clicks, as a percentage (according to Yandex Metrica data). It might be greater than 100 because a single click can be the source of multiple sessions.

If the request included Yandex Metrica goals (the Goals parameter), the ConversionRate field is replaced with ConversionRate_<goal_ID>_<attribution_model> field.

ConversionRate_<goal_ID>_<attribution_model>

The ratio of the number of converted sessions during which the specified goal was reached to the number of clicks. It might be greater than 100 because a single click can be the source of multiple sessions. The name of the field contains the goal ID and the name of the attribution model (the value of the AttributionModels parameter).

For example, the ConversionRate_1234567_FC field contains the number of sessions that had a conversion for goal 1234567, when the session source is attributed using the “first click” model.

If the request specifies multiple attribution models, the data is output separately for each model. The number of ConversionRate_<goal_ID>_<attribution_model> fields for each attribution model corresponds to the number of goals specified in the Goals parameter.

Conversions

The number of conversions (according to Yandex Metrica data).

If the request included Yandex Metrica goals (the Goals), the Conversions field is replaced with Conversions_<goal_ID>_<attribution_model>.