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.

API name	Adverity UI name	Description	Use in Adverity
AdFormat	AdFormat	The format of the advertisement.	dimension
AdGroupId	AdGroupId	The unique identifier for the ad group.	metric
AdGroupName	AdGroupName	The name of the ad group.	dimension
AdId	AdId	The unique identifier for the advertisement.	metric
AdNetworkType	AdNetworkType	The type of ad network where the ad was shown (e.g., search or display network).	dimension
Age	Age	The age demographic of the audience targeted or reached.	dimension
AvgClickPosition	AvgClickPosition	The average position of an ad when it was clicked.	dimension
AvgCpc	AvgCpc	The average cost per click for the ads.	dimension
AvgImpressionPosition	AvgImpressionPosition	The average position of an ad when it received an impression.	metric
AvgPageviews	AvgPageviews	The average number of pages viewed per session.	dimension
BounceRate	BounceRate	The percentage of single-page sessions on your website.	dimension
Bounces	Bounces	The number of bounces (according to Yandex.Metrica data).	metric
CampaignId	CampaignId	The unique identifier for the campaign.	metric
CampaignName	CampaignName	The name of the advertising campaign.	dimension
CampaignType	CampaignType	The type of the advertising campaign (e.g., text-image, dynamic).	dimension
CampaignUrlPath	CampaignUrlPath	The URL path associated with the campaign.	dimension
CarrierType	CarrierType	The type of mobile carrier network used by the user.	dimension
ClickType	ClickType	The type of click received (e.g., headline click, site link click).	dimension
Clicks	Clicks	The total number of clicks received by the ads.	metric
Client	Client	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.	dimension
ClientName	ClientName	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.	dimension
ConversionRate	ConversionRate	The percentage of clicks or sessions that result in a conversion.	dimension
Conversions	Conversions	The total number of conversions recorded.	dimension
Cost	Cost	The total cost incurred for the advertising activities.	metric
CostPerConversion	CostPerConversion	The average cost incurred for each conversion.	dimension
Criteria	Criteria	The targeting criterion used for ad impressions, such as keywords or retargeting conditions.	dimension
CriteriaId	CriteriaId	The unique identifier for the targeting criterion.	metric
CriteriaType	CriteriaType	The type of the targeting criterion (e.g., keyword, audience).	dimension
Criterion	Criterion	The targeting criterion, which can be a keyword or a retargeting criterion.	dimension
CriterionId	CriterionId	The unique identifier for the targeting criterion.	metric
Ctr	Ctr	The click-through rate, calculated as Clicks divided by Impressions.	metric
Currency	Currency	The currency used for monetary values in the report.	dimension
Date	Date	The specific date for which the report data is aggregated.	dimension
Device	Device	The type of device used by the user (e.g., mobile, desktop, tablet).	dimension
ExternalNetworkName	ExternalNetworkName	The name of the external network where the ad was displayed.	dimension
Gender	Gender	The gender demographic of the audience targeted or reached.	dimension
GoalsRoi	GoalsRoi	The Return on Investment (ROI) for specified goals.	dimension
Impressions	Impressions	The total number of times an ad was shown.	metric
Link	Link	The URL linking to the advertiser’s website, used as the destination for an ad.	dimension
LocationOfPresenceId	LocationOfPresenceId	The unique identifier for the geographic region where the user was located.	metric
LocationOfPresenceName	LocationOfPresenceName	The name of the geographic region where the user was located.	dimension
MatchType	MatchType	The keyword match type used (e.g., broad, phrase, exact).	dimension
MatchedKeyword	MatchedKeyword	The keyword that triggered the ad impression.	dimension
MobilePlatform	MobilePlatform	The mobile operating system or platform (e.g., iOS, Android) of the device.	dimension
Month	Month	The month for which the report data is aggregated.	dimension
Placement	Placement	The specific placement on a website or app where the ad was displayed.	dimension
Quarter	Quarter	The quarter of the year for which the report data is aggregated.	dimension
Query	Query	The search query entered by the user.	dimension
Revenue	Revenue	The total revenue generated from advertising activities.	metric
Sessions	Sessions	The total number of sessions on the website.	metric
Slot	Slot	The location where the ad was displayed in the search engine results page (SERP).	dimension
TargetingLocationId	TargetingLocationId	The unique identifier for the geographic region targeted by the campaign.	metric
TargetingLocationName	TargetingLocationName	The name of the geographic region targeted by the campaign.	dimension
Week	Week	The week for which the report data is aggregated.	dimension
Year	Year	The year for which the report data is aggregated.	dimension