설명서Analytics스트리밍 미디어용 서비스 안내서

Ping

마지막 업데이트: 2026년 5월 29일

작성 대상:

  • Developer

ping 이벤트는 세션을 활성 상태로 유지하고 재생 진행률을 추적하는 하트비트입니다. 재생 도중 타이머로 보냅니다. Mobile SDK에서는 Ping이 자동으로 전송됩니다. 다른 모든 플랫폼에서는 지정된 간격에 따라 수동으로 전송해야 합니다.

  • 기본 컨텐츠: 재생이 시작된 후 먼저 10초 후에 ping하고, 그 후에는 10초마다 ping합니다.
  • 광고 콘텐츠: 광고 추적 중 1초마다

Ping 요청 본문에 params 개체를 포함하지 마십시오.

권장 구현 유형

웹 SDK

eventType: "media.ping"(으)로 반복 sendEvent 통화를 예약합니다. 각 호출에서 playhead을(를) 현재 재생 위치로 업데이트합니다.

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.ping",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 10
    }
  }
});
iOS
Mobile SDK은 ping 이벤트를 자동으로 전송합니다. 명시적인 호출이 필요하지 않습니다.
Android
Mobile SDK은 ping 이벤트를 자동으로 전송합니다. 명시적인 호출이 필요하지 않습니다.
Roku

eventType: "media.ping"(으)로 반복 sendMediaEvent 통화를 예약합니다. 각 호출에서 playhead을(를) 현재 재생 위치로 업데이트합니다.

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

타이머에서 ping 끝점을 호출합니다. Adobe에서는 기본 재생이 시작된 후 첫 번째 ping은 10초 후를, 10초 후를, 광고 추적 중에는 1초를 권장합니다.

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

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x
Media SDK은 ping 이벤트를 자동으로 전송합니다. 명시적인 호출이 필요하지 않습니다.
Chromecast
Chromecast SDK은 ping 이벤트를 자동으로 전송합니다. 명시적인 호출이 필요하지 않습니다.
미디어 컬렉션 API

타이머의 이벤트 끝점에 ping POST를 보냅니다. params 개체 포함 안 함:

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