Yandex.Direct: Most-used fields

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
AdFormat Dimension

The format of the advertisement.

AdGroupId Metric

The unique identifier for the ad group.

AdGroupName Dimension

The name of the ad group.

AdId Metric

The unique identifier for the advertisement.

AdNetworkType Dimension

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

Age Dimension

The age demographic of the audience targeted or reached.

AvgClickPosition Dimension

The average position of an ad when it was clicked.

AvgCpc Dimension

The average cost per click for the ads.

AvgImpressionPosition Dimension

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

AvgPageviews Dimension

The average number of pages viewed per session.

BounceRate Dimension

The percentage of single-page sessions on your website.

Bounces Dimension

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

CampaignId Dimension

The unique identifier for the campaign.

CampaignName Dimension

The name of the advertising campaign.

CampaignType Dimension

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

CarrierType Dimension

The type of mobile carrier network used by the user.

ClickType Dimension

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

Clicks Metric

The total number of clicks received by the ads.

Client Dimension

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.

ClientName Dimension

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.

ConversionRate Dimension

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

Conversions Metric

The total number of conversions recorded.

Cost Metric

The total cost incurred for the advertising activities.

CostPerConversion Dimension

The average cost incurred for each conversion.

Criteria Dimension

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

CriteriaId Dimension

The unique identifier for the targeting criterion.

CriteriaType Dimension

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

Criterion Dimension

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

CriterionId Metric

The unique identifier for the targeting criterion.

Ctr Dimension

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

Currency Dimension

The currency used for monetary values in the report.

Date Dimension

The specific date for which the report data is aggregated.

Device Dimension

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

ExternalNetworkName Dimension

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

Gender Dimension

The gender demographic of the audience targeted or reached.

GoalsRoi Dimension

The Return on Investment (ROI) for specified goals.

Impressions Metric

The total number of times an ad was shown.

LocationOfPresenceId Dimension

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

LocationOfPresenceName Dimension

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

MatchType Dimension

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

MobilePlatform Dimension

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

Placement Dimension

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

Revenue Metric

The total revenue generated from advertising activities.

Sessions Metric

The total number of sessions on the website.

Slot Dimension

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

TargetingLocationId Dimension

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

TargetingLocationName Dimension

The name of the geographic region targeted by the campaign.