Segmenter les données d'annonces avec des emplacements

Sélectionnez une plate-forme : Android iOS Android (ancienne version)

Pour segmenter les données de rapport sur les performances de vos annonces, utilisez la fonctionnalité d'emplacements d'annonce. Les emplacements vous permettent de segmenter les données d'impression dans un rapport sans avoir besoin de blocs d'annonces supplémentaires. Pour utiliser la fonctionnalité d'emplacements, vous avez besoin d'un ID d'emplacement. Pour en savoir plus sur les emplacements, consultez À propos des emplacements.

Ce guide explique comment définir un ID d'emplacement dans GMA Next-Gen SDK et comment afficher un rapport sur les performances des annonces.

Prérequis

Avant de continuer, procédez comme suit :

  • Terminez la configuration GMA Next-Gen SDK.
  • Vous devez disposer de la version GMA Next-Gen SDK ou ultérieure.
  • Accédez à la fonctionnalité d'ID d'emplacement. Pour demander l'accès, contactez votre responsable de compte.
  • Créez un ID d'emplacement pour votre application.

Définir un ID d'emplacement

Pour segmenter les données sur les performances de votre annonce, vous pouvez définir un ID d'emplacement de l'une des manières suivantes :

  • Lors du chargement de l'annonce.
  • avant d'afficher l'annonce.

Vous pouvez modifier l'ID de l'emplacement si nécessaire. Lorsque GMA Next-Gen SDK enregistre une impression d'annonce, il utilise le dernier ID d'emplacement défini.

Définir un ID d'emplacement au moment du chargement

Cette section explique comment définir un ID d'emplacement au moment du chargement. Ce workflow s'applique à tous les formats d'annonces.

L'exemple suivant définit un ID d'emplacement pour une annonce interstitielle au moment du chargement :

Kotlin

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

Java

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

Remplacez les valeurs suivantes :

  • AD_UNIT_ID par l'ID de votre bloc d'annonces.
  • PLACEMENT_ID par l'ID de votre emplacement.

Définir l'ID d'emplacement au moment de la diffusion

Cette section explique comment définir un ID d'emplacement au moment de la diffusion pour tous les formats d'annonces. Sélectionnez les formats d'annonces de votre choix dans les sections suivantes :

Pour les bannières publicitaires, vous définissez l'ID d'emplacement avant de placer la vue d'annonce dans la hiérarchie des vues. L'exemple suivant définit un ID d'emplacement pour une bannière publicitaire au moment de l'affichage :

Kotlin

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

Java

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

Annonces plein écran

Pour les formats d'annonces en plein écran, vous définissez l'ID d'emplacement avant d'afficher une annonce. Ce workflow s'applique aux formats suivants :

L'exemple suivant définit l'ID d'emplacement d'une annonce interstitielle au moment de l'affichage :

Kotlin

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

Java

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

Annonces natives

Pour les annonces natives, vous définissez l'ID d'emplacement après avoir chargé une annonce native et avant d'enregistrer l'annonce dans la vue d'annonce.

L'exemple suivant définit un ID d'emplacement pour une annonce native au moment de l'affichage :

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}

Java

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}

Afficher le rapport sur les emplacements

Une fois l'ID d'emplacement défini, vous verrez un rapport sur la dimension de l'ID d'emplacement dans l'interface utilisateur AdMob. Pour afficher le rapport, consultez Afficher vos emplacements.