스트리밍 미디어 이벤트

스트리밍 미디어 추적은 일련의 이벤트 호출을 Adobe 데이터 수집 끝점으로 보내어 작동하며, 각 값은 플레이어 상태의 전환을 나타냅니다. 모든 이벤트는 세션 시작 호출로 열린 활성 세션에 속합니다. 세션이 만료 기간을 통해 자동으로 닫히거나 세션 종료 호출로 즉시 닫힐 수 있습니다.

이벤트는 6개의 카테고리(세션, 재생, 광고, 챕터, 플레이어 상태 및 품질)로 그룹화되어 각각 미디어 경험의 고유한 측면을 다룹니다.

세션 이벤트

세션 이벤트는 주문형 비디오, 라이브 스트림, 팟캐스트 및 오디오북을 포함한 모든 유형의 미디어 추적에 적용됩니다. 이 세그먼트는 추적 세션 자체의 경계를 정의합니다. 거의 모든 다른 이벤트 유형은 세션 ID가 생성하는 세션 ID에 따라 달라지므로 가장 중요한 세션 이벤트는 세션 시작입니다. 사용자가 재생을 누를 때 또는 플레이어가 자동 재생을 시작할 때와 같이 세션을 시작할 때 이를 첫 번째 이벤트로 보냅니다.

세션이 열리면 세션 완료 또는 세션 종료를 사용하여 보기 환경이 종료되는 방식을 지정하십시오. 뷰어가 콘텐츠의 자연적인 끝에 도달하면 세션 전송 완료 - 비디오가 완료되거나 팟캐스트 에피소드가 종료되거나 오디오북의 마지막 챕터가 종료됩니다. 세션 완료는 세션을 닫지 않습니다. 세션이 자연적으로 만료될 때까지 열려 있으므로 최종 ping과 같은 모든 후행 이벤트는 계속 캡처됩니다.

뷰어가 종료되기 전에 나가는 경우 세션 종료를 전송하여 세션을 즉시 닫으십시오. 플레이어가 삭제되거나 페이지가 언로드된 경우와 같이 추가 이벤트가 발생하지 않는 경우에만 세션을 종료합니다. 세션 종료는 하드 닫기입니다. 세션이 전송되면 세션이 종료되고 더 이상 이벤트를 추적할 수 없습니다. 대부분의 경우 자연적으로 세션 만료를 허용하는 것이 안전하다. 예를 들어 뷰어가 무기한 일시 중지되거나, 앱이 백그라운드로 이동되거나, 콘텐츠가 로드되지 않는 문제가 있습니다.

10분 동안 이벤트가 수신되지 않거나 30분 동안 플레이헤드 이동이 감지되지 않으면 세션이 자동으로 만료됩니다. 두 조건 중 하나가 충족되고 뷰어가 컨텐츠로 돌아가면 추가 이벤트를 보내기 전에 세션 시작 을 다시 호출하여 새 세션을 열어야 합니다.

재생 이벤트

재생 이벤트는 세션 전체에서 미디어 플레이어에서 상태 전환을 추적합니다. 이벤트 스트림의 코어를 형성하고 모든 콘텐츠 유형에 적용됩니다.

기본 재생 이벤트는 재생입니다. 세션 시작을 호출한 후 재생은 콘텐츠가 초기 시작인지, 자동 재생 트리거인지 또는 재생 상태로 돌아가는지 등의 여부를 포함하여 재생이 시작되었음을 알립니다. 일시 중지 시작 사용자가 재생을 일시 중지했음을 알립니다. 전용 다시 시작 이벤트는 없습니다. 뷰어가 다시 시작하면 Play를 다시 보내십시오. 버퍼링 중지 후에도 재생이 동일하게 작동합니다. 플레이어가 데이터 대기를 중지하면 버퍼 시작을 보낸 다음 버퍼링이 확인될 때 재생을 반복합니다.

기본 콘텐츠 재생 중에는 10초마다 Ping을(를) 보내고 광고 재생 중에는 1초마다 보냅니다. Ping은 세션을 활성 상태로 유지하고 플레이헤드 이동을 기록합니다. Mobile SDK에서는 Ping이 자동으로 전송됩니다. 다른 모든 플랫폼에서는 수동으로 전송해야 합니다.

