Migrare le versioni dell'SDK

Questa pagina illustra le migrazioni per le versioni attuali e precedenti.

Esegui la migrazione dalla versione 24 alla versione 25

Le seguenti sottosezioni descrivono le modifiche che provocano un errore e le differenze di comportamento tra le versioni principali 24 e 25 di Google Mobile Ads SDK (Legacy).

Il livello API Android minimo è 24

A partire dalla versione 25.5.0, Google Mobile Ads SDK (Legacy) richiede che tutte le app vengano eseguite su un livello API Android minimo 24. Per regolare il livello API, modifica il valore minSdk nel file build.gradle a livello di app impostandolo su 24 o su un valore superiore.

Rimozione dei callback degli annunci ritirati

I seguenti callback degli annunci deprecati sono stati rimossi dalle seguenti classi:

Modifiche alle API per le dimensioni dei banner adattivi ancorati

La versione 25.0.0 ritira le API esistenti per le dimensioni dei banner adattivi ancorati e introduce le API per le dimensioni degli annunci banner adattivi ancorati di grandi dimensioni. Google Mobile Ads SDK (Legacy) può pubblicare la domanda di video negli annunci banner utilizzando le nuove API per le dimensioni dei banner adattivi ancorati di grandi dimensioni.

La tabella seguente descrive in dettaglio le API di dimensionamento ritirate e le relative sostituzioni:

Rimozione del corso mediation.VersionInfo

La classe VersionInfo nel pacchetto com.google.android.gms.ads.mediation è stata rimossa. Utilizza invece il pacchetto com.google.android.gms.ads.VersionInfo.

Rimozione del metodo getConfiguration() nella classe RtbSignalData

L'API del metodo deprecato getConfiguration() in RtbSignalData è stata rimossa. Utilizza invece il metodo getConfigurations(), che restituisce un elenco List<MediationConfiguration>.

Esegui la migrazione dalla versione 23 alla versione 24

Le sezioni seguenti descrivono le modifiche che provocano un errore e le differenze di comportamento tra le versioni principali 23 e 24 di Google Mobile Ads SDK (Legacy).

Il livello API Android minimo è 23

A partire dalla versione 24.0.0, Google Mobile Ads SDK (Legacy) richiede che tutte le app vengano eseguite su un livello API Android minimo 23. Per regolare il livello API, modifica il valore minSdk nel file build.gradle a livello di app impostandolo su 23 o un valore superiore.

Modifiche all'inizializzazione e al caricamento ottimizzati

Per impostazione predefinita, i flag OPTIMIZE_INITIALIZATION e OPTIMIZE_AD_LOADING sono impostati su true. Per saperne di più su questi flag, consulta Ottimizza l'inizializzazione e il caricamento.

Dipendenze firebase-ads e firebase-ads-lite rimosse

A partire dalla versione 24.0.0, le release dell'SDK non distribuiscono più le dipendenze firebase-ads e firebase-ads-lite. Utilizza invece la dipendenza play-services-ads.

Imposta i parametri di targeting personalizzato

Per impostare il targeting personalizzato su una richiesta di annuncio, utilizza addCustomTargeting().

Rimozione delle API di orientamento deprecate per gli annunci apertura app

• Sono stati rimossi i metodi AppOpenAd.load() che accettano un parametro di input di orientamento. Utilizza invece i metodi AppOpenAd.load() che non accettano un orientamento.
• Rimosso l'enum AppOpenAdOrientation.

Callback del premio semplificato per gli adattatori di mediazione

La versione 24.0.0 aggiunge il callback onUserEarnedReward() in MediationRewardedAdCallback e ritira onUserEarnedReward(RewardItem). Gli adattatori di mediazione devono iniziare a chiamare onUserEarnedReward() quando l'utente guadagna un premio.

Quando inoltrano i callback dagli adattatori di mediazione, tutte le versioni di Google Mobile Ads SDK (Legacy) restituiscono il premio definito nell'interfaccia utente di Ad Manager in OnUserEarnedRewardListener.

Corsi rimossi

Le seguenti classi sono state rimosse senza sostituzione:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

Metodi rimossi

I seguenti metodi sono stati rimossi senza sostituzione:

Metodi deprecati

I seguenti metodi sono deprecati e non verranno sostituiti:

Esegui la migrazione dalla versione 22 alla versione 23

Le sezioni seguenti descrivono le modifiche che provocano un errore e le differenze di comportamento tra le versioni principali 22 e 23 di Google Mobile Ads SDK (Legacy).

Il livello API Android minimo è 21

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

I metodi AdManagerAdRequest.Builder ereditati dalla superclasse possono essere concatenati

