Yandex.Direct fields

21 metrics54 dimensions

Search fields

ACCOUNT

accountId

Field label	Account ID
Field type	dimension
Data type	string.text.value

accountName

Field label	Account name
Field type	dimension
Data type	string.text.value

Currency

Field label	Currency
Field type	dimension
Data type	string.currency.code

AdFormat

Field label	Ad format
Description	Format of the ad impression: IMAGE — With an image, TEXT — A text ad, VIDEO — With video
Field type	dimension
Data type	string.text.value

AdGroupId

Field label	Ad group ID
Description	ID of the ad group
Field type	dimension
Data type	string.text.value

AdGroupName

Field label	Ad group name
Description	Name of the ad group
Field type	dimension
Data type	string.text.value

AdId

Field label	Ad ID
Description	The ad ID
Field type	dimension
Data type	string.text.value

AdNetworkType

Field label	Ad network type
Description	The type of advertising place where the ad is shown: SEARCH — In search results, AD_NETWORK — On ad networks
Field type	dimension
Data type	string.text.value

Href

Field label	Ad destination URL
Description	Link to the advertiser's website
Field type	dimension
Data type	string.text.url

AD METRICS

Impressions

Field label	Impressions
Description	Number of impressions
Field type	metric
Data type	int.number.value

Clicks

Field label	Clicks
Description	The number of clicks
Field type	metric
Data type	int.number.value

Cost

Field label	Cost
Description	Campaign cost in the account currency
Field type	metric
Data type	float.currency.value

Cost_eur

Field label	Cost (EUR)
Description	Campaign cost converted to euros
Field type	metric
Data type	float.currency.value
Services	Currency conversion

Cost_gbp

Field label	Cost (GBP)
Description	Campaign cost converted to British pounds
Field type	metric
Data type	float.currency.value
Services	Currency conversion

Cost_usd

Field label	Cost (USD)
Description	Campaign cost converted to US dollars
Field type	metric
Data type	float.currency.value
Services	Currency conversion

Ctr

Field label	CTR (%)
Description	CTR as a percent
Field type	metric
Data type	float.number.percentage

AvgClickPosition

Field label	Avg. click position
Description	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
Field type	metric
Data type	float.number.value
Aggregation	Non-aggregatable metric

AvgCpc

Field label	CPC
Description	Average cost per click
Field type	metric
Data type	float.currency.value

AvgImpressionPosition

Field label	Avg. impression position
Description	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
Field type	metric
Data type	float.number.value
Aggregation	Non-aggregatable metric

WeightedImpressions

Field label	Weight impressions
Description	WeightedImpressions = Impressions × AvgTrafficVolume / 100
Field type	metric
Data type	float.number.value
Aggregation	Non-aggregatable metric

CAMPAIGN

CampaignId

Field label	Campaign ID
Description	The campaign ID
Field type	dimension
Data type	string.text.value

CampaignName

Field label	Campaign name
Description	The campaign name
Field type	dimension
Data type	string.text.value

CampaignType

Field label	Campaign type
Description	The type of campaign: TEXT_CAMPAIGN, MOBILE_APP_CAMPAIGN, DYNAMIC_TEXT_CAMPAIGN
Field type	dimension
Data type	string.text.value

CONVERSIONS

ConversionRate

Field label	Conversion rate
Description	Conversions as a percent of the total number of sessions
Field type	metric
Data type	float.number.percentage

Conversions

Field label	Conversions
Description	The number of conversions
Field type	metric
Data type	int.number.value

CostPerConversion

Field label	Cost per conversion
Description	The average cost of reaching a goal (according to Yandex.Metrica data): the ratio of the cost of clicks to the number of conversions
Field type	metric
Data type	float.currency.value

Revenue

Field label	Revenue
Description	Revenue (according to Yandex.Metrica data)
Field type	metric
Data type	float.currency.value

Profit

Field label	Profit
Description	Calculated as the total revenue for goals minus the cost of clicks
Field type	metric
Data type	float.currency.value

GoalsRoi

Field label	Return on investment
Description	The return on investment in advertising, up to two decimal places
Field type	metric
Data type	float.currency.value

DATASOURCE

dataSourceName

Field label	Data source
Description	The name of the source for this data, as listed on supermetrics.com/docs
Field type	dimension
Data type	string.text.value
Destinations	API, Data warehouse

system_metadata.data_source_logins

Field label	Data source logins
Description	The data source login accounts that were used to authenticate against the data source
Field type	dimension
Data type	string.text.json

system_metadata.data_source_login_owners

Field label	Data source login owners
Description	The Supermetrics users that created the data source login connections
Field type	dimension
Data type	string.text.json

DEVICE

Device

Field label	User device type
Description	The type of device the ad was shown on: DESKTOP, MOBILE or TABLET
Field type	dimension
Data type	string.text.value

MobilePlatform

Field label	Operating system type
Description	OS type: ANDROID, IOS, OTHER or UNKNOWN
Field type	dimension
Data type	string.text.value

CarrierType

Field label	Type of connection
Description	The type of targeting criteria set by the advertiser
Field type	dimension
Data type	string.text.value

DISPLAY

Slot

Field label	Ad display location in SERP
Description	The ad display place: PREMIUMBLOCK — Premium Placement, OTHER — Other ad blocks
Field type	dimension
Data type	string.text.value

