Segmenter les données d'annonces avec des emplacements

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 Google Mobile Ads SDK (Legacy) et afficher un rapport sur les performances des annonces.

Prérequis

Avant de continuer, procédez comme suit :

  • Configurez Google Mobile Ads SDK (Legacy).
  • Disposer de la version 24.5.0 ou ultérieure de Google Mobile Ads SDK (Legacy).
  • Accédez à la fonctionnalité d'ID de lieu. 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 de diffuser l'annonce.

Vous pouvez modifier l'ID d'emplacement si nécessaire. Lorsque Google Mobile Ads SDK (Legacy) 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. Cette procédure 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 l'ID de votre emplacement.

Définir l'ID d'emplacement au moment de l'affichage

Cette section explique comment définir un ID d'emplacement au moment de l'affichage pour tous les formats d'annonces. Sélectionnez vos formats d'annonces préférés 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 l'affichage :

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 plein écran, vous devez définir 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 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 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 l'affichage :

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 l'ID d'emplacement défini, un rapport sur la dimension "ID d'emplacement" s'affiche dans l'interface utilisateur d'AdMob. Pour afficher le rapport, suivez les instructions de la section Afficher vos emplacements.