Anuncios complementarios

Esta guía está destinada a editores interesados en agregar anuncios complementarios a su implementación de IMA para Android.

Requisitos previos

  • Aplicación para Android con el SDK de IMA integrado. Consulta BasicExample si Si todavía no tienen una aplicación con el SDK integrado.
  • Una etiqueta de anuncio configurada para mostrar un anuncio complementario.

Aspectos básicos útiles

Si aún necesita implementar el SDK de IMA en su aplicación, consulte nuestra Get Guía de introducción

Cómo agregar anuncios complementarios a tu app

Crea un objeto ViewGroup para mostrar tu elemento complementario

Antes de solicitar una compañía complementaria, debes crear un espacio para ella en tu . En tu XML de diseño, agrega un elemento ViewGroup. este ejemplo usa un LinearLayout. En un paso posterior, pasarás un referencia a este elemento en tu AdDisplayContainer. Si estás integración en la aplicación BasicExample, agrega esto a activity_my.xml por debajo de la 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" />

Cómo crear un CompanionAdSlot

El siguiente paso es compilar un objeto CompanionAdSlot, que es y, luego, se agregará a una ArrayList<CompanionAdSlot>. AdDisplayContainer toma una lista de espacios publicitarios complementarios para que puedas mostrar varios anuncios complementarios a la vez. Deberás crear una instancia de ImaSdkFactory para crear la 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);

Crear un espacio publicitario para cada tamaño de anuncio complementario que desees mostrar en tu aplicación El SDK de IMA propaga el espacio publicitario del anuncio complementario con cualquier anuncio complementario de la respuesta de VAST que tengan dimensiones que coincidan con la altura y el ancho de la vista. El SDK de IMA también admite el uso de complementos de tamaño flexible. Una vez que hayas creado los companionAdSlots, debes agregarlos al AdsLoader Los siguientes ejemplos muestran cómo hacerlo según usan los Ejemplo básico de IMA para Android, que usa la extensión Exoplayer-IMA o bien otras implementaciones de IMA que no usen la extensión.

BasicExample

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

Otras implementaciones

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

¡Esto es todo lo que hay sobre este tema! Tu aplicación ahora muestra anuncios complementarios anuncios.

Mostrar anuncios complementarios flexibles

El IMA ahora admite anuncios complementarios flexibles. Se puede cambiar el tamaño de estos anuncios complementarios para que coincidan con el tamaño del anuncio ranura. Rellenan el 100% del ancho de la vista superior y, luego, cambian el tamaño de su altura para que se adapte a la del complementario. contenido. Se configuran con el tamaño complementario Fluid en Ad Manager. Consulta la de la siguiente imagen para saber dónde establecer este valor.

Imagen que muestra la configuración de anuncios complementarios de Ad Manager. Destaca la opción de tamaños complementarios.

Cómo actualizar apps para Android para complementos flexibles

Para declarar un espacio complementario flexible, actualiza el CompanionAdSlot.setSize() método para tomar CompanionAdSlot.FLUID_SIZE como ambos parámetros. 

  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);

Preguntas frecuentes

Seguí la guía, pero no veo anuncios complementarios. ¿Qué debo hacer?
Primero, asegúrate de que tu etiqueta realmente muestre anuncios complementarios. Tareas pendientes ábrela en un navegador web y busca una etiqueta de CompanionAds. Si ves Asegúrate de que el tamaño del anuncio complementario que se muestra sea el mismo. tamaño que las dimensiones que estás pasando a CompanionAdSlot .
¿Cómo se verá mi espacio publicitario complementario tras seguir esta guía?
La siguiente imagen se creó a partir del BasicExample y reproduce el video de contenido arriba junto con el anuncio complementario que aparece abajo.

Imagen de ejemplo del anuncio complementario de IMA para Android.