Segmentare i dati pubblicitari con i posizionamenti

Seleziona la piattaforma: Android iOS Android (legacy)

Per segmentare i dati dei report sul rendimento degli annunci, utilizza la funzionalità dei posizionamenti degli annunci. I posizionamenti ti consentono di segmentare i dati sulle impressioni in un report senza la necessità di unità pubblicitarie aggiuntive. Per utilizzare la funzionalità dei posizionamenti, devi disporre di un ID posizionamento. Per informazioni dettagliate sui posizionamenti, vedi Informazioni sui posizionamenti.

Questa guida illustra come impostare un ID posizionamento in GMA Next-Gen SDK e visualizzare un report sul rendimento degli annunci.

Prerequisiti

Prima di continuare, completa queste operazioni:

  • Completa Configura GMA Next-Gen SDK.
  • Avere la versione GMA Next-Gen SDK o successive.
  • Accedi alla funzionalità ID posizionamento. Per richiedere l'accesso, contatta il tuo account manager.
  • Crea un ID posizionamento per la tua app.

Imposta un ID posizionamento

Per segmentare i dati sul rendimento dell'annuncio, imposta un ID posizionamento in uno dei seguenti modi:

  • Durante il caricamento dell'annuncio.
  • Prima di mostrare l'annuncio.

Puoi aggiornare l'ID posizionamento in base alle tue esigenze. Quando GMA Next-Gen SDK registra un'impressione dell'annuncio, utilizza l'ID posizionamento più recente.

Imposta un ID posizionamento al momento del caricamento

Questa sezione illustra l'impostazione di un ID posizionamento al tempo di caricamento. Questo flusso di lavoro si applica a tutti i formati degli annunci.

L'esempio seguente imposta un ID posizionamento per un annuncio interstitial al momento del caricamento:

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

Sostituisci i seguenti valori:

  • AD_UNIT_ID con l'ID unità pubblicitaria.
  • PLACEMENT_ID con l'ID posizionamento.

Impostare l'ID posizionamento al momento della pubblicazione

Questa sezione illustra l'impostazione di un ID posizionamento al momento della pubblicazione per tutti i formati degli annunci. Seleziona i formati degli annunci che preferisci nelle seguenti sezioni:

Per gli annunci banner, imposti l'ID posizionamento prima di inserire la visualizzazione di annuncio nella gerarchia di oggetti View. L'esempio seguente imposta un ID posizionamento per un annuncio banner al momento della pubblicazione:

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

Annunci a schermo intero

Per i formati degli annunci a schermo intero, imposti l'ID posizionamento prima di mostrare un annuncio. Questo flusso di lavoro si applica ai seguenti formati:

L'esempio seguente imposta l'ID posizionamento per un annuncio interstitial al momento della visualizzazione:

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

Annunci nativi

Per gli annunci nativi, imposta l'ID posizionamento dopo aver caricato un annuncio nativo e prima di registrare l'annuncio nella visualizzazione di annuncio.

L'esempio seguente imposta un ID posizionamento per un annuncio nativo al momento della pubblicazione:

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

Visualizza report sui posizionamenti

Dopo aver impostato l'ID posizionamento, visualizzi un report della dimensione ID posizionamento nella UI di AdMob. Per visualizzare il report, segui le istruzioni riportate in Visualizza i posizionamenti.