버전 6으로 마이그레이션 가이드

Важно

사용한 Yandex Mediation 어댑터와 타사 중재 네트워크용 어댑터를 최신 버전으로 업데이트하세요. 이전 버전은 어댑터 통합 오류를 유발하여 광고가 제공되지 않을 수 있습니다.

이를 해결하려면 생성 중인 프로젝트에 대한 사용자 지정 템플릿을 활성화합니다. Build Settings → Player Settings → Publishing Settings → Build로 이동하여 Custom Main Gradle Template을 활성화하세요.

다른 잠재적 오류를 방지하기 위해 Unity 앱을 빌드할 때 항상 Custom Main Gradle Template 및 Custom Gradle Properties Template을 사용하는 것을 권장합니다.

배너

AdSize 클래스 이름을 BannerAdSize로 변경했습니다. FlexibleSize(int width, int height) 메서드가 제거되었습니다.

광고 유형에 따라 메서드를 사용하세요.

적응형 스티키 배너를 생성하려면 BannerAdSize.stickySize(int width) 메서드를 사용하세요.

앱 화면의 상단 또는 하단에 배치되어 자동으로 업데이트되는 작은 광고입니다.

주요 앱 콘텐츠와 겹치지 않으며 게임 앱에서 자주 사용됩니다.

스티키 배너의 높이는 자동으로 결정되며, 장치의 화면 크기에 맞춰 조정되고 화면 높이의 15%를 초과하지 않습니다.

Важно

버전 6.0.0에서는 적응형 스티키 배너에 대한 자동 새로 고침 지원이 추가되었습니다.

이전에 스티키 배너에 대한 자동 새로 고침을 구현한 경우, 비활성화하세요.

적응형 인라인 배너를 생성하려면 BannerAdSize.inlineSize(int width, int maxHeight) method를 사용하세요.

적응형 인라인 배너는 장치에서 광고 크기를 최적화하여 최대 효율을 제공하는 유연한 배너 광고 형식입니다.

배너 높이는 자동으로 조정되며, 장치 화면의 높이까지 도달할 수 있습니다.

일반적으로 해당 형식은 피드 기반 앱이나 광고에 주로 집중해도 되는 상황에서 사용됩니다.

이전 버전과의 호환성을 위해 fixedSize(int width, int height) 메서드를 보존했지만 권장하지는 않습니다. 대신 inlineSize(int width, int maxHeight) 또는 stickySize(int width)를 사용하세요. SDK 6.1.0에서는 광고 요청이 전송되기 전에 배너 높이가 자동으로 계산되어 알려집니다. 이 높이를 화면 레이아웃에 사용할 수 있습니다.

보상형 광고

광고 생성 및 로드 접근 방식이 변경되었습니다. 이제 광고를 로드하는 RewardedAdLoader 로더 객체와 OnAdLoaded 광고 로드 이벤트에서 가져온 RewardedAd광고 객체를 제공합니다.

새로운 API에 대한 자세한 내용은 SDK 참조를 참조하세요.

광고 로드

SDK 5

광고 로드 및 렌더링을 위한 단일 객체:

private RewardedAd rewardedAd;

private void RequestRewardedAd()
{
    string adUnitId = "demo-rewarded-yandex"; // "R-M-XXXXXX-Y"로 교체
    rewardedAd = new RewardedAd(adUnitId);

    AdRequest request = new AdRequest.Builder().Build();
    rewardedAd.LoadAd(request);
}

SDK 6

여러 광고를 로드하기 위한 RewardedAdLoader:

private void SetupLoader()
{
  rewardedAdLoader = new RewardedAdLoader();
  rewardedAdLoader.OnAdLoaded += HandleRewardedAdLoaded;
  rewardedAdLoader.OnAdFailedToLoad += HandleRewardedAdFailedToLoad;
}

private void RequestRewardedAd()
{
    string adUnitId = "demo-rewarded-yandex"; // "R-M-XXXXXX-Y"로 교체
    AdRequestConfiguration adRequestConfiguration = new AdRequestConfiguration.Builder(adUnitId).Build();
    rewardedAdLoader.LoadAd(adRequestConfiguration);
}

public void HandleAdLoaded(object sender, RewardedAdLoadedEventArgs args)
{
    this.interstitial = args.RewardedAd;
}

public void HandleAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    Debug.Log($"HandleAdFailedToLoad event received with message: {args.Message}");
}

광고 렌더링

SDK 5

광고를 표시하기 전에 광고가 로드되었는지 확인하세요.

private void ShowRewardedAd()
{
    if (rewardedAd != null && rewardedAd.IsLoaded())
    {
        rewardedAd.Show();
    }
}

SDK 6

광고가 로드되었는지 확인할 필요가 없습니다.

private void ShowRewardedAd()
{
    if (rewardedAd != null)
    {
        rewardedAd.Show();
    }
}

광고 수명주기 이벤트 구독

SDK 5

모든 이벤트는 단일 RewardedAd 객체로 도착합니다.

rewardedAd.OnRewardedAdLoaded += HandleRewardedAdLoaded;
rewardedAd.OnRewardedAdFailedToLoad += HandleRewardedAdFailedToLoad;
rewardedAd.OnReturnedToApplication += HandleReturnedToApplication;
rewardedAd.OnLeftApplication += HandleLeftApplication;
rewardedAd.OnAdClicked += HandleAdClicked;
rewardedAd.OnRewardedAdShown += HandleRewardedAdShown;
rewardedAd.OnRewardedAdFailedToShow += HandleRewardedAdFailedToShow;
rewardedAd.OnRewardedAdDismissed += HandleRewardedAdDismissed;
rewardedAd.OnImpression += HandleImpression;
rewardedAd.OnRewarded += HandleRewarded;

