Annunci companion

Questa guida è destinata ai publisher interessati ad aggiungere annunci companion alla propria implementazione IMA per iOS.

Prerequisiti

  • un'applicazione iOS con l'SDK IMA integrato.
  • Un tag annuncio configurato per restituire un annuncio companion.

Iniziative utili

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

Aggiungi annunci companion alla tua app

Creare una UIView per l'app companion

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

Immagine della creazione di una UIView per l'app companion.

Crea un'area annuncio IMACompanion

Il passaggio successivo consiste nel creare un oggetto IMACompanionAdSlot dalla tua vista. L'SDK IMA compila l'area annuncio companion con tutti i companion della risposta VAST avente dimensioni. che corrispondono all'altezza e alla larghezza della visualizzazione. L'SDK IMA supporta anche l'utilizzo annunci companion di 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];

Trasferimento dell'area annuncio companion al contenitore degli annunci

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

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

E con questo è tutto! Nella tua applicazione vengono ora visualizzati annunci companion.

Mostra annunci companion flessibili

IMA ora supporta gli annunci companion flessibili. Questi annunci companion possono essere ridimensionati per l'area annuncio. Riempino il 100% della larghezza della vista principale e poi ne ridimensionano l'altezza per adattarle ai contenuti 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. Mette in evidenza l'opzione Dimensioni companion.

Aggiorna le app per iOS per creare companion fluidi

Puoi dichiarare un'area companion flessibile avviando la IMACompanionAdSlot solo con il parametro view; esclusi 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?
Per prima cosa, verifica che il tag restituisca effettivamente creatività companion. Per farlo, apri il tag in un browser Web e cerca un tag CompanionAds. In questo caso, controlla che la dimensione della creatività companion restituita corrisponda alla dimensione della UIView in cui stai tentando di visualizzarla.