DocumentationAnalyticsGuide des services des médias en streaming

Ping

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

L’événement ping est une pulsation qui maintient la session active et suit la progression de la lecture. Envoyez-le sur un minuteur pendant la lecture. Sur les SDK mobiles, les pings sont envoyés automatiquement. Sur toutes les autres plateformes, ils doivent être envoyés manuellement selon l’intervalle spécifié.

  • Contenu principal : première commande ping 10 secondes après le début de la lecture, puis toutes les 10 secondes par la suite
  • Contenu publicitaire : toutes les secondes pendant le suivi des publicités

N’incluez pas d’objet params dans le corps de la requête ping.

Types d’implémentation recommandés

SDK Web

Planifiez un appel sendEvent récurrent avec eventType: "media.ping". Mettez à jour la playhead vers la position de lecture actuelle à chaque appel :

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.ping",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 10
    }
  }
});
iOS
Mobile SDK envoie automatiquement des événements ping. Aucun appel explicite n’est requis.
Android
Mobile SDK envoie automatiquement des événements ping. Aucun appel explicite n’est requis.
Roku

Planifiez un appel sendMediaEvent récurrent avec eventType: "media.ping". Mettez à jour la playhead vers la position de lecture actuelle à chaque appel :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.ping",
        "mediaCollection": {
            "playhead": 10
        }
    }
})
API Media Edge

Appelez le point d’entrée ping sur un minuteur. Adobe recommande d’exécuter le premier ping 10 secondes après le début de la lecture principale, toutes les 10 secondes par la suite et toutes les secondes pendant le suivi publicitaire :

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

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x
Media SDK envoie automatiquement des événements ping. Aucun appel explicite n’est requis.
Chromecast
Le SDK Chromecast envoie automatiquement des événements ping. Aucun appel explicite n’est requis.
API Media Collection

Envoyez une ping POST au point d’entrée événements sur un minuteur. N’incluez pas d’objet params :

code language-json 
{
  "playerTime": { "playhead": 10, "ts": 1699523820000 },
  "eventType": "ping"
}
recommendation-more-help
media-analytics-help