DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Ping

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Das Ping-Ereignis ist ein Heartbeat, der die Sitzung am Leben erhält und den Wiedergabegeschritt verfolgt. Senden Sie es während der gesamten Wiedergabe auf einem Timer. Bei Mobile SDKs werden Pings automatisch gesendet. Auf allen anderen Plattformen müssen sie im angegebenen Intervall manuell gesendet werden.

  • Hauptinhalt zuerst Ping 10 Sekunden nach dem Wiedergabebeginn und danach alle 10 Sekunden
  • Anzeigeninhalt: alle 1 Sekunde beim Anzeigen-Tracking

Fügen Sie kein params Objekt in den Textkörper der Ping-Anfrage ein.

Empfohlene Implementierungsarten

Web SDK

Planen Sie einen wiederkehrenden sendEvent mit eventType: "media.ping". Aktualisieren Sie bei jedem Aufruf playhead auf die aktuelle Wiedergabeposition:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.ping",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 10
    }
  }
});
iOS
Mobile SDK sendet automatisch Ping-Ereignisse. Es ist kein expliziter Aufruf erforderlich.
Android
Mobile SDK sendet automatisch Ping-Ereignisse. Es ist kein expliziter Aufruf erforderlich.
Roku

Planen Sie einen wiederkehrenden sendMediaEvent mit eventType: "media.ping". Aktualisieren Sie bei jedem Aufruf playhead auf die aktuelle Wiedergabeposition:

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

Rufen Sie den ping-Endpunkt in einem Timer auf. Adobe empfiehlt das erste Ping 10 Sekunden nach dem Beginn der Hauptwiedergabe, danach alle 10 Sekunden und danach alle 1 Sekunde während des Anzeigen-Trackings:

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x
Media SDK sendet automatisch Ping-Ereignisse. Es ist kein expliziter Aufruf erforderlich.
Chromecast
Die Chromecast-SDK sendet automatisch Ping-Ereignisse. Es ist kein expliziter Aufruf erforderlich.
Media Collection API

Senden Sie einen ping POST an den events-Endpunkt auf einem Timer. params Objekt nicht einschließen:

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