Anúncios complementares

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

Pré-requisitos

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

Guias úteis

Se você ainda precisa implementar o SDK do IMA no seu app, confira o Guia explicativo.

Adicionar anúncios complementares ao seu app

Criar um UIView para o companion

Antes de solicitar um complementar, é necessário criar um espaço para ele no layout. No storyboard, arraste e solte uma visualização no ViewController e dimensione-a para seu anúncio complementar. Em seguida, certifique-se de que o espaço do anúncio complementar esteja vinculado a uma variável em sua implementação (este 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 um UIView para o companion.

Criar um IMACompanionAdSlot

A próxima etapa é criar um objeto IMACompanionAdSlot a partir da sua visualização. O SDK do IMA preenche o espaço do anúncio complementar com os complementares da resposta VAST que têm dimensões correspondendo à altura e largura da visualização. O SDK do IMA também é compatível com o uso de companheiros 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];

Transmita o espaço do anúncio complementar para seu contêiner de anúncios

Por fim, é necessário informar ao SDK que esse slot complementar existe, transmitindo uma matriz dos slots complementares ao construtor IMAAdDisplayContainer:

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

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

Exibir anúncios complementares fluidos

Agora o IMA é compatível com anúncios complementares fluidos. Esses anúncios complementares podem ser redimensionados para corresponder ao tamanho do espaço de anúncio. Eles preenchem 100% da largura da visualização pai e depois redimensionam a altura para se ajustar à conteúdo de outro companheiro. Eles são definidos usando o tamanho de Fluid complementar 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 complementos fluidos

Você pode declarar um espaço de complementar fluido iniciando o IMACompanionAdSlot apenas com o parâmetro view. excluindo width e height.

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

Perguntas frequentes

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