Segmenter les données d'annonces avec des emplacements

Sélectionnez la plate-forme : Android Dernière sélection Android iOS

Pour segmenter les données de rapport sur les performances de vos annonces, utilisez la fonctionnalité "Emplacements d'annonces". Les emplacements vous permettent de segmenter les données d'impressions dans un rapport sans avoir besoin de blocs d'annonces supplémentaires. Pour utiliser la fonctionnalité "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.
  • Utilisez la version GMA Next-Gen SDK ou une version ultérieure.
  • Obtenez l'accès à 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 la diffusion de l'annonce

Vous pouvez modifier l'ID d'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 votre ID d'emplacement

Définir un 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, vous définissez l'ID d'emplacement avant de placer la vue de l'annonce dans la hiérarchie des vues. L'exemple suivant définit un ID d'emplacement pour une bannière au moment de la diffusion :

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 de diffuser une annonce. Ce workflow s'applique aux formats suivants :

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

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 de l'annonce.

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

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 que vous avez défini l'ID d'emplacement, un rapport sur la dimension de l'ID d'emplacement s'affiche dans l'interface utilisateur AdMob. Pour afficher le rapport, consultez Afficher vos emplacements.