La API del supervisor de actividad de transmisión (SAM) de la inserción de anuncios dinámicos (DAI) te permite inspeccionar y solucionar problemas de sesiones de visualización individuales de transmisiones en vivo y de video on demand (VOD).
Para inspeccionar visualmente y solucionar problemas de una sesión de visualización de VOD o transmisión en vivo individual, usa el supervisor de actividad de transmisión en la IU de Google Ad Manager.
Para recuperar de forma programática los datos de diagnóstico de una sesión, usa el recurso networks.daiSessions de la API de Ad Manager.
Comprender los casos de uso
Con la API de SAM, puedes automatizar el diagnóstico de transmisiones y resolver problemas de publicación de anuncios en tus integraciones de DAI, como los siguientes:
- Verifica la creación de la sesión de transmisión: Confirma los parámetros, el modo de unión de
STITCHEDoPOD_SERVING, el modo de informes y los metadatos de contenido que recibe la DAI de Google cuando se crea una sesión de transmisión en vivo o de VOD. - Audita las solicitudes y respuestas de anuncios: Inspecciona las etiquetas de anuncios salientes de la plantilla de publicación de anuncios de video (VAST) y de la lista de reproducción con múltiples anuncios de video (VMAP), los códigos de estado HTTP, las latencias de respuesta, los cuerpos de respuesta XML sin procesar y las cadenas de redireccionamiento de wrappers.
- Soluciona problemas relacionados con la toma de decisiones y las creatividades de los grupos de anuncios: Verifica qué anuncios selecciona o descarta la DAI de Google para cada grupo, la duración de cada anuncio del grupo y el sistema de anuncios de origen de la creatividad del anuncio.
- Realiza un seguimiento de la ejecución de la carga previa de anuncios: Determina si la DAI de Google realiza la carga previa de un grupo de anuncios y verifica la etapa de carga previa de cada grupo de anuncios.
- Valida las llamadas a la API de pausas publicitarias de DAI y a la API de DAI de publicación de grupos de anuncios: Compara la ejecución real de las pausas, las duraciones de los anuncios publicados y las duraciones de las cortinillas insertadas con las llamadas a la API, como la API de pausas publicitarias de DAI y la API de DAI de publicación de grupos de anuncios.
- Verifica el seguimiento de eventos de anuncios: Confirma si los pings de seguimiento del cliente o del servidor se realizaron correctamente y, luego, inspecciona las respuestas HTTP de los servidores de anuncios.
- Automatiza la supervisión de sesiones y las alertas: Analiza las entradas de hallazgos estructurados con una gravedad
INFO,WARNINGoERRORpara detectar problemas de reproducción o monetización en pruebas de integración automatizadas y canalizaciones de supervisión de producción.
Conocer el recurso de nivel superior
La API de SAM forma parte de la API de REST de Google Ad Manager (beta) en el extremo admanager.googleapis.com y expone el método de solo lectura networks.daiSessions.get. Puedes consultar un recurso DaiSession
con un ID de sesión de DAI o una clave de depuración personalizada. La DAI conserva los registros de sesión durante
un máximo de tres días después de la reproducción.
La API de SAM no admite la enumeración de todos los recursos DaiSession en una red de Google Ad Manager.
Inspecciona las respuestas de transmisiones de DAI con SAM
Para verificar cómo la DAI de Google procesa tus solicitudes de transmisión, examina
la respuesta DaiSession:
- API de DAI de servicio completo: Inspecciona el campo
creationContext.streamCreateRequestpara verificar la llamada de registro de transmisión, consulta los mapasadSelectionsyadPodspara revisar la toma de decisiones de anuncios y examina el mapaadBreakspara confirmar las duraciones del anuncio unido, la creatividad de cortinilla y el contenido subyacente. - API de DAI de publicación de grupos de anuncios: Confirma que el campo
creationContext.stitchingTypeesté configurado con el valorPOD_SERVING, verifica el campoadBreakIden los mapasadPodsyadBreakscon tus llamadas de solicitud de manifiesto o segmento de grupo de anuncios, y, luego, inspecciona los píxeles contadores de verificación de medios o del servidor en el mapatrackingPings. - API de pausas publicitarias de DAI: Haz coincidir el valor
breakSequencede un objetoAdBreakcon la propiedadAdBreak.breakSequence.
Realiza tu primera solicitud
Para configurar la autenticación y recuperar los recursos de la sesión de DAI, consulta Usa la API de supervisor de actividad de transmisión.