This article has been moved to the primary doc, and this page will be deleted soon. Please check out the doc (EN, RU) to link your Yandex account.
To link your Yandex Advertising Network account, complete all the steps from this article.
Before you start
Make sure you have a Yandex adapter provided by Appodeal SDK in your app.
Step 1: Set up a Yandex Advertising Network account
If you already have a Yandex account, proceed with step 2.
1.1 Create a free Yandex account using this link.
1.2 Complete the registration form.
In the “What do you want to monetize?” section, choose “Apps” or both.
Step 2: Create a new Yandex app
Now you need to add the app, which you want to monetize with Yandex Advertising Network.
2.1 Go to “Ads in apps” and click on the “Add app” button.
2.2 Add your app’s store URL.
Note! It make take a few days for Yandex to approve your app after adding the store link.
If you haven’t published the app yet, click on the “My app is not published”, choose the platform and add the app name.
2.3 Click on the “Add” button to create your Yandex app.
2.4 You will see your Yandex App ID to the right of your app name. Save it, you will need it later.
You can also find your Yandex App ID later on the “Ads in apps” to the right of your app name.
Step 3: Create Yandex ad units
Create the first ad unit for your app.
3.1 Choose the ad unit type.
At the moment, Appodeal supports Banner, Interstitial and Rewarded video for Yandex. For MREC, choose the banner ad type on the Yandex side.
3.2 Fill in the ad unit name.
3.3 Choose the CPM type. There are two ways to set a CPM floor:
Auto CPM. Yandex dynamically sets your floors for best ad performance based on all available data.
CPMV floor. You manually set the value of the minimum CPMV for each ad unit. CPMV is a cost of one thousand viewable impressions.
Important! If you want to set the Yandex Minimum CPMV floor, keep in mind that by default Yandex uses RUB, not USD. Currency can be changed in Yandex Advertising Network → Edit user settings → Currency of CPM floors.
3.4 Click on the “Create ad unit” button to save the changes.
You will be able to set up other ad units at “Ads in apps” → “Apps” → Your app → “Create ad unit”.
3.5 After creating the ad units, go to “Ads in apps” → “Apps” → Your app, you will see your ad units list. Save your ad units’ codes, you will need them later.
Step 4: Get Yandex OAuth Token to export stats
This token is necessary for importing reports from your Yandex account to Appodeal dashboard. This is important for effective mediation.
4.1 Go to Yandex.OAuth and register a new client.
4.2 Under the Platforms section select the Web services checkbox, click “Set URL for development” .
In Callback URL #1 you'll see https://oauth.yandex.ru/verification_code.
4.3 Enable access to the following data:
4.4 After saving the changes you'll see your ID, Password and Callback URL(see the example below).
4.5 Now you can manually get a token for the user. As a user, you can use the same developer account you have used to register your app and apply for access.
To get a token manually, follow these steps:
а) Log in to Yandex with your username.
(put your app identifier instead of ID).
c) On the page that opens, click “Allow”.
d) Yandex.OAuth will redirect you to the page displaying the token. The token will also be added to the URL shown in the address bar.
Step 5: Set up an AppMetrica app
5.1 Go to AppMetrica. Login with your Yandex account.
5.2 Add your app. If you have already added your app to AppMetrica, proceed with point 5.6.
5.3 Fill in the app name, choose the app’s category, add the store link to your app and click “Continue”.
5.4 Choose your Time Zone, accept the data processing conditions and enter your email.
5.5 Click “Go to Reports”.
5.6 Go to AppMetrica → Applications tab and choose the app. In the Settings, you’ll see Application ID and API Key (for SDK) in the General settings.
Save Application ID and API Key (for SDK), you will need them later.
Step 6: Link your Yandex account to Appodeal
After completing all the previous steps, you should have the following data, which is necessary for linking Yandex with Appodeal (numbers in brackets refer to points in the instructions):
Yandex email (1.1);
Yandex OAuth token (4.5d);
Yandex Advertising Network app ID (2.4);
AppMetrica Application ID (5.6);
AppMetrica API Key (for SDK) (5.6);
Ad units’ codes (3.5).
6.1 Link your Yandex account to Appodeal
Follow this link: https://www.appodeal.com/apps/linked_networks.
Go to Yandex → Link your account.
Add your Yandex email and Yandex OAuth token.
6.2 Link your Yandex App & Create Line Items
Select the app wish to link at https://www.appodeal.com/apps.
Go to the desired ad type, select the Yandex account you created.
Fill in the following data:
PageID with Yandex Advertising Network app ID;
AppMetrica Application ID;
AppMetrica API Key (for SDK).
Click “Add Line Item” and fill in:
The Line Item’s label - a name for your ad unit in the Appodeal dashboard.
Default eCPM - ad unit's start position in the waterfall. In automatic priorities configuration, it will be recalculated later based on your stats.
For Auto CPM ad units, you can set any Default eCPM.
For CPMV floor ad units, set Default eCPM based on the ad unit’s CPM threshold on Yandex.
Important! Default eCPM on Appodeal side is in USD but Minimum CPM threshold on Yandex Advertising Network's side is in RUB by default. For line items to be set up correctly, don't forget to convert RUB to USD or change the currency in the Yandex Advertising Network → Edit user settings → Currency of CPM floors .
Code - your Yandex ad unit ID.
Device Type (for banners) - phone or tablet.
After creating a line item, save the changes.
Now you can monetize with Yandex Advertising Network via DCC!