Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Yandex.Direct: Most-used fields

The table below gives information about most-used fields that you can import from Yandex.Direct. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

FieldAdverity UI nameType
AdFormatDimension

The format of the advertisement.

AdGroupIdMetric

The unique identifier for the ad group.

AdGroupNameDimension

The name of the ad group.

AdIdMetric

The unique identifier for the advertisement.

AdNetworkTypeDimension

The type of ad network where the ad was shown (e.g., search or display network).

AgeDimension

The age demographic of the audience targeted or reached.

AvgClickPositionDimension

The average position of an ad when it was clicked.

AvgCpcDimension

The average cost per click for the ads.

AvgImpressionPositionDimension

The average position of an ad when it received an impression.

AvgPageviewsDimension

The average number of pages viewed per session.

BounceRateDimension

The percentage of single-page sessions on your website.

BouncesDimension

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

CampaignIdDimension

The unique identifier for the campaign.

CampaignNameDimension

The name of the advertising campaign.

CampaignTypeDimension

The type of the advertising campaign (e.g., text-image, dynamic).

CarrierTypeDimension

The type of mobile carrier network used by the user.

ClickTypeDimension

The type of click received (e.g., headline click, site link click).

ClicksMetric

The total number of clicks received by the ads.

ClientDimension

The client identifier in Yandex.Direct. This field represents the unique ID of the advertiser or agency whose data is being collected. For agency accounts, this is often used to scope requests to specific client accounts.

ClientNameDimension

The full name or login of the Yandex.Direct user associated with the client account. This can be either the advertiser's full name or the login used to access the Direct account.

ConversionRateDimension

The percentage of clicks or sessions that result in a conversion.

ConversionsMetric

The total number of conversions recorded.

CostMetric

The total cost incurred for the advertising activities.

CostPerConversionDimension

The average cost incurred for each conversion.

CriteriaDimension

The targeting criterion used for ad impressions, such as keywords or retargeting conditions.

CriteriaIdDimension

The unique identifier for the targeting criterion.

CriteriaTypeDimension

The type of the targeting criterion (e.g., keyword, audience).

CriterionDimension

The targeting criterion, which can be a keyword or a retargeting criterion.

CriterionIdMetric

The unique identifier for the targeting criterion.

CtrDimension

The click-through rate, calculated as Clicks divided by Impressions.

CurrencyDimension

The currency used for monetary values in the report.

DateDimension

The specific date for which the report data is aggregated.

DeviceDimension

The type of device used by the user (e.g., mobile, desktop, tablet).

ExternalNetworkNameDimension

The name of the external network where the ad was displayed.

GenderDimension

The gender demographic of the audience targeted or reached.

GoalsRoiDimension

The Return on Investment (ROI) for specified goals.

ImpressionsMetric

The total number of times an ad was shown.

LocationOfPresenceIdDimension

The unique identifier for the geographic region where the user was located.

LocationOfPresenceNameDimension

The name of the geographic region where the user was located.

MatchTypeDimension

The keyword match type used (e.g., broad, phrase, exact).

MobilePlatformDimension

The mobile operating system or platform (e.g., iOS, Android) of the device.

PlacementDimension

The specific placement on a website or app where the ad was displayed.

RevenueMetric

The total revenue generated from advertising activities.

SessionsMetric

The total number of sessions on the website.

SlotDimension

The location where the ad was displayed in the search engine results page (SERP).

TargetingLocationIdDimension

The unique identifier for the geographic region targeted by the campaign.

TargetingLocationNameDimension

The name of the geographic region targeted by the campaign.