Миграция с Google AdMob (ex. AdMob) на медиацию Яндекса на Android (Kotlin)

Подключение SDK
Форматы объявлений

Чтобы заменить рекламу Google AdMob (ex. AdMob) на медиацию Yandex Ads на Android, внесите в свой код следующие изменения.

Подключение SDK

Добавьте зависимости для Yandex Mobile Ads SDK в файл Gradle вашего модуля на уровне приложения, обычно app/build.gradle.

Google AdMob (ex. AdMob)

Yandex Ads

dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.5.0'
}

dependencies {
    implementation 'com.yandex.android:mobileads:6.2.0'
    implementation 'com.yandex.ads.mediation:mobileads-admob:22.5.0.0'
    implementation 'com.google.android.gms:play-services-ads:22.5.0'
}

Перед загрузкой рекламы инициализируйте библиотеку с помощью метода initialize():

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.MobileAds
import com.google.android.gms.ads.initialization.InitializationStatus

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {
            fun onInitializationComplete(initializationStatus: InitializationStatus?) {

            }
        }
    }
}

import com.yandex.mobile.ads.common.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {

        }
    }
}

Форматы объявлений

Interstitial

Загрузка объявления

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.AdRequest
import com.google.android.gms.ads.LoadAdError
import com.google.android.gms.ads.interstitial.InterstitialAd
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback

class MainActivity : AppCompatActivity() {
    private var interstitialAd: InterstitialAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {
            fun onInitializationComplete(initializationStatus: InitializationStatus?) {
            }
        }
        val adRequest: AdRequest = Builder().build()

        InterstitialAd.load(this, "ca-app-pub-3940256099942544/1033173712", adRequest,
            object : InterstitialAdLoadCallback() {
                override fun onAdLoaded(interstitialAdLoaded: InterstitialAd) {
                    // The interstitialAd reference will be null until
                    // an ad is loaded.
                    interstitialAd = interstitialAdLoaded
                    Log.i("TAG", "onAdLoaded")
                }

                override fun onAdFailedToLoad(loadAdError: LoadAdError) {
                    // Handle the error
                    Log.i("TAG", loadAdError?.toString())
                    interstitialAd = null
                }
            })
    }
}

import com.yandex.mobile.ads.common.MobileAds
import com.yandex.mobile.ads.interstitial.InterstitialAd
import com.yandex.mobile.ads.common.AdRequest

class MainActivity : AppCompatActivity() {
    private var interstitialAd: InterstitialAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {

        }

        val adRequest: AdRequest = Builder().build()

        interstitialAd = InterstitialAd(this)
        interstitialAd?.setAdUnitId("demo-interstitial-yandex")
        interstitialAd?.loadAd(adRequest)
    }
}

Установка колбеков рекламы

Перед показом рекламы установите колбеки, чтобы отслеживать события, связанные с вашим объявлением.

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.AdError
import com.google.android.gms.ads.FullScreenContentCallback

interstitialAd?.fullScreenContentCallback = object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
        // Called when fullscreen content is dismissed.
        Log.d("TAG", "The ad was dismissed.")
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
        // Called when fullscreen content failed to show.
        Log.d("TAG", "The ad failed to show.")
    }

    override fun onAdShowedFullScreenContent() {
        // Called when fullscreen content is shown.
        // Make sure to set your reference to null so you don't
        // show it a second time.
        interstitialAd = null
        Log.d("TAG", "The ad was shown.")
    }
}

import com.yandex.mobile.ads.common.ImpressionData
import com.yandex.mobile.ads.common.AdRequestError

