Transfer of costs

With Yandex Metrica, you can track the effectiveness of any traffic sources on your tag. To do this, you can transfer expense information to Yandex Metrica for all traffic sources or for individual advertising systems. Data can be transferred:

Using Yandex Metrica integrations for uploading advertising expenses.
A special-format CSV file. Uploading is possible in the Yandex Metrica web interface and via API.

Transfer of costs by traffic source

If a traffic source cannot be tagged with UTM tags or you do not need detailed advertising expenses down to individual campaigns, ads, or placement types, you can still send expenses for such source. To transfer expenses, specify the Source (TrafficSource) and Traffic Source (detailed) (TrafficSourceDetail) parameters in the expense upload. The list of values for these parameters is specified in the table.

All Yandex Metrica integrations for uploading advertising expenses support automatic traffic source transfer.

To see which metrics are calculated based on the uploaded data and what you can do with them, go to the Sources, costs and ROI report.

Yandex Metrica integrations for uploading advertising expenses

Advertising system	How to pass data	Note
Yandex Direct	Data is transmitted automatically.	Alert If you upload expenses manually, they will be duplicated with those transferred automatically, and the report will be incorrect.
Google Ads	Set up integration in Yandex Metrica.	The source of expenses will be indicated as Ad Clicks — Google Ads
Facebook Ads	Set up integration in Yandex Metrica.	The source of expenses will be indicated as Ad Clicks — Facebook. If `UtmSource` contains the `instagram` value, Ad Clicks — Instagram

Transfer of costs with a special-format CSV file

To transfer ad campaign data to Yandex Metrica, create a CSV file that fits the expense transfer format for Metrica.

Sample of file for uploading data

Fields for transmitting data

Field name	Required	Description	Example
`Date`	Yes	Period that data is transmitted for. It can be a day or an interval of time. In the Unix Time Stamp format according to the ISO 8601 standard (YYYY-MM-DD). To specify a date range, use /.	2020-02-18 2020-01-18/2020-02-18
`Expenses`	Yes	The amount spent on advertising without VAT.	50,000
`Currency`	No	Three-letter ISO 4217 currency code. If the currency isn't specified, Yandex Metrica uses the currency specified in the tag settings to generate reports.	RUB
`TrafficSource`	Yes*	First-level traffic source. Acceptable values are given in the table.	ad
`TrafficSourceDetail`	No	Second-level traffic source. Acceptable values are given in the table.	vk
`UTMSource`	Yes*	The value of the UTM tag that is specified in the URL of the link in the ad. Note the case of the characters in the tag value.	vk
`UTMCampaign`	No		new
`UTMMedium`	No		cpc
`UTMTerm`	No		shirt-blue
`UTMContent`	No		shirt
`Clicks`	No	Number of clicks on ads.	100

* The UTMSource field is required if the TrafficSource field is not specified.

Available TrafficSource and TrafficSourceDetail values

	TrafficSource	TrafficSourceDetail
Internal traffic	`internal`	—
Direct traffic	`direct`	—
Link traffic	`referral`	Specify the domain in `website.com` format
Search engine traffic	`organic`	List of values
Ad traffic	`ad`	List of values
Cached page traffic	`saved`	—
Undefined	`undefined`	—
Mailing traffic	`email`	—
Traffic from social networks	`social`	List of values
Messenger traffic	`messenger`	List of values
QR code traffic	`qrcode`	—
Recommendation system traffic	`recommend`	List of values

Search engine traffic

