Setting up mediation

For each external ad network you are going to connect, create an ad unit in the interface of this network and get the parameters for integrating the unit into Yandex Mobile Mediation.

Below are examples of creating ad units in external ad networks.

AdMob

1. Register or log in to your AdMob account.
2. Click the Apps tab, then click Add app to add your app.

   

3. Enter your app's URL used in the Google Play store. After that AdMob will prompt you to create an ad unit and select the ad format.

   

4. Once you selected the format, enter the name of your ad unit and click Create ad unit → Done.

   

   

5. If you want to add an ad unit into a pre-existing app, click the name of your app in the table, which will open the app details page, and click Add ad unit.
6. Go to the Ad units section on the app details page. Copy the ad unit ID under the name of the ad unit you need. You'll use it as the value of the Ad Unit ID parameter when setting up Mobile mediation in the Yandex Advertising Network interface.

   

AppLovin

1. Register or log in to your AppLovin account.
2. Go to Account → Keys and copy the SDK Key value. When setting up your ad unit in the Yandex Advertising Network interface, you'll use it as the value of the SDK Key parameter.

   

3. Go to Discovery → Zones and click the Create a Zone button to add a placement.

   

4. Fill in the fields describing the placement. For the Interstitial ad format, choose the Non-Rewarded Full Screen type, for a banner, Banner, for rewarded ads, Rewarded.

   

5. Click Save.
6. Copy the Zone ID value. When setting up your ad unit in the Yandex Advertising Network interface, you'll need it as the value of the Zone ID parameter in the Monetizer unit ID field.

   

7. In the Yandex Advertising Network interface, when setting up the monetizer unit ID, fill out the SDK Key and Zone ID fields.

Chartboost

Note. Mobile mediation with Chartboost is currently only available for Android apps.

1. Register or log in to your Chartboost account.
2. Click All Apps and select an app from the list.

   

3. Open the app settings ( App Settings → Basic Settings).
4. Copy the App ID and App Signature. You'll use them as values for the App ID and App Signature parameters when setting up Mobile mediation.

   

5. When settings up the monetizer unit ID in the Yandex Advertising Network interface, enter the values that you copied in your Chartboost account into the App ID and App Signature fields and set the Location parameter. The Location parameter can have up to 20 characters.

To learn more about how to add an app and create a campaign, see Chartboost Help.

Digital Turbine

Note. Mobile mediation with Digital Turbine is currently only available for Android apps.

1. Register or log in to your Digital Turbine account.
2. Click the MONETIZATION tab, then click Setup New App to add your app.

   

3. Fill in the app details and click Create.
4. Copy the AdColony App UUID. You'll need it when configuring an ad unit in the Yandex Advertising Network interface as the value of the App ID parameter.
5. Click Setup New Ad Zone to create a new placement.

   

   Fill in the placement data and type:

   • For interstitial ads, select the Full Screen type and disable the Reward Users for Viewing an Ad (Full Screen Only) option.
   • For rewarded, select the Full Screen type and enable the Reward Users for Viewing an Ad (Full Screen Only) option.
   • For banner ads, select the Banner type.

   

   Click Create at the bottom of the page to create a placement.
6. Go to the created Ad Zone and copy the Zone ID. You'll need it when configuring an ad unit in the Yandex Advertising Network interface as the value of the Zone ID parameter.

   

7. When setting up the monetizer unit ID in the Yandex Advertising Network, fill in the App ID and Zone ID fields.

ironSource

1. Register or log in to your ironSource account.
2. Click the New App button to add your app.

   

3. Fill in the details about your app: enter the app's URL in Google Play/AppStore or select the App Not Live in the Application Store option.

   

4. Click Add App.

   

5. Copy the APP KEY value. When configuring your ad unit in the Yandex Advertising Network interface, you'll use it as the value of the AppKey parameter.

   

6. Select the ad types you need and click Continue.
7. Go to the Ad Units & Placements tab and choose your app in the APPLICATIONS section. Select your ad type and click New Instance. Please note that the Offerwall type is not supported in mediation.

   If you don't have the New Instance button, contact the ironSource support team.

   

8. Enter the name in the Instance Name field and click Save.

   

9. Copy the Instance Id value. You'll need it when configuring an ad unit in the Yandex Advertising Network interface as the value of the Instance ID parameter.

   

