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.
Edge 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.
Roku 2.x

Media SDK invia automaticamente gli eventi ping, purché si chiami processMediaMessages nel ciclo eventi. Aggiorna la testina di riproduzione in modo che ogni ping riporti la posizione corrente:

code language-brightscript 
ADBMobile().mediaUpdatePlayhead(10)
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