interstitialAd?.setInterstitialAdEventListener(object : InterstitialAdEventListener {
    override fun onAdLoaded() {
        Log.i("TAG", "onAdLoaded")
    }

    override fun onAdFailedToLoad(error: AdRequestError) {
        // Handle the error
        Log.i("TAG", error.description)
    }

    override fun onAdDismissed() {
        // Called when an interstitial ad has been dismissed.
        Log.d("TAG", "The ad was dismissed.")
    }

    override fun onAdShown() {
        // Called when an interstitial ad has been shown.
        Log.d("TAG", "The ad was shown.")
    }

    override fun onImpression(impressionData: ImpressionData?) {
        // Called when an impression was tracked
        Log.d("TAG", "The ad imprassion was tracked.")
    }

    override fun onAdClicked() {
        // Called when user clicked on the ad.
        Log.d("TAG", "The ad was clicked.")
    }

    override fun onReturnedToApplication() {
        // Called when user returned to application after click.
        Log.d("TAG", "The ad was clicked.")
    }

    override fun onLeftApplication() {
        // Called when user is about to leave application after tapping on an ad.
        Log.d("TAG", "The ad left application after click.")
    }
})

Межстраничная реклама должна отображаться во время естественных пауз в работе приложения. Например, между уровнями игры или после того, как пользователь выполнил задачу. Чтобы показать межстраничное объявление, используйте метод show().

Google AdMob (ex. AdMob)

Yandex Ads

if (interstitialAd != null) {
    interstitialAd?.show(MyActivity.this)
} else {
    Log.d("TAG", "The interstitial ad wasn't ready yet.")
}

if (interstitialAd?.isLoaded == true) {
    interstitialAd?.show()
} else {
    Log.d("TAG", "The interstitial ad wasn't ready yet.")
}

Баннер

Добавьте AdView в верстку

Чтобы отобразить баннер, разместите BannerAdView в нужном Activity или Fragment. Для этого добавьте его в соответствующий XML-файл макета:

Google AdMob (ex. AdMob)

Yandex Ads

# main_activity.xml
...
  <com.google.android.gms.ads.AdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-app-pub-3940256099942544/6300978111">
  </com.google.android.gms.ads.AdView>
...

# main_activity.xml
...
  <com.yandex.mobile.ads.banner.BannerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true">
  </com.yandex.mobile.ads.banner.BannerAdView>
...

Укажите в коде обязательные атрибуты:

// ...
bannerAdView = (BannerAdView) findViewById(R.id.adView)
bannerAdView.setAdUnitId("demo-banner-yandex")
bannerAdView.setAdSize(AdSize.stickySize(320, 50))
// ...

adSize — необходимый размер для баннера.
adUnitId — уникальный идентификатор рекламного блока. Если в вашем приложении баннер показывается в разных Activity, рекомендуется для каждого баннера создавать отдельные идентификаторы рекламных блоков в Партнерском интерфейсе.

Также вы можете создать BannerAdView программно:

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.AdSize
import com.google.android.gms.ads.AdView

val adView = AdView(this)
adView.setAdSize(AdSize.BANNER)
adView.adUnitId = "ca-app-pub-3940256099942544/6300978111"
// TODO: Add adView to your view hierarchy.

import com.yandex.mobile.ads.banner.AdSize
import com.yandex.mobile.ads.banner.BannerAdView

// создание баннера через xml
val adView = (BannerAdView) findViewById(R.id.adView)
// программное создание баннера
// val adView = BannerAdView(this)

adView.setAdSize(AdSize.stickySize(320))
adView.setAdUnitId("demo-banner-yandex")
// TODO: Add adView to your view hierarchy.

Загрузка рекламы

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.AdRequest
import com.google.android.gms.ads.AdView
import com.google.android.gms.ads.MobileAds
import com.google.android.gms.ads.initialization.InitializationStatus

class MainActivity : AppCompatActivity() {
    private var adView: AdView? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {
            fun onInitializationComplete(initializationStatus: InitializationStatus?) {

            }
        }

        adView = findViewById<AdView>(R.id.adView)
        val adRequest = AdRequest.Builder().build()
        adView?.loadAd(adRequest)
    }
}

