타임라인 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
}