Segmentare i dati pubblicitari con i posizionamenti

Seleziona la piattaforma: Android (beta) New-selected Android iOS

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, è necessario 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.
  • Accedere alla funzionalità ID posizionamento. Per richiedere l'accesso, contatta il tuo account manager.
  • Crea un ID posizionamento per la tua app.

Impostare 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 descrive l'impostazione di 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() {
  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)
      }
    },
  )
}

AdPlacementsSnippets.kt

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

AdPlacementsSnippets.java

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 dell'annuncio. Seleziona i formati degli annunci che preferisci dalle seguenti sezioni:

Per gli annunci banner, imposti l'ID posizionamento prima di inserire la visualizzazione dell'annuncio nella gerarchia delle visualizzazioni. 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))
}

AdPlacementsSnippets.kt

Java 

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

AdPlacementsSnippets.java

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Annunci nativi

Per gli annunci nativi, imposta l'ID posizionamento dopo aver caricato un annuncio nativo e prima di registrare l'annuncio nella visualizzazione 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)
}

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Visualizzare il report sui posizionamenti

Dopo aver impostato l'ID posizionamento, viene visualizzato un report della dimensione ID posizionamento nell'interfaccia utente di AdMob. Per visualizzare il report, segui le istruzioni riportate in Visualizzare i posizionamenti.