Metadati degli annunci

Questa guida è rivolta 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

Alcune app potrebbero voler sapere di più sugli annunci pubblicati. Puoi monitorare le modifiche ai metadati degli annunci video con premio chiamando RewardedVideoAd.setAdMetadataListener() con un'implementazione di AdMetadataListener. Una volta chiamato AdMetadataListener.onAdMetadataChanged(), puoi controllare RewardedVideo.getAdMetadata() per i metadati di un annuncio.

onAdMetadataChanged() viene chiamato subito dopo il caricamento di un annuncio o quando i suoi metadati vengono modificati in modo asincrono dopo il caricamento. Non è garantito che i metadati di un annuncio siano disponibili al momento del caricamento, pertanto 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 pacchetto per le chiavi che ti interessano. A diversi tipi di annunci possono essere 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 traffico, vuoti se non disponibili.
DealId Stringa Il primo ID deal presente nella catena di wrapper per l'annuncio corrente, a partire dall'alto. Se non disponibile, il valore è vuoto.
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 dei contenuti multimediali selezionati.
Wrappers Array L'array viene compilato con gli 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 in overlay, vuoto se non disponibile.
AdSystem
Stringa. Sistema pubblicitario utilizzato per l'annuncio incapsulato, vuoto se non disponibile.
CreativeId
Stringa. ID creatività utilizzato per l'annuncio con wrapper, vuoto se non disponibile.