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.
- Si necesitas una muestra, consulta nuestras Preguntas frecuentes.
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.](https://developers.google.cn/static/interactive-media-ads/images/ad_manager_fluid_companion.png?authuser=6&hl=es-419)
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.