10. In the Yandex Advertising Network interface, when setting up the monetizer unit ID, fill in the AppKey and Instance ID fields.

Liftoff

Note. Mobile mediation with Liftoff is currently only available for Android apps.

1. Register or log in to your Liftoff account.
2. Click the Add Application button to add your app.

   

3. Fill in the app details and click Continue.

   

4. Select Placement type, enter the Placement Name, and click Continue.

   

5. Copy the ID of the ad unit you created. When setting up Mobile mediation, use it as the value of the Placement ID parameter.

   

6. Go to the home page, find your app in the list, and copy the value from the App ID column. Use it as the value of the App ID parameter when setting up Mobile mediation.

   

7. In the Yandex Advertising Network interface, when setting up the monetizer unit ID, fill in the App ID and Placement ID fields.

Mintegral

The settings to specify in the Mintegral interface will vary based on the technology you use to enable your advertising network:

• Via In-App Bidding
• Via Smart Waterfall

1. Register or log in to your Mintegral account.
2. If you have already added the app, go to the Placements & Units tab, select your app, and click Add Placement.

   

3. In the Bidding Type field, choose Header Bidding and click Save.

   

4. Copy the Ad Placement ID and AD Unit ID. You'll need to set up mobile mediation in the Yandex Advertising Network interface.

   

5. Open the APP Setting tab and copy the values for APP ID and APP Key. You will also need them when setting up Mobile mediation in the Yandex Advertising Network interface.

   

If you don't see the app in Mintegral, go to the App Setting tab and click Add App. Fill in the required fields and click Save.

1. Register or log in to your Mintegral account.
2. If you have already added the app, go to the Placements & Units tab, select your app, and click Add Placement.

   

3. In the Bidding Type field, choose Traditional. If you want to set a CPM floor, select a value in the Target Ecpm field. Click Save.

   

4. Copy the Ad Placement ID and AD Unit ID. You'll need to set up mobile mediation in the Yandex Advertising Network interface.

   

5. Open the APP Setting tab and copy the values for APP ID and APP Key. You will also need them when setting up Mobile mediation in the Yandex Advertising Network interface.

   

If you don't see the app in Mintegral, go to the App Setting tab and click Add App. Fill in the required fields and click Save.

myTarget

The settings to specify in the myTarget interface will vary based on the technology you use to enable your advertising network:

• Via In-App Bidding
• Via Smart Waterfall

1. Register or log in to your myTarget network account.
2. Click the APPS tab, then click CREATE APP to add your app.

   

3. Enter your app's URL in Google Play or the App Store. After that, myTarget will automatically create an ad unit.
4. Select the ad format for your unit: Banner, Interstitial, Native, or Rewarded video.
5. Specify the in-app bidding integration type and click ADD AD UNIT.

   

6. Copy the Placement ID and Slot ID parameters from the ad unit list to the line opposite to the unit you created. You will need these to set up Mobile mediation during the next step.

   

1. Register or log in to your myTarget network account.
2. Click the APPS tab, then click CREATE APP to add your app.

   

3. Enter your app's URL in Google Play or the App Store. After that, myTarget will automatically create an ad unit.
4. Select the ad format for your unit: Banner, Interstitial, Native, or Rewarded video.
5. Specify SDK/Javascript as your integration type and click ADD AD UNIT.

   

6. Copy the Slot ID parameter from the ad unit list to the line opposite to the unit you created. When setting up Mobile mediation, use this value for the Slot ID parameter.

If you want to add an ad unit to a pre-existing app, click the name of your app in the table to open the app details page, and click ADD AD UNIT.

Pangle

Note. Mobile mediation with Pangle is currently only available for Android apps.

1. Register or log in to your Pangle account.
2. If you've already added an app and created an ad unit, go to Applications → Ad Placements and find the desired ad unit in the list.
3. Copy the Ad Placement ID and App ID. You'll need to set up mobile mediation in the Yandex Advertising Network interface.

   

If you don't have an app and ad unit in Pangle:

1. To add an app, go to Applications → Apps, click +Add App, fill in the required fields, and click Submit.
2. To add an ad unit, go to Applications → Ad Placements and click +Add Ad Placement.

Start.io

1. Register or log in to your Start.io account.
2. Go to the MY APPLICATIONS tab and click Add New App to add your app.

   

