Zuletzt aktualisiert: Februar 2023
Auf dieser Seite werden Migrationen für die aktuelle und die vorherige Version beschrieben.
Von Version 7 zu Version 8 migrieren
Für Vollbildformate wird jetzt eine statische Lademethode verwendet
In Version 7 des Plug-ins wurde für Interstitial- und Anzeigen mit Prämie die Methode LoadAd() auf Instanzebene zum Laden einer Anzeige verwendet. Für Interstitial-Anzeigen mit Prämie und Anzeigen, die bei App-Öffnung ausgeliefert werden, wurde die statische Methode Load() verwendet. In Version 8 wird für alle Vollbildanzeigen (Interstitial-, Anzeigen mit Prämie, Interstitial-Anzeigen mit Prämie und App-Start-Anzeigen) die statische Load()-Methode zum Laden von Anzeigen verwendet. Hier ein Beispiel für das 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 (alt)
#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 für das 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 (alt)
// 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 mit Prämie, Interstitial-Anzeigen mit Prämie und App-Start-Anzeigen) die Methode IsLoaded() verwendet, die true zurückgibt, wenn die Anzeige geladen wurde. Aufgrund der Änderung bei der Anzeigenauslieferung haben Sie in Version 8 erst nach dem Laden der Anzeige Zugriff auf das Vollbildanzeigenobjekt. Die Methode IsLoaded() ist daher nicht mehr verfügbar.
Version 8 enthält 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() in einer 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 (alt)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.IsLoaded())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad is not ready yet.");
}
}
„Show(Action)“verwenden, um Anzeigen mit Prämie zu präsentieren
In Version 7 des Plug-ins gab es für Anzeigen mit Prämie die Methode Show() mit einem separaten Ereignis OnUserEarnedReward zum Verarbeiten der Nutzerprämiensignale. Für Interstitials mit Prämie gab es die Methode Show(Action<Reward>) mit einem Callback zum Verarbeiten des Nutzerprämiensignals. In Version 8 haben Anzeigenformate mit Prämie und Interstitial-Anzeigenformate mit Prämie eine Show(Action<Reward>)-Methode mit einem Rückruf zur Verarbeitung der Benachrichtigung über die Prämie für Nutzer.
Hier ein Beispiel für eine 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 (alt)
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);
}
Für Anzeigenereignis-Delegierte werden jetzt bestimmte Typargumente verwendet
In Version 7 der API haben wir EventHandlers verwendet, um Ereignisdelegierte zu definieren. In Version 8 haben wir generische Delegatings für Anzeigenereignisse eingeführt. Daher werden Ereigniswerte jetzt direkt von Ereignissen gesendet, ohne in die Klasse EventArg verpackt zu werden.
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 (alt)
private BannerView _bannerView;
public void ConfigureBanner()
{
_bannerView.OnPaidEvent += (object sender, AdValueEventArg arg) =>
{
AdValue value = arg.Value;
};
}
Anzeigenformate haben jetzt eine einheitliche Benutzeroberfläche
In Version 7 des Plug-ins gab es Abweichungen bei den Ereignisnamen zwischen Vollbildanzeigenformaten. In Version 8 haben wir viele unserer API-Methoden umbenannt, um für Konsistenz bei unseren Anzeigenformaten zu sorgen.
In der folgenden Tabelle sind die Änderungen an Klassen aufgeführt, die in Version 8 eingeführt wurden.
BannerView | |
|---|---|
| v7 | v8 |
| 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. |