Setting up mediation

Step 1. Create ad units in other advertising 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 Mobile 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. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the SDK Key and Zone ID in the appropriate fields.

BIGO Ads

The settings in the BIGO Ads interface 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're creating a new slot.
    • Ad format: Ad format in the unit (Interstitial, Rewarded Video, or Banner).
    • Auction Type: Server Bidding auction type.
    • Set CPM Floor: CPM floor.

    Click Submit.

  8. Copy the Ad Slot ID value. You'll need it when configuring your ad unit in the Yandex Advertising Network.

  9. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the APP ID and Ad Slot ID in 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 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're creating a new slot.
    • Ad format: Ad format in the unit (Interstitial, Rewarded Video, or Banner).
    • Auction Type: Waterfall auction type.
    • Set CPM Floor: CPM floor.

    Click Submit.

  8. Copy the Ad Slot ID value. You'll need it when configuring your ad unit in the Yandex Advertising Network.

  9. When setting up the monetizer unit ID in the Yandex Advertising Network interface, enter the APP ID and Ad Slot ID in 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 setting up the monetizer unit ID in the Yandex Advertising Network, paste the App ID and App Signature, which you have copied from your Chartboost account, into appropriate fields and specify the Location parameter. The maximum length of the Location parameter is 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 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 ads, select the Full Screen type and disable 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 an ad placement.

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

  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

  1. Register or log in to your Google AdMob account.

  2. Go to the Apps tab and press 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 URL used in the Google Play store. After that Google 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 the ad unit you need. 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 New app 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 Add Application to add your app.

  3. Fill in the app details and click Continue.

  4. Select Placement type, specify 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 in the Mintegral interface vary depending on the technology you use to connect the ad network:

  1. Register or log in to your Mintegral account.

  2. If you've 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.

  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.

  5. 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 can't find your app in Mintegral, go to the APP Setting tab and click Add App. Fill in the relevant fields and click Save.

  1. Register or log in to your Mintegral account.

  2. If you've already added the app, go to the Placements & Units tab, select your app, and click Add Placement.

  3. In the Bidding Type field, select Traditional. If you want to specify 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.

  5. 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 can't find your app in Mintegral, go to the APP Setting tab and click Add App. Fill in the relevant 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, then 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. You can use a custom string as a tag to easily identify ad placements in Start.io reports. You can use any format for tag values: 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 left-hand menu, 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 see your 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 left-hand menu, 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) network 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. Under Apps, 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 In-app bidding integration type.
  8. If necessary, set a CPM floor. automatic CPM is selected by default. If you want to set a minimum ad CPM for your 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 ID. You'll need the unit ID to set up Mobile Mediation in the next step: paste it in the Slot ID and Block ID fields. Unit ID corresponds to Slot ID in myTarget.
  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. Under Apps, 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. automatic CPM is selected by default. If you want to set a minimum ad CPM for your 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 Slot ID in myTarget.

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 in 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 set for an ad unit from the external ad network.

      • App and ad unit IDs from the external ad network that you got in Step 1. Fill in the following fields based on the ad network you've selected:

        Yandex Advertising Network

        Type of mediation

        App IDs

        Unit IDs

        BIGO Ads

        In-App Bidding, Smart Waterfall

        App ID

        Slot ID

        Google AdMob

        Smart Waterfall

        —

        Ad Unit ID

        Liftoff (ex. Vungle)

        In-App Bidding, Smart Waterfall

        App ID

        Placement ID

        Mintegral

        In-App Bidding, Smart Waterfall

        Placement ID, App ID, AppKey

        Unit ID

        Start.io

        Smart Waterfall

        Account ID, App ID

        Ad Tag

        VK Ads (ex. myTarget)

        In-App Bidding, Smart Waterfall

        —

        Placement ID

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

    4. If necessary, set the unit serving geography: go to the Geography tab and specify the CPM floor for 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: the Yandex Advertising Network reports will show more accurate impression and revenue data from your external ad networks.

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

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

  3. Depending on the selected network:

    Network

    Getting started

    Google AdMob

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

    Bigo

    In the Access token field, specify the BIGO Ads Reporting API parameter.

    Digital Turbine

    In the Client ID and Client Secret fields, enter the corresponding values from the Digital Turbine interface.

    IronSource

    In the Secret Key and Refresh Token fields, enter the corresponding 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.

    Liftoff

    In the Account ID and API Key fields, enter the corresponding values from the Liftoff interface.

    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 under Report API.

    Pangle

    In the userID, roleID, and Security Key fields, enter the values from the corresponding fields in 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 bottom left corner, copy the userID value.

    Unity Ads

    Copy the API Key and Organization core ID parameter values from the Unity Ads interface and paste them in the Token and Organization ID fields, respectively.

    How to get the API Key and Organization core ID

    Log in to the Unity Ads interface:

    • Go to Monetization → Setup → API Management and copy the Monetization Stats API Access value.
    • Go to 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 see only estimated data based on the CPM floors that you specified during setup. The actual revenue may differ. For more information about Yandex Mediation reports, see Yandex Mediation statistics.

Step 4. Set up your app

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

Contact support

Previous
Ad sources
Next
Third-party mediation