Configura el SDK de IMA para la DAI

Los SDKs de IMA facilitan la integración de anuncios multimedia en tus sitios web y apps. Los SDKs de IMA pueden solicitar anuncios de cualquier servidor de anuncios que cumpla con VAST y administrar la reproducción de anuncios en tus apps. Con los SDKs de DAI de IMA, las apps realizan una solicitud de transmisión de anuncios y videos de contenido, ya sea VOD o contenido en vivo. Luego, el SDK muestra una transmisión de video combinada para que no tengas que administrar el cambio entre el video de anuncios y el contenido dentro de tu app.

Selecciona la solución de DAI que te interesa

Servicio completo Publicación de pods

Publicación de grupos de anuncios de DAI

Los SDKs de IMA facilitan la integración de anuncios multimedia en tus sitios web y apps. Los SDKs de IMA pueden solicitar anuncios de cualquier servidor de anuncios que cumpla con VAST y administrar la reproducción de anuncios en tus apps. Con los SDKs de DAI de IMA, las apps realizan una solicitud de transmisión de anuncios y videos de contenido, ya sea VOD o contenido en vivo. Luego, el SDK muestra una transmisión de video combinada para que no tengas que administrar el cambio entre el video de anuncios y el contenido dentro de tu app.

En esta guía, se muestra cómo reproducir una transmisión de Publicación de grupos de anuncios de DAI con el SDK de IMA DAI con un reproductor de video para la reproducción de transmisiones en vivo y de VOD. Para ver o seguir una integración de muestra completada, descarga el ejemplo de Publicación de pods.

Nota: El SDK de DAI de IMA para Android admite transmisiones HLS y DASH.

En esta guía, se explica cómo configurar exoplayer y el SDK de IMA DAI para reproducir una transmisión HLS. Para ver un ejemplo de un reproductor de video que admite transmisiones HLS y DASH, consulta nuestro ejemplo avanzado.

Punto clave: Para usar la publicación de grupos de anuncios dinámicos de IMA, debes trabajar con un socio de publicación de grupos de anuncios y tener una cuenta avanzada de Ad Manager 360. Si tienes una cuenta de Ad Manager, comunícate con tu administrador de cuentas para obtener más detalles. Para obtener información sobre cómo registrarte en Ad Manager, visita el Centro de ayuda de Ad Manager.

Nota: Para obtener información sobre la integración con otras plataformas o el uso de los SDKs del cliente de IMA, consulta SDKs de anuncios multimedia interactivos.

Descripción general de la Publicación de grupos de anuncios de DAI de IMA

• StreamRequest: Es un objeto que define una solicitud de transmisión a los servidores de publicidad de Google. Se debe crear con ImaSdkFactory.createPodStreamRequest() o ImaSdkFactory.createPodVodStreamRequest() para habilitar la publicación de Pods. Estos métodos requieren un código de red y createPodStreamRequest también requiere una clave de activo personalizado y una clave de API opcional. Ambos incluyen otros parámetros opcionales.

• StreamManager: Es un objeto que controla la comunicación entre la transmisión de video y el SDK de DAI de IMA, como activar pings de seguimiento y reenviar eventos de transmisión al publicador.

Requisitos previos

• Una app para Android ya configurada con el SDK de DAI de IMA para reproducir transmisiones de video con anuncios de DAI Si aún no tienes una app de este tipo, te recomendamos que uses Android DAI BasicExample como punto de partida. BasicExample tiene la base de código a la que se hace referencia en esta guía.

• Es importante que tu app envíe eventos ID3 con VideoStreamPlayerCallback.onUserTextReceived() para que funcione la DAI de IMA. Consulta este ejemplo de fragmento de código de DAI de servicio completo.

Configura tus variables de publicación de grupos de anuncios

Todos los cambios necesarios para la publicación de grupos de anuncios se realizan en SampleAdsWrapper.java. El primer paso es actualizar las variables constantes.

Estas son las constantes de solicitud de flujo de grupos de anuncios que se deben agregar:

• STREAM_URL: Solo se usa para transmisiones en vivo: Es la URL de transmisión de video que proporciona tu manipulador de manifiestos o tu socio externo con la publicación de grupos de anuncios. Debería requerir que insertes el ID de transmisión que proporciona el SDK de IMA DAI antes de realizar una solicitud. En este caso, la URL de la transmisión incluye un marcador de posición, "[[STREAMID]]", que se reemplaza por el ID de la transmisión antes de realizar una solicitud.

• NETWORK_CODE: Es el código de red de tu cuenta de Ad Manager 360.

• CUSTOM_ASSET_KEY: Solo se usa para transmisiones en vivo: Es la clave de activo personalizado que identifica tu evento de publicación de grupo de anuncios en Ad Manager 360. Tu manipulador de manifiestos o tu socio externo de Publicación de grupos de anuncios pueden crearlo.

