Migration du SDK

Cette page concerne les migrations pour les versions actuelles et antérieures.

Passer de la version 22 à la version 23

Le niveau d'API Android minimal est 21

À partir de la version 23.0.0, le SDK Google Mobile Ads nécessite que toutes les applications sur un niveau d'API Android minimal 21. Pour ajuster le niveau d'API, modifiez la valeur de minSdkVersion dans votre fichier build.gradle au niveau de l'application sur 21 ou plus.

Méthodes obsolètes supprimées/remplacées

Passer de la version 21 à la version 22

Utiliser MobileAds.getVersion() pour obtenir la version du SDK Google Mobile Ads

Suppression de la méthode MobileAds.getVersionString() dans la version 22.0.0 au profit de de MobileAds.getVersion()

La nouvelle méthode renvoie le numéro de version externe attendu (par exemple, 22.0.0 Pour plus d'informations sur ce changement, consultez l'article Utiliser la nouvelle version de Google Mobile SDK Ads getVersion() méthode.

Méthodes supprimées ou remplacées

Le tableau ci-dessous liste les modifications spécifiques apportées à la version 22.0.0.

Passer de la version 20 à la version 21

Mettre à jour minSdkVersion vers la version 19 ou ultérieure

À partir de la version 21.0.0, le SDK Google Mobile Ads nécessite que toutes les applications soient sur un niveau d'API Android minimal 19. Pour ajuster le niveau d'API, modifiez la valeur de minSdkVersion dans le fichier de compilation de votre application sur 19 ou plus.

Appliquer la possibilité de valeur nulle stricte

En vue de l'application de la possibilité de valeur nulle stricte, les annotations @NonNull sont ajouté à toutes les API qui ne définissaient pas explicitement la possibilité de valeur nulle.

Cette modification peut endommager les applications Kotlin et celles qui utilisent la vérification des valeurs nulles Java. s'il existe des violations de sécurité nulle et qu'elles n'ont pas été traitées auparavant les valeurs null de manière sécurisée (consultez la documentation Kotlin sur Sécurité nulle ).

Suppression de la méthode addNetworkExtras()

La méthode addNetworkExtras() qui transmet des paramètres supplémentaires en tant que L'instance NetworkExtras vers un adaptateur de réseau publicitaire spécifique a été abandonnée dans le SDK version 20.3.0 et seront supprimées dans la version 21.0.0. Utilisez les addNetworkExtrasBundle() de la même classe AdRequest.Builder.

Suppression des méthodes de localisation

Les méthodes de localisation suivantes seront supprimées dans la version 21.0.0:

• La méthode setLocation(Location location) de la classe AdRequest.Builder qui définit la position de l'utilisateur pour le ciblage de la médiation.
• La méthode getLocation() de la classe AdRequest qui renvoie l'ID de l'utilisateur informations de ciblage géographique précédemment transmises à la méthode setLocation(Location location).
• La méthode getLocation() de la classe MediationAdConfiguration qui renvoie la position géographique de l'utilisateur, si elle est définie par AdRequest.

Les données de localisation ne sont pas utilisées par Google pour cibler des annonces. Vous devez utiliser des API tierces afin de fournir les informations aux réseaux publicitaires tiers si obligatoire.

Abandon des interfaces d'événements personnalisés

Les événements personnalisés permettent aux éditeurs Médiation AdMob pour configurer une source d'annonces participant à la cascade d'annonces dans l'une des valeurs suivantes : AdMob sources d'annonces compatibles.

Toutes les requêtes personnalisées événement sont obsolètes au profit du Adapter classe et MediationAdLoadCallback de commande.

Le tableau ci-dessous liste la classe ou l'interface correspondante à utiliser. Pour chaque interface d'événement personnalisé à partir de la version 21.0.0:

Passer de la version 19 à la version 20

La version 20.0.0 comporte de nombreuses modifications destructives. Version 19.7.0 introduite Nombreuses nouvelles API, et obsolète ou renommé de nombreuses classes en vue de la création d'une version 20.0.0. Ce guide présente les principaux changements intervenus dans la version 20.0.0.

Mises à jour de l'API pour le format plein écran

À partir de la version 20.0.0, les interstitiels, les annonces avec récompense, les interstitiels avec récompense et Les formats d'annonces à l'ouverture d'une application sont standardisés afin de respecter une conception d'API cohérente.

Toutes les API de format plein écran utilisent les principes suivants:

• Une méthode de chargement statique
• Un mécanisme de gestionnaire ou de rappel de chargement similaire
• Utilisation des FullScreenContentCallback pour les rappels de présentation

Suppression de l'ancienne API RécompenseVideoAd

Les plus récents RewardedAd L'API a été introduite en mars 2019 et a été l'API privilégiée depuis plus de 18 mois. Elle a fait l'objet de plus d'améliorations par rapport à la version précédente L'API RewardedVideoAd, qui permet de charger plusieurs annonces avec récompense à la fois.

L'ancienne API RewardedVideoAd a été supprimée de la version 20.0.0 du SDK.

Abandon des bannières intelligentes au profit des bannières adaptatives

Les bannières intelligentes sont obsolètes en faveur des bannières adaptatives annonces. Les bannières adaptatives offrent des performances supérieures et davantage de flexibilité pour définir la largeur de l'annonce. Si vous préférez continuer à utiliser des bannières pleine largeur, vous pouvez utiliser une bannière adaptative, comme illustré dans l'extrait de code suivant:

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

Quitter la suppression du rappel d'application

Le rappel onAdLeftApplication a été supprimé pour tous les formats d'annonces et a été remplacé par de ProcessLifecycleOwner L'utilisation d'une API au niveau du système d'exploitation vous avertit chaque fois qu'un utilisateur quitte votre application, quel que soit qu'elle soit due ou non à une interaction avec une annonce.

Notez que le rappel onAdLeftApplication n'a jamais été destiné à être une annonce sur le gestionnaire de clics, et l'utilisation de ce rappel pour signaler les clics n'a généré aucune une métrique précise. Par exemple, un clic sur l'icône "Choisir sa pub" un navigateur externe a appelé le rappel, mais n'a pas été comptabilisé comme un clic.

Modification du nom des cours

Le tableau ci-dessous liste les noms de classes spécifiques qui ont été modifiés ou supprimés. En résumé :

• La plupart des classes associées à UnifiedNativeAd ont été renommées NativeAd.
• Les MobileAds.Settings, NativeExpressAdView et NativeAppInstallAd Les classes et les vues NativeContentAd et InstreamAd ont été supprimées.
• Toutes les classes avec le préfixe Publisher ont été remplacées par un Préfixe AdManager.
• Le nom du package InterstitialAd a changé.

Méthodes supprimées/remplacées

Le tableau ci-dessous liste les modifications spécifiques apportées à la version 20.0.0. En résumé :

• Les méthodes d'initialisation obsolètes ont été supprimées de la classe MobileAds.
• Certaines méthodes de la classe AdRequest.Builder() ont été supprimées ou déplacée vers la classe RequestConfiguration.
• Les API RewardAd et InterstitielAd ont été mises à jour pour correspondre les formats plein écran.
• Les fonctionnalités de corrélateur ont été supprimées.