Ping

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.

Non includere un oggetto params nel corpo della richiesta ping.

Web SDK

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

alloy("sendEvent", {
  xdm: {
    eventType: "media.ping",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 10
    }
  }
});

Mobile SDK

Il SDK mobile invia automaticamente gli eventi ping. Non è richiesta alcuna chiamata esplicita.

Roku (BrightScript)

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

m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.ping",
        "mediaCollection": {
            "playhead": 10
        }
    }
})

API di 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:

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

Media SDK

Media SDK 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:

{
  "playerTime": { "playhead": 10, "ts": 1699523820000 },
  "eventType": "ping"
}