Name	ID
Other search engine: Identified by tags	`unknown`: Everything that doesn’t match any other ID
Yandex	`yandex`
Metabot.ru	`metabot_ru`
Poisk.ru	`poisk_ru`
blekko	`blekko`
Rx24	`rx24`
Gigabase	`gigabase`
AOL	`aol_search`
Zen News	`yandex_news`
I.ua	`i_ua`
MyStart by IncrediMail.com	`mystart`
Winamp Search	`winamp_search`
Search on NUR.KZ	`nur_kz`
Topsy	`topsy`
KAZ.KZ	`kaz_kz`
All.by	`all_by`
Tut.by	`tut_by`
Webalta	`webalta`
Magna	`magna`
Lycos	`lycos`
Meta.ua	`meta_ua`
My Web Search	`myweb_search`
Exalead.fr	`exalead_fr`
Gbg.bg	`gbg_bg`
Conduit	`conduit`
Babylon Search	`babylon_search`
Alexa Web Search	`alexa_web`
search.1and1.com	`1and1`
7search.com	`7search`
search.about.com	`about`
acoon.com	`acoon`
Alhea	`alhea`
AltaVista	`altavista`
amfibi.com	`amfibi`
Aport	`aport`
arama.com	`arama`
Ask.com	`ask_com`
search.avg.com	`avg`
Baidu	`baidu`
biglobe.ne.jp	`biglobe_ne`
Bigmir.net	`bigmir_net`
Bing	`bing`
Coc Coc	`coccoc`
crawler.com	`crawler`
Cuil.com	`cuil_com`
DAEMON search	`daemon_search`
daum.net	`daum`
dogpile.com	`dogpile`
DuckDuckGo	`duckduckgo`
Ecosia	`ecosia`
finnerask.com	`finnerask`
start.funmoods.com	`funmoods`
Gde.ru	`gde_ru`
gigablast.com	`gigablast`
gmx.net	`gmx_net`
GoGo	`gogo`
goo.ne.jp	`goo_ne`
Google	`google`
hakia.com	`hakia`
search.handycafe.com	`handycafe`
hi.ru	`hi_ru`
hotbot.com	`hotbot`
Hotline.ua	`hotline`
icerocket.com	`icerocket`
Search on ICQ.com	`icq_search`
search.iminent.com	`iminent`
search.incredibar.com	`incredibar`
infospace.com	`infospace`
istella.it	`istella`
k9safesearch	`k9safesearch`
Search on KM.RU	`km_search`
kvasir.no	`kvasir`
Liveinternet	`liveinternet`
Live Search	`livesearch`
Mail.ru	`mail_ru`
mamma.com	`mamma`
metacrawler.com	`metacrawler`
MSN	`msn`
myahint.com	`myahint`
najdi.si	`najdi_si`
naver.com	`naver`
netsearch.org	`netsearch`
Nigma	`nigma`
onet.pl	`onet_pl`
Pivim.com	`pivim_com`
plusnetwork.com	`plusnetwork`
Search on QIP.ru	`qip_search`
Quintura	`quintura`
Qwant	`qwant`
Rambler	`rambler`
sapo.pt	`sapo_pt`
scrubtheweb.com	`scrubtheweb`
search.gmx.net	`search_gmx_net`
searchcompletion.com	`searchcompletion`
search-results.com	`searchresults`
searchya.com	`searchya`
Seznam	`seznam`
Skydns	`skydns`
search.smilebox.com	`smilebox`
so.360.cn	`so360`
search.softonic.com	`softonic`
Sogou	`sogou`
speedbit.com	`speedbit`
Sputnik	`sputnik`
Startpagina	`startpagina`
startsiden.no/sok	`startsiden_no`
search.sweetim.com	`sweetim`
Ukr.net	`ukr_net`
v9.com	`v9`
virgilio.it	`virgilio_it`
voila.fr	`voila`
Web.de	`web_de`
Wikia Search	`wikia_search`
wow	`wow`
wp.pl	`wp_pl`
Yaani	`yaani`
Yahoo!	`yahoo`
yam.com	`yam`
yippy.com	`yippy`
Zapmeta	`zapmeta`

Ad traffic

Name	ID
Google Ads	`google_adwords`
Begun	`begun`
Krasnoyarsk.biz	`krasnoyarsk_biz`
Link.ru	`link_ru`
MadBanner	`madbanner`
Magna-context	`magna_context`
RORER	`rorer`
Stavka.ru	`stavka_ru`
WebAlta	`webalta`
Yandex Market	`market`
aVtomarket.ru	`avtomarket`
Kavango	`kavanga`
PRRE.RU	`prre`
Videonow.ru	`videonow`
AdRiver	`adriver`
AdFox	`adfox`
MediaTarget	`mediatarget`
DirectPoint	`directpoint`
TBN	`tbn`
LitBN	`litbn`
SoftBN	`softbn`
AdLand	`adland`
Linkad	`linkad`
Ukrainian Banner Network	`banner`
Banner Bank	`banner_bank`
BannerHost	`banner_host`
List Banner Exchange	`list_banner_exchange`
Pravda Banner Network	`pravda_banner_network`
Land Banner Network	`land_banner_network`
IBN	`ibn`
BigBN	`bigbn`
Display advertising	`media_awaps`
AdvMaker.ru	`advmaker`
Tovary@Mail.Ru	`tovary_mail_ru`
VK	`vkontakte`
Facebook	`facebook`
Odnoklassniki (OK)	`odnoklassniki`
Moi Mir	`moimir`
B2BContext	`b2bcontext`
B2BCAdNewsontext	`adnews`
People Group	`people_group`
VisitWeb.com	`visitweb`
Adlabs Media Network	`adlabs_media_network`
Admitad	`admitad`
Medialand	`medialand`
MyTarget	`target_mail_ru`
Aport	`aport`
Price.ru	`price_ru`
MarketGid	`marketgid`
adPremium	`adpremium`
ExoClick	`exoclick`
LadyCenter	`ladycenter`
POST RMBN	`POST RMBN`
Direct/ADVERT	`directadvert`
Recreativ	`recreativ`
AdWolf	`adwolf`
Adonweb	`adonweb`
AdBlender	`adblender`
AdvertLink	`advertlink`
SharedAdDomain	`sharedaddomain`
Adnxs	`Adnxs`
Targetix	`targetix`
adhood	`adhood`
Criteo	`criteo`
Google Merchant	`google_merchant`
Avito Context	`avito_context`
Sociomantic	`sociomantic`
Ttarget	`ttarget`
Yandex: Display	`display`
Avito Promo	`avito_promo`
Yandex Advertising Network: RTB blocks	`yandexrtb`
ADNOUS	`adnous`
VigLink	`viglink`
Instagram	`instagram`
Rare.ru	`rareru`
BingAds	`bingads`
Whisla	`whisla`
Taboola	`taboola`
Other advertising: identified by tags	`unknown`
YouTube	`youtube`
Giraff.io	`giraffio`
DriveNetwork	`drivenetwork`
NNN	`nnn`
Nadavi	`nadavi`
Tkat.ru	`tkat`
coccoc	`coccoc`
Relap	`relap`
TikTok	`tiktok`
Yandex PromoPages	`zen_ads`
RTB House	`rtbhouse`
Yandex: Direct	`yandex_direct_star`
VK Ads	`vk_ads`
Ozon	`ozon`

