Annunci companion

Questa guida è rivolta ai publisher interessati ad aggiungere annunci companion all'implementazione IMA per iOS.

Prerequisiti

  • Applicazione iOS con SDK IMA integrato.
  • Un tag annuncio configurato per restituire un annuncio companion.

Istruzioni utili

Se devi ancora implementare l'SDK IMA nella tua app, consulta la nostra Guida introduttiva.

Aggiungi annunci companion alla tua app

Crea una UIView per l'asset companion

Prima di richiedere un companion, devi creare uno spazio nel tuo layout. Nello storyboard, trascina una visualizzazione sul ViewController e ridimensionala in base all'annuncio companion. Poi, assicurati che la tua area companion sia associata a una variabile nella tua implementazione (in questo esempio viene utilizzata una variabile denominata companionView). Nel seguente screenshot, la visualizzazione grigio chiaro è la visualizzazione dell'annuncio companion:

Immagine della creazione di una UIView per la creatività companion.

Crea un IMACompanionAdSlot

Il passaggio successivo consiste nel creare un oggetto IMACompanionAdSlot dalla tua visualizzazione. L'SDK IMA completa l'area annuncio companion con tutte le creatività companion provenienti dalla risposta VAST con dimensioni corrispondenti all'altezza e alla larghezza della visualizzazione. L'SDK IMA supporta inoltre l'utilizzo di compagni con dimensioni flessibili.

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];

Trasmetti l'area annuncio companion al contenitore dell'annuncio

Infine, devi comunicare all'SDK che questa area companion esiste passando un array di aree annuncio companion al costruttore IMAAdDisplayContainer:

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

E con questo è tutto! La tua applicazione ora mostra annunci companion.

Mostra annunci companion flessibili

Ora IMA supporta gli annunci companion flessibili. Questi annunci companion possono essere ridimensionati per adattarsi alle dimensioni dell'area annuncio. Riempiono il 100% della larghezza della vista principale, poi ridimensionano la propria altezza per adattarsi ai contenuti dell'annuncio companion. Vengono impostate utilizzando la dimensione companion Fluid in Ad Manager. Vedi l'immagine seguente per sapere dove impostare questo valore.

Immagine che mostra le impostazioni degli annunci companion di Ad Manager. Evidenzia l'opzione relativa alle dimensioni companion.

Aggiorna le app per iOS per creare companion flessibili

Per dichiarare un'area companion flessibile, avvia IMACompanionAdSlot solo con il parametro view, escludendo width e height.

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

Domande frequenti

Ho seguito la guida, ma non visualizzo annunci companion. Che cosa devo fare?
Innanzitutto, verifica che il tuo tag restituisca davvero delle creatività companion. Per farlo, apri il tag in un browser web e cerca un tag CompanionAds. In questo caso, verifica che le dimensioni dell'annuncio companion restituito siano delle stesse dimensioni dell'elemento UIView in cui stai tentando di visualizzarlo.