Placement

Field label	Ad placement website
Description	Name of the site where the ad is being displayed
Field type	dimension
Data type	string.text.value

ClickType

Field label	Part of the ad clicked
Description	The type of connection: CELLULAR — Mobile connection, STATIONARY — Wi-Fi or wired internet access, UNKNOWN — The type couldn‘t be detected
Field type	dimension
Data type	string.text.value

ExternalNetworkName

Field label	Ad exchange company name
Description	The name of the ad exchange (SSP)
Field type	dimension
Data type	string.text.value

KEYWORDS

MatchedKeyword

Field label	Matched keyword
Description	The matched keyword
Field type	dimension
Data type	string.text.value

MatchType

Field label	Keyword match type
Description	Keyword match type: RELATED_KEYWORD — Impression for a related keyword, SYNONYM — Impression for a keyword synonym, NONE — All other cases
Field type	dimension
Data type	string.text.value

LOCATION

LocationOfPresenceId

Field label	User region ID
Description	ID of the region where the user is located
Field type	dimension
Data type	string.geo.zip

LocationOfPresenceName

Field label	User region name
Description	Name of the region where the user is located
Field type	dimension
Data type	string.geo.region

TargetingLocationId

Field label	Targeting region ID
Description	ID of the targeting region. If extended geo-targeting is used, it may differ from the region of the user's location
Field type	dimension
Data type	string.geo.zip

TargetingLocationName

Field label	Targeting region name
Description	Name of the targeting region
Field type	dimension
Data type	string.geo.region

QUERY

system_metadata.query_date_range_start

Field label	Start date
Description	The start date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_date_range_end

Field label	End date
Description	The end date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_timezone

Field label	Timezone
Description	The timezone that is supplied to the query
Field type	dimension
Data type	string.time.timezone

system_metadata.query_filters

Field label	Filters
Description	All filters used in the query
Field type	dimension
Data type	string.text.json

system_metadata.query_date_start

Field label	Start
Description	When the query was started
Field type	dimension
Data type	string.time.datetime

system_metadata.query_date_end

Field label	End
Description	When the query completed
Field type	dimension
Data type	string.time.datetime

system_metadata.query_duration

Field label	Duration
Description	The duration in seconds of the query
Field type	dimension
Data type	int.duration.seconds

system_metadata.query_accounts

Field label	Accounts
Description	A list of accounts of which the data was pulled from
Field type	dimension
Data type	string.text.json

SITE METRICS

BounceRate

Field label	Bounce rate
Description	The percentage of bounces in the total number of sessions (according to Yandex.Metrica data)
Field type	metric
Data type	float.number.percentage
Aggregation	Non-aggregatable metric

Bounces

Field label	Bounces
Description	The number of bounces (according to Yandex.Metrica data)
Field type	metric
Data type	int.number.value

Sessions

Field label	Sessions
Description	Number of sessions. For mobile app ads, the number of clicks is shown as the number of visits
Field type	metric
Data type	int.number.value

AvgPageviews

Field label	Avg. pageviews
Description	The average session depth on the site, meaning the number of pages viewed
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

TARGET GROUP

Criterion

Field label	Targeting criteria
Description	The name or text of the targeting criteria set by the advertiser
Field type	dimension
Data type	string.text.value

CriterionId

Field label	Targeting criteria ID
Description	The ID of the targeting criteria set by the advertiser
Field type	dimension
Data type	string.text.value

CriterionType

Field label	Targeting criteria type
Description	The type of targeting criteria set by the advertiser
Field type	dimension
Data type	string.text.value

RlAdjustmentId

Field label	Retargeting list
Description	ID of a retargeting list used for applying bid adjustments for website users
Field type	dimension
Data type	string.text.value

TIME

today

Field label	Today
Description	Today's date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date
Destinations	API, Data warehouse

year

Field label	Year
Field type	dimension
Data type	string.time.year

yearOfWeek

Field label	Year of week
Field type	dimension
Data type	string.time.year

yearMonth

Field label	Year & month
Field type	dimension
Data type	string.time.yearmonth

quarter

Field label	Quarter
Field type	dimension
Data type	string.time.quarter

month

Field label	Month
Field type	dimension
Data type	string.time.month

yearWeekIso

Field label	Year & week (Mon-Sun)
Field type	dimension
Data type	string.time.yearweek

yearWeek

Field label	Year & week (Sun-Sat)
Field type	dimension
Data type	string.time.yearweekiso

isoWeek

Field label	Week (Mon-Sun)
Field type	dimension
Data type	string.time.weekiso

week

Field label	Week (Sun-Sat)
Field type	dimension
Data type	string.time.week

dayOfWeek

Field label	Day of week (Mon-Sun)
Field type	dimension
Data type	string.time.dayofweek

date

Field label	Date
Field type	dimension
Data type	string.time.date

USER

Age

Field label	Age
Description	The user‘s age group: one of the values AGE_0_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45 or UNKNOWN
Field type	dimension
Data type	string.person.age

Gender

Field label	Gender
Description	The user‘s gender: GENDER_MALE, GENDER_FEMALE or UNKNOWN
Field type	dimension
Data type	string.person.gender