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.

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

  2. Click the Apps tab, then click Add app to add your app.

    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.

  3. Enter your app's URL used in the Google Play store. After that Google AdMob (ex. 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. 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 Yandex 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.

BIGO Ads

The setup process in the BIGO Ads interface varies depending on the technology you use to connect the advertisement 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 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 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 the App ID and App Signature. You'll use them as values for the App ID and App Signature parameters when setting 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. 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.

  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, 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 APP KEY 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 (ex. Vungle)

Note

Yandex Mediation with Liftoff (ex. Vungle) is currently only available for Android apps.

  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. When setting up Yandex 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 Yandex 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 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, choose Header Bidding and click Save.

  4. Copy the Ad Placement ID and AD Unit ID. You'll need to set up 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 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. You'll need to set up 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 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

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

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

VK Ads (ex. myTarget)

The settings you need to navigate in the VK Ads (ex. myTarget) interface will vary depending on the technology you use to enable the advertisement 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 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 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 Placements tab, find the line with the ad unit you created, and copy the unit's ID. You'll need it to set up Yandex mediation in the next step. Unit ID corresponds with 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

        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 Yandex Mediation adapter for the desired ad network:

Contact support