Setting up mediation

Step 1. Create ad units in other ad networks

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 Mediation.

Note

If you use Smart Waterfall to connect the network, create multiple ad units with different CPM floors. The more ad units you add to Yandex Mediation, the more accurately the platform will forecast the bid from the external ad network. Overall, you can add up to 100 ad units per ad network to Yandex Mediation.

To connect an ad network using In-App Bidding, you only need to create one ad unit.

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

AppLovin

  1. Register or log in to your AppLovin account.

  2. Go to the Account → Keys tab and copy the SDK Key value. You'll need it when configuring your ad unit in the Yandex Advertising Network interface.

  3. Go to Discovery → Zones tab and click Create a Zone 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, select Banner; for rewarded ads, select Rewarded.

  5. Click Save.

  6. Copy the Zone ID value. You'll need it when configuring your ad unit in the Yandex Advertising Network interface.

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

BIGO Ads

The settings you'll have to configure in the BIGO Ads interface will vary depending on the technology you use to connect the ad network:

  1. Register or log in to your BIGO Ads account.

  2. Click New app to add your app.

  3. Fill in your app's details. Choose Yandex as the mediation platform.

  4. Click Submit.

  5. Copy the APP ID value. You'll need it when configuring your ad unit in the Yandex Advertising Network interface.

  6. When the app passes moderation, go to the Ad Slot tab and click New Ad Slot.

  7. Select:

    • App: The app for which you are creating a new slot.
    • Ad format: The ad format in the ad unit: Interstitial, Rewarded Video, or Banner.
    • Auction Type: The Server Bidding ad auction type.
    • Set CPM Floor: CPM floor.

    Click Submit.

  8. Copy the Ad Slot ID value. You'll need it to configure the ad unit in the Yandex Advertising Network.

  9. When setting up the monetizer ad unit ID in the Yandex Advertising Network interface, enter the APP ID and Ad Slot ID into the appropriate fields.

  1. Register or log in to your BIGO Ads account.

  2. Click New app to add your app.

  3. Fill in your app's details. Choose Yandex as the mediation platform.

  4. Click Submit.

  5. Copy the APP ID value. You'll need it to configure the ad unit in the Yandex Advertising Network interface.

  6. When the app passes moderation, go to the Ad Slot tab and click New Ad Slot.

  7. Select:

    • App: The app for which you're creating a new slot.
    • Ad format: Ad format in the ad unit: Interstitial, Rewarded Video, or Banner.
    • Auction Type: The Waterfall ad auction type.
    • Set CPM Floor: CPM floor.

    Click Submit.

  8. Copy the Ad Slot ID value. You'll need it to configure the ad unit in the Yandex Advertising Network.

  9. When setting up the monetizer ad unit ID in the Yandex Advertising Network interface, enter the APP ID and Ad Slot ID into the appropriate fields.

Chartboost

  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 App ID and App Signature. You'll need them to set up Yandex 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 (ex. AdColony)

  1. Register or log in to your Digital Turbine (ex. AdColony) account.

  2. Go to 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 value. You'll need it for the App ID parameter when configuring your ad unit in the Yandex Advertising Network interface.

  5. Click Setup New Ad Zone to create a new placement.

  6. 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.

  7. Click Create at the bottom of the page to create a placement.

  8. Go to the created Ad Zone and copy the Zone ID.

  9. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the App ID and Zone ID in the appropriate fields.

Google AdMob (ex. AdMob)

  1. Register or log in to your Google AdMob (ex. AdMob) account.

  2. Go to the Apps tab and click Add app.

    If you want to add an ad unit to an existing app, click the app's name in the table to open the app details page, and click Add ad unit.

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

  4. After selecting the format, enter the name of your ad unit and click Create ad unit → Done.

  5. Go to the Ad Units section on the app details page. Copy the ad unit ID under the name of your ad unit. When setting up Yandex Mediation in the Yandex Advertising Network interface, you will need this value for the Ad Unit ID parameter.

