Metadados do anúncio

Selecionar plataforma: Android Novo Android iOS

Este guia é destinado aos publishers que integram metadados de anúncios com Google Mobile Ads SDK para iOS.

Pré-requisitos

Como buscar metadados de anúncios

Para que um app saiba mais sobre os anúncios veiculados, defina o anúncio como o próprio GADAdMetadataDelegate. Em seguida, implemente o método adMetadataDidChange: em GADAdMetadataDelegate para detectar mudanças nos metadados do anúncio. Depois que esse delegado for chamado, verifique a propriedade adMetadata no anúncio.

adMetadataDidChange: é chamado logo após o carregamento de um anúncio ou quando os metadados dele mudam de forma assíncrona após o carregamento. Não há garantia de que os metadados do anúncio estejam disponíveis no tempo de carregamento. Por isso, recomendamos aguardar esse callback antes de acessar os metadados de um anúncio.

Confira um exemplo de código que mostra como recuperar os metadados de um anúncio premiado:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [GAMRequest 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"];
}

Depois de recuperar os metadados, você pode verificar o pacote em busca das chaves que interessam. Diferentes tipos de anúncios podem ter chaves de metadados diferentes associadas a eles. Os anúncios em vídeo VAST têm as seguintes chaves:

Chave Tipo Descrição
AdId String O ID do anúncio ou a string vazia, se não estiver disponível.
AdTitle String O título, vazio se não for especificado.
CreativeDurationMs Número inteiro A duração do criativo selecionado em milissegundos, -1 se não for linear.
TraffickingParameters String Parâmetros de tráfego ou a string vazia, se não estiver disponível.
DealId String O primeiro ID da transação presente na cadeia de wrapper do anúncio atual, começando pela parte de cima, ou a string vazia, se essas informações não estiverem disponíveis.
AdSystem String O servidor de anúncios de origem do anúncio, vazio se não estiver disponível.
CreativeId String O ID do criativo selecionado para o anúncio, vazio se não estiver disponível.
MediaURL String O URL da mídia selecionada.
Wrappers Matriz A matriz é preenchida com elementos que começam no anúncio de wrapper mais interno (próximo ao anúncio inline) e se movem para fora até o anúncio de wrapper mais externo. Cada elemento na matriz é um dicionário que contém as seguintes chaves e valores.
AdId
String. ID do anúncio usado para o anúncio de wrapper, vazio se não estiver disponível.
AdSystem
String. Sistema de anúncios usado para o anúncio de wrapper, vazio se não estiver disponível.
CreativeId
String. ID do criativo usado para o anúncio de wrapper, vazio se não estiver disponível.