Segmenter les données d'annonces avec des emplacements

Sélectionnez une plate-forme : Android Nouveau Android iOS

Pour segmenter les données des rapports sur les performances de vos annonces, utilisez la fonctionnalité "Emplacements d'annonces". Les emplacements vous permettent de segmenter les données sur les 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 Google Mobile Ads SDK et afficher un rapport sur les performances des annonces.

Prérequis

Avant de continuer, procédez comme suit :

  • Terminez la configuration Google Mobile Ads SDK.
  • Utilisez la version Google Mobile Ads SDK 24.5.0 ou 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, définissez 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 Google Mobile Ads 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(context: Context) {
  val adRequest = AdRequest.Builder().setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    context,
    "AD_UNIT_ID",
    adRequest,
    object : InterstitialAdLoadCallback() {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

Java 

public void loadInterstitial(Context context) {
  AdRequest adRequest = new AdRequest.Builder().setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      context,
      "AD_UNIT_ID",
      adRequest,
      new InterstitialAdLoadCallback() {
        @Override
        public void onAdLoaded(@NonNull 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 d'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(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

Java 

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

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 showInterstitial(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 de l'enregistrer dans la vue d'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) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.setNativeAd(nativeAd)
}

Java 

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

Afficher le rapport sur les emplacements

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