3. Enter your app's URL in Google Play/AppStore.

   

4. Specify whether your app is intended for children or not.
5. Click Add App.

   

6. Receive your placement ID. To do this, go to My Apps. Copy the Account ID and APP ID numeric values. When configuring your ad unit in the Yandex Advertising Network interface, you'll use them as values for the Account ID and App ID parameters, respectively.

   

7. For additional identification of a placement in Start.io reports, you can use an arbitrary string as a tag. Values for the tag can be specified in any form. For example: main_page_banner.
8. In the Yandex Advertising Network interface, when setting up the monetizer unit ID, fill in the Account ID, App ID, and Ad Tag fields.

TapJoy

Note. Mobile mediation with TapJoy is currently only available for Android apps.

1. Register or log in to your TapJoy account.
2. If you've already added an app and created an ad unit (Placement), click on the account name and select the app from the drop-down list.

   

3. In the top menu, click Settings and go to App Settings.

   

4. Scroll down the app settings tab and copy the SDK Key. You'll need it to set up Mobile mediation in the Yandex Advertising Network interface.

   

5. Click Monetization in the top menu.
6. A window with monetization settings opens. In the menu on the left, go to Placements.

   

7. Open the ad unit settings and copy the Name. You'll need it to set up Mobile mediation in the Yandex Advertising Network interface.

   

If you don't have an app and ad unit in TapJoy:

1. To add an app, click the account name, +Add App, and fill in the required fields. Click Create now.
2. To add an ad unit, click on the account name and select the app. In the menu on the left, go to Placements and click Create Placement.

Unity

1. Register or log in to your Unity account.
2. Go to the dashboard and click Create Project.

   

3. Fill in the project details and click Create Project.

   

4. Go to Monetize → Placements. Copy the Game ID value. You'll need it when configuring an ad unit in the Yandex Advertising Network interface as the value of the Game ID parameter.

   

5. Click Add Placement to create a placement.

   

6. Select the ad type, enter the Placement ID, then click Create Placement.

   

7. Copy the Placement ID value you entered. When setting up an ad unit in the Yandex Advertising Network interface, use it as the value of the Placement ID parameter.
8. In the Yandex Advertising Network interface, when setting up the monetizer unit ID, fill in the Game ID and Placement ID fields.

1. In the Yandex Advertising Network interface, start creating a new ad unit or open the settings of an existing unit.
2. In the ad unit settings at the bottom of the page, click Add network.
3. Select the mediation type: In-App Bidding or Smart Waterfall. A list of networks that support the selected type of mediation will appear.

   Note. Networks that support this feature are listed in the In-App Bidding section.
4. Select an ad network and set the parameters of ad units created in the interface of this advertising network:

   • Currency: The currency of the CPM floor in the external advertising network unit.

   • The IDs of the app and units from the external ad network that you obtained in step 1. Depending on the selected ad network, fill in the fields:

     Advertising network	Application IDs	Unit IDs
     AdMob	—	Ad Unit ID
     AppLovin	SDK Key	Zone ID
     ChartBoost	App ID App Signature	Location is an arbitrary set of characters. The maximum number of characters is 20.
     Digital Turbine	App ID	Zone ID
     ironSource	AppKey	Instance ID
     Liftoff	App ID	Placement ID
     Mintegral (In-App Bidding, Smart Waterfall)	Placement ID App ID App Key	Unit ID
     myTarget (Smart Waterfall)	—	Slot ID
     myTarget (In-App Bidding)	Slot ID Unit ID	—
     Pangle	App ID	Placement ID
     Start.io	Account ID App ID	Ad Tag
     Tapjoy	SDK Key	Placement Name
     Unity	Game ID	Placement ID

     Advertising network	Application IDs	Unit IDs
     AdMob	—	Ad Unit ID
     AppLovin	SDK Key	Zone ID
     ChartBoost	App ID App Signature	Location is an arbitrary set of characters. The maximum number of characters is 20.
     Digital Turbine	App ID	Zone ID
     ironSource	AppKey	Instance ID
     Liftoff	App ID	Placement ID
     Mintegral (In-App Bidding, Smart Waterfall)	Placement ID App ID App Key	Unit ID
     myTarget (Smart Waterfall)	—	Slot ID
     myTarget (In-App Bidding)	Slot ID Unit ID	—
     Pangle	App ID	Placement ID
     Start.io	Account ID App ID	Ad Tag
     Tapjoy	SDK Key	Placement Name
     Unity	Game ID	Placement ID

   • eCPM: The CPM threshold for the added unit (only for networks connected by Smart Waterfall).
