DocumentaciónAnalyticsGuía de servicios de medios de streaming

Ping

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

El evento de ping es un latido que mantiene la sesión activa y rastrea el progreso de reproducción. Enviarlo con un temporizador durante toda la reproducción. En los SDK móviles, los pings se envían automáticamente; en todas las demás plataformas deben enviarse manualmente en el intervalo especificado.

  • Contenido principal: primer ping 10 segundos después de iniciarse la reproducción y, a continuación, cada 10 segundos
  • Contenido de anuncio: cada 1 segundo durante el seguimiento de anuncios

No incluya un objeto params en el cuerpo de la solicitud de ping.

Tipos de implementación recomendados

SDK web

Programar una llamada recurrente de sendEvent con eventType: "media.ping". Actualizar playhead a la posición de reproducción actual en cada llamada:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.ping",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 10
    }
  }
});
iOS
Mobile SDK envía eventos de ping automáticamente. No se requiere una llamada explícita.
Android
Mobile SDK envía eventos de ping automáticamente. No se requiere una llamada explícita.
Roku

Programar una llamada recurrente de sendMediaEvent con eventType: "media.ping". Actualizar playhead a la posición de reproducción actual en cada llamada:

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

Llame al extremo ping en un temporizador. Adobe recomienda el primer ping 10 segundos después del inicio de la reproducción principal, cada 10 segundos después y cada 1 segundo durante el seguimiento de anuncios:

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x
Media SDK envía eventos de ping automáticamente. No se requiere una llamada explícita.
Chromecast
Chromecast SDK envía eventos de ping automáticamente. No se requiere una llamada explícita.
API de recopilación de medios

Envíe una publicación de ping al extremo de eventos en un temporizador. No incluya un objeto params:

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