개요: 데이터 수집 API v2

서문

분석 데이터는 네이티브 플레이어 SDK에서 제공하는 데이터를 포함하여 브라이트코브 플레이어가 자동으로 전송합니다. 당신이있는 경우아니 Brightcove Player를 사용하여 Video Cloud 비디오를 제공하려면 데이터 수집기로 데이터를 전송하는 데 사용중인 플레이어를 계측해야합니다.

Data Collection API v2는 현재 표준입니다. v1 버전은 더 이상 사용되지 않습니다. v1 구현이있는 경우 v1에서 변경된 사항아래 섹션.

이 개요 및 API 참조 , 이것도 참조샘플 구현 .

Analytics Data Collection API는 실시간 분석 이벤트의 끝점입니다. 이벤트 데이터는 다음과 같은 HTTP 요청을 통해 제출 된 일련의 매개 변수를 통해 Brightcove로 전송됩니다.

  http://metrics.brightcove.com/v2/tracker?event=video_view&domain=videocloud&account=123&video=789
  
  

이 매개 변수는것이벤트가 발생했을 때 시스템 상태에 대한 정보. 위의 예는video_view비디오에 대한 이벤트 발생789계정123 (또는 : 사용자가 계정을보기 시작했습니다. 123님의 비디오789 . 보다이하추적 된 현재 분석 이벤트에 대한 설명).

해상도 및 비트레이트

차원은 이벤트 발생시 시스템 상태에 대한 정 성적 사실입니다. 예를 들어 요청이 다음과 같은 경우 :

  http://metrics.brightcove.com/tracker
  ?event=video_view&session=581136_2018-07-03T18:34:46.214Z
  &domain=videocloud&account=123
  &video=789
  
  

동영상 ID ( 789 ) 및 계정 ID ( 123 ), 요청 자체에서 수집 한 모든 기기 및 위치 정보는 모두video_view행사. Analytics 시스템은video_view이 요청이 작성되었을 때 이벤트가 발생했습니다.

이벤트 및 도메인 매개 변수

그만큼event매개 변수는 발생한 이벤트를 설명합니다. 그만큼domain매개 변수는 이벤트에 대한 네임 스페이스를 제공합니다. 그만큼event , domain , 및session필수 매개 변수입니다 (값domain항상videocloud ).

추가 매개 변수

Analytics 시스템이 이벤트를 성공적으로 분석 할 수 있도록 특정 매개 변수가 이벤트에 포함되어야합니다.

응답 유형

분석 데이터 수집 API 요청에 대한 응답에는 HTTP 응답 코드와 사람이 읽을 수있는 메시지가 포함됩니다.

최소한의 데이터

최소한session이드와video_view세션 중에 재생되는 모든 비디오에 대한 이벤트입니다. 그만큼video_view보내야한다후모든 프리 롤 광고가 완료됩니다.

session

이것은 세션 식별자입니다. 그만큼session본질적으로 플레이어가있는 페이지 또는 앱보기의 한보기입니다. 값은 세션 기간 동안 일정해야하며모든 이벤트에 대해 보냄 . GUID (Globally Unique Identifier)에 최대한 가까워 야합니다. 충돌이있는 경우 두 세션이 얽 히지 않으면 유효하지 않은 것으로 폐기 될 수 있습니다.

JavaScript에서 GUID를 만드는 데는 다양한 체계가 있습니다. 한 가지 예는이 GitHub 저장소 . Brightcove는 타사 스크립트를 지원하지 않습니다.

성능을위한 최소 데이터 (재생률 및 참여도 점수)

사내 행사 및 이벤트 소식을 비디오로 제공하십시오.

• video_impression
• video_view
• video_engagement

속성 (모든 이벤트)

• account
• video

추가 속성 ( video_engagement이벤트 만)

주문형 비디오

• range
• video_duration

라이브

• video_seconds_viewed

HTTP 헤더

• User-Agent -기기보고에 필요

모범 사례

Collector에 올바른 데이터를 전송하고 있는지 확인하려면 일반적으로 배포하기 전에 데이터 수집 스크립트를 테스트해야합니다. 다음을 권장합니다.

1. 플레이어에 대한 데이터 수집 스크립트를 작성하십시오.
2. 통제 된 환경에서 최소 하루 동안 테스트하십시오.
3. 분석 모듈 또는Analytics API수집 된 내용이 귀하의 기대와 일치하는지 확인합니다.

요청 보내기-CORS 문제 방지

