Usa la API de Stream Activity Monitor

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:

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"
}

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:

  1. Comienza desde una entrada en el array adBreaks.
  2. Lee la lista podKeys para ubicar las entradas correspondientes en el array adPods.
  3. Usa el campo adPod.adRequestKey en el Pod para encontrar el AdRequest.adRequestKey coincidente en el array adSelections.
  4. Inspecciona la solicitud HTTP de origen y la respuesta de VAST en el objeto adRequest coincidente o su array childRequests anidado.

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:

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"
}