Annunci companion

Questa guida è rivolta ai publisher interessati ad aggiungere annunci companion a l'implementazione IMA di Android.

Prerequisiti

• Applicazione per Android con l'SDK IMA integrato. Consulta BasicExample se non disponi già di un'app con l'SDK integrato.
• Un tag annuncio configurato per restituire un annuncio companion.
  • Se ti serve un esempio, consulta le nostre Domande frequenti.

Iniziative utili

Se hai ancora bisogno di implementare l'SDK IMA nella tua app, consulta il nostro Guida introduttiva.

Aggiungi annunci companion alla tua app

Crea un ViewGroup per visualizzare l'annuncio companion

Prima di richiedere un companion, devi creare uno spazio nella tua layout. Nel file XML di layout, aggiungi un elemento ViewGroup; questo utilizza un LinearLayout. In un passaggio successivo passerai riferimento a questo elemento a AdDisplayContainer. Se integrazione nell'app BasicExample, aggiungilo 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 prevede la creazione di un oggetto CompanionAdSlot, che poi aggiunto a un ArrayList<CompanionAdSlot>. AdDisplayContainer richiede un elenco di aree annuncio companion per consentirti mostrare più annunci companion contemporaneamente. Dovrai creare un'istanza 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 di companion che intendi mostrare nella tua app. L'SDK IMA completa l'area annuncio companion con eventuali companion della risposta VAST che avere dimensioni corrispondenti all'altezza e alla larghezza della visualizzazione. L'SDK IMA supporta anche l'utilizzo annunci companion di dimensioni flessibili. Una volta creati i companionAdSlots, devi aggiungerli al AdsLoader. I seguenti esempi mostrano come eseguire questa operazione a seconda che tu disponga o meno di utilizzano IMA Android BasicExample che utilizza il parametro Estensione IMA per Exoplayer, o 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 l'app companion annunci.

Mostra annunci companion flessibili

IMA ora supporta gli annunci companion flessibili. Questi annunci companion possono essere ridimensionati per adattarsi alle dimensioni dell'annuncio slot machine. riempiono il 100% della larghezza della vista principale e poi ne ridimensionano l'altezza per adattarle a quelle dell'annuncio companion. contenuti. Vengono impostate utilizzando la dimensione companion Fluid in Ad Manager. Consulta le immagine seguente per sapere dove impostare questo valore.

Aggiorna le app per Android per creare companion fluidi

Puoi dichiarare un'area companion flessibile aggiornando il campo CompanionAdSlot.setSize() metodo per acquisire CompanionAdSlot.FLUID_SIZE 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?

Per prima cosa, verifica che il tag restituisca effettivamente creatività companion. Da fare In questo modo, apri il tag in un browser web e cerca un tag CompanionAds. Se vedi assicurarsi che le dimensioni dell'annuncio companion restituito siano le stesse dimensione corrispondente alle dimensioni che stai passando all'elemento CompanionAdSlot .

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

L'immagine seguente è stata creata da BasicExample e mostra il video dei contenuti sopra con l'annuncio companion sotto.