Segmenter les données d'annonces avec des emplacements

Sélectionnez une plate-forme : Android (bêta) Nouveau Android iOS

Pour segmenter les données de vos rapports sur les performances des 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 et comment afficher un rapport sur les performances des annonces.

Prérequis

Avant de continuer, procédez comme suit :

  • Terminez la configuration Google Mobile Ads SDK.
  • Avoir la version 24.5.0 ou ultérieure de Google Mobile Ads SDK
  • 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 de performances de votre annonce, vous devez définir 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 de l'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)
      }
    },
  )
}

AdPlacementsSnippets.kt

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());
        }
      });
}

AdPlacementsSnippets.java

Remplacez les valeurs suivantes :

  • AD_UNIT_ID par l'ID de votre bloc d'annonces.
  • PLACEMENT_ID par votre ID d'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(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Annonces plein écran

Pour les formats d'annonces 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)
}

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

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)
}

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Afficher le rapport sur les emplacements

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