Show Menu
TOPICS×

타임라인 2 - 사용자가 세션을 중단함

VOD, 프리롤 광고, 미드롤 광고, 사용자가 일찍 컨텐츠를 중단함

다음 다이어그램은 플레이헤드 타임라인과 사용자 작업의 해당 타임라인을 보여 줍니다. 각 작업 및 추가 요청에 대한 세부 사항은 아래에 나와 있습니다.

작업 세부 사항

작업 1 - 세션 시작

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
자동 재생 또는 재생 단추 누름
0
0
/api/v1/sessions
구현 세부 정보
이 호출은 비디오를
재생하도록 사용자에게 신호
​를 보냅니다. 세션 내의 모든 후속 추적 호출을 식별하는 데 사용되는 클라이언트에 세션 ID(
{sid}
)가 반환됩니다. 플레이어 상태가 아직 "재생 중"이 아니라 "시작 중"입니다. 필수 세션 매개 변수 는 요청 본문의
params
맵에 포함해야 합니다. 백엔드에서 이 호출은 Adobe Analytics 시작 호출을 생성합니다.
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:sessionStart, params: { "media.playerName": "sample-html5-api-player", "analytics.trackingServer": "[ _YOUR-TS_ ]", "analytics.reportSuite": "[ _YOUR-RSID_ ]", "analytics.visitorId": "[ _YOUR-VISITOR-ID_ ]", "media.contentType": "VOD", "media.length": 60.3333333333333, "media.id": "VA API Sample Player", "visitor.marketingCloudOrgId": "[YOUR-MCID]", "media.name": "ClickMe", "media.channel": "sample-channel", "media.sdkVersion": "va-api-0.0.0", "analytics.enableSSL": false } }

작업 2 - Ping 타이머 시작

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
앱이 ping 이벤트 타이머 시작
0
0
구현 세부 정보
앱의 Ping 타이머를 시작합니다. 그러면 첫 번째 Ping 이벤트는 프리롤 광고가 있는 경우 1초, 없는 경우에는 10초 실행됩니다.

작업 3 - 광고 브레이크 시작

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
프리롤 광고 브레이크 추적 시작
0
0
/api/v1/sessions/{sid}/events
구현 세부 정보
프리롤 광고를 추적해야 합니다. 광고는 광고 브레이크 내에서만 추적할 수 있습니다.
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:adBreakStart, params: { "media.ad.podFriendlyName": "ad_pod1", "media.ad.podIndex": 0, "media.ad.podSecond": 0 } }

작업 4 - 광고 시작

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
프리롤 광고 1 시작
0
0
/api/v1/sessions/{sid}/events
구현 세부 정보
12초 광고가 시작됩니다.
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:adStart, params: { "media.ad.podFriendlyName": "ad_pod1", "media.ad.name": "Ad 1", "media.ad.id": "002", "media.ad.length": 7, "media.ad.podPosition": 1, "media.ad.playerName": "Sample Player", "media.ad.advertiser": "Ad Guys", "media.ad.campaignId": "1", "media.ad.creativeId": "42", "media.ad.siteId": "XYZ", "media.ad.creativeURL": "https://xyz-creative.com", "media.ad.placementId": "sample-placement2" }, }

작업 5 - 광고 Ping

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
앱에서 ping 이벤트 보내기
1
0
/api/v1/sessions/{sid}/events
구현 세부 정보
1초마다 백 엔드를 Ping합니다. (간결성을 위해 후속 광고 Ping은 표시되지 않습니다.)
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:ping }

작업 6 - 광고 완료

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
프리롤 광고 1 추적 완료
12
0
/api/v1/sessions/{sid}/events
구현 세부 정보
첫 번째 프리롤 광고가 끝났습니다.
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:adComplete }

작업 7 - 광고 브레이크 완료

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
프리롤 광고 브레이크 추적 완료
12
0
/api/v1/sessions/{sid}/events
구현 세부 정보
광고 브레이크가 끝났습니다. 광고 프레이크 전체에서 플레이어가 "재생 중" 상태에 남아 있습니다.
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:adBreakComplete }

