Annunci companion

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

Prerequisiti

• 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.

Approfondimenti utili

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

Aggiungere annunci associati alla tua app

Crea un ViewGroup per visualizzare il companion

Prima di richiedere un componente aggiuntivo, devi creare uno spazio per questo nel layout. Aggiungi un elemento ViewGroup al file XML del layout. In questo esempio viene utilizzato un LinearLayout. In un passaggio successivo, passerai un riferimento a questo elemento a AdDisplayContainer. Se stai integrando l'app BasicExample, aggiungi questo codice a activity_my.xml sotto videoPlayerContainer.

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 CompanionAdSlot

Il passaggio successivo consiste nel creare un oggetto CompanionAdSlot, che viene poi aggiunto a un ArrayList<CompanionAdSlot>. AdDisplayContainer accetta un elenco di spazi annunci companion per consentirti di mostrare 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 uno spazio annuncio companion per ogni dimensione di annunci companion che intendi mostrare nella tua app. L'SDK IMA compila lo spazio annuncio companion con tutti gli annunci companion della risposta VAST che hanno dimensioni corrispondenti all'altezza e alla larghezza della visualizzazione. L'SDK IMA supporta anche l'utilizzo di creatività companion con dimensioni flessibili. Una volta creato il companionAdSlots, doveva essere aggiunto al AdsLoader. Gli esempi riportati di seguito mostrano come eseguire questa operazione a seconda che tu stia utilizzando IMA Android BasicExample, che utilizza l'estensione Exoplayer-IMA, 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 annunci companion.

Pubblicare annunci companion fluidi

IMA ora supporta gli annunci companion flessibili. Le dimensioni di questi annunci possono essere adattate alle dimensioni dell'area annuncio. Riempiono il 100% della larghezza della vista principale, quindi ridimensionano l'altezza in base ai contenuti del video correlato. Vengono impostate utilizzando la dimensione dell'annuncio companion Fluid in Ad Manager. Vedi la seguente immagine per sapere dove impostare questo valore.

Aggiornare le app Android per i compagni fluidi

Puoi dichiarare uno slot companion fluido aggiornando il metodo CompanionAdSlot.setSize() in modo che accetti 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 vedo gli annunci companion. Che cosa devo fare?

Innanzitutto, assicurati che il tag stia effettivamente restituendo i compagni. Per farlo, apri il tag in un browser web e cerca un tag CompanionAds. Se lo vedi, assicurati che le dimensioni del companion restituito corrispondano alle dimensioni che stai passando all'CompanionAdSlot oggetto

.

Che aspetto avrà la mia area annuncio associata se seguo questa guida?

L'immagine di seguito è stata creata da ExampleBase e mostra il video dei contenuti in riproduzione sopra e l'annuncio companion sotto.