Segmentare i dati pubblicitari con i posizionamenti

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 bisogno di unità pubblicitarie aggiuntive. Per utilizzare la funzionalità dei posizionamenti, devi avere un ID posizionamento. Per maggiori dettagli sui posizionamenti, consulta Informazioni sui posizionamenti.

Questa guida illustra come impostare un ID posizionamento in Google Mobile Ads SDK (Legacy) e visualizzare un report sul rendimento degli annunci.

Prerequisiti

Prima di continuare, completa queste operazioni:

  • Completa la sezione Configura Google Mobile Ads SDK (Legacy).
  • Disporre della versione 24.5.0 o successive di Google Mobile Ads SDK (Legacy).
  • Accedi alla funzionalità ID luogo. Per richiederlo, contatta il tuo account manager.
  • Crea un ID posizionamento per la tua app.

Imposta un ID luogo

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 luogo in base alle tue esigenze. Quando Google Mobile Ads SDK (Legacy) registra un'impressione dell'annuncio, utilizza l'ID posizionamento impostato più di recente.

Imposta un ID luogo al momento del caricamento

Questa sezione illustra come impostare un ID posizionamento al momento del 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(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());
        }
      });
}

Sostituisci i seguenti valori:

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

Imposta l'ID luogo al momento della visualizzazione

Questa sezione illustra come impostare un ID posizionamento al momento della visualizzazione per tutti i formati degli annunci. Seleziona i formati degli annunci che preferisci dalle seguenti sezioni:

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

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

Annunci a schermo intero

Per i formati degli annunci a schermo intero, imposta l'ID posizionamento prima di mostrare un annuncio. Questo workflow 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 showInterstitial(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 registrarlo nella visualizzazione dell'annuncio.

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

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

Visualizza report sui posizionamenti

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