작업 8 - 컨텐츠 재생

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
재생 이벤트 추적
12
0
/api/v1/sessions/{sid}/events
구현 세부 정보
플레이어를 "재생 중" 상태로 이동하고, 컨텐츠 재생 시작을 추적하기 시작합니다.
샘플 요청 본문
{ playerTime: { playhead: 0, ts: <timestamp> }, eventType:play, qoeData: { bitrate: 10000 } }

작업 9 - Ping

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
앱에서 ping 이벤트 보내기
20
8
/api/v1/sessions/{sid}/events
구현 세부 정보
10초마다 백엔드를 ping합니다.
샘플 요청 본문
{ playerTime: { playhead: 8ß, ts: <timestamp> }, eventType:ping }

작업 10 - Ping

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
앱에서 ping 이벤트 보내기
30
18
/api/v1/sessions/{sid}/events
구현 세부 정보
10초마다 백엔드를 ping합니다.
샘플 요청 본문
{ playerTime: { playhead: 18, ts: <timestamp> }, eventType:ping }

작업 11 - 오류

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
오류가 발생하여, 앱에서 오류 정보를 보냅니다.
32
20
/api/v1/sessions/{sid}/events
구현 세부 정보
샘플 요청 본문
{ playerTime: { playhead: 20, ts: <timestamp> }, eventType:error }

작업 12 - 컨텐츠 재생

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
앱이 오류에서 복구되어 사용자가 재생을 누름
37
20
/api/v1/sessions/{sid}/events
구현 세부 정보
샘플 요청 본문
{ playerTime: { playhead: 18, ts: <timestamp> }, eventType:play, qoeData: { bitrate: 10000 } }

작업 13 - Ping

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
앱에서 ping 이벤트 보내기
40
28
/api/v1/sessions/{sid}/events
구현 세부 정보
10초마다 백엔드를 ping합니다.
샘플 요청 본문
{ playerTime: { playhead: 28, ts: <timestamp> }, eventType:ping }

작업 14 - 광고 브레이크 시작

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
미드롤 광고 브레이크 추적 시작
45
33
/api/v1/sessions/{sid}/events
구현 세부 정보
8초 동안의 미드롤 광고:
adBreakStart
를 보냅니다.
샘플 요청 본문
{ playerTime: { playhead: 33, ts: <timestamp> }, eventType:adBreakStart, params: { "media.ad.podFriendlyName": "ad_pod2", "media.ad.podIndex": 1, "media.ad.podSecond": 33 } }

작업 15 - 광고 시작

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
미드롤 광고 1 추적 시작
45
33
/api/v1/sessions/{sid}/events
구현 세부 정보
미드롤 광고를 추적합니다.
샘플 요청 본문
{ playerTime: { playhead: 33, ts: <timestamp> }, eventType:adStart, params: { "media.ad.podFriendlyName": "ad_pod1", "media.ad.name": "Ad 1", "media.ad.id": "002", "media.ad.length": 8, "media.ad.podPosition": 1, "media.ad.playerName": "Sample Player", "media.ad.advertiser": "Ad Guys", "media.ad.campaignId": "7", "media.ad.creativeId": "40", "media.ad.siteId": "XYZ", "media.ad.creativeURL": "https://xyz_creative.com", "media.ad.placementId": "sample_placement2" }, }

작업 16 - 앱 닫기

작업
작업 타임라인(초)
플레이헤드 위치(초)
클라이언트 요청
사용자가 앱을 닫습니다. 앱에서 사용자가 보기를 중단하고 이 세션으로 돌아가지 않았음을 확인했습니다.
48
33
/api/v1/sessions/{sid}/events
구현 세부 정보
sessionEnd
를 VA 백엔드에 보내어 추가 처리 없이 세션을 즉시 닫아야 한다는 것을 나타냅니다.
샘플 요청 본문
{ playerTime: { playhead: 33, ts: <timestamp> }, eventType:sessionEnd }