• API_KEY: Solo se usa para transmisiones en vivo: Es una clave de API opcional que se puede requerir para recuperar un ID de transmisión desde el SDK de DAI de IMA.

Android DAI BasicExample está diseñado para reproducir una variedad de tipos de transmisiones, pero para la publicación de grupos de anuncios, está configurado para reproducir una sola transmisión. Cambia la sección de variables del ejemplo para que coincida con lo siguiente:

Nota: Los parámetros de transmisión proporcionados son para una transmisión de grupo en vivo. Para realizar pruebas con una transmisión de VOD de Pod Serving, debes proporcionar tus propios parámetros de transmisión de prueba.

/** This class implements IMA to add pod ad-serving support to SampleVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Set up the pod serving variables.
  private static final String NETWORK_CODE = "";
  private static final String CUSTOM_ASSET_KEY = "";
  private static final String API_KEY = "";
  private static final String STREAM_URL = "";
  private static final StreamFormat STREAM_FORMAT = StreamFormat.HLS;
SampleAdsWrapper.java

Crea una solicitud de transmisión de grupos de anuncios en vivo o VOD para habilitar la Publicación de grupos de anuncios

Publicación de grupos de transmisiones en vivo

Se quitó el método buildStreamRequest() que se usaba para alternar entre la compilación de una variedad de tipos de transmisiones. Luego, modifica requestAndPlayAds() para llamar a ImaSdkFactory.createPodStreamRequest() y crear una solicitud de anuncio de publicación de pod en vivo.

// Live pod stream request.
request = sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
SampleAdsWrapper.java

Publicación de grupos de anuncios de VOD

Se quitó el método buildStreamRequest() que se usaba para alternar entre la compilación de una variedad de tipos de transmisiones. Luego, modifica requestAndPlayAds() para llamar a ImaSdkFactory.createPodVodStreamRequest() y crear una solicitud de anuncio de publicación de pod de VOD.

// VOD pod stream request.
request = sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
SampleAdsWrapper.java

Después de crear la instancia de solicitud de transmisión, solicítala con AdsLoader.requestStream():

request.setFormat(STREAM_FORMAT);
adsLoader.requestStream(request);
SampleAdsWrapper.java

Edita y configura la URL de transmisión

Publicación de grupos de transmisiones en vivo

Llama al método StreamManager.getStreamId() para obtener el ID del flujo. Esto se debe insertar en STEAM_URL reemplazando "[[STREAMID]]". Después de realizar este cambio, establece la nueva URL de transmisión con el método videoPlayer.setStreamUrl() y llama al método videoPlayer.play() para iniciar la reproducción de la transmisión.

// Play the live pod stream.
streamID = streamManager.getStreamId();
String liveStreamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);
// Call videoPlayer.play() here, because IMA doesn't call the VideoStreamPlayer.loadUrl()
// function for livestreams.
videoPlayer.setStreamUrl(liveStreamUrl);
videoPlayer.play();
SampleAdsWrapper.java

Publicación de grupos de anuncios de transmisión de VOD

1. Llama al método StreamManager.getStreamId() para obtener el ID del flujo.
2. Solicita una URL de transmisión a tu socio de tecnología de video (VTP).
3. Después de recibir la URL de tu VTP, llama al método StreamManager.loadThirdPartyStream() con la URL para cargar la transmisión, junto con los subtítulos que devuelve tu VTP.

// Play the VOD pod stream.
streamID = streamManager.getStreamId();
String vodStreamUrl = "";
// Refer to your Video Tech Partner (VTP) or video stitching guide to fetch the stream URL
// and the subtitles for a the ad stitched VOD stream.

// In the following commented out code, 'vtpInterface' is a place holder
// for your own video technology partner (VTP) API calls.
// vodStreamUrl = vtpInterface.requestStreamURL(streamID);
List<Map<String, String>> subtitles = new ArrayList<>();
streamManager.loadThirdPartyStream(vodStreamUrl, subtitles);
SampleAdsWrapper.java

En el caso de las solicitudes de publicación de pods de VOD, IMA llama a la devolución de llamada VideoStreamPlayer.loadUrl() cuando se carga la transmisión. Para iniciar la reproducción de la transmisión, agrega las llamadas videoPlayer.setStreamUrl() y videoPlayer.play() a la devolución de llamada VideoStreamPlayer.loadUrl():

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      // IMA doesn't make calls to VideoStreamPlayer.loadUrl() for pod serving live streams.
      // The following code is for VOD streams.
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }
SampleAdsWrapper.java

Limpia los recursos de DAI de IMA

Cuando termines de solicitar y mostrar anuncios correctamente en una transmisión de publicación de grupos con el SDK de DAI de IMA, te sugerimos que limpies los recursos después de que se complete la sesión de publicación de grupos. Llama a StreamManager.destroy() para detener la reproducción de la transmisión, detener todo el seguimiento de anuncios y liberar todos los recursos de transmisión cargados.

Para ver otros ejemplos del uso del SDK de Android, consulta los ejemplos en GitHub.