InMobi

  1. Register or log in to your InMobi account.

  2. Go to the Inventory → Inventory Settings tab, then click Add Inventory to add your app.

  3. Enter your app's name and Google Play or App Store URL and click Continue.

  4. Specify these settings:

    • Child Privacy Compliance: Specify whether your app is intended for children or not.
    • Location Permission: Specify whether InMobi can collect the data about user location.
    • Block Setting: Enter blocking settings (if needed).

    Click Save and Create Placements.

  5. Select the ad format, enter the ad placement's name in the Placement Name field, and click Create Placement.

  6. Copy the placement ID. You'll need it for the Placement ID field when configuring your ad unit in the Yandex Advertising Network.

  7. Click your account in the upper-left corner and copy the account ID from the window that opens. You'll also need the ID for the Account ID field when configuring your ad unit in the Yandex Advertising Network.

  8. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the Account ID and Placement ID in the appropriate fields.

IronSource

  1. Register or log in to your IronSource account.

  2. Click the New app button to add your app.

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

  4. Click Add App.

  5. Copy the APP KEY value. You'll need it when configuring your ad unit in the Yandex Advertising Network interface.

  6. Select the ad format and click Continue.

  7. Go to the Ad Units & Placements tab and choose your app in the APPLICATIONS section. Select the appropriate ad format and click New Instance. Please note that the Offerwall format isn't supported in mediation. If you don't see the New Instance button, contact the IronSource support team.

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

  9. Copy the Instance Id value. You'll need it when configuring your ad unit in the Yandex Advertising Network.

  10. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the AppKey and Instance Id in the appropriate fields.

Liftoff (ex. Vungle)

  1. Register or log in to your Liftoff (ex. Vungle) 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. You'll need it for the Placement ID parameter's value when setting up Yandex Mediation.

  6. Go to the main page, find your app in the list, and copy the value from the App ID column. You'll need it when setting up Yandex Mediation.

  7. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the App ID and Placement ID in the appropriate fields.

Mintegral

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

  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, select Header Bidding and click Save.

![](../_images/mintegral-2.png)

  1. Copy the Ad Placement ID and AD Unit ID values. You'll need them to set up Yandex Mediation in the Yandex Advertising Network interface.

  2. Open the APP Setting tab and copy the APP ID and APP Key values. You'll also need those when setting up Yandex 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 values. You'll need them to set up Yandex Mediation in the Yandex Advertising Network interface.

![](../_images/mintegral-3.png)

  1. Open the APP Setting tab and copy the APP ID and APP Key values. You'll also need those when setting up Yandex 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.

Pangle

Note

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 your app and created an ad unit, go to Applications → Ad Placements and find the ad unit in the list.

  3. Copy the Ad Placement ID and App ID values. You'll need them to set up Yandex Mediation in the Yandex Advertising Network interface.

If you don't see your app and ad unit in Pangle:

  1. To add an app, go to Applications → Apps and 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. Obtain a placement ID. To do this, go to My Apps. Copy the Account ID and APP ID values. You'll need them when configuring your ad unit in the Yandex Advertising Network interface.

  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. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter Account ID, APP ID, and Ad Tag in the appropriate fields.

Tapjoy

Note

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 Yandex 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 Yandex 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 Ads

  1. Register or log in to your Unity Ads 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 your ad unit in the Yandex Advertising Network interface.

  5. Click Add Placement to create a placement.

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

  7. Copy the Placement ID you entered. You'll need it when configuring your ad unit in the Yandex Advertising Network interface.

  8. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter Game ID and Placement ID.

VK Ads (ex. myTarget)

The settings in the VK Ads (ex. myTarget) interface vary depending on the technology you use to connect the ad network:

  1. Register or log in to your VK Ads (ex. myTarget) account.
  2. Go to Apps and click Add app.
  3. Enter your app's URL in Google Play or the App Store. The app is then added to the moderation queue. In the meantime, you can start creating ad units.
  4. In the Apps section, go to the Placements tab and click Add placement.
  5. Select your app and name the new ad unit.
  6. Select an ad format: Banner, Native, Fullscreen, or Rewarded.
  7. Choose the In-app bidding integration type.
  8. If necessary, set a CPM floor. An automatic CPM is set by default. If you want to set a minimum cost per 1,000 impressions for your ad unit, select Manual and specify the threshold. You can set a CPM floor for individual geographic regions.
  9. Select permitted creative types: banner ad, video, or carousel.
  10. Click Create.
  11. Go to the Placements tab, find the line with the ad unit you created, and copy the unit's ID. You'll need it to set up Mobile Mediation in the next step as the value for the Slot ID and Block ID fields. Unit ID corresponds to myTarget's Slot ID.
  1. Register or log in to your VK Ads account.
  2. Go to the Apps section and click Add app.
  3. Enter your app's URL in Google Play or the App Store. The app is then added to the moderation queue. In the meantime, you can start creating ad units.
  4. In the Apps section, go to the Placements tab and click Add placement.
  5. Select your app and name the new ad unit.
  6. Select the ad format for your ad unit: Banner, Native, Fullscreen, or Rewarded.
  7. Choose the Direct integration integration type.
  8. If necessary, set a CPM floor. An automatic CPM is set by default. If you want to set a minimum cost per 1,000 impressions for your ad unit, select Manual and specify the threshold. You can set a CPM floor for individual geographic regions.
  9. Select permitted creative types: banner ad, video, or carousel.
  10. Click Create.
  11. Go to the Ad Units tab, find the line with the ad unit you created, and copy the unit ID. You'll need it when setting up Mobile Mediation in the next step. Unit ID corresponds to myTarget's Slot ID.