정크 데이터

일반적으로 Collector로 전송 된 데이터는 Analytics 시스템에 의해 진실로 기록됩니다. 이벤트에 부적절하거나 잘못된 정보가 포함 된 경우 Analytics 시스템은 데이터를 잘못 해석합니다.

예를 들어 실수로 타임 스탬프를 비디오 ID로 보낸 경우 분석 데이터가 전체 요약에 영향을 미치는 방식으로 왜곡됩니다.

URI 인코딩

공백 또는 특수 문자를 포함 할 수있는 Data Collection API로 보내는 모든 문자열 URI로 인코딩되어야합니다.요청이 성공합니다. JavaScript를 통해 요청을 제출하는 경우 다음을 사용할 수 있습니다. encodeURI()메서드는 요청 문자열을 인코딩합니다. 예:

  urlStr += "&video=" + currentVideo.id + "&video_name=" + encodeURI(currentVideo.video_name);
  
  

사내 행사 및 이벤트 소식을 비디오로 제공하십시오.

아래 나열된 이벤트는 Analytics 시스템에서 처리됩니다.

player_load

의도 / 의미

최종 사용자가 플레이어 세션을 시작했습니다. 이는 분석 세션의 시작을 표시하며 다른 이벤트보다 먼저 전송되어야합니다.

예

http://metrics.brightcove.com/tracker
  ?event=player_load
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  %2Furl%3Fsa%3D-t%26rct%3Dj%26q%3D%26esrc%3Ds%26source
  %253A-%252F%252Fsupport.brightcove.com%252F%26ei%3D
  OdxWZSGdJ-pL7WJaEeUJVlnw%26bvm%3Dbv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200
  &time=1377191644796

error

의도 / 의미

재생 환경을 방해하는 치명적인 오류가 발생하면 전송됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=error
  &error_code=MEDIA_ERR_SRC_NOT_SUPPORTED
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  %3Dhttp%253A-%252F%252Fsupport.brightcove.com
  %26usgWZSGdJ-pL7WJaEeUJVlnw%26bvm%3Dbv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200
  &time=1377191644796

catalog_request

의도 / 의미

Video Cloud Playback API에 대한 요청이있을 때 전송됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=catalog_request
  &session=581136_2018-07-03T18:34:46.214Z
  &catalog_url=https%3A%2F%2Fedge.api.brightcove.com%2Fplayback
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  %3Dhttp%253A-%252F%252Fsupport.brightcove.com
  WZSGdJ-pL7WJaEeUJVlnw%26bvm%3Dbv.51156542%2Cd.dmg
  &domain=videocloud&account=1749339200
  &time=1377191644796

catalog_response

의도 / 의미

이전에 대한 응답이있을 때 보냄catalog_request접수됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=catalog_response
  &session=581136_2018-07-03T18:34:46.
  &catalog_url=https%3A%2F%2Fedge.api.brightcove.com%2Fp2F23823423800
  &response_time_ms=243
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  53A-%252F%252Fsupport.brightcove.com%252F%2Tzn-oCgCQ
  AFQjCNJaEeUJVlnw%26bvm%3Dbv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200
  &time=1377191644796

play_request

의도 / 의미

사용자가 명시 적으로 재생 버튼을 클릭하여 재생을 시작하거나 플랫폼이 자동 재생 시나리오에서 재생을 트리거 할 때 자동으로 전송됩니다. 여러play_request시청자가 동영상을 일시 중지했다가 다시 시작하면 단일 시청 세션 중에 이벤트가 전송 될 수 있습니다.

예

http://metrics.brightcove.com/tracker
  ?event=play_request
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  %3Dhttp%253A-%252F%252Fsupport.brightcove.com%252F%2
  dJ-pL7WJaEeUJVlnw%26bvm%3Dbv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200
  &time=1377191644796

ad_mode_begin

의도 / 의미

재생 플랫폼이 광고 대행사에게 제어권을 넘길 때 전송됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=ad_mode_begin
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  %3Dhttp%253A-%252F%252Fsupport.brightcove.com%252
  %26usg%3DAFQjCNEtLod%3Dbv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200
  &time=1377191644796

ad_mode_complete

의도 / 의미

재생 플랫폼이 광고 대행사에게 제어권을 넘길 때 전송됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=ad_mode_complete
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A-%2F%2Fsup-port.brightcove.com%2F
  &source=http%3A-%2F%2Fwww.google.com
  %3Dhttp%253A-%252F%252Fsupport.brightcove.com%252F%2
  WZSGdJ-pL7WJaEeUJVlnw%26bvm%3Dbv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200
  &time=1377191644796

