SDK-Versionen migrieren

Plattform auswählen: Android iOS Unity

Letzte Aktualisierung: Februar 2023

Auf dieser Seite werden Migrationen für aktuelle und frühere Versionen behandelt.

Von Version 7 zu Version 8 migrieren

Für Vollbildformate wird jetzt eine statische Lademethode verwendet

In Version 7 des Plug-ins hatten Interstitial-Anzeigen und Anzeigen mit Prämie eine LoadAd()-Methode auf Instanzebene zum Laden einer Anzeige, während Interstitial-Anzeigen mit Prämie und App-Start-Anzeigen eine statische Load()-Methode zum Laden von Anzeigen hatten. In Version 8 haben alle Vollbildanzeigenformate (Interstitial, mit Prämie, mit Prämie und Interstitial sowie App-Start) eine statische Load()-Methode zum Laden von Anzeigen. Hier ein Beispiel zum Laden einer Interstitial-Anzeige:

Version 8 (aktuell)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadAd()
{
    // Load an interstitial ad
    InterstitialAd.Load(adUnitId, new AdRequest(),
        (InterstitialAd ad, LoadAdError loadAdError) =>
        {
            if (loadAdError != null)
            {
                Debug.Log("Interstitial ad failed to load with error: " +
                           loadAdError.GetMessage());
                return;
            }
            else if (ad == null)
            {
                Debug.Log("Interstitial ad failed to load.");
                return;
            }

            Debug.Log("Interstitial ad loaded.");
            _interstitialAd = ad;
        });
}

Version 7 (Legacy)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadInterstitialAd()
{
    // Initialize an InterstitialAd.
    _interstitialAd = new InterstitialAd(adUnitId);
    // Called when an ad request has successfully loaded.
    _interstitialAd.OnAdLoaded += HandleOnAdLoaded;
    // Called when an ad request has failed to load.
    _interstitialAd.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    // Create an empty ad request.
    AdRequest request = new AdRequest.Builder().Build();
    // Load the interstitial with the request.
    _interstitialAd.LoadAd(request);
}

private void HandleOnAdLoaded(object sender, EventArgs args)
{
    Debug.Log("Interstitial ad loaded.");
}

private void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    if (args != null)
    {
        Debug.Log("Interstitial ad failed to load with error: " +
                   args.LoadAdError.GetMessage());
    }
}

Hier ein Beispiel zum Laden einer Anzeige mit Prämie:

Version 8 (aktuell)

// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
const string adUnitId = "unused";
#endif

private RewardedAd _rewardedAd;

private void LoadRewardedAd()
{
    // Load a rewarded ad
    RewardedAd.Load(adUnitId, new AdRequest(),
        (Rewarded ad, LoadAdError loadError) =>
        {
            if (loadError != null)
            {
                Debug.Log("Rewarded ad failed to load with error: " +
                           loadError.GetMessage());
                return;
            }
            else if (ad == null)
            {
                Debug.Log("Rewarded ad failed to load.");
                    return;
            }

            Debug.Log("Rewarded ad loaded.");
            _rewardedAd = ad;
        });
}

Version 7 (Legacy)

// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
const string adUnitId = "unused";
#endif

private RewardedAd _rewardedAd;

private void LoadRewardedAd()
{
    // Initialize an InterstitialAd.
    _rewardedAd = new RewardedAd(adUnitId);
    // Called when an ad request has successfully loaded.
    _rewardedAd.OnAdLoaded += HandleOnAdLoaded;
    // Called when an ad request has failed to load.
    _rewardedAd.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    // Create an empty ad request.
    AdRequest request = new AdRequest.Builder().Build();
    // Load the interstitial with the request.
    _rewardedAd.LoadAd(request);
}

private void HandleOnAdLoaded(object sender, EventArgs args)
{
    Debug.Log("Rewarded ad loaded.");
}

private void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    if (args != null)
    {
        Debug.Log("Rewarded ad failed to load with error: " +
                   args.LoadAdError.GetMessage());
    }
}

Mit `CanShowAd()` prüfen, ob Vollbildanzeigen bereit sind

In Version 7 hatten Vollbildanzeigen (Interstitial, mit Prämie, mit Prämie und Interstitial sowie App-Start) die Methode IsLoaded(), die true zurückgibt, wenn die Anzeige geladen wurde. Aufgrund der Änderung beim Laden von Anzeigen haben Sie in Version 8 erst dann Zugriff auf das Vollbildanzeigenobjekt, wenn die Anzeige geladen wurde. Dadurch wird die Methode IsLoaded() überflüssig.

Version 8 hat eine neue Methode namens CanShowAd(), die true zurückgibt, wenn die Anzeige noch ausgeliefert werden kann. Hier ein Beispiel für die Verwendung von CanShowAd() für eine Interstitial-Anzeige:

Version 8 (aktuell)

private InterstitialAd _interstitalAd;

public void ShowInterstitialAd()
{
    if (_interstitalAd != null && _interstitalAd.CanShowAd())
    {
        _interstitalAd.Show();
    }
    else
    {
        Debug.Log("Interstitial ad cannot be shown.");
    }
}

Version 7 (Legacy)