Nella versione 23.0.0, i metodi AdManagerAdRequest.Builder ereditati dal relativo elemento principale possono essere concatenati per creare un AdManagerAdRequest utilizzando una singola chiamata:

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

Metodi deprecati rimossi/sostituiti

Esegui la migrazione dalla versione 21 alla versione 22

Le seguenti sottosezioni descrivono le modifiche che provocano un errore e le differenze di comportamento tra le versioni principali 21 e 22 di Google Mobile Ads SDK (Legacy).

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

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

Il nuovo metodo restituisce il numero di versione esterno previsto, ad esempio 22.0.0. Per saperne di più su questa modifica, consulta Utilizza il nuovo metodo dell'SDK Google Mobile Ads getVersion().

Rimozione del metodo NativeCustomFormatAd.getVideoMediaView() deprecato

Nella versione 21, Google Mobile Ads SDK (Legacy) ha fornito il metodo NativeCustomFormatAd.getVideoMediaView() per ottenere l'asset multimediale per un formato dell'annuncio personalizzato nativo.

A partire dalla versione 22, crei il tuo MediaView e imposti i relativi contenuti multimediali, quindi utilizzi MediaContent.getVideoController() per ottenere i controlli video.

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

Per saperne di più, consulta la guida agli annunci nativi personalizzati.

Metodi rimossi o sostituiti

La tabella seguente elenca le modifiche specifiche della versione 22.0.0:

Esegui la migrazione dalla versione 20 alla versione 21

Le seguenti sottosezioni descrivono le modifiche che provocano un errore e le differenze di comportamento tra le versioni principali 20 e 21 di Google Mobile Ads SDK (Legacy):

Aggiorna minSdkVersion alla versione 19 o successive

A partire dalla versione 21.0.0, Google Mobile Ads SDK (Legacy) richiede che tutte le app abbiano un livello API Android minimo pari a 19 per l'esecuzione. Per regolare il livello API, modifica il valore di minSdkVersion nel file di build della tua app impostandolo su 19 o un valore superiore.

Applica l'annullabilità rigorosa

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

Questa modifica potrebbe causare l'interruzione delle app Kotlin e delle app che utilizzano framework di controllo dei valori null di Java se sono presenti violazioni della sicurezza dei valori null e se in precedenza non venivano gestiti i valori null in modo sicuro (consulta la documentazione di Kotlin sulla sicurezza dei valori null).

Rimozione del metodo addNetworkExtras()

Il metodo addNetworkExtras() che passa parametri aggiuntivi come istanza NetworkExtras a un adattatore di 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 localizzazione

I seguenti metodi di localizzazione verranno rimossi nella versione 21.0.0:

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

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

Ritiro delle interfacce degli eventi personalizzati

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

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

La tabella seguente elenca la classe o l'interfaccia corrispondente che devi utilizzare per ogni interfaccia di evento personalizzato a partire dalla versione 21.0.0:

Esegui 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 ritirato o rinominato molte classi in preparazione alla versione 20.0.0. Questa guida evidenzia le principali modifiche della 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 dell'API coerente.

Tutte le API dei formati a schermo intero utilizzano i seguenti principi:

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

Rimozione dell'API RewardedVideoAd precedente

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

L'API RewardedVideoAd legacy viene rimossa nella versione 20.0.0 dell'SDK.

Ritiro dei banner intelligenti a favore dei banner adattivi

Gli annunci banner intelligenti sono stati ritirati a favore degli annunci banner adattivi. I banner adattivi offrono un rendimento superiore e una maggiore flessibilità nell'impostazione della larghezza degli annunci. Se preferisci continuare a utilizzare i banner a larghezza intera, puoi farlo utilizzando il banner adattivo, come mostrato nello snippet di codice seguente:

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

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

Leave application callback removal

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

Tieni presente che il callback onAdLeftApplication non è mai stato concepito per essere un gestore dei clic sugli annunci e l'utilizzo di 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 clic.

Ridenominazioni dei corsi

La tabella seguente elenca i nomi delle classi specifici che sono stati modificati o rimossi:

• La maggior parte delle classi relative a UnifiedNativeAd è stata rinominata in NativeAd.
• Le classi e le visualizzazioni MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd e InstreamAd sono state rimosse.
• Tutte le classi con il prefisso Publisher sono state sostituite con un prefisso AdManager.
• Il nome del pacchetto InterstitialAd è cambiato.

Metodi rimossi/sostituiti

La tabella seguente elenca le modifiche specifiche della versione 20.0.0:

• 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 RewardedAd e InterstitialAd sono state aggiornate per essere in linea con tutti i formati a schermo intero.
• Le funzionalità del correlatore sono state rimosse.