Questa pagina è stata tradotta dall'API Cloud Translation.

Annunci companion

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

Prerequisiti

un'applicazione Android con l'SDK IMA integrato. Consulta BasicExample se non hai ancora un'app con l'SDK integrato.
Un tag annuncio configurato per restituire un annuncio companion.
- Se hai bisogno di un esempio, consulta le nostre Domande frequenti.

Istruzioni utili

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

Aggiungi annunci companion alla tua app

Crea un gruppo di visualizzazioni per visualizzare il companion

Prima di richiedere un companion, devi creare uno spazio nel layout. Nel file XML di layout, aggiungi un elemento ViewGroup. In questo esempio viene utilizzato un elemento LinearLayout. In un passaggio successivo passerai un riferimento a questo elemento a AdDisplayContainer. Se esegui l'integrazione nell'app BasicExample, aggiungila a activity_my.xml sotto com.google.android.exoplayer2.ui.PlayerView.

activity_my.xml

<LinearLayout
  android:id="@+id/companionAdSlot"
  android:layout_width="match_parent"
  android:layout_height="250dp"
  android:layout_gravity="center_horizontal"
  android:gravity="center"
  android:orientation="vertical"
  android:textAlignment="center" />

Crea un'area annuncio companion

Il passaggio successivo consiste nel creare un oggetto CompanionAdSlot, che viene aggiunto a un ArrayList<CompanionAdSlot>. AdDisplayContainer crea un elenco di aree annuncio companion per consentirti di visualizzare più annunci companion contemporaneamente. Dovrai creare un'istanza di ImaSdkFactory per creare CompanionAdSlot.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

Crea un'area annuncio companion per ogni dimensione dell'annuncio companion che intendi mostrare nella tua app. L'SDK IMA completa l'area annuncio companion con eventuali 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. Dopo aver creato companionAdSlots, devono essere aggiunti a AdsLoader. I seguenti esempi mostrano come eseguire questa operazione a seconda che utilizzi l'IMA Android BasicExample, che usa l'estensione Exoplayer-IMA, oppure altre implementazioni IMA che non utilizzano l'estensione.

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

Altre implementazioni

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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 di seguito 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 Android per creare companion flessibili

Per dichiarare un'area companion flessibile, aggiorna il metodo CompanionAdSlot.setSize() in modo da utilizzare CompanionAdSlot.FLUID_SIZE come entrambi i parametri.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

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 uguali a quelle trasferite nell'oggetto CompanionAdSlot.
Che aspetto avrà la mia area annuncio companion quando seguo questa guida?: L'immagine seguente è stata creata da BasicExample e presenta il video di contenuti in alto con l'annuncio companion riportato di seguito.