플레이어의 적응형 비트 전송률 알고리즘이 다른 품질 수준으로 전환될 때마다 비트 전송률 변경을 보냅니다. QoE 데이터에 새 비트율 값을 포함하면 평균 비트율 보고를 사용할 수 있습니다.

광고 이벤트

광고 이벤트는 미디어 세션 내에서 광고를 추적합니다. 일반적인 시나리오에는 비디오가 시작되기 전의 프리롤 광고, 긴 형식의 비디오 또는 라이브 스트림 동안 간격을 두고 삽입되는 미드롤 광고, 콘텐츠가 끝난 후의 포스트롤 광고가 포함됩니다. 단일 광고 브레이크에는 하나 또는 여러 개의 개별 광고가 포함될 수 있습니다.

모든 광고 브레이크는 동일한 구조를 따릅니다. 광고 브레이크 시작에서 브레이크를 열고 광고 브레이크 완료에서 닫습니다. 이 두 이벤트는 모든 개별 광고 이벤트를 래핑하는 북엔드 역할을 합니다. 휴식 시간 내에 각 개별 광고가 재생을 시작할 때 광고 시작을 보냅니다. 광고가 재생되는 경우 광고 완료, 뷰어가 건너뛰기 단추를 선택하는 경우 광고 건너뛰기로 팔로우합니다. 북엔드를 생략하면 중단의 모든 광고 이벤트가 무시되고 광고 기간이 기본 콘텐츠로 잘못 귀속됩니다.

다음 예제는 뷰어가 세 번째 광고를 건너뛴, 세 개의 광고가 포함된 단일 광고 브레이크에 대한 올바른 이벤트 시퀀스를 보여 줍니다.

챕터 이벤트

챕터 이벤트는 선택 사항이며 세션 내에서 이름이 지정된 콘텐츠 세그먼트를 추적합니다. 이들은 자연스럽게 이산적인 부분으로 나뉘어지는 내용에 잘 부합한다. 일반적인 예로는 오디오북의 챕터, 다큐멘터리의 작업, 비디오 과정의 수업 또는 팟캐스트 에피소드의 세그먼트가 있습니다. 대상자가 건너뛸 경향이 있는 챕터를 식별하는 등 세그먼트 수준에서 뷰어 참여를 이해하려는 경우 챕터 이벤트를 사용합니다.

챕터가 시작되면 챕터 시작을 보냅니다. 뷰어가 챕터의 끝까지 시청하는 경우 챕터 완료를 보냅니다. 뷰어가 챕터 경계가 완료되는 것을 보지 않고 지나가도록 하려면 대신 챕터 건너뛰기를 보냅니다. 새 챕터를 열려면 먼저 챕터 완료 또는 챕터 건너뛰기로 챕터를 닫아야 합니다. 챕터는 겹칠 수 없습니다.

플레이어 상태 이벤트

플레이어 상태 이벤트는 뷰어가 세션 전체에서 플레이어 컨트롤과 상호 작용하는 방법을 추적합니다. 이 메서드는 뷰어가 자막 또는 음소거를 활성화하는 빈도와 같은 접근성 기능 사용을 이해하는 데 유용합니다. 또한 전체 화면 대 인라인 보기 및 PIP(Picture-in-Picture) 멀티태스킹과 같은 보기 비헤이비어 패턴을 보여줍니다.

추적할 수 있는 5개 상태는 fullscreen, mute, closedCaptioning, pictureInPicture 및 inFocus입니다. 플레이어가 이러한 상태에 들어오면 상태 시작을 보내고 종료되면 상태 끝을 보냅니다. 여러 상태를 동시에 활성화할 수 있습니다. 뷰어는 전체 화면에 있고 동시에 음소거될 수 있으며 여러 상태는 동일한 이벤트 호출 내에서 종료될 수 있습니다.

오류 이벤트

Error 이벤트는 세션 중 재생 실패(실패한 스트림 요청, 코덱 오류 또는 외부 게재 실패)를 기록합니다. 의미 있는 오류가 발생할 때마다 보내십시오. 오류 이벤트로 인해 세션이 닫히지 않습니다. 재생이 계속될 수 있으며 후속 이벤트가 동일한 세션에서 추적됩니다. 오류를 복구할 수 없는 경우 세션 종료 와 함께 이 오류를 수행하여 세션을 명시적으로 닫습니다.