Per discutere e fornire feedback sui nostri prodotti, unisciti al canale Discord ufficiale di Ad Manager nel server della community di Google Advertising and Measurement.

Questa pagina è stata tradotta dall'API Cloud Translation.

Metadati degli annunci

Seleziona la piattaforma:Android iOS

Questa guida è destinata ai publisher che integrano i metadati degli annunci con l'SDK Google Mobile Ads per Android.

Prerequisiti

Versione minima 17.0.0 dell'SDK Google Mobile Ads.
Completa i passaggi descritti in Video con premio.

Recupero dei metadati degli annunci

Per saperne di più sugli annunci pubblicati, ascolta le modifiche ai metadati degli annunci negli annunci video con premio.

onAdMetadataChanged() viene chiamato subito dopo il caricamento di un annuncio o quando i relativi metadati cambiano in modo asincrono dopo il caricamento. Non è garantito che i metadati di un annuncio siano disponibili al momento del caricamento dell'annuncio, pertanto ti consigliamo di attendere questo callback prima di accedere ai metadati di un annuncio.

Ecco un esempio di codice che mostra come recuperare i metadati dell'annuncio:

Java

RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        mRewardedAd = rewardedAd;
        rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
          @Override
          public void onAdMetadataChanged() {
            Bundle metadata = rewardedAd.getAdMetadata();
            String adId = metadata.getString("AdId");
          }
        });
      }
    });

Kotlin

RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(),
                    object : RewardedAdLoadCallback() {
      override fun onAdLoaded(rewardedAd: RewardedAd) {
        mRewardedAd = rewardedAd
        rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
          val metadata = rewardedAd.adMetadata
          val adId = metadata.getString("AdId")
        }
      }
    })

Dopo aver recuperato i metadati, puoi controllare il bundle per le chiavi che ti interessano. Diversi tipi di annunci possono avere associate chiavi di metadati degli annunci diverse. Gli annunci video VAST hanno le seguenti chiavi:

`Key`	Tipo	Descrizione
`AdId`	Stringa	L'ID dell'annuncio, vuoto se non disponibile.
`AdTitle`	Stringa	Il titolo, vuoto se non specificato.
`CreativeDurationMs`	Numero intero	La durata della creatività selezionata in millisecondi, -1 se non lineare.
`TraffickingParameters`	Stringa	Parametri di trafficking, vuoti se non disponibili.
`DealId`	Stringa	Il primo ID deal presente nella catena di wrapper per l'annuncio corrente, a partire dall'alto. Vuoto se non disponibile.
`AdSystem`	Stringa	L'ad server di origine dell'annuncio, vuoto se non disponibile.
`CreativeId`	Stringa	L'ID della creatività selezionata per l'annuncio, vuoto se non disponibile.
`MediaURL`	Stringa	L'URL del media selezionato.
`Wrappers`	Array	L'array viene compilato con elementi a partire dall'annuncio wrapper più interno (vicino all'annuncio in linea) fino all'annuncio wrapper più esterno. Ogni elemento dell'array è un dizionario che contiene le seguenti chiavi e valori. `AdId` Stringa. ID annuncio utilizzato per l'annuncio wrapper, vuoto se non disponibile. `AdSystem` Stringa. Sistema pubblicitario utilizzato per l'annuncio wrapper, vuoto se non disponibile. `CreativeId` Stringa. ID creatività utilizzato per l'annuncio wrapper, vuoto se non disponibile.