video_impression

의도 / 의미

플레이어에 추가 된 동영상의 메타 데이터가로드를 완료했으며 플레이어는 자동 재생 또는 사용자 상호 작용을 통해보기 이벤트를 트리거 할 준비가되었습니다.

예

http://metrics.brightcove.com/tracker
  ?event=video_impression
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A%2F%2Fwww.current-times.com%2F
  &time=1377191644801
  &source=http%3A%2F%2Fwww.google.com
  %252-F%26ei%3DoEYWUtCgEIXq9ATznoCgCQ
  %26usg%3DAFQjCNEtLod-Odx6bvm%3Dbv.5115-6542%2Cd.dmg
  &video=2621468623001
  &video_name=Democratic-Rivals%20Target%20Bill
  &domain=videocloud
  &account=1749339200

video_view

의도 / 의미

동영상 재생이 시작되었습니다 (로드 후 자동 재생 또는 사용자 상호 작용으로 인해). 단 하나video_view시청자가 비디오를 중지했다가 다시 시작하거나 재생하더라도 시청 세션 중에 이벤트가 녹화됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=video_view
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A%2F%2Fwww.current-times.com%2F
  &video=2621468623001
  &video_name=Debate-2
  &video_duration=189
  &time=1377191666432
  &source=http%3A%2F%2Fwww.google.com%2Furl%
  %252F%26ei%3DoEYWUtCgEIXq9ATznoCgCQ%26us-g
  %3DAFQjCNEtv.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200

video_engagement

의도 / 의미

사용자가 비디오 타임라인의 시간 범위를 초 단위로 시청했습니다. 이 이벤트는 비디오 참여도를 추적하기 위한 하트비트이며 사용자 상호 작용 및 비디오 길이에 따라 재생 중에 여러 번 전송될 수 있습니다. Brightcove 플레이어 계측은 재생이 중단되지 않은 경우 10 초마다이 이벤트를 보냅니다. 20 초 이상의 범위를 설명하는 이벤트는 Analytics 시스템에서 삭제됩니다.

예

http://metrics.brightcove.com/tracker
  ?event=video_engagement
  &session=581136_2018-07-03T18:34:46.214Z
  &destination=http%3A%2F%2Fwww.current-times.com%2F
  &video=2621468623001
  &video_name=Debate-2
  &video_duration=189
  &time=1377191676589
  &range=0..9
  &source=http%3A%2F%2Fwww.google.com
  %2Furl%3Fsa%3Dt-%26rct%3Dj%26q%3D%26esrc%3Ds
  %26source%3Dweb%26cd%3D1%26ved%3D0CDYQFjAA
  %26url%3Dhttp%253A%252F%252Fwww.current-times.com
  %252F%26ei%3DoEYWUtC-gEIXq9ATznoCgCQ
  %26usg%3DAFQjCNEtLodOdxWZSGdJpL7WJ.51156542%2Cd.dmg
  &domain=videocloud
  &account=1749339200

모든 이벤트에 대한 매개 변수

이러한 이벤트에 대한 매개 변수에는 이벤트가 발생했을 때 시스템의 현재 상태와 관련된 모든 정보가 포함되어야하며 가능한 한 구체적이어야합니다. 이 섹션에서는 모든 이벤트와 함께 전송할 수있는 매개 변수에 대해 자세히 설명하고 다음 섹션에서는 특정 이벤트에 대한 매개 변수를 보여줍니다.

사용자 매개 변수

• 플레이어 / 클라이언트 애플리케이션이 고유 한 뷰어를 추적하려면 사용자 매개 변수로 수집기에 고유 한 ID를 보내야합니다.
• 만약user제공되지 않거나 비어있는 경우 대체 방법을 사용하여Source IP address + the User-Agent String고유 식별자로.
• 사용자 매개 변수의 값은 로그 / 데이터베이스에 저장되지 않으며 해시 (SHA-256 사용) 만 저장됩니다.
• 수집기는 쿠키를 설정하지 않습니다.

고유 사용자

Brightcove Player의 플러그인 기능을 사용하여보고 된 분석에 고유 한 비디오 뷰어 데이터를 추가 할 수 있습니다. 이렇게하려면 고유 식별자를settings분석 기능의 개체.

