Errore

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).

Web SDK

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

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

Mobile SDK

Chiamare trackError con una stringa ID errore.

iOS (Swift)

tracker.trackError(errorId: "media-error-001")

Android (Cotlino)

tracker.trackError("media-error-001")

Roku (BrightScript)

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

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

API di Media Edge

Chiama l’endpoint error con errorDetails richiesto:

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

Media SDK

Chiamare trackError con una stringa ID errore:

tracker.trackError("media-error-001");

API Media Collection

Invia un POST error all’endpoint eventi:

{
  "playerTime": { "playhead": 45, "ts": 1699523820000 },
  "eventType": "error",
  "params": {
    "media.errorId": "media-error-001",
    "media.errorSource": "player"
  }
}