Yandex: Setup guide

On this page

This guide explains how to collect data from Yandex.

Introduction

For a list of the fields that you can collect from Yandex, see Yandex.

Limitations

Collecting data from Yandex comes with the following limitations:

Adverity only supports authorizations to Yandex Direct. Authorizations to Yandex Metrica are not supported.
Yandex can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.
Historical data is available for up to 3 years prior to the current month. Data availability for specific metrics may vary.

Prerequisites

Before you start collecting data from Yandex, perform all of the following actions:

Ensure that the account you use to connect to Yandex has at least Representative or similar permissions that allow you to select a network on which to collect data.
Request API access for each Yandex account from which you want to collect data.
To collect client login data, ensure that the account you use to connect to Yandex has agency privileges. For more information, see the Yandex documentation.

Creating a datastream to collect data from Yandex

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Yandex.

Authorization: Allow Adverity to access Yandex

If you choose Access using your credentials or Access using someone else’s credentials, in Set up or edit Clients, you or the person granting access must choose one of the following options:
- Choose Grant access to all items, including those created in the future to give Adverity Clients to access all existing items and all items created in the future.
- Choose Select specific items to which you want to grant access to only give Adverity Clients to access the selected items. Adverity will not automatically have access to items created in the future. You will need to grant Adverity access to any items created in the future.
Warning
If you use your credentials to grant Adverity access to Yandex, all the items available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.
If someone else uses their credentials to grant Adverity access to Yandex, the same applies to the items available using their credentials.
This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the authorization items. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from Yandex

To choose what data to collect and customize the Yandex datastream configuration, follow these steps:

(Optional) Rename your datastream.
In Report type, select the type of data to collect from Yandex. The selected report type determines the additional fields to populate.
In Fields, change the list of fields that you want to see in your data extract.
Select the Include VAT, checkbox to collect VAT data.
Select the Include discount, checkbox to collect data about discounts.
In Clients, Campaigns, Ad Groups and Ads, select the clients, campaigns, ad groups and ads for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

What’s next?

Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.
Transform your data to meet your needs by creating and applying transformations to your datastream.
Load your data into a warehouse to continue working with your data in Adverity.
Load your data into an external destination of your choice.