Migrazione SDK

Ultimo aggiornamento: 2 febbraio 2024

Questa pagina riguarda le migrazioni per le versioni correnti e precedenti.

Migrazione dalla versione 22 alla versione 23

Il livello API Android minimo è 21

A partire dalla versione 23.0.0, per poter essere eseguite, l'SDK Google Mobile Ads richiede che tutte le app abbiano il livello API Android minimo 21. Per regolare il livello API, modifica il valore di minSdkVersion nel file build.gradle a livello di app impostandolo su 21 o superiore.

Metodi obsoleti rimossi/sostituiri

API v22.0.0	API v23.0.0
AdRequest.Builder.addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()
AdRequest.Builder.tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()
AdRequest.Builder.setIsDesignedForFamilies()	RequestConfiguration.Builder.setMaxAdContentRating()
AdFormat.UNKNOWN	Nessuna sostituzione
AdLoader.Builder.forUnifiedNativeAd()	AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd()	AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.formats.NativeAdOptions)	AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.nativead.NativeAdOptions)
void MobileAds.setSameAppKeyEnabled()	boolean MobileAds.putPublisherFirstPartyIdEnabled()

Migrazione dalla versione 21 alla versione 22

Utilizza MobileAds.getVersion() per ottenere la versione dell'SDK Google Mobile Ads

Il metodo MobileAds.getVersionString() viene rimosso nella versione 22.0.0 a favore di MobileAds.getVersion().

Il nuovo metodo restituisce il numero di versione esterna previsto, ad esempio 22.0.0. Per ulteriori informazioni su questa modifica, consulta l'articolo Utilizzare il nuovo metodo getVersion() dell'SDK Google Mobile Ads.

Metodi rimossi o sostituiti

Nella tabella seguente sono elencate le modifiche specifiche della versione 22.0.0.

v21.0.0	v22.0.0
MobileAds.getVersionString()	MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView()	NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController()	NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo()	AdRequest.Builder.setAdString()
MediationRewardedVideoAdAdapter	Alimentatore
MediationRewardedVideoAdListener
com.google.android.gms.ads.mediation.VersionInfo	com.google.android.gms.ads.VersionInfo
com.google.android.gms.ads.doubleclick.AppEventListener	com.google.android.gms.ads.admanager.AppEventListener

Eseguire la migrazione dalla versione 20 alla versione 21

Aggiorna minSdkVersion a 19 o versioni successive

A partire dalla versione 21.0.0, per poter essere eseguite, l'SDK Google Mobile Ads richiede che tutte le app abbiano un livello API Android minimo 19. Per regolare il livello API, imposta il valore di minSdkVersion nel file di compilazione dell'app su 19 o versioni successive.

Impostare la nullità rigorosa

In preparazione all'applicazione della nullità rigorosa, le annotazioni @NonNull vengono aggiunte a tutte le API che in precedenza non definivano esplicitamente la nullità.

Questa modifica potrebbe causare un malfunzionamento delle app Kotlin e di quelle che utilizzano framework di controllo dei valori null di Java se si verificano violazioni della sicurezza di null e in precedenza non venivano gestiti in modo sicuro i valori null (consulta la documentazione di Kotlin sulla sicurezza di null).

Rimozione del metodo addNetworkExtras()

Il metodo addNetworkExtras() che passa parametri aggiuntivi come istanza NetworkExtras a un adattatore della rete pubblicitaria specifico è stato ritirato nella versione 20.3.0 dell'SDK e verrà rimosso nella versione 21.0.0. Utilizza invece il metodo addNetworkExtrasBundle() della stessa classe AdRequest.Builder.

Rimozione dei metodi di geolocalizzazione

I seguenti metodi di geolocalizzazione verranno rimossi nella versione 21.0.0:

• Il metodo setLocation(Location location) nella classe AdRequest.Builder che imposta la località dell'utente ai fini del targeting di mediazione.
• Il metodo getLocation() nella classe AdRequest che restituisce le informazioni sul targeting per località dell'utente precedentemente trasmesse al metodo setLocation(Location location).
• Il metodo getLocation() nella classe MediationAdConfiguration che restituisce la posizione dell'utente, se definita dal AdRequest.

I dati sulla posizione non vengono utilizzati da Google per il targeting degli annunci. Se necessario, devi utilizzare API di terze parti per fornire le informazioni a reti pubblicitarie di terze parti.

Ritiro delle interfacce degli eventi personalizzati

Gli eventi personalizzati consentono ai publisher che utilizzano la mediazione per configurare un'origine annuncio con struttura a cascata che non è una delle origini annuncio supportate di AdMob.

Tutte le interfacce eventi personalizzati sono deprecate a favore della classe Adapter e dell'interfaccia MediationAdLoadCallback.

La tabella seguente elenca la classe o l'interfaccia corrispondente da utilizzare per ogni interfaccia di eventi personalizzati a partire dalla versione 21.0.0:

