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

Tip. 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 Mobile 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.

AdColony
Note. Mobile Mediation with AdColony is currently only available for Android apps.
  1. Register or log in to your 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.

    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 videos, 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. In the monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the app_id and zone_id parameters separated by the / symbol (app_id/zone_id).
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. After selecting the format enter the name of your ad unit and click Create ad unit.
  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. Find the Ad block ID parameter for the ad unit you need and copy the value specified for that parameter. You will need to use it as the value of the ad_unit_id parameter when setting up Mobile Mediation.
AppLovin
  1. Register or log in to your AppLovin account.
  2. Go to Account → Keys and copy the SDK Key value. You'll need it when configuring an ad unit in the Yandex Advertising Network interface 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. You'll need it when configuring an ad unit in the monetization ad unit ID field in the Yandex Advertising Network interface as the value of the zone_id parameter.

  7. In the monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the sdk_key and zone_id parameters separated by the / symbol (sdk_key/zone_id).
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 need to use them as values for the app_id and app_signature parameters when setting up Mobile Mediation.

  5. In the monetization ad unit ID field in the Yandex Advertising Network interface, enter the app_id and app_signature values you copied in the Chartboost account and set the location parameter. The location parameter can have up to 20 characters. All values are entered in one text field separated by the / symbol (app_id/app_signature/location).
To learn more about how to add an app and create a campaign, see Chartboost Help.
ironSource
  1. Register or log in to your ironSource account.
  2. Click the New App button to add your own 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. You'll need it when configuring an ad unit in the Yandex Advertising Network interface 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 the ad type you need 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 monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the app_key and instance_id parameters separated by the / symbol (app_key/instance_id).
Mintegral
Note. Mobile Mediation with Mintegral is only available through In-App Bidding.
  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 on 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:

  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 used in the Google Play store 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.

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.
StartApp
  1. Register or log in to your StartApp 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. You'll need them when configuring an ad unit in the Yandex Advertising Network interface as values for the account_id and app_id parameters, respectively.

  7. For additional identification of a placement in StartApp 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 monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the account_id, app_id, and tag parameters separated by the / symbol (account_id/app_id/tag).
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 Name.

  8. In the monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the SDK Key and Ad Placement Name parameters separated by the / symbol (sdk_key/placement_name).

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

  1. To add an app, click on 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.
UnityAds
  1. Register or log in log in to your UnityAds 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, and click Create Placement.

  7. Copy the placement_id value you entered. You'll need it when configuring an ad unit in the Yandex Advertising Network interface as the value of the placement_id parameter.
  8. In the monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the game_id and placement_id parameters separated by the / symbol (game_id/placement_id).
Vungle
Note. Mobile Mediation with Vungle is currently only available for Android apps.
  1. Register or log in to your Vungle account.
  2. Press the Add Application button to add your app.

  3. Fill in the app details and click Continue.

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

  5. Copy the ID of the ad unit you created. You will need to use it as the value of the placement_id parameter when setting up Mobile Mediation.

  6. Go to the main page, find the app you need in the list, and copy the value from the App ID column. You will need to use it as the value of the app_id parameter when setting up Mobile Mediation.

  7. To add an ad unit, select the app from the list on the main page.
  8. Click Add Placement.

  9. In the monetization ad unit ID field in the Yandex Advertising Network interface, enter the values of the app_id and placement_id parameters separated by the / symbol (app_id/placement_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. 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 ad network:

    • Currency: The currency of the CPM floor in the external ad network unit.
    • App ID: The ID of your app in the external ad network (only for networks connected using In-App Bidding). Specify the value depends on the selected network:
      • myTarget: placement_id
      • Mintegral: app_id/app_key
    • Unit IDs: The IDs of units from the external ad network that you got in Step 1. The ID can consist of several parameters that start with the / character. The ID format depends on the ad network:
      • AdColony: app_id/zone_id
      • AdMob: ad_unit_id (the ID of the ad unit)
      • AppLovin: sdk_key/zone_id
      • ChartBoost: app_id/app_signature/location, where app_id and app_signature are the parameters that you copied from your Chartboost account and location is an arbitrary sequence of characters. The maximum number of characters in location is 20.
      • ironSource: app_key/instance_id
      • Mintegral: placement_id/ad_unit_id
      • myTarget: slot_id
      • Pangle: app_id/placement_id
      • StartApp: account_id/app_id/tag
      • Tapjoy: sdk_key/placement_name
      • UnityAds: game_id/placement_id
      • Vungle: app_id/placement_id
    • eCPM: The CPM floor 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.

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 → Ad networks.
  2. Next to the desired ad network, click Connect and fill out the required fields.

Accurate statistics are available for the following ad networks:

  • AdMob

  • AppLovin
  • myTarget

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.

Step 4. Configure your app

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