Metadatos de anuncios

Esta guía está destinada a los editores que integran metadatos de anuncios con el SDK de iOS para anuncios de Google para dispositivos móviles.

Requisitos previos

Obteniendo metadatos de anuncios

Para que una app obtenga más información sobre los anuncios que se publican, configura el anuncio de modo que tenga su propio GADAdMetadataDelegate. Luego, puedes detectar cambios en los metadatos de los anuncios mediante la implementación del método adMetadataDidChange: en GADAdMetadataDelegate. Una vez que se llame a este delegado, verifica la propiedad adMetadata en el anuncio.

Se llama a adMetadataDidChange: justo después de que se carga un anuncio o cuando los metadatos de un anuncio cambian de manera asíncrona después de que se carga. No se garantiza que los metadatos de los anuncios estén disponibles en el momento de la carga, por lo que recomendamos esperar esta devolución de llamada antes de acceder a los metadatos de un anuncio.

A continuación, se muestra un ejemplo de código que muestra cómo recuperar los metadatos de un anuncio recompensado:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

Después de recuperar los metadatos, puedes verificar el Bundle para las claves que te interesan. Los diferentes tipos de anuncios pueden tener diferentes claves de metadatos de anuncios asociadas a ellos. Los anuncios de video de VAST tienen las siguientes claves:

Clave Tipo Descripción
AdId Cadena Es el ID del anuncio o la string vacía si no está disponible.
AdTitle Cadena Título, vacío si no se especifica.
CreativeDurationMs Número entero La duración de la creatividad seleccionada en milisegundos; -1 si no es lineal.
TraffickingParameters Cadena Parámetros de coordinación de anuncios o la string vacía si no está disponible
DealId Cadena Es el primer ID de acuerdo presente en la cadena de wrapper para el anuncio actual, comenzando desde la parte superior o en la cadena vacía si esta información no está disponible.
AdSystem Cadena Es el servidor de anuncios fuente del anuncio. Este campo estará vacío si no está disponible.
CreativeId Cadena El ID de la creatividad seleccionada para el anuncio (vacío si no está disponible).
MediaURL Cadena La URL del contenido multimedia seleccionado
Wrappers Array El array se propaga con elementos que comienzan en el anuncio wrapper interno (cerca del anuncio intercalado) y se mueven hacia afuera, hasta el anuncio wrapper más externo. Cada elemento del array es un diccionario que contiene las siguientes claves y valores.
AdId
String. ID de anuncio utilizado para el anuncio de wrapper; vacío si no está disponible.
AdSystem
String. Sistema de anuncios utilizado para el anuncio wrapper; estará vacío si no está disponible.
CreativeId
String. ID de creatividad utilizado para el anuncio de envoltorio; vacío si no está disponible