Interfacce della versione 20.0.0	v21.0.0 Classe/ interfaccia
CustomEvent	Alimentatore
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	Adapter, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

Eseguire la migrazione dalla versione 19 alla versione 20

La versione 20.0.0 contiene molte modifiche che provocano un errore. La versione 19.7.0 ha introdotto molte nuove API e ha deprecato o rinominato molte classi in preparazione alla versione 20.0.0. Questa guida mette in evidenza le modifiche principali nella versione 20.0.0.

Aggiornamenti dell'API per i formati a schermo intero

A partire dalla versione 20.0.0, i formati degli annunci interstitial, con premio, interstitial con premio e apertura app sono standardizzati per seguire un design API coerente.

Tutte le API per il formato a schermo intero utilizzano i seguenti principi:

• Un metodo di caricamento statico
• Un meccanismo di callback o gestore di caricamento simile
• Utilizzo della classe FullScreenContentCallback per i callback della presentazione

Rimozione dell'API RewardVideoAd precedente

La nuova API RewardedAd è stata introdotta per la prima volta a marzo 2019 ed è da oltre 18 mesi l'API con premio preferita. Ha subito più miglioramenti rispetto all'API RewardedVideoAd precedente, inclusa la possibilità di caricare più di un annuncio con premio alla volta.

L'API RewardedVideoAd precedente è stata rimossa nella versione 20.0.0 dell'SDK.

Ritiro dei banner intelligenti in favore dei banner adattivi

Gli annunci banner intelligenti non sono più supportati in favore degli annunci banner adattivi. I banner adattivi offrono prestazioni superiori e una maggiore flessibilità nell'impostazione della larghezza dell'annuncio. Se preferisci continuare a utilizzare i banner a larghezza intera, puoi farlo anche con i banner adattivi, come mostrato nel seguente snippet di codice:

Java

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

Kotlin

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

Abbandona la rimozione del callback dell'applicazione

Il callout onAdLeftApplication per tutti i formati degli annunci è stato rimosso in favore di ProcessLifecycleOwner. L'utilizzo di un'API a livello di sistema operativo ti avvisa ogni volta che gli utenti escono dalla tua app, indipendentemente dal fatto che sia o meno dovuta a un'interazione con l'annuncio.

Tieni presente che il callback onAdLeftApplication non è mai stato pensato come gestore dei clic sugli annunci e, affidarsi a questo callback per generare report sui clic non ha prodotto una metrica accurata. Ad esempio, un clic sull'icona Scegli Tu! che ha avviato un browser esterno ha richiamato il callback, ma non è stato conteggiato come un clic.

Ridenominazioni dei corsi

La tabella seguente elenca nomi di classi specifici che sono stati modificati o rimossi. In conclusione:

• La maggior parte dei corsi correlati a UnifiedNativeAd è stata rinominata in NativeAd.
• I corsi e le visualizzazioni MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd e InstreamAd sono stati rimossi.
• Tutti i corsi con il prefisso Publisher sono stati sostituiti con un prefisso AdManager.
• Il nome del pacchetto InterstitialAd è stato modificato.

19.5.0 Classe	Classe 20.0.0
com.google.android.gms.ads.	com.google.android.gms.ads.
reward.RewardedVideoAd	rewarded.RewardedAd
reward.RewardedVideoAdListener	predicted.RewardAdLoadCallback e FullScreenContentCallback
reward.RewardItem	rewarded.RewardItem
rewarded.RewardedAdCallback	OnUserEarnedRewardListener
formats.UnifiedNativeAdView	nativead.NativeAdView
formats.UnifiedNativeAd	nativead.NativeAd
formats.UnifiedNativeAdAssetNames	nativead.NativeAdAssetNames
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener	nativead.NativeAd.OnNativeAdLoadedListener
formats.AdChoicesView	nativead.AdChoicesView
formats.NativeAd.AdChoicesInfo	nativead.NativeAd.AdChoicesInfo
formats.MediaView	nativead.MediaView
formats.NativeAdViewHolder	nativead.NativeAdViewHolder
formats.NativeAdOptions	nativead.NativeAdOptions
formats.NativeCustomTemplateAd	nativead.NativeCustomFormatAd
formats.NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener	nativead.NativeCustomFormatAd.OnCustomFormatAdLoadedListener
MobileAds.Settings	Rimosso
doubleclick.PublisherAdRequest	admanager.AdManagerAdRequest
doubleclick.PublisherAdView	admanager.AdManagerAdView
formats.PublisherAdViewOptions	formats.AdManagerAdViewOptions
doubleclick.PublisherInterstitialAd	admanager.AdManagerInterstitialAd
InterstitialAd	interstitial.InterstitialAd
NativeExpressAdView	Rimosso
instream.InstreamAd	Rimosso
mediation.admob.AdMobExtras	Rimosso
Correlatore	Rimosso
search.SearchAdRequest	Rimosso
Interfaccia AdRequest.TagForUnderAgeOfConsent	Rimosso
Interfaccia AdRequest.MaxAdContentRating	Rimosso
formats.NativeAppInstallAd	native.NativeAd
formats.NativeAppInstallAdView	native.NativeAdView
mediation.NativeAppInstallAdMapper	mediation.UnifiedNativeAdMapper
formats.NativeContentAd	native.NativeAd
formats.NativeContentAdView	native.NativeAdView
mediation.NativeContentAdMapper	mediation.UnifiedNativeAdMapper

