Setting up Mediation

Step 1. Add a mobile app and a placement

  1. Open the Mobile Mediation tab in YAN and click Add app.
  2. Add a store link to your app (App Store or Google Play) and click Create app.

    The app you added will then appear in the list. You can also use this page to view the total number of requests, renderings, and filled fields for each placement.

  3. Go to the app's placement list. To do this, choose the app from the list. Click Add placement on the page that opens. Specify the placement's name and format:
    • Banner: Placed over the app's main content, usually at the top or bottom of the screen
    • Interstitial: Covers the app's content completely, displayed between a user request and a response from the app (such as getting to the next level in a game).
    • Native ad: Seamlessly integrated into the app's main content to look organic.
    • Rewarded video: Used when monetizing games. Watching these videos earns the user a reward or in-game currency. Please specify the currency used in your game and the reward you wish to give players for viewing a video ad. You can use the Callback URL field to add a link to your app's backend if you want to transfer currency to users from a server. This is an optional field.
    Note. Some advertising networks don't have access to certain formats. For a detailed list of supported formats, see Ad sources.
  4. Click Create placement. Your ad placement will appear in the list with a unique ID. You can also use this page to view the total number of requests, renderings, and fill rate for each placement.

Step 2. Create ad blocks for external advertising networks

YAN chooses the right format and creates a block automatically. You can find it at Products → Mobile RTB blocks. You can edit settings as necessary.

Each external advertising network you want to add needs its own ad block created in the advertising network's interface. Setup instructions for some external advertising networks are given below.

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 block in the YAN 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 block in the YAN interface as the value of the zone_id parameter.

  7. In the Monetizer block ID field in the YAN 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 block and select the ad format.

  4. After selecting the format enter the name of your ad block and click Create ad block.

  5. If you want to add an ad block 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 block.

  6. Go to the Ad blocks section on the app details page. Find the Ad block ID parameter for the ad block 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 block in the YAN 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 block in the Monetizer block ID field in the YAN interface as the value of the zone_id parameter.

  7. In the Monetizer block ID field in the YAN 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 Monetizer unit ID field in the YAN 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.
Meta Audience Network
Element priority:
  1. You must have a contract with the Meta Audience Network.
  2. Receive your placement ID. To do this, go to Manage monetization object → Ad spaces → Placements and click Copy ID. You will need to use it as the value for the ad_unit_id parameter when setting up Mobile Mediation.

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 block in the YAN 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 section 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.

  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 block in the YAN interface as the value of the instance_id parameter.

  10. In the Monetizer block ID field in the YAN interface, enter the values of the app_key and instance_id parameters separated by the / symbol (app_key/instance_id).
MoPub
  1. Register or log in to your MoPub account.
  2. Click the Apps tab, then click NEW APP to add your app.

  3. Choose Android as your app's platform, then fill in the app name and the app package name. Select the primary and secondary app categories from the list that opens.

  4. Select the device type (Phone or Tablet) and enter your ad block's name. We recommend disabling banner auto-updates. Click Save to create your block.

  5. You will see a window with the Ad unit ID. Copy the value of this parameter. You will need to use it as the value for the ad_unit_id parameter when setting up Mobile Mediation.

If you want to add an ad block into a pre-existing app, go to the Apps tab and choose the app you wish to create an ad block for. Click New ad unit on the app details page.
myTarget

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

Note. This technology is only available for Android apps.
  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. After that, myTarget will automatically create an ad block.
  4. Select the ad format for your block: Banner, Interstitial, or Native.
  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 block list to the line opposite to the block 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 block, go to Applications → Ad Placements and find the desired ad block in the list.
  3. Copy the Ad Placement ID and App ID. You'll need to set up mobile Mediation in the YAN interface.

  4. In the Monetizer block ID field in the YAN interface, enter the values of the Ad Placement ID and App ID parameters separated by the / symbol (game_id/placement_id).

If you don't have an app and ad block 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 block, 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 block in the YAN 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 Monetizer block ID field in the YAN 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 block (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 YAN 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 block settings and copy Name.

  8. In the Monetizer block ID field in the YAN 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 block 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 block, 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 block in the YAN 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 block in the YAN interface as the value of the placement_id parameter.
  8. In the Monetizer block ID field in the YAN 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 block 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 block, select the app from the list on the main page.
  8. Click Add Placement.

  9. In the Monetizer block ID field in the YAN interface, enter the values of the app_id and placement_id parameters separated by the / symbol (app_id/placement_id).

Step 3. Set up your ad placement monetization

Your Mobile Mediation settings will vary based on the method you use when connecting an external advertising network.

Via Smart Waterfall

  1. Select the desired app in the Mobile Mediation tab. A list of placements will appear.
  2. Select the desired placement. A window with placement settings and a list of advertising networks will appear on the right.
  3. Click Configure next to the name of the desired advertising network.
  4. Fill in the required fields in the advertising network settings window on the Common tab:
    • Currency: The currency used in the external advertising network.
    • Monetizer unit ID: The block ID your received during step 2. The ID can consist of several parameters that start with the / character.
    • Min CPM: The minimum CPM threshold set for this ad block.
  5. Add the remaining blocks created in this advertising network the same way.

    The ad block used to display an ad is selected automatically between networks linked to the placement. You can add up to 100 blocks for one advertising network, but only some of them will be selected based on what works best. By default, blocks are selected in ascending order starting from the lowest CPM.

    Note. The Yandex Advertising Network block is enabled automatically. Its CPM threshold is specified in the settings. If you want to configure a YAN block, go to Products → Mobile RTB blocks and use the search field to find the block with the same name.
  6. Enable the Active status for your demand platform. Don't forget to enable Mediation on the app page.

You can set CPM thresholds based on the user's country in the Geography of views tab. This lets you increase revenue you receive from impressions with flexible management of the minimum price: you can set a higher CPM for some countries, and completely block ads for others.

Set the minimum CPM threshold for ad placements in the desired country or region. No blocks with the threshold below the value you set will be displayed.

You can use the Units column to view the number of blocks eligible for ad rotation under the applied region settings. For example, an advertising network has three blocks with a CPM of 50, 80, and 100. The minimum CPM for the CIS region is set to 75. This means that all ads with CPM set at 80 and 100 will be included in the rotation.

Ad placement settings for each connected network display the network's status, ad serving area, and enabled ad blocks with their respective CPM thresholds.

Via In-App Bidding

Note. This technology is currently only available on Android and only for apps powered by myTarget.
  1. Select the desired app in the Mobile Mediation tab. A list of placements will appear.
  2. Select the desired placement. A placement settings window will appear on the right.
  3. Click Configure next to the name of myTarget bidding ad network.
  4. Fill in the required fields in the settings window on the Common tab:
    • Currency: Specify the currency used by myTarget.
    • Site ID: Specify the site ID in myTarget. To do this, open the app list in the myTarget interface and copy the Placement ID parameter from the line with your desired app.
    • Monetizer unit ID: Specify the myTarget slot ID. To view the slot ID, click the name of the desired app in the app list in the myTarget interface. The block list will appear. Find and copy the Slot ID from the line with your desired block.
  5. Set your demand platform's status to Active and click Save.

Step 4. Configure your app

  1. Integrate the latest version of the Yandex Mobile Ads SDK into your app according to the instructions (iOS/Android).
  2. Copy the dependencies from YAN and insert them in the app's build.gradle file. You can find dependencies on the ad placement page by clicking SDK configuration.

Mobile Mediation reports are available on the Statistics tab. To learn more about creating reports, see Managing Yandex Advertising Network reports.