Anúncios complementares

Este guia é destinado a editores interessados em adicionar anúncios complementares à implementação do IMA para iOS.

Pré-requisitos

  • Aplicativo iOS com o SDK do IMA integrado.
  • Uma tag de anúncio configurada para retornar um anúncio complementar.

Carimbos úteis

Se você ainda precisar implementar o SDK do IMA no seu aplicativo, confira nosso Guia explicativo.

Adicionar anúncios complementares ao seu app

Criar uma UIView para o complementar

Antes de solicitar um complementar, é preciso criar um espaço para ele no layout. No storyboard, arraste e solte uma visualização no ViewController e dimensione-a para o anúncio complementar. Em seguida, verifique se o espaço complementar está vinculado a uma variável na sua implementação (esse exemplo usa uma variável chamada companionView). Na captura de tela abaixo, a visualização em cinza claro é a visualização do anúncio complementar:

Imagem da criação de uma UIView para o complementar.

Criar um IMACompanionAdSlot

A próxima etapa é criar um objeto IMACompanionAdSlot de sua visualização. O SDK do IMA preenche o espaço do anúncio complementar com todos os complementares da resposta VAST que têm dimensões correspondentes à altura e à largura da visualização. O SDK do IMA também é compatível com o uso de complementares de tamanho flexível.

ViewController.h 
@property(nonatomic, weak) IBOutlet UIView *companionView;
ViewController.m 
self.companionSlot =
    [[IMACompanionAdSlot alloc] initWithView:self.companionView
                                       width:self.companionView.frame.size.width
                                      height:self.companionView.frame.size.height];

Transmitir o espaço do anúncio complementar para o contêiner do anúncio

Por fim, é necessário informar ao SDK que esse espaço complementar existe transmitindo uma matriz dos espaços complementares para o construtor IMAAdDisplayContainer:

ViewController.m 
return [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                           viewController:self
                                           companionSlots:@[ self.companionSlot ]];

Isso é tudo! Agora seu aplicativo está exibindo anúncios complementares.

Exibir anúncios complementares flexíveis

O IMA agora é compatível com anúncios complementares flexíveis. Os anúncios complementares podem ser redimensionados para corresponder ao tamanho do espaço do anúncio. Eles preenchem 100% da largura da visualização mãe e, em seguida, redimensionam a altura para se ajustarem ao conteúdo do complementar. Eles são definidos usando o tamanho complementar Fluid no Ad Manager. Consulte a imagem a seguir para saber onde definir esse valor.

Imagem mostrando as configurações de anúncios complementares do Ad Manager. Destaca a opção de tamanhos de complementares.

Atualizar apps iOS para complementares flexíveis

É possível declarar um espaço complementar fluido iniciando IMACompanionAdSlot somente com o parâmetro view, excluindo width e height.

ViewController.m 
self.companionSlot =
      [[IMACompanionAdSlot alloc] initWithView:self.companionView];

Perguntas frequentes

Segui o guia, mas não estou vendo anúncios complementares. O que devo fazer?
Primeiro, verifique se a tag realmente está retornando complementares. Para isso, abra a tag em um navegador da Web e procure uma tag CompanionAds. Se você vir isso, verifique se o tamanho do complementar retornado tem o mesmo tamanho da UIView em que está tentando exibi-lo.