Traffic from social networks

Name	ID
VK	`vk`
Twitter	`twitter`
Facebook	`facebook`
Odnoklassniki (OK)	`odnoklassniki`
Liveinternet	`liveinternet`
LiveJournal	`livejournal`
Leprosorium	`leprosorium`
Diary.ru	`diary`
Google+	`google`
Moi Mir@Mail.ru	`mail`
ORKUT	`orkut`
Ya.ru	`ya`
Moi Krug	`moikrug`
Vkrugudruzei.ru	`vkrugudruzei`
Linked in	`linkedin`
juick	`juick`
connect.ua	`connect`
LJ.Rossia.org	`rossia`
FriendFeed	`friendfeed`
myspace.com	`myspace`
delicious.com	`delicious`
Privet.ru	`privet`
www.draugiem.lv	`draugiem`
cloob.com	`cloob`
mixi	`mixi`
hi.baidu.com	`baidu`
hi5.com	`hi5`
renren.com	`renren`
skyrock.com	`skyrock`
tumblr.com	`tumblr`
Instagram	`instagram`
sprashivai.ru	`sprashivai`
ask.fm	`ask`
Pinterest	`pinterest`
Postila.ru	`postila`
Fotostrana.ru	`fotostrana`
Reddit	`reddit`
pin.me	`pin`
point.im	`point`
StumbleUpon	`adnews`
Other social media: Identified by tags	`unknown`: Everything that doesn’t match any other ID
YouTube	`youtube`

Messenger traffic

Name	ID
Other messenger: Identified by tags	`unknown`: Everything that doesn’t match any other ID
Telegram	`telegram`
WhatsApp	`whatsapp`
Viber	`viber`
Skype	`skype`
WeChat	`wechat`
Yandex Messenger	`yandex_chats`
Facebook	`facebook`
VK	`vk`

Recommendation system traffic

Name	ID
Other recommendation system: Identified by tags	`unknown`: Everything that doesn’t match any other ID
Zen	`zen_yandex`
Google Discover	`google_discover`
Opera Personal News	`opera_news`
Sony News Suite	`sony_news`
Flipboard	`flipboard`
Pulse	`pulse`
MirTesen	`mirtesen`
Toutiao	`toutiao`
Rambler	`rambler`

Note

You can upload data for the last 360 days and no more than 30 days ahead.

You can send a CSV file with data:

In the web interface

Via the API

In Yandex Metrica, go to Settings → Upload data.
In the Advertising expenses section, click Upload.
Upload the prepared file.
In the window that appears, specify the following:
- TrafficSource and TrafficSourceDetail values.
- Value of the UTMSource tag (the ad system that the file was uploaded from).
  Make sure that the case in which the UTM tag value is specified matches the case in the ad URL.
- column in the file corresponds to the field Data.
- column in the file corresponds to the field Expenses.
  Select the type of amount separator that is used in the file uploaded in Step 1 — a comma or dot.
- column in the file corresponds to the field Clicks.
- the currency in which the expenses are specified.
  If the currency is not specified, Yandex Metrica uses the currency from the tag settings for report generation.
- other UTM tags and their values from the list.
  You can enter a single value for all tags. For example, for the UTMMedium tag you can specify the value cpc.
Click Upload data.

If you upload a file with data for the same period, the new file will replace the previously uploaded one.

If a time period is specified in the file, Yandex Metrica will evenly distribute the numerical values (for example, expense, number of clicks, and so on) in it for displaying in the report.

Chat with us

Write an email

Please note: Our support team will never initiate a call to you. Do not follow any instructions of people who call you and introduce themselves as the Yandex Metrica support team.

Useful links

Online training

Was the article helpful?

Measurement Protocol

Connecting Google Ads to upload expense data