DocumentazioneAnalyticsGuida ai servizi Streaming Media

Ping

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

L’evento ping è un heartbeat che mantiene attiva la sessione e tiene traccia dell’avanzamento della riproduzione. Inviarla con un timer durante la riproduzione. Sugli SDK per dispositivi mobili, i ping vengono inviati automaticamente; su tutte le altre piattaforme devono essere inviati manualmente nell’intervallo specificato.

  • Contenuto principale: primo ping 10 secondi dopo l’avvio della riproduzione, quindi ogni 10 secondi
  • Contenuto annuncio: ogni 1 secondo durante il tracciamento degli annunci

Non includere un oggetto params nel corpo della richiesta ping.

Tipi di implementazione consigliati

Web SDK

Pianifica una chiamata sendEvent ricorrente con eventType: "media.ping". Aggiorna playhead alla posizione di riproduzione corrente in ogni chiamata:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.ping",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 10
    }
  }
});
iOS
Il SDK mobile invia automaticamente gli eventi ping. Non è richiesta alcuna chiamata esplicita.
Android
Il SDK mobile invia automaticamente gli eventi ping. Non è richiesta alcuna chiamata esplicita.
Roku

Pianifica una chiamata sendMediaEvent ricorrente con eventType: "media.ping". Aggiorna playhead alla posizione di riproduzione corrente in ogni chiamata:

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

Chiama l’endpoint ping in un timer. Adobe consiglia di eseguire il primo ping 10 secondi dopo l’inizio della riproduzione principale, ogni 10 secondi dopo tale inizio e ogni 1 secondo durante il tracciamento degli annunci:

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x
Media SDK invia automaticamente gli eventi ping. Non è richiesta alcuna chiamata esplicita.
Chromecast
Il SDK Chromecast invia automaticamente gli eventi ping. Non è richiesta alcuna chiamata esplicita.
API Media Collection

Invia un POST ping all’endpoint eventi in un timer. Non includere un oggetto params:

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