Ping

O evento ping é um heartbeat que mantém a sessão ativa e rastreia o progresso da reprodução. Enviá-lo em um cronômetro durante toda a reprodução. Nos SDKs móveis, os pings são enviados automaticamente; em todas as outras plataformas, eles devem ser enviados manualmente no intervalo especificado.

Não inclua um objeto params no corpo da solicitação de ping.

SDK da web

Agendar uma chamada recorrente de sendEvent com eventType: "media.ping". Atualize playhead para a posição de reprodução atual em cada chamada:

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

SDK móvel

O Mobile SDK envia eventos de ping automaticamente. Nenhuma chamada explícita é necessária.

Roku (BrightScript)

Agendar uma chamada recorrente de sendMediaEvent com eventType: "media.ping". Atualize playhead para a posição de reprodução atual em cada chamada:

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

API de borda de mídia

Chame o ponto de extremidade ping em um timer. A Adobe recomenda que o primeiro ping seja executado 10 segundos após o início da reprodução principal, a cada 10 segundos após e a cada 1 segundo durante o rastreamento de anúncios:

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

SDK de mídia

O Media SDK envia eventos de ping automaticamente. Nenhuma chamada explícita é necessária.

API da coleção de mídia

Envie uma POSTAGEM ping para o ponto de extremidade de eventos em um timer. Não inclua um objeto params:

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