---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://boost.yandex.com/doc/en/ad-monetization/monetization/yandex-mediation/setup.md
  - https://boost.yandex.com/doc/ru/ad-monetization/monetization/yandex-mediation/setup.md
  - href: en/ad-monetization/monetization/yandex-mediation/setup.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/en/llms.txt

# Setting up mediation



## Step 1. Create ad units in other advertising networks {#step-1}

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 info %}

If you use [Smart Waterfall](https://boost.yandex.com/doc/en/ad-monetization/monetization/yandex-mediation/types.md#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.

{% endnote %}

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

{% cut "AppLovin" %}

1. [Register](https://dash.applovin.com/signup) or [log in](https://dash.applovin.com/login) to your AppLovin account.
1. Go to the **Account** → **Keys** tab and copy the **SDK Key** value. You'll need it when configuring your ad unit in the Boost interface.

     ![](../_images/applovin-1.png)
1. Go to **Discovery** → **Zones** tab and click **Create a Zone** to add a placement.

     ![](../_images/applovin-2.png)
1. 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**.

     ![](../_images/applovin-3.png)
1. Click **Save**.
1. Copy the **Zone ID** value. You'll need it when configuring your ad unit in the Boost interface.

     ![](../_images/applovin-4.png)
1. When setting up the monetizer unit ID in the Boost interface, enter the **SDK Key** and **Zone ID** in the appropriate fields.

{% endcut %}

{% cut "BIGO Ads" %}

The settings in the BIGO Ads interface vary depending on the technology you use to connect the ad network:

{% list tabs %}

- Via In-App Bidding

  1. [Register](https://www.bigossp.com/register) or [log in](https://www.bigossp.com/login) to your BIGO Ads account.
  2. Click **New app** to add your app.

      ![](../_images/bigo-1.png)

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

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

  4. Click **Submit**.

      ![](../_images/bigo-3.png =300x)

  5. Copy the **APP ID** value. You'll need it when configuring your ad unit in the Boost interface.

      ![](../_images/bigo-4.png)

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

      ![](../_images/bigo-6.png)

  9. When setting up the monetizer unit ID in the Boost interface, enter the **APP ID** and **Ad Slot ID** in the appropriate fields.

- Via Smart Waterfall

   1. [Register](https://www.bigossp.com/register) or [log in](https://www.bigossp.com/login) to your BIGO Ads account.
   2. Click **New app** to add your app.

       ![](../_images/bigo-1.png)

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

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

   4. Click **Submit**.

       ![](../_images/bigo-3.png =300x)

   5. Copy the **APP ID** value. You'll need it when configuring your ad unit in the Boost interface.

       ![](../_images/bigo-4.png)

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

       ![](../_images/bigo-5.png)

   8. Copy the **Ad Slot ID** value. You'll need it when configuring your ad unit in the Boost.

       ![](../_images/bigo-6.png)

   9. When setting up the monetizer unit ID in the Boost interface, enter the **APP ID** and **Ad Slot ID** in the appropriate fields.

{% endlist %}


{% endcut %}

{% cut "Chartboost" %}

1. [Register](https://www.chartboost.com/sign-up/) or [log in](https://dashboard.chartboost.com/login) to your Chartboost account.
1. Click **All Apps** and select an app from the list.

     ![](../_images/chartboost-1.png)
1. Open the app settings: **App Settings** → **Basic Settings**.
1. Copy **App ID** and **App Signature**. You'll need them to set up Yandex Mediation.

     ![](../_images/chartboost-2.png)
1. When setting up the monetizer unit ID in the Boost, 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](https://answers.chartboost.com/en-us/articles/200797729).

{% endcut %}

{% cut "Digital Turbine (ex. AdColony)" %}

1. [Register](https://clients.adcolony.com/register) or [log in](https://clients.adcolony.com/login) to your Digital Turbine (ex. AdColony) account.
1. Go to the **MONETIZATION** tab, then click **Setup New App** to add your app.

     ![](../_images/digital-turbine-1.png)
1. Fill in the app details and click **Create**.

1. Copy the **AdColony App UUID** value. You'll need it for the **App ID** parameter when configuring your ad unit in the Boost interface.

1. Click **Setup New Ad Zone** to create a placement.

     ![](../_images/digital-turbine-2.png)
1. 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.

     ![](../_images/digital-turbine-3.png)
1. Click **Create** at the bottom of the page to create an ad placement.
1. Go to the Ad Zone you created and copy the **Zone ID** value.

     ![](../_images/digital-turbine-4.png)
1. When setting up the monetizer unit ID in the Boost interface, enter the **App ID** and **Zone ID** in the appropriate fields.

{% endcut %}

{% cut "Google AdMob" %}

1. [Register](https://apps.admob.com/signup) or [log in](https://apps.admob.com/) to your Google AdMob account.
1. Go to the **Apps** tab and press **Add app**.

     ![](../_images/admob-1.png)

     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**.
1. 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.

     ![](../_images/admob-2.png)
1. After selecting the format, enter the name of your ad unit and click **Create ad unit** → **Done**.

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

     ![](../_images/admob-4.png)
1. 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 Boost interface, you will need this value for the **Ad Unit ID** parameter.

     ![](../_images/admob-5.png)

{% endcut %}


{% cut "InMobi" %}

1. Register or log in to your [InMobi](https://www.inmobi.com/mobile-in-app-monetization) account.
2. Go to the **Inventory** → **Inventory Settings** tab, then click **Add Inventory** to add your app.

   ![](../_images/inmobi-1.png)

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

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

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**.
   
   ![](../_images/inmobi-3.png)
 
6. Select the ad format, enter the ad placement's name in the **Placement Name** field, and click **Create Placement**.

   ![](../_images/inmobi-4.png)
   
7. Copy the placement ID. You'll need it for the **Placement ID** field when configuring your ad unit in the Boost.

   ![](../_images/inmobi-5.png)
   
8. 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 Boost.

   ![](../_images/inmobi-6.png)
   
9. When setting up the monetizer unit ID in the Boost interface, enter the **Account ID** and **Placement ID** in the appropriate fields.

{% endcut %}


{% cut "IronSource" %}

1. [Register](https://platform.ironsrc.com/partners/signup) or [log in](https://platform.ironsrc.com/partners/login) to your IronSource account.
1. Click **New app** to add your app.

     ![](../_images/ironsource-1.png)
1. Fill in your app's details: enter the app's Google Play/App Store URL or select **App Not Live in the Application Store**.

     ![](../_images/ironsource-2.png)
1. Click **Add App**.

     ![](../_images/ironsource-3.png)
1. Copy the **APP KEY** value. You'll need it when configuring your ad unit in the Boost interface.

    ![](../_images/ironsource-4.png)
1. Select the ad format and click **Continue**.
1. 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](https://www.is.com/contact/).

     ![](../_images/ironsource-5.png)
1. Specify the name in the **Instance Name** field and click **Save**.

     ![](../_images/ironsource-6.png)
1. Copy the **Instance Id** value. You'll need it when configuring your ad unit in the Boost.

     ![](../_images/ironsource-7.png)
1. When setting up the monetizer unit ID in the Boost interface, enter the **AppKey** and **Instance Id** in the appropriate fields.

{% endcut %}

{% cut "Liftoff (ex. Vungle)" %}


1. [Register](https://app.vungle.com/signup) or [log in](https://app.vungle.com/login) to your Liftoff (ex. Vungle) account.
1. Click **Add Application** to add your app.

     ![](../_images/liftoff-1.png)
1. Fill in the app details and click **Continue**.

     ![](../_images/liftoff-2.png)
1. Select **Placement type**, specify **Placement Name**, and click **Continue**.

     ![](../_images/liftoff-3.png)
1. 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.

     ![](../_images/liftoff-4.png)
1. 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.

     ![](../_images/liftoff-5.png)
1. When setting up the monetizer unit ID in the Boost interface, enter the **App ID** and **Placement ID** in the appropriate fields.

{% endcut %}

{% cut "Mintegral" %}

The settings in the Mintegral interface vary depending on the technology you use to connect the ad network:

{% list tabs %}

- Via In-App Bidding

     1. [Register](https://dev.mintegral.com/user/signup) or [log in](https://dev.mintegral.com/user/login) to your Mintegral account.
     1. If you've already added the app, go to the **Placements & Units** tab, select your app, and click **Add Placement**.

         ![](../_images/mintegral-1.png)
     1. 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 Boost 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 Boost interface.

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

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


- Via Smart Waterfall

     1. [Register](https://dev.mintegral.com/user/signup) or [log in](https://dev.mintegral.com/user/login) to your Mintegral account.
     1. If you've already added the app, go to the **Placements & Units** tab, select your app, and click **Add Placement**.

         ![](../_images/mintegral-1.png)
     1. 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**.

         ![](../_images/mintegral-5.png)
     1. Copy the **Ad Placement ID** and **AD Unit ID** values. You'll need them to set up Yandex Mediation in the Boost 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 Boost interface.

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

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

{% endlist %}

{% endcut %}

{% cut "Pangle" %}

{% note info %}

Mediation with Pangle is currently only available for Android apps.

{% endnote %}


1. [Register](https://www.pangleglobal.com/?operation=register) or [log in](https://www.pangleglobal.com/?operation=login) to your Pangle account.
1. 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.
1. Copy the **Ad Placement ID** and **App ID** values. You'll need them to set up Yandex Mediation in the Boost interface.

     ![](../_images/pangle-1.png)

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**.
1. To add an ad unit, go to **Applications** → **Ad Placements** and click **+Add Ad Placement**.

{% endcut %}

{% cut "Start.io" %}

1. Register or log in to your [Start.io](https://portal.start.io/) account.
1. Go to the **MY APPLICATIONS** tab, then click **Add New App** to add your app.

     ![](../_images/start-io-1.png)
1. Enter your app's URL in Google Play/AppStore.

     ![](../_images/start-io-2.png)
1. Specify whether your app is intended for children or not.
1. Click **Add App**.

     ![](../_images/start-io-3.png)
1. 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 Boost interface.

     ![](../_images/start-io-4.png)
1. You can use a custom string as a [tag](https://support.start.io/hc/en-us/articles/115002841734-Adding-Ad-Tags) to easily identify ad placements in Start.io reports. You can use any format for `tag` values: for example, `main_page_banner`.
1. When setting up the monetizer unit ID in the Boost interface, enter **Account ID**, **APP ID**, and **Ad Tag** in the appropriate fields.

{% endcut %}

{% cut "Tapjoy" %}

{% note info %}

Mediation with Tapjoy is currently only available for Android apps.

{% endnote %}


1. [Register](https://ltv.tapjoy.com/s/l#session/signup) or [log in](https://ltv.tapjoy.com/s/l#session/login) to your Tapjoy account.
1. 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.

     ![](../_images/tapjoy-1.png)
1. In the top menu, click **Settings** and go to **App Settings**.

     ![](../_images/tapjoy-2.png)
1. Scroll down the app settings tab and copy the **SDK Key**. You'll need it to set up Yandex Mediation in the Boost interface.

     ![](../_images/tapjoy-3.png)
1. Click **Monetization** in the top menu.
1. A window with monetization settings opens. In the left-hand menu, go to **Placements**.

     ![](../_images/tapjoy-4.png)
1. Open the ad unit settings and copy the **Name**. You'll need it to set up Yandex Mediation in the Boost interface.

     ![](../_images/tapjoy-5.png)


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**.
1. 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**.

{% endcut %}

{% cut "Unity Ads" %}

1. [Register or log in](https://id.unity.com/) to your Unity Ads account.
1. Go to the [dashboard](https://dashboard.unity3d.com/monetization) and click **Create Project**.

     ![](../_images/unityads-1.png)
1. Fill in the project details and click **Create Project**.

     ![](../_images/unityads-2.png =500x)
1. Go to **Monetize** → **Placements**. Copy the **Game ID** value. You'll need it when configuring your ad unit in the Boost interface.

     ![](../_images/unityads-3.png)
1. Click **Add Placement** to create a placement.

     ![](../_images/unityads-4.png)
1. Select the ad type, enter the **Placement ID**, and click **Create Placement**.

     ![](../_images/unityads-5.png =500x)
1. Copy the **Placement ID** you entered. You'll need it when configuring your ad unit in the Boost interface.
1. When setting up the monetizer unit ID in the Boost interface, enter **Game ID** and **Placement ID**.

{% endcut %}

{% cut "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:

{% list tabs %}

- Via In-App Bidding

     1. Register or log in to your [VK Ads (ex. myTarget)](https://ads.vk.com/hq/dashboard?requiredAccount=advert) network account.
     1. Go to the **Apps** section and click **Add app**.
     1. 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.
     1. Under **Apps**, go to the **Placements** tab and click **Add placement**.
     1. Select your app and name the new ad unit.
     1. Select the ad format for your ad unit: **Banner**, **Native**, **Fullscreen**, or **Rewarded**.
     1. Choose the **In-app bidding** integration type.
     1. 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.
     1. Select permitted creative types: banner ad, video, or carousel.
     1. Click **Create**.
     1. 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.

- Via Smart Waterfall

     1. Register or log in to your [VK Ads](https://ads.vk.com/hq/dashboard?requiredAccount=advert) account.
     1. Go to the **Apps** section and click **Add app**.
     1. 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.
     1. Under **Apps**, go to the **Placements** tab and click **Add placement**.
     1. Select your app and name the new ad unit.
     1. Select the ad format for your ad unit: **Banner**, **Native**, **Fullscreen**, or **Rewarded**.
     1. Choose the **Direct integration** integration type.
     1. 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.
     1. Select permitted creative types: banner ad, video, or carousel.
     1. Click **Create**.
     1. 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.

{% endlist %}

{% endcut %}

## Step 2. Connect the ad network to a unit in the Boost {#step-2}

1. In the Boost interface, start [creating a new ad unit](https://boost.yandex.com/doc/en/ad-monetization/monetization/formats.yaml) or open the settings of an existing unit.

1. Connect external ad networks in the unit:

      <!-- source: en/ad-monetization/monetization/_includes/mobmed-setup.md -->
      1. In the ad unit settings at the bottom of the page, click **Add network**.
      1. Select the mediation type: [In-App Bidding](https://boost.yandex.com/doc/en/ad-monetization/monetization/yandex-mediation/types.md#in-app-bidding) or [Smart Waterfall](https://boost.yandex.com/doc/en/ad-monetization/monetization/yandex-mediation/types.md#smart-waterfall). A list of networks that support the selected type of mediation will appear.
      1. 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).
      1. If necessary, set the unit serving geography: go to the **Geography** tab and specify the CPM floor for selected regions.
      <!-- endsource: en/ad-monetization/monetization/_includes/mobmed-setup.md -->

1. Click **Save** at the bottom of the page.


## Step 3. Set up your app {#step-4}

1. Integrate the latest version of the Yandex Mobile Ads SDK into your app according to the instructions:
    * [Android](https://boost.yandex.com/doc/en/ad-monetization/dev/android/quick-start-mm.md)
    * [iOS](https://boost.yandex.com/doc/en/ad-monetization/dev/ios/quick-start-mm.md)
    * [Unity](https://boost.yandex.com/doc/en/ad-monetization/dev/unity/quick-start-mm.md)
    * [Flutter](https://boost.yandex.com/doc/en/ad-monetization/dev/flutter/quick-start-mm.md)
    * [React Native](https://boost.yandex.com/doc/en/ad-monetization/dev/react-native/quick-start-mm.md)
1. Connect the Mobile Mediation adapter for this ad network:
    * [Android](https://boost.yandex.com/doc/en/ad-monetization/dev/android/list-network.md)
    * [iOS](https://boost.yandex.com/doc/en/ad-monetization/dev/ios/list-network.md)
    * [Unity](https://boost.yandex.com/doc/en/ad-monetization/dev/unity/list-network.md)
    * [Flutter](https://boost.yandex.com/doc/en/ad-monetization/dev/flutter/list-network.md)
    * [React Native](https://boost.yandex.com/doc/en/ad-monetization/dev/react-native/list-network.md)



<!-- source: en/_includes/chat-button.md -->
[Chat with us](https://yandex.ru/chat#/user/61c73805-2a89-9b86-4328-68e3b74b8122){.button}

<!-- source: en/_includes/button-style.md -->

<!-- endsource: en/_includes/button-style.md -->
<!-- endsource: en/_includes/chat-button.md -->


<!-- source: en/ad-monetization/monetization/_includes/banner-easy.md -->
<div style="position: relative; width: 100%; height: 0; padding-bottom: 18.61%;">
    <!-- padding-bottom — скорректировать из реального соотношения сторон -->
    <img src="https://yastatic.net/s3/doc-binary/src/support/mobile-ads/en/images/banner-easy.svg" style="position: absolute; width: 100%; height: 100%;" />
    <!-- Ссылка занимает всю щирину и высоту -->
    <a href="../../easy/index" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></a>
</div>
<!-- endsource: en/ad-monetization/monetization/_includes/banner-easy.md -->
