La API de Supervisor de actividad de transmisión (SAM) de inserción de anuncios dinámicos (DAI) te permite recuperar registros de diagnóstico y resultados de publicación para tus sesiones de transmisión en vivo y video on demand (VOD).
En esta guía, se explica cómo configurar la autenticación, recuperar un recurso
DaiSession de nivel superior y solicitar los recursos identificados en los
campos de la sesión.
Requisitos previos
Para usar la API de SAM, necesitas lo siguiente:
- Acceso a la API de Google Ad Manager Para obtener más información, consulta Cómo comenzar.
- Una transmisión en vivo o de VOD de DAI configurada Para obtener más información, consulta Configura una transmisión en vivo para DAI y Crea una fuente de contenido para video on demand.
- Un ID de sesión de DAI o una clave de depuración de una solicitud de creación de transmisión Para obtener más detalles, consulta Cómo encontrar un ID de sesión de DAI o una clave de depuración.
Solicita un recurso DaiSession
Para inspeccionar una sesión de DAI, envía una solicitud HTTP GET al extremo networks.daiSessions.get con un ID de sesión de DAI o una clave de depuración de transmisión de DAI.
Recupera un recurso DaiSession por ID
Cuando registras una sesión de transmisión con el SDK de IMA para DAI, la API de DAI de servicio completo o la API de DAI de publicación de grupos de anuncios, la DAI de Google devuelve un ID de sesión de DAI.
En el siguiente ejemplo, se recupera un recurso DaiSession con el ID de sesión:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID" \
-H "Authorization: Bearer OAUTH_TOKEN"
Reemplaza lo siguiente:
NETWORK_CODE: Es tu código de red de Google Ad Manager.SESSION_ID: Es el ID de sesión de DAI que se devuelve cuando se crea la sesión de transmisión.OAUTH_TOKEN: Es tu token de acceso de OAuth 2.0.
Usa una clave de depuración para la sesión de DAI
Cuando registras una sesión de transmisión, puedes asignar una clave de depuración personalizada con el parámetro dai-sam-id o el parámetro sam_id en las solicitudes de VOD de publicación de grupos de anuncios. Puedes pasar esta clave de depuración directamente en la ruta de acceso del recurso
DaiSession.
En el siguiente ejemplo, se recupera un recurso DaiSession con la clave de depuración:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/DEBUG_KEY" \
-H "Authorization: Bearer OAUTH_TOKEN"
Reemplaza DEBUG_KEY por una clave de depuración personalizada especificada en tu solicitud de creación de transmisión.
Ambas solicitudes devuelven una respuesta JSON DaiSession que contiene el contexto de la sesión, las selecciones de anuncios, los grupos de anuncios decididos, las pausas publicitarias y los hallazgos de diagnóstico.
El resultado es similar a este:
{
"name": "networks/21775744923/daiSessions/9587e2c1-d745-4bf1-9f6a-e9092127cb48:ATL",
"creationContext": {
"streamCreateRequest": {
"requestTime": "2026-10-16T19:59:57.365124Z",
"latency": "0.045s",
"url": "/ssai/event/c-rArva4ShKVIAkNfy6HUQ/streams",
"userAgent": "Mozilla/5.0",
"responseCode": 201
},
"linearInfo": {
"liveStream": "networks/21775744923/liveStreams/20000016294786",
"assetKey": "c-rArva4ShKVIAkNfy6HUQ",
"prefetchEnabled": false,
"podTrimmingEnabled": true,
"podTrimTolerance": "2s",
"eventStartTime": "2020-06-09T20:00:00Z",
"eventEndTime": "2037-01-01T08:00:00Z"
},
"debugKey": "my-custom-debug-key-001",
"contentTitle": "IMA sample HLS live stream",
"stitchingType": "STITCHED",
"reportingType": "CLIENT",
"interstitialEnabled": false
},
"slate": {
"idType": "CREATIVE_ID",
"idValue": "138544327419",
"adSystem": "GDFP",
"duration": "10s"
},
"adSelections": {
"2021043961286562353": {
"type": "VAST",
"adRequest": {
"adRequestKey": "2021043961286562353",
"adTag": "https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/vmap_ads_for_dai&cust_params=sample_ar%3Dstreammidonly&output=xml_vast4&pmxd=30000",
"httpRequest": {
"requestTime": "2026-10-16T19:59:57.177283526Z",
"latency": "0.138s",
"url": "https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/vmap_ads_for_dai&cust_params=sample_ar%3Dstreammidonly&output=xml_vast4&pmxd=30000",
"responseCode": 200,
"responseBody": "<VAST version=\"4.0\"><Ad id=\"5937252921\" sequence=\"1\"><InLine><AdSystem>GDFP</AdSystem><AdTitle>External - Pod Midroll 1</AdTitle><Creatives><Creative id=\"138383221557\" sequence=\"1\"><Linear><Duration>00:00:10</Duration></Linear></Creative></Creatives></InLine></Ad></VAST>"
},
"childRequests": []
}
}
},
"adPods": {
"9204525715521575580": {
"requestedBreakType": "MIDROLL",
"adRequestKey": "2021043961286562353",
"prefetchStage": "DISABLED",
"adBreakId": "-3821178632466845617",
"label": "3196133",
"creatives": {
"6086226973783046639": {
"idType": "GOOGLE_VIDEO_REGISTRY_ID",
"idValue": "tVFdo4-fFVE",
"adSystem": "GDFP",
"duration": "10.010s",
"podSequence": 1,
"adBuffet": false,
"vastInfos": [
{
"adSystem": "GDFP",
"adTitle": "External - Pod Midroll 1",
"creativeId": "138383221557"
}
]
}
}
}
},
"adBreaks": {
"-3821178632466845617": {
"podKeys": [
"9204525715521575580"
],
"adBreakId": "-3821178632466845617",
"breakType": "MIDROLL",
"breakSequence": "3196133",
"servedAdsDuration": "30.999999999s",
"executedBreakDuration": "30.999999999s",
"linear": {
"breakStartTime": "2026-10-16T20:22:28.130329Z",
"expectedBreakDuration": "31s",
"slateDuration": "0s",
"underlyingDuration": "0s"
},
"trackingPings": {
"3641994172850159057": {
"originalTrackingEventId": "google_4445276280058090123",
"request": {
"requestTime": "2026-10-16T20:22:29.393993Z",
"latency": "0.030s",
"url": "https://dai.google.com/view/p/service/linear/impression/stream/1dccd632-5028-45be-a68a-6c90645cd237:ATL/network/21775744923/event/xDte1UxoSxmtRrB6lqHdmg/media/7083951761/stream_ad_id/EfzeSEQzFPU",
"responseCode": 200
}
}
}
}
},
"findings": [
{
"severity": "INFO",
"description": "Minimum slate inserted into underfilled ad break.",
"slateFinding": {
"type": "SLATE_STATUS_MINIMUM_INSERTED"
}
},
{
"severity": "INFO",
"description": "Ad break was decisioned, but not served during playback.",
"adBreakFinding": {
"type": "UNSERVED_BREAK",
"breakKey": "-3821178632466845617"
}
}
],
"sessionDuration": "31.453022s"
}
Solicita recursos relacionados
Después de identificar una sesión, puedes consultar campos de sesión específicos en el recurso DaiSession, navegar por las claves de entidad de los resultados de la sesión o realizar solicitudes de seguimiento a recursos relacionados en la API de Ad Manager.
Filtra los campos de sesión con máscaras de campo
Una respuesta completa de DaiSession incluye cuerpos XML de VAST y VMAP sin procesar, y todos
los eventos de pausas históricos. Para reducir el tamaño de la carga útil y recuperar solo los campos de sesión
que necesitas, pasa una máscara de lectura en el parámetro de consulta fields o el
encabezado HTTP X-Goog-FieldMask. Para obtener más detalles, consulta
Máscaras de campo.
Para verificar si una sesión encontró errores, solicita solo el contexto de creación de la sesión y los hallazgos de diagnóstico:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID?fields=name,creationContext,findings" \
-H "Authorization: Bearer OAUTH_TOKEN"
Para recuperar solo los campos adBreaks y adPods sin descargar las respuestas de anuncios XML sin procesar en el campo adSelections, usa el encabezado X-Goog-FieldMask:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID" \
-H "Authorization: Bearer OAUTH_TOKEN" \
-H "X-Goog-FieldMask: name,adBreaks,adPods"
Inspecciona los hallazgos de la sesión
Cada entrada de la lista findings incluye un objeto de hallazgo con tipo con una clave
que apunta a la entidad específica en el recurso DaiSession. En la siguiente tabla, se muestra cómo resolver las claves de hallazgos en los campos de sesión:
| Cómo encontrar la ruta de acceso de la clave | Ubicación de segmentación en DaiSession |
|---|---|
adBreakFinding.breakKey |
adBreaks[breakKey] |
adRequestFinding.adSelectionKey, adRequestFinding.adRequestKey |
adSelections[adSelectionKey].adRequest y childRequests[] anidada |
creativeFinding.creativeKey |
Coincidencia de creativeKey en las entradas de adPods[podKey].creatives[creativeKey] |
podFinding.podKey |
adPods[podKey] |
slateFinding |
slate |
trackingFinding.trackingPingKey |
Coincidencia de trackingPingKey en las entradas de adBreaks[breakKey].trackingPings[trackingPingKey] |
Para rastrear las relaciones entre colecciones, haz lo siguiente:
- Comienza desde una entrada en el array
adBreaks. - Lee la lista
podKeyspara ubicar las entradas correspondientes en el arrayadPods. - Usa el campo
adPod.adRequestKeyen el Pod para encontrar elAdRequest.adRequestKeycoincidente en el arrayadSelections. - Inspecciona la solicitud HTTP de origen y la respuesta de VAST en el objeto
adRequestcoincidente o su arraychildRequestsanidado.
Solicita los recursos de contenido y de transmisión en vivo
Un recurso DaiSession contiene nombres de recursos que se vinculan a los recursos livestream y content en la API de Google Ad Manager en el extremo admanager.googleapis.com. Para verificar la configuración de la transmisión y los metadatos del contenido, puedes realizar
solicitudes HTTP GET a estos recursos:
- Recurso
LiveStream: Usa el valor del campocreationContext.linearInfo.liveStreampara llamar al métodonetworks.liveStreams.get. - Recurso
Contentde VOD: Usa el valor del campocreationContext.vodInfo.contentpara llamar al métodonetworks.content.get.
En el siguiente ejemplo, se recupera el recurso LiveStream vinculado al que se hace referencia en
el campo creationContext.linearInfo.liveStream:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreams/LIVE_STREAM_ID" \
-H "Authorization: Bearer OAUTH_TOKEN"
Reemplaza LIVE_STREAM_ID por el
ID de transmisión en vivo en tu recurso DaiSession.
El resultado es similar a este:
{
"name": "networks/21775744923/liveStreams/20000016294786",
"displayName": "IMA sample HLS live stream",
"status": "ACTIVE",
"createTime": "2020-06-09T20:00:07Z",
"updateTime": "2026-08-18T15:37:05Z",
"startTime": "2020-06-09T20:00:00Z",
"endTime": "2037-01-01T08:00:00Z",
"endTimeUnlimited": true,
"contentUrls": [
"https://contentsim.sandbox.google.com/content/590f95c5-c3ee-4a56-a10c-0cc660e91faa/linear/multivariant.m3u8"
],
"adTags": [
"https://pubads.g.doubleclick.net/gampad/live/ads?sz=640x480&output=xml_vast3&iu=/21775744923/external/vmap_ads_for_dai&env=vp&impl=s&gdfp_req=1&unviewed_position_start=1&ad_rule=0&cust_params=sample_ar%3Dstreammidonly&lseco=%%ASSET_KEY%%"
],
"assetKey": "c-rArva4ShKVIAkNfy6HUQ",
"slate": "networks/21775744923/slates/138544327419",
"enableDaiAuthenticationKeys": false,
"adBreakFillType": "SLATE",
"underfillAdBreakFillType": "SLATE",
"adHolidayDuration": "0s",
"enableMaxFillerDuration": false,
"enableDurationlessAdBreaks": false,
"hlsSettings": {
"playlistType": "LIVE",
"masterPlaylistSettings": {
"refreshType": "AUTOMATIC"
}
},
"allowlistedIpsEnabled": false,
"dynamicAdInsertionType": "LINEAR",
"relativePlaylistDeliveryEnabled": false,
"streamingFormat": "HLS",
"prefetchEnabled": false,
"forcedCueInEnabled": false,
"shortSegmentDroppingEnabled": false,
"adBreakMarkupTypesEnabled": false,
"earlyBreakNotificationMultiBreakSchedulingEnabled": false,
"dvrWindowDuration": "60s"
}