Erreur
L’événement d’erreur indique que le lecteur multimédia a rencontré une erreur. Le suivi d’une erreur ne ferme pas la session. Si l’erreur empêche la lecture de continuer, appelez Fin de session après l’événement d’erreur.
- Conditions préalables : début de session
- Mesure associée : Flux impactés par l’erreur
La propriété errorDetails.source accepte uniquement deux valeurs : player (erreurs provenant du lecteur multimédia) et external (erreurs provenant d’une source externe telle qu’un réseau de diffusion de contenu ou un réseau).
SDK web
Appelez sendEvent avec les eventType: "media.error" et les errorDetails requises :
alloy("sendEvent", {
xdm: {
eventType: "media.error",
mediaCollection: {
errorDetails: {
name: "media-error-001",
source: "player"
},
sessionID: "{sid}",
playhead: 45
}
}
});
SDK mobile
Appelez trackError avec une chaîne d’ID d’erreur.
iOS (Swift)
tracker.trackError(errorId: "media-error-001")
Android (Kotlin)
tracker.trackError("media-error-001")
Roku (BrightScript)
Appelez sendMediaEvent avec les eventType: "media.error" et les errorDetails requises :
m.aepSdk.sendMediaEvent({
"xdm": {
"eventType": "media.error",
"mediaCollection": {
"errorDetails": {
"name": "media-error-001",
"source": "player"
},
"playhead": 45
}
}
})
API Media Edge
Appelez le point d’entrée error avec la errorDetails requise :
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"
}
}]
}'
SDK Media
Appelez trackError avec une chaîne d’ID d’erreur :
tracker.trackError("media-error-001");
API Media Collection
Envoyez une error POST au point d’entrée événements :
{
"playerTime": { "playhead": 45, "ts": 1699523820000 },
"eventType": "error",
"params": {
"media.errorId": "media-error-001",
"media.errorSource": "player"
}
}