DocumentaciónAnalyticsGuía de servicios de medios de streaming

Error

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

El evento de error indica que el reproductor de contenido ha encontrado un error. El seguimiento de un error no cierra la sesión. Si el error impide que continúe la reproducción, llame a Session end después del evento de error.

La propiedad errorDetails.source solo acepta dos valores: player (errores que se originan en el reproductor de medios) y external (errores de un origen externo como una CDN o una red).

Tipos de implementación recomendados

SDK web

Llamar a sendEvent con eventType: "media.error" y el errorDetails requerido:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.error",
    mediaCollection: {
      errorDetails: {
        name: "media-error-001",
        source: "player"
      },
      sessionID: "{sid}",
      playhead: 45
    }
  }
});
iOS

Llamar a trackError con una cadena de identificador de error.

code language-swift 
tracker.trackError(errorId: "media-error-001")
Android

Llamar a trackError con una cadena de identificador de error.

code language-kotlin 
tracker.trackError("media-error-001")
Roku

Llamar a sendMediaEvent con eventType: "media.error" y el errorDetails requerido:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.error",
        "mediaCollection": {
            "errorDetails": {
                "name": "media-error-001",
                "source": "player"
            },
            "playhead": 45
        }
    }
})
API de Media Edge

Llame al extremo error con el elemento errorDetails requerido:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/error?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.error",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 45,
        "errorDetails": {
          "name": "media-error-001",
          "source": "player"
        }
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Llamar a trackError con una cadena de identificador de error:

code language-javascript 
tracker.trackError("media-error-001");
Chromecast

Llamar a trackError con una cadena de identificador de error:

code language-javascript 
ADBMobile.media.trackError("media-error-001");
API de recopilación de medios

Enviar un POST de error al extremo de eventos:

code language-json 
{
  "playerTime": { "playhead": 45, "ts": 1699523820000 },
  "eventType": "error",
  "params": {
    "media.errorId": "media-error-001",
    "media.errorSource": "player"
  }
}
recommendation-more-help
media-analytics-help