Step 2. Connect the ad network to a unit in the Yandex Advertising Network

  1. In the Yandex Advertising Network interface, start creating a new ad unit or open the settings of an existing unit.

  2. Connect external ad networks to the unit.

    1. In the ad unit settings at the bottom of the page, click Add network.

    2. Select the mediation type: In-App Bidding or Smart Waterfall. A list of networks that support the selected type of mediation will appear.

    3. 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:

        Ad network

        Mediation type

        App IDs

        Unit IDs

        AppLovin

        Smart Waterfall

        SDK Key

        Zone ID

        BIGO Ads

        In-App Bidding, Smart Waterfall

        App ID

        Slot ID

        Chartboost

        Smart Waterfall

        App ID, App Signature

        Location: any character sequence. The maximum number of characters is 20.

        Digital Turbine (ex. AdColony)

        Smart Waterfall

        App ID

        Zone ID

        Google AdMob (ex. AdMob)

        Smart Waterfall

        —

        Ad Unit ID

        InMobi

        Smart Warterfall

        Account ID

        Placement ID

        IronSource

        Smart Waterfall

        AppKey

        Instance ID

        Liftoff (ex. Vungle)

        Smart Waterfall

        App ID

        Placement ID

        Mintegral

        In-App Bidding, Smart Waterfall

        Placement ID, App ID, AppKey

        Unit ID

        Pangle

        In-App Bidding, Smart Waterfall

        App ID

        Placement ID

        Start.io

        Smart Waterfall

        Account ID, App ID

        Ad Tag

        Tapjoy

        Smart Waterfall

        SDK Key

        Placement Name

        Unity Ads

        Smart Waterfall

        Game ID

        Placement ID

        VK Ads (ex. myTarget)

        Smart Waterfall

        —

        Unit ID

        VK Ads (ex. myTarget)

        In-App Bidding

        App ID

        Unit ID

      • eCPM: The CPM floor for the added unit (only for networks connected by Smart Waterfall).

    4. If necessary, set the unit serving geography: go to the Geography tab and specify the CPM floor for the selected regions.

  3. Click Save at the bottom of the page.

Step 3. Enable statistics from external ad networks

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 → Networks.

  2. Click Add network next to the ad network.

  3. Depending on the selected ad network:

    Network

    How to enable

    Google AdMob (ex. AdMob)

    Click Authorize with Google and allow the yandex.com app to view statistics in Google AdMob (ex. 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.

    Pangle

    In the userID, roleID и 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 Ads

    Enter the API Key parameter value in the Token field and the Organization core ID value from the Unity Ads interface in the Organization ID field.

    How to get the API Key and Organization core ID

    Log in to the Unity Ads interface. Go to the sections:

    • Monetization → Setup → API Management and copy the Monetization Stats API Access value;
    • Monetization → Setup → Organization settings and copy the Organization core ID value.

    VK Ads (ex. myTarget)

    In the Token field, enter the token value from the VK Ads interface.

    How to get the token

    Log in to the VK Ads (ex. myTarget) interface. In Settings, go to Statistics API, click Show token, and copy its 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 Yandex Mediation reports, see Yandex Mediation statistics.

Step 4. Configure your app

  1. Integrate the latest version of the Yandex Mobile Ads SDK into your app by following the instructions:
  2. Connect the Mobile Mediation adapter for this ad network:

Contact support

Previous
Ad sources
Next
A/B tests