Charger une seule annonce à l'ouverture d'une application

Les annonces à l'ouverture d'application sont un format d'annonce spécial destiné aux éditeurs qui souhaitent monétiser les écrans de chargement de leur application. Les annonces à l'ouverture d'une application peuvent être fermées à tout moment. Elles sont conçues pour s'afficher lorsque vos utilisateurs mettent votre application au premier plan.

Ce guide explique comment intégrer des annonces à l'ouverture dans une application Android.

Prérequis

Configurer GMA Next-Gen SDK

Toujours effectuer des tests avec des annonces tests

Lorsque vous créez et testez vos applications, assurez-vous d'utiliser des annonces tests plutôt que des annonces de production. Sinon, votre compte pourrait être suspendu.

Pour charger des annonces tests, utilisez l'ID de bloc d'annonces test dédié aux annonces à l'ouverture d'application Android :

/21775744923/example/app-open

Cet ID de bloc d'annonces a été spécialement configuré pour renvoyer des annonces test à chaque demande. Vous pouvez l'utiliser librement dans vos propres applications lors du codage, des tests et du débogage. Veillez à le remplacer par votre propre ID de bloc d'annonces avant de publier votre application.

Pour en savoir plus sur les annonces tests GMA Next-Gen SDK, consultez Activer les annonces tests.

Charger une annonce

L'exemple suivant montre comment charger une seule annonce :

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

Lors des tests, utilisez l'ID du bloc d'annonces de test : /21775744923/example/app-open.

Diffuser l'annonce

Pour afficher une annonce à l'ouverture d'une application, utilisez la méthode show.

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

Écouter les événements publicitaires

Avant de diffuser l'annonce, écoutez les événements de cycle de vie des annonces :

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

Démarrages à froid et écrans de chargement

Un démarrage à froid se produit lorsque votre application se lance à partir de zéro, par exemple lorsqu'un utilisateur ouvre votre application pour la première fois ou après l'arrêt de la mémoire. Lors d'un démarrage à froid, vous ne disposez pas d'annonce à l'ouverture d'une application précédemment chargée et prête à être diffusée immédiatement.

En raison des délais de demande d'annonces, les utilisateurs peuvent interagir avec votre application avant qu'une annonce à l'ouverture ne s'affiche. Pour éviter une mauvaise expérience utilisateur, n'affichez les annonces à l'ouverture d'application lors d'un démarrage à froid qu'à partir d'un écran de chargement pendant le chargement des éléments de l'application. Si le chargement des composants est terminé et que l'utilisateur accède au contenu principal avant le chargement de l'annonce, ne l'affichez pas.

Chargez les éléments de l'application sur un thread d'arrière-plan afin que le chargement se poursuive pendant l'affichage de l'annonce.

Bonnes pratiques

Suivez ces bonnes pratiques pour les annonces à l'ouverture d'une application :

• Attendez qu'un utilisateur ait ouvert votre application plusieurs fois avant de diffuser votre première annonce à l'ouverture.
• Ne diffusez des annonces à l'ouverture de votre application que pendant que les utilisateurs attendent le chargement de votre application.
• Si votre écran de chargement finit de charger pendant que l'annonce est diffusée, fermez-le dans la méthode de rappel de fermeture de l'annonce.