SDK 6

광고 로딩 이벤트는 RewardedAdLoader 객체로 도착하고, 광고 렌더링 이벤트는 RewardedAd 객체로 도착합니다. 이벤트 이름을 통일했습니다. OnLeftApplication 및 OnReturnedToApplication 이벤트를 제거했습니다.

rewardedAdLoader.OnAdLoaded += HandleRewardedAdLoaded;
rewardedAdLoader.OnAdFailedToLoad += HandleRewardedAdFailedToLoad;
// ...
rewardedAd.OnAdClicked += HandleAdClicked;
rewardedAd.OnAdShown += HandleRewardedAdShown;
rewardedAd.OnAdFailedToShow += HandleRewardedAdFailedToShow;
rewardedAd.OnAdDismissed += HandleRewardedAdDismissed;
rewardedAd.OnAdImpression += HandleImpression;
rewardedAd.OnRewarded += HandleRewarded;

전면 광고

광고 생성 및 로드 접근 방식이 변경되었습니다. 이제 광고를 로드하는 InterstitialAdLoader 로더 객체와 OnAdLoaded 광고 로드 이벤트에서 가져온 Interstitial광고 객체를 제공합니다.

새로운 API에 대한 자세한 내용은 SDK 참조를 참조하세요.

광고 로드

SDK 5

광고 로드 및 렌더링을 위한 단일 객체:

private Interstitial interstitial;

private void RequestInterstitial()
{
    string adUnitId = "demo-interstitial-yandex"; // "R-M-XXXXXX-Y"로 교체
    interstitial = new Interstitial(adUnitId);

    AdRequest request = new AdRequest.Builder().Build();
    interstitial.LoadAd(request);
}

SDK 6

여러 광고를 로드하기 위한 InterstitialAdLoader.

private void SetupLoader()
{
  interstitialAdLoader = new InterstitialAdLoader();
  interstitialAdLoader.OnAdLoaded += HandleInterstitialLoaded;
  interstitialAdLoader.OnAdFailedToLoad += HandleInterstitialFailedToLoad;
}

private void RequestInterstitial()
{
    string adUnitId = "demo-interstitial-yandex"; // "R-M-XXXXXX-Y"로 교체
    AdRequestConfiguration adRequestConfiguration = new AdRequestConfiguration.Builder(adUnitId).Build();
    interstitialAdLoader.LoadAd(adRequestConfiguration);
}

광고 렌더링

SDK 5

광고를 표시하기 전에 로드되었는지 확인합니다.

private void ShowInterstitial()
{
    if (interstitial != null && interstitial.IsLoaded())
    {
        interstitial.Show();
    }
}

SDK 6

광고가 로드되었는지 확인할 필요가 없습니다.

private void ShowInterstitial()
{
    if (interstitial != null)
    {
        interstitial.Show();
    }
}

광고 수명주기 이벤트 구독

SDK 5

모든 이벤트는 단일 Interstitial 객체로 도착합니다.

interstitial.OnInterstitialLoaded += HandleInterstitialLoaded;
interstitial.OnInterstitialFailedToLoad += HandleInterstitialFailedToLoad;
interstitial.OnReturnedToApplication += HandleReturnedToApplication;
interstitial.OnLeftApplication += HandleLeftApplication;
interstitial.OnAdClicked += HandleAdClicked;
interstitial.OnInterstitialShown += HandleInterstitialShown;
interstitial.OnInterstitialFailedToShow += HandleInterstitialFailedToShow;
interstitial.OnInterstitialDismissed += HandleInterstitialDismissed;
interstitial.OnImpression += HandleImpression;

SDK 6

광고 로딩 이벤트는 InterstitialAdLoader 객체로 도착하고, 광고 렌더링 이벤트는 Interstitial 객체로 도착합니다. 이벤트 이름을 통일했습니다. OnLeftApplication 및 OnReturnedToApplication 이벤트를 제거했습니다.

interstitialAdLoader.OnAdLoaded += HandleInterstitialLoaded;
interstitialAdLoader.OnAdFailedToLoad += HandleInterstitialFailedToLoad;
// ...
interstitial.OnAdClicked += HandleAdClicked;
interstitial.OnAdShown += HandleInterstitialShown;
interstitial.OnAdFailedToShow += HandleInterstitialFailedToShow;
interstitial.OnAdDismissed += HandleInterstitialDismissed;
interstitial.OnAdImpression += HandleImpression;

앱 실행 광고

새 광고 형식 추가됨: 앱 실행 광고. 자세한 내용은 앱 실행 광고를 참조하세요

Yandex Mediation

Важно

패키지 mobileads-admob-mediation-2.9.0.unitypackage의 이름을 mobileads-google-mediation-6.0.0.unitypackage로 변경했습니다.

표준형 중재 빌드를 사용하는 경우 조치를 취할 필요가 없습니다. 어댑터를 수동으로 추가하는 경우 이전 패키지를 제거한 후 새 패키지를 추가하세요.

통합에 대한 전체 예시를 여기서 확인하세요.

GitHub 링크.

Was the article helpful?

플러그인 통합

광고 형식