SDK-Migration

Letzte Aktualisierung: Februar 2023

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

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 wird für alle Vollbildanzeigenformate (Interstitial, Interstitial mit Prämie, Interstitial mit Prämie und App-Start-Anzeigen) eine statische Load()-Methode zum Laden von Anzeigen verwendet. Hier sehen Sie ein Beispiel für das Laden einer Interstitial-Anzeige:

#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;
        });
}

#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 sehen Sie ein Beispiel, wie eine Anzeige mit Prämie geladen wird:

// 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;
        });
}

// 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 ausgeliefert werden können

In Version 7 wurde für Vollbildanzeigen (Interstitial-Anzeigen, Interstitial-Anzeigen mit Prämie, Interstitial-Anzeigen mit Prämie und App-Start-Anzeigen) die Methode IsLoaded() verwendet. Diese gibt true zurück, wenn die Anzeige geladen wurde. Aufgrund der geänderten Lademethode von Anzeigen haben Sie in Version 8 erst nach dem Laden der Anzeige Zugriff auf das Vollbildanzeigenobjekt. Aus diesem Grund ist die Methode IsLoaded() veraltet.

In Version 8 ist eine neue Methode namens CanShowAd() verfügbar, die true zurückgibt, wenn die Anzeige weiterhin eingeblendet werden kann. Hier sehen Sie ein Beispiel für die Verwendung von CanShowAd() in einer Interstitial-Anzeige:

private InterstitialAd _interstitalAd;

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

private InterstitialAd _interstitalAd;

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

Show(Action) zum Einblenden von Anzeigen mit Prämie verwenden

In Version 7 des Plug-ins hatten Anzeigen mit Prämie die Methode Show() mit einem separaten OnUserEarnedReward-Ereignis zum Verarbeiten der Nutzerprämiensignale. Die Interstitial-Anzeige mit Prämie hatte eine Show(Action<Reward>)-Methode mit einem Callback zur Verarbeitung des Nutzerprämiensignals. In Version 8 haben Interstitial-Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie eine Show(Action<Reward>)-Methode mit einem Callback für die Verarbeitung der Benachrichtigung über die Nutzerprämie.

Hier ein Beispiel für das Ausliefern einer Anzeige mit Prämie:

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.");
    }
}

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);
}

Anzeigenereignisdelegierte übernehmen jetzt bestimmte Typargumente

In Version 7 der API haben wir zum Definieren von Ereignisdelegierten EventHandlers verwendet. In Version 8 wurden allgemeine Bevollmächtigte für Anzeigenereignisse eingeführt. Daher geben Ereignisse jetzt Ereigniswerte direkt aus, ohne in die Klasse EventArg eingeschlossen zu werden.

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

private BannerView _bannerView;

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

private BannerView _bannerView;

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

Anzeigenformate jetzt auf einer einheitlichen Benutzeroberfläche

In der Version 7 des Plug-ins weichen die Ereignisnamen bei den Vollbildanzeigenformaten voneinander ab. In Version 8 haben wir viele API-Methoden umbenannt, damit sie in allen Anzeigenformaten einheitlich sind.

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