Metodi rimossi/sostituiri

Nella tabella seguente sono elencate le modifiche specifiche della versione 20.0.0. In sintesi:

• I metodi di inizializzazione obsoleti sono stati rimossi dalla classe MobileAds.
• Alcuni metodi della classe AdRequest.Builder() sono stati rimossi o spostati nella classe RequestConfiguration.
• Le API per gli annunci con premio e interstitial sono state aggiornate per allinearle a tutti i formati a schermo intero.
• Le funzionalità di correlazione sono state rimosse.

Classe	API v19.5.0	API v20.0.0	Note
AdSize	getPortraitBannerAdSizeWithWidth()	getPortraitAnchoredAdaptiveBannerAdSize()
	getLandscapeBannerAdSizeWithWidth()	getLandscapeAnchoredAdaptiveBannerAdSize()
	getCurrentOrientationBannerAdSizeWithWidth()	getCurrentOrientationAnchoredAdaptiveBannerAdSize()
MobileAds	inizializza(Contesto, Stringa)	MobileAds.initialize(Context, OnInitializationCompleteListener)	L'ID app è ora impostato in AndroidManifest.xml.
	initialize(Context, String, MobileAds.Settings)	inizializza(Contesto, ListenerOnInizializzazione)	Il corso Impostazioni è stato ritirato.
	getRewardedVideoAdInstance()	Rimosso	Utilizza l'API RewardedAd.
AdListener	onAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onAdLeftApplication()	Rimosso	I formati degli annunci a schermo intero utilizzano FullscreenContentCallback al posto di AdListener e non esiste un metodo equivalente su FullscreenContentCallback. Il metodo è stato rimosso da AdListener.
VideoController	getAspectRatio()	MediaContent.getAspectRatio()
AdRequest	getGender()	Rimosso
	getBirthday()	Rimosso
	getNetworkExtras()	Rimosso
	setManualImpressionsEnabled()	Rimosso
	updateCorrelator()	Rimosso	Consulta Filtro dei contenuti degli annunci.
AdRequest.Builder	setBirthday()	Rimosso
	setGender()	Rimosso
	setIsDesignedForFamilies()	Rimosso	Consulta la guida.
	addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()	Consulta Attivazione degli annunci di prova.
	tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()	Consulta la pagina Filtro dei contenuti degli annunci.
	setTagForUnderAgeOfConsent()	RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
	setMaxAdContentRating()	RequestConfiguration.Builder.setMaxAdContentRating()
AdView	getMediationAdapterClassName()	ResponseInfo.getMediationAdapterClassName()	Un oggetto ResponseInfo è ora disponibile tramite il metodo getResponseInfo() di AdView.
NativeAdOptions	setImageOrientation()	setMediaAspectRatio()
	getImageOrientation	getMediaAspectRatio()
RewardedAd	loadAd(AdRequest, RewardAdLoadCallback)	RewardAd.load(Contesto, Stringa, Richiesta dell'annuncio, RewardAdLoadCallback)	L'annuncio con premio ora utilizza lo stesso approccio al caricamento statico degli altri formati a schermo intero.
	loadAd(PublisherAdRequest, RewardedAdLoadCallback)	RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback)
	isLoaded()	Rimosso	Il callback dal metodo di caricamento statico fornisce un annuncio già caricato.
	show(Activity, RewardedAdCallback)	show(Activity, OnUserEarnedRewardListener)	Questo metodo di visualizzazione è conforme all'approccio più ampio del formato a schermo intero.
RewardedAdLoadCallback	onRewardedAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedAdLoaded()	onAdLoaded(RewardedAd)
AppOpenAdLoadCallback	onAppOpenAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdLoaded(AppOpenAd)	onAdLoaded(AppOpenAd)
RewardedInterstitialAdLoadCallback	onRewardedInterstitialAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdLoaded(RewardedInterstitialAd)	onAdLoaded(RewardedInterstitialAd)
InterstitialAd	new InterstitialAd()	InterstitialAd.load(Context, String, AdRequest, InterstitialAdLoadCallback)	InterstitialAd ora utilizza lo stesso approccio al caricamento statico degli altri formati a schermo intero.
	setAdListener()
DynamicHeightSearchAdRequest	getNetworkExtras()	Rimosso	La classe NetworkExtras è stata ritirata.
AdLoader	forContentAd()	Rimosso
	forAppInstallAd()	Rimosso
	withCorrelator()	Rimosso
	getMediationAdapterClassName()	Rimosso