5. If necessary, set the unit serving geography: go to the Geography tab and specify the CPM floor for the selected regions.
6. Click Save at the bottom of the page.

You can enable statistics for networks from the list below: in this case, accurate data on impressions and revenue for your account in the external ad network will be shown in the Yandex Advertising Network reports.

1. In the left menu, open the tab Ads in apps → Ad networks.

2. Click Connect next to the ad network and fill out the required fields.

3. Depending on the selected ad network, enable statistics:

   Network	How to enable
   AdMob	Click Authorize with Google and allow the yandex.ru app to view statistics in AdMob.
   AppLovin	In the Access token field, specify the Report Key parameter from the AppLovin interface. How to get the Report Key Log in to the AppLovin interface. Go to Account → Keys and copy the Report Key value.
   ironSource	In the Secret Key and Refresh Token fields, enter the appropriate values from the ironSource interface. How to get the Secret Key and Refresh Token Log in to the ironSource interface. Go to Account → API and copy the Secret Key and Refresh Token values.
   Mintegral	In the Secret and Skey fields, enter the Secret and Skey parameter values from the Mintegral interface. How to get the Secret and Skey Log in to the Mintegral interface. Go to Account → API Tools and copy the Secret and Skey values in the Report API block.
   myTarget	In the Permanent access token field, enter the token value from the myTarget interface. How to get a token Log in to the myTarget interface. Go to Profile → Tokens, click Create token, and copy the values.
   Pangle	In the userID, roleID, and Security Key fields, enter the values of the corresponding fields from the Pangle interface. How to get the userID, roleId, and Security Key Log in to the Pangle interface. Go to Integrations → SDK&API → Pangle Reporting API 2.0: Copy the roleID and Security Key values. In the lower-left corner of the screen, copy the userID value.
   Unity	Enter the API Key parameter value in the Token field and the Organization core ID value from the Unity interface in the Organization ID field. How to get the API Key and Organization core ID Log in to the Unity interface. Go to the sections: Monetization → Setup → API Management and copy the API Key value. Monetization → Setup → Organization settings and copy the Organization core ID value.

   Network	How to enable
   AdMob	Click Authorize with Google and allow the yandex.ru app to view statistics in AdMob.
   AppLovin	In the Access token field, specify the Report Key parameter from the AppLovin interface. How to get the Report Key Log in to the AppLovin interface. Go to Account → Keys and copy the Report Key value.
   ironSource	In the Secret Key and Refresh Token fields, enter the appropriate values from the ironSource interface. How to get the Secret Key and Refresh Token Log in to the ironSource interface. Go to Account → API and copy the Secret Key and Refresh Token values.
   Mintegral	In the Secret and Skey fields, enter the Secret and Skey parameter values from the Mintegral interface. How to get the Secret and Skey Log in to the Mintegral interface. Go to Account → API Tools and copy the Secret and Skey values in the Report API block.
   myTarget	In the Permanent access token field, enter the token value from the myTarget interface. How to get a token Log in to the myTarget interface. Go to Profile → Tokens, click Create token, and copy the values.
   Pangle	In the userID, roleID, and Security Key fields, enter the values of the corresponding fields from the Pangle interface. How to get the userID, roleId, and Security Key Log in to the Pangle interface. Go to Integrations → SDK&API → Pangle Reporting API 2.0: Copy the roleID and Security Key values. In the lower-left corner of the screen, copy the userID value.
   Unity	Enter the API Key parameter value in the Token field and the Organization core ID value from the Unity interface in the Organization ID field. How to get the API Key and Organization core ID Log in to the Unity interface. Go to the sections: Monetization → Setup → API Management and copy the API Key value. Monetization → Setup → Organization settings and copy the Organization core ID value.

4. Click Save.

For other ad networks, you can only see data estimated based on the CPM floor that you specified at setup. The actual revenue may differ. For more information about Mobile Mediation reports, see Mobile Mediation statistics.