Aggiungere il supporto degli annunci companion

Seleziona la piattaforma: HTML5 Android iOS

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

Prerequisiti

• App per Android con l'SDK IMA integrato. Consulta BasicExample se non hai già un'app con l'SDK integrato. Se hai bisogno di aiuto per implementare l'SDK IMA nella tua app, consulta Configura l'SDK IMA.
• Un tag annuncio configurato per restituire un annuncio companion. Se hai bisogno di un esempio, consulta le nostre domande frequenti.

Aggiungi annunci companion alla tua app

Segui le istruzioni per aggiungere un'area annuncio companion e visualizzare gli annunci companion nella tua app.

Crea un ViewGroup per visualizzare la creatività companion

Prima di richiedere un annuncio companion, devi creare uno spazio per questo annuncio nel tuo layout. Nel file XML del layout, aggiungi un elemento ViewGroup; questo esempio utilizza un LinearLayout. In un passaggio successivo, passerai un riferimento a questo elemento al tuo AdDisplayContainer.

Se stai eseguendo l'integrazione nell'app BasicExample, aggiungi questo codice al file activity_my.xml, sotto videoPlayerContainer.

<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" />
companion_ad_slot_snippet.xml

Crea un CompanionAdSlot

Il passaggio successivo consiste nel creare un oggetto CompanionAdSlot, che viene poi aggiunto a un'istanza ArrayList<CompanionAdSlot>. L'interfaccia AdDisplayContainer accetta un elenco di aree annuncio companion, in modo da poter mostrare più annunci companion contemporaneamente. Devi creare un'istanza della classe ImaSdkFactory per creare l'oggetto CompanionAdSlot.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

Crea un'area annuncio companion per ogni dimensione di annuncio companion che intendi mostrare nella tua app. L'SDK IMA compila l'area annuncio companion con tutti gli annunci companion della risposta VAST con dimensioni corrispondenti all'altezza e alla larghezza della visualizzazione. L'SDK IMA supporta anche l'utilizzo di companion di dimensioni flessibili. Dopo aver creato i companionAdSlots, aggiungili alla AdsLoader. Gli esempi seguenti mostrano come eseguire questa operazione a seconda che tu stia utilizzando l'estensione Exoplayer-IMA o altre implementazioni IMA che non utilizzano l'estensione.

Estensione Exoplayer-IMA

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

Altre implementazioni

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

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

Visualizza annunci companion fluidi

IMA supporta gli annunci companion flessibili. Questi annunci companion possono essere ridimensionati in base alle dimensioni dell'area annuncio. Riempiono il 100% della larghezza della vista genitore, quindi ridimensionano l'altezza per adattarla ai contenuti del companion. Vengono impostate utilizzando la dimensione companion Fluid in Ad Manager. Consulta l'immagine seguente per sapere dove impostare questo valore.

Aggiorna le app per Android per un'esperienza fluida

Puoi dichiarare un'area companion flessibile aggiornando il metodo CompanionAdSlot.setSize() in modo che accetti CompanionAdSlot.FLUID_SIZE come entrambi i parametri.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

Domande frequenti

Ho seguito la guida, ma non vedo gli annunci companion. Che cosa devo fare?

Innanzitutto, verifica che il tag restituisca effettivamente i companion. Per farlo, apri il tag in un browser web e cerca un tag <CompanionAds>. Se vedi questo messaggio, assicurati che le dimensioni del companion restituito siano le stesse di quelle che stai passando all'oggetto CompanionAdSlot.

Che aspetto avrà l'area annuncio companion se seguo questa guida?

La seguente immagine è stata creata da BasicExample e mostra il video dei contenuti in riproduzione in alto con l'annuncio companion in basso.