import com.yandex.mobile.ads.banner.BannerAdView
import com.yandex.mobile.ads.common.AdRequest
import com.yandex.mobile.ads.common.MobileAds

class MainActivity : AppCompatActivity() {
    private var adView: BannerAdView? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {

        }

        adView = findViewById<BannerAdView>(R.id.adView)
        val adRequest: AdRequest = Builder().build()
        adView?.loadAd(adRequest)
    }
}

Подписка на события отображения рекламы

Чтобы настраивать поведение рекламы, вы можете подписаться на события жизненного цикла рекламных объявлений.

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.AdListener
import com.google.android.gms.ads.LoadAdError

adView?.adListener = object : AdListener() {
    override fun onAdLoaded() {
        // Code to be executed when an ad finishes loading.
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
        // Code to be executed when an ad request fails.
    }

    override fun onAdOpened() {
        // Code to be executed when an ad opens an overlay that
        // covers the screen.
    }

    override fun onAdClicked() {
        // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
        // Code to be executed when the user is about to return
        // to the app after tapping on an ad.
    }
}

import com.yandex.mobile.ads.common.AdRequestError
import com.yandex.mobile.ads.common.ImpressionData

adView?.setBannerAdEventListener(object : BannerAdEventListener {
    override fun onAdLoaded() {
        // Code to be executed when an ad finishes loading.
    }

    override fun onAdFailedToLoad(error: AdRequestError) {
        // Code to be executed when an ad request fails.
    }

    override fun onAdClicked() {
        // Code to be executed when the user clicks on an ad.
    }

    override fun onImpression(impressionData: ImpressionData?) {
        // Called when an impression was tracked
    }

    override fun onLeftApplication() {
        // Called when user is about to leave application after tapping on an ad.
    }

    override fun onReturnedToApplication() {
        // Code to be executed when the user is about to return
        // to the app after tapping on an ad.
    }
})

Реклама с вознаграждением

Загрузка объекта рекламы с вознаграждением

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.AdRequest
import com.google.android.gms.ads.LoadAdError
import com.google.android.gms.ads.MobileAds
import com.google.android.gms.ads.initialization.InitializationStatus
import com.google.android.gms.ads.rewarded.RewardedAd
import com.google.android.gms.ads.rewarded.RewardedAdLoadCallback

class MainActivity : AppCompatActivity() {
    private var rewardedAd: RewardedAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {
            fun onInitializationComplete(initializationStatus: InitializationStatus?) {
            }
        }

        val adRequest: AdRequest = Builder().build()

        RewardedAd.load(this, "ca-app-pub-3940256099942544/5224354917",
            adRequest, object : RewardedAdLoadCallback() {
                override fun onAdFailedToLoad(loadAdError: LoadAdError) {
                    // Handle the error.
                    Log.d("TAG", loadAdError?.toString())
                    rewardedAd = null
                }

                override fun onAdLoaded(rewardedAd: RewardedAd) {
                    rewardedAd = rewardedAd
                    Log.d("TAG", "Ad was loaded.")
                }
            })
    }
}

import com.yandex.mobile.ads.common.AdRequest
import com.yandex.mobile.ads.common.MobileAds
import com.yandex.mobile.ads.rewarded.RewardedAd

class MainActivity : AppCompatActivity() {
    private var rewardedAd: RewardedAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        MobileAds.initialize(this) {

        }

        val adRequest: AdRequest = Builder().build()
        rewardedAd = RewardedAd(this)
        rewardedAd?.setAdUnitId("demo-rewarded-yandex")
    }
}

Установка колбеков рекламы

Google AdMob (ex. AdMob)

Yandex Ads

import com.google.android.gms.ads.FullScreenContentCallback
import com.google.android.gms.ads.AdError