물론 고유 한 사용자 ID를 캡처하는 방법은 응용 프로그램마다 다르지만 예를 들어이 코드는 다음과 같은 고유 한 사용자 데이터를 포함하는 로그인 URL이 캡처된다고 가정합니다. http://exampledomain.com/users/912389123 . 이 고유 URL이 플러그인에 전달됩니다.

아래 플러그인 코드는 다음 작업을 수행합니다.

• 표준 구문을 사용하여 플러그인 이름이 다음과 같이 정의 된 Brightcove Player 플러그인을 만듭니다. uniqueUserForAnalyticsPlugin . 플러그인은 또한options플러그인에 전달 된 데이터를 포함하는 객체입니다.
• 그만큼myPlayer변수에 플레이어에 대한 참조가 할당됩니다. 또한 두 개의 다른 변수가 생성됩니다.
• 그만큼userPath변수에는 다음을 통해 플러그인에 전달 된 경로가 할당됩니다. options목적.
• 그만큼uniqueViewer변수에 구문 분석 된 버전이 할당됩니다. userPath이므로 사용자 ID 숫자 만 변수에 할당됩니다.
• 사용자 속성이 애널리틱스 플러그인의settings목적.

  videojs.registerPlugin('uniqueUserForAnalyticsPlugin', function(options) {
  var myPlayer = this,
  userPath = '',
  uniqueViewer = '';
  //Assign uniqueViewer a value according to your app and business rules
  //In this example, parsing the path passed to the plugin in the options object
  userPath = options.path;
  uniqueViewer = userPath.substring( userPath.lastIndexOf('/') + 1 );
  //Assign a user variable to Analytic's settings object
  myPlayer.bcAnalytics.client.user(USER) = uniqueViewer;
  });
  
  

이 코드는 애플리케이션 로직에 맞게 변경 한 다음 인터넷 액세스 가능 URL에 저장해야합니다.

Studio에서플러그인섹션과 같이 플레이어에서 플러그인을로드합니다.

뒤에 나오는 JSON 대신 사용자 데이터가 포함 된 문자열을 플러그인에 전달합니다. 물론, 플러그인 코드는 고유 한 사용자 ID를 추출하기 위해 그에 따라 업데이트되어야합니다.

  {
  "path": "http://exampledomain.com/users/912389123"
  }
  
  

플러그인 개발에 대한 자세한 내용은단계별 : 플러그인 개발문서.

device_type , device_os , device_os_version , device_manufacturer , 및browser_type매개 변수

기본적으로 Analytics 시스템은 User-Agent 헤더에서 장치 유형 및 OS 정보를 감지하려고 시도합니다. 만약양자 모두device_type과device_os전송되면 User-Agent 헤더의 정보가 무시됩니다. device_type과device_os . 대부분의 경우 장치, OS 및 브라우저 정보를 보낼 필요가 없습니다. -이 재정의는 User-Agent가 신뢰할 수 없거나 사용할 수없는 경우에만 사용해야합니다.

분석 시스템은other요청에 기기 매개 변수 재정의에 대해 인식 할 수없는 값이 포함 된 경우

지리 데이터 매개 변수

기본적으로 Analytics 시스템은 원격 IP 주소에서 지리 정보를 감지하려고 시도합니다. 이 동작은 다음을 전달하여 재정의 할 수 있습니다. country , country_name , region , region_name , city과dma매개 변수. 대부분의 경우 이러한 매개 변수는 필요하지 않습니다. -이 재정의는 원격 IP 주소를 신뢰할 수 없거나 사용할 수없는 경우에만 사용해야합니다.

분석 시스템은ZZ또는unknown요청에 인식 할 수없는 재정의 값이 포함 된 경우

목적지 및 소스 매개 변수

그만큼destination과source매개 변수는 이벤트 ( destination ) 및 사용자를 그곳으로 보낸 URI ( source ).

그만큼source매개 변수는 트래픽 소스 정보를 결정하는 데 사용됩니다. 만약source지정되지 않은 경우 Analytics 시스템은 이벤트를 직접 트래픽에 의해 시작된 것으로 처리합니다.

그만큼destination매개 변수는 트래픽 목적지 정보, 즉 동영상이 시청되는 위치를 결정하는 데 사용됩니다. URI에 권한이 포함되지 않은 경우 API는destination_domain . 그만큼destination_path URI의 경로로 기록됩니다.