private InterstitialAd _interstitalAd;

public void ShowInterstitialAd()
{
    if (_interstitalAd != null && _interstitalAd.IsLoaded())
    {
        _interstitalAd.Show();
    }
    else
    {
        Debug.Log("Interstitial ad is not ready yet.");
    }
}

Mit `Show(Action)` Anzeigen mit Prämie präsentieren

In Version 7 des Plug-ins hatten Anzeigen mit Prämie die Show() Methode mit einem separaten OnUserEarnedReward Ereignis zur Verarbeitung der Nutzersignale für Prämien. Interstitial-Anzeigen mit Prämie hatten die Show(Action<Reward>) Methode mit einem Callback zur Verarbeitung des Nutzersignals für Prämien. In Version 8 haben Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie die Methode Show(Action<Reward>) mit einem Callback zur Verarbeitung der Benachrichtigung über die Prämie für den Nutzer.

Hier ein Beispiel zum Präsentieren einer Anzeige mit Prämie:

Version 8 (aktuell)

private RewardedAd _rewardedAd;

public void ShowRewardedAd()
{
    if (_rewardedAd != null && _rewardedAd.CanShowAd())
    {
        _rewardedAd.Show((Reward reward) =>
        {
            Debug.Log("Rewarded ad granted a reward: " +
                    reward.Amount);
        });
    }
    else
    {
        Debug.Log("Rewarded ad cannot be shown.");
    }
}

Version 7 (Legacy)

private RewardedAd _rewardedAd;

public void ShowRewardedAd()
{
    if (_rewardedAd != null && _rewardedAd.CanShowAd())
    {
        _rewardedAd.OnUserEarnedReward += HandleUserEarnedReward;
        _rewardedAd.Show();
    }
    else
    {
        Debug.Log("Rewarded ad is not ready yet.");
    }
}
public void HandleUserEarnedReward(object sender, Reward reward)
{
    Debug.Log("Rewarded ad granted a reward: " +
               reward.Amount);
}

Delegaten für Anzeigenereignisse verwenden jetzt bestimmte Typargumente

In Version 7 der API haben wir EventHandlers verwendet, als wir Ereignisdelegaten definiert haben. In Version 8 haben wir generische Delegaten für Anzeigenereignisse eingeführt. Dadurch geben Ereignisse jetzt Ereigniswerte direkt aus, ohne in die Klasse EventArg eingebunden zu sein.

Hier ein Beispiel für die Verwendung von OnAdPaid anstelle von OnPaidEvent:

Version 8 (aktuell)

private BannerView _bannerView;

public void ConfigureBanner()
{
    _bannerView.OnAdPaid += (AdValue value) =>
    {
        AdValue value = value;
    };
}

Version 7 (Legacy)

private BannerView _bannerView;

public void ConfigureBanner()
{
    _bannerView.OnPaidEvent += (object sender, AdValueEventArg arg) =>
    {
        AdValue value = arg.Value;
    };
}

Anzeigenformate entsprechen jetzt einer einheitlichen Schnittstelle

In Version 7 des Plug-ins gab es Unterschiede bei den Ereignisnamen zwischen Vollbildanzeigenformaten. In Version 8 haben wir viele unserer API-Methoden umbenannt, um sie für alle Anzeigenformate einheitlich zu gestalten.

In der folgenden Tabelle sind die in Version 8 eingeführten Klassenänderungen aufgeführt.

BannerView
v7v8
OnAdLoaded OnBannerAdLoaded
OnAdFailedToLoad OnBannerAdLoadFailed
OnAdOpening OnAdFullScreenContentOpened
OnAdClosed OnAdFullScreenContentClosed
OnPaidEvent OnAdPaid
InterstitialAd
LoadAd() InterstitialAd.Load()
InterstitialAd() InterstitialAd.Load()
OnAdLoaded InterstitialAd.Load()
OnAdFailedToLoad InterstitialAd.Load()
OnAdOpening OnAdFullScreenContentOpened
OnAdClosed OnAdFullScreenContentClosed
OnAdFailedToShow OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
OnPaidEvent OnAdPaid
RewardedAd
LoadAd() RewardedAd.Load()
RewardedAd() RewardedAd.Load()
OnAdLoaded RewardedAd.Load()
OnAdFailedToLoad RewardedAd.Load()
OnAdOpening OnAdFullScreenContentOpened
OnAdClosed OnAdFullScreenContentClosed
OnAdFailedToShow OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
OnPaidEvent OnAdPaid
Show() Show()
OnUserEarnedReward Show()
RewardedInterstitialAd
LoadAd() RewardedInterstitialAd.Load()
OnPaidEvent OnAdPaid
OnAdDidPresentFullScreenContent OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
AppOpenAd
LoadAd() AppOpenAd.Load()
OnPaidEvent OnAdPaid
OnAdDidPresentFullScreenContent OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
AdErrorEventArgs
AdErrorEventArgs.AdError Verwenden Sie AdError direkt.
AdFailedToLoadEventArgs
AdFailedToLoadEventArgs.LoadAdError Verwenden Sie LoadAdError direkt.
AdValueEventArgs
AdValueEventArgs.AdValue Verwenden Sie AdValue direkt.