rewardedAd?.fullScreenContentCallback = object : FullScreenContentCallback() {
    override fun onAdShowedFullScreenContent() {
        // Called when ad is shown.
        Log.d(TAG, "Ad was shown.")
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
        // Called when ad fails to show.
        Log.d(TAG, "Ad failed to show.")
    }

    override fun onAdDismissedFullScreenContent() {
        // Called when ad is dismissed.
        // Set the ad reference to null so you don't show the ad a second time.
        Log.d(TAG, "Ad was dismissed.")
    }
}

import com.yandex.mobile.ads.rewarded.RewardedAdEventListener
import com.yandex.mobile.ads.common.AdRequestError
import com.yandex.mobile.ads.rewarded.Reward

rewardedAd?.setRewardedAdEventListener(object : RewardedAdEventListener {
    override fun onAdLoaded() {
        Log.i("TAG", "onAdLoaded")
    }

    override fun onAdFailedToLoad(error: AdRequestError) {
        // Handle the error
        Log.i("TAG", error.description)
    }

    override fun onRewarded(reward: Reward) {
        // Handle the reward.
        Log.d("TAG", "The user earned the reward.")
        val rewardAmount: Int = reward.amount
        val rewardType: String = reward.type
    }

    override fun onAdDismissed() {
        // Called when an interstitial ad has been dismissed.
        Log.d("TAG", "The ad was dismissed.")
    }

    override fun onAdShown() {
        // Called when an interstitial ad has been shown.
        Log.d("TAG", "The ad was shown.")
    }

    override fun onImpression(impressionData: ImpressionData?) {
        // Called when an impression was tracked
        Log.d("TAG", "The ad impression was tracked.")
    }

    override fun onAdClicked() {
        // Called when user clicked on the ad.
        Log.d("TAG", "The ad was clicked.")
    }

    override fun onReturnedToApplication() {
        // Called when user returned to application after click.
        Log.d("TAG", "The ad was clicked.")
    }

    override fun onLeftApplication() {
        // Called when user is about to leave application after tapping on an ad.
        Log.d("TAG", "The ad left application after click.")
    }
})

Показать объявление

Когда вы показываете рекламу с вознаграждением, используйте объект RewardedAdEventListener для обработки события вознаграждения.

Google AdMob (ex. AdMob)

Yandex Ads

rewardedAd?.let { ad ->
  ad.show(this, OnUserEarnedRewardListener { rewardItem ->
    // Handle the reward.
    val rewardAmount = rewardItem.amount
    val rewardType = rewardItem.type
    Log.d(TAG, "User earned the reward.")
  })
} ?: run {
  Log.d(TAG, "The rewarded ad wasn't ready yet.")
}

if (rewardedAd?.isLoaded == true) {
    rewardedAd?.show()
} else {
    Log.d("TAG", "The rewarded ad wasn't ready yet.")
}

Обратиться в службу поддержки

Была ли статья полезна?

Android (Java)

iOS

Миграция с Google AdMob (ex. AdMob) на медиацию Яндекса на Android (Kotlin)

Подключение SDKПодключение SDK

Форматы объявленийФорматы объявлений

InterstitialInterstitial

Загрузка объявленияЗагрузка объявления

Установка колбеков рекламыУстановка колбеков рекламы

Показать объявлениеПоказать объявление

БаннерБаннер

Добавьте AdView в версткуДобавьте AdView в верстку

Загрузка рекламыЗагрузка рекламы

Подписка на события отображения рекламыПодписка на события отображения рекламы

Реклама с вознаграждениемРеклама с вознаграждением

Загрузка объекта рекламы с вознаграждениемЗагрузка объекта рекламы с вознаграждением

Установка колбеков рекламыУстановка колбеков рекламы

Показать объявлениеПоказать объявление

Была ли статья полезна?

Подключение SDK

Форматы объявлений

Interstitial

Загрузка объявления

Установка колбеков рекламы

Показать объявление

Баннер

Добавьте AdView в верстку

Загрузка рекламы

Подписка на события отображения рекламы

Реклама с вознаграждением

Загрузка объекта рекламы с вознаграждением

Установка колбеков рекламы

Показать объявление