DocumentazioneAnalyticsGuida ai servizi Streaming Media

Errore

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

L’evento di errore segnala che il lettore multimediale ha riscontrato un errore. Il tracciamento di un errore non chiude la sessione. Se l’errore impedisce il proseguimento della riproduzione, chiamare Session end dopo l’evento di errore.

La proprietà errorDetails.source accetta solo due valori: player (errori originati nel lettore multimediale) e external (errori provenienti da un’origine esterna, ad esempio una rete o una rete CDN).

Tipi di implementazione consigliati

Web SDK

Chiama sendEvent con eventType: "media.error" e il errorDetails richiesto:

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

Chiamare trackError con una stringa ID errore.

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

Chiamare trackError con una stringa ID errore.

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

Chiama sendMediaEvent con eventType: "media.error" e il errorDetails richiesto:

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

Chiama l’endpoint error con errorDetails richiesto:

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Chiamare trackError con una stringa ID errore:

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

Chiamare trackError con una stringa ID errore:

code language-javascript 
ADBMobile.media.trackError("media-error-001");
API Media Collection

Invia un POST error all’endpoint eventi:

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