웹 재생 중에 동영상이 재생되는 페이지의 주소 표시 줄에있는 URL은destination , 그리고source리퍼러 ( top.document.referrer ).

예를 들어 Brightcove 지원 사이트에서 "실시간 스트리밍 유선 방송"을 검색하고 결과에 나오는 비디오를 볼 때 :

  https://support.brightcove.com/en/video-cloud/search/live%20streaming%20wirecast
  
  

  https://support.brightcove.com/en/video-cloud/training-videos/live-streaming-wirecast
  
  

URL이없는 경우 (예 : 기본 재생의 경우) destination과source동영상이 재생되는 위치와 사용자가 거기에 도착한 방법을 각각 식별하는 유효한 URI 여야합니다.

가정destination이다유효한 URI :

  <scheme name> : <hierarchical part> [ ? <query> ] [ # <fragment> ]
  ex. https://www.example.com/foo/bar/baz
  --------------/----------/
  |             |
  authority        path
  ---/    -------------------------/
  |                |
  scheme       hierarchical part
  
  

Analytics 시스템은 다음과 같이 처리합니다.

URI에권위 , API 응답은 해당 권한을destination_domain및destination_path . URI에 권한이 포함되지 않은 경우 API는destination_domain . 그만큼destination_path URI의 경로로 기록됩니다. ㅏdestination체계가없는 모든 값과 마찬가지로 계층 적 부분이없는 (예 : 체계 만)은 유효하지 않은 것으로 간주됩니다.

특정 이벤트에 대한 매개 변수

오류 이벤트 매개 변수

다음 매개 변수는error이벤트.

catalog_request 이벤트 매개 변수

다음 매개 변수는catalog_request이벤트.

catalog_response 이벤트 매개 변수

다음 매개 변수는catalog_response이벤트.

video_impression 이벤트 매개 변수

다음 매개 변수는video_impression이벤트.

video_view 이벤트 매개 변수

다음 매개 변수는video_view이벤트.

video_engagement 이벤트 매개 변수

다음 매개 변수는video_engagement이벤트.

그만큼video_engagement이벤트는 비디오가 재생되는 동안 비디오 참여를 추적하는 수단이며 재생 중에 여러 번 전송 될 수 있습니다. (재생이 중단되지 않은 경우 Flash / HTML5 플레이어 계측은 10 초마다이 이벤트를 보냅니다.) 현재 20 초 이상의 범위를 설명하는 이벤트는 Analytics 시스템에 의해 삭제되므로 이러한 이벤트를 더 자주 전송해야합니다.

두 가지 형태가 있습니다. video_engagement이벤트는 다음을 취할 수 있습니다 (간결성을 위해 다른 매개 변수는 생략 됨).

  event=video_engagement&video=123&video_duration=75&range=0..9
  
  

두 버전 모두 시청 시간을 추적하지만video_duration과range또한 추가 참여 데이터를 계산하는 데 필요한 정보를 포함하며선호하는 방법보내다video_engagement분석 시스템에 이벤트 데이터를 보냅니다. 라이브 스트림의 경우 또는 비디오의 타임 라인이 재생 중에 계속 변경되거나 신뢰할 수없는 경우, video_seconds_viewed사용 가능한 유일한 데이터입니다. VOD의 경우duration사용할 수 없습니다. video_engagement이벤트에는video_duration과range .

세 가지 매개 변수 ( video_duration , range과video_seconds_viewed )는video_engagement이벤트가 발생하면 Analytics 시스템은video_duration + range매개 변수.

V2 변경 사항

이 섹션에서는 v1을 사용해 온 사용자를 위해 데이터 수집기의 v1에서 v2 로의 변경 사항을 요약합니다.

추적기의 기본 URL

  http(s)://metrics.brightcove.com/v2
  
  

모든 이벤트에서 지원되는 추가 필드 :

device_os_version : 기기에서 사용중인 OS의 버전입니다. 지정하지 않으면 추적 요청에 대한 사용자 에이전트 문자열을 구문 분석하여 계산됩니다.

platform_version : 지정된 플랫폼의 새 릴리스가 이벤트를 보내는 데 사용됨을 나타내는 데 사용됩니다.

V2의 새로운 이벤트

catalog_request : videocloud 카탈로그 API에 대한 요청이있을 때 전송됩니다.이 이벤트는 내부 용이며 분석 모듈 또는 분석 API를 통해 노출되지 않습니다.

• 카탈로그 URL : 다음과 관련된 도착 URL catalog_request이벤트-이 이벤트는 내부 용이며 Analytics 모듈 또는 Analytics API를 통해 노출되지 않습니다.

카탈로그 _ 응답 : 이전에 대한 응답이있을 때 보냄catalog_request수신 됨-이 이벤트는 내부 용이며 Analytics 모듈 또는 Analytics API를 통해 노출되지 않습니다.

• 카탈로그 URL : 다음과 관련된 도착 URL catalog_request이 응답을 시작한 이벤트-이 이벤트는 내부 용이며 Analytics 모듈 또는 Analytics API를 통해 노출되지 않습니다.
• response_time_ms : 사이의 시간 (밀리 초) catalog_request이벤트 및catalog_response이벤트-이 이벤트는 내부 용이며 Analytics 모듈 또는 Analytics API를 통해 노출되지 않습니다.

play_request : 사용자가 명시 적으로 재생 버튼을 클릭하여 재생을 시작하거나 플랫폼이 자동 재생 시나리오에서 재생을 트리거 할 때 자동으로 전송됩니다.

ad_mode_begin : [대체ad_start ] 재생 플랫폼이 광고 대행사에게 제어권을 넘겨 주면 전송됩니다.

ad_mode_complete : [대체ad_end ] 광고 대행사에서 재생 플랫폼으로 제어권이 넘겨지면 전송됩니다.

오류 : 재생 환경을 방해하는 치명적인 오류가 발생하면 전송됩니다.

• 에러 코드 : 이벤트와 관련된 플랫폼 특정 오류 코드입니다.

V2에 대한 업데이트 된 이벤트

video_view : 새로운 대기 시간 측정 포함

• load_time_ms : 비디오에 대한 데이터로드를 시작하고 비디오를 재생할 수있게되는 사이의 시간 (밀리 초)입니다.
• start_time_ms : 재생 시작과 렌더링되는 비디오의 첫 번째 프레임 사이의 시간 (밀리 초)입니다. 이는 경험에 따라 다를 수 있습니다. 예를 들어 구성된 프리 롤 광고가없는 경우이 측정 값은 'play_request'와video_view이벤트. 프리 롤 광고가있는 경우ad_mode_begin과ad_mode_complete포함되지 않아야합니다.

video_engagement : 추가 변환 선택, 비트 전송률 측정 및 버퍼링 정보를 포함합니다. 참여 기간 동안 시청이 발생하지 않은 경우에도 정기적으로 전송해야한다는 점에서 동영상 참여도 미묘하게 변경되었습니다. 이 변경은 사용자가 재생을 기다리게하는 재 버퍼링 지연 및 카운트 추적을 활성화하기위한 것입니다.

• 범위 : 범위 매개 변수는 이제 선택 사항입니다. 범위는 참여 이벤트에서 제외되어 이벤트에 포함 된 기간 동안보기 활동이 없음을 표시 할 수 있습니다. (예 : re-buffering 활동 만있는 경우)
• rendition_url : 가장 최근에 선택한 변환의 URL입니다. 예를 들어 HLS 스트림의 경우 가장 최근에 선택한 변형의 URL이됩니다.
• rendition_indicated_bps : 가장 최근에 선택한 변환의 표시된 비트 전송률 (초당 비트 수)입니다.
• rendition_mime_type : 가장 최근에 선택한 변환의 MIME 유형입니다.
• rendition_height : 비디오 변환의 인코딩 된 높이 (픽셀)
• rendition_width : 비디오 변환의 인코딩 된 너비 (픽셀)
• rebuffering_seconds : 참여 기간 동안 요청되지 않은 지연으로 인해 사용자가 동영상 재생을 기다리는 데 소비 한 시간 (초)입니다.
• rebuffering_count : 표시된 참여 기간 동안 다시 버퍼링으로 인해 재생이 중지 된 횟수입니다.
• forward_buffer_seconds : 현재 정방향 버퍼에있는 비디오의 시간 (초)입니다.
• 측정 된 _bps : 가장 최근에 다운로드 한 세그먼트에 포함 된 비트 수와 해당 세그먼트를 다운로드하는 데 소요되는 시간의 비율 (초당 비트 수)입니다.
• player_width참여 범위가 끝날 때 플레이어의 현재 픽셀 너비입니다.
• player_height참여 범위가 끝날 때 플레이어의 현재 픽셀 높이입니다.
• drop_frames : 이 참여 기간 동안 비디오 재생에서 삭제 된 프레임 수