지원 지원 문의 | 시스템 상태 시스템 상태

개요 : Data Collection API v2

이 항목에서는 애널리틱스 개요를 제공합니다. Data Collection API v2 : 이벤트를 이벤트에 추가 할 수 있습니다. Video Cloud Brightcove가 이벤트를 직접 추적 할 수없는 상황의 분석 데이터.

소개

웹 로그 분석 데이터는 Brightcove Player원주민이 제공 한 것들을 포함하여 Player SDK. 당신이있는 경우 지원 를 사용하여 Brightcove Player 제공하는 Video Cloud 비디오, 당신은 악기를해야합니다 player 데이터를 데이터 콜렉터로 전송하는 데 사용 중입니다.

Data Collection API v2는 현재 표준입니다. v1 버전은 더 이상 사용되지 않습니다. v1 구현을 사용하는 경우 v1의 변경 사항 섹션을 참조하십시오.

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

애널리틱스 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 행사. 애널리틱스 시스템은 video_view 요청이 생성 될 때 이러한 차원으로 이벤트가 발생했습니다.

이벤트 및 도메인 매개 변수

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

추가 매개 변수

애널리틱스 시스템에서 이벤트를 분석 할 수 있도록 특정 매개 변수가 이벤트에 포함되어야합니다.

응답 유형

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

HTTP 상태 코드 설명
200 요청은 수집기에 의해 성공적으로 수신되었고 지속되었습니다. (1x1 픽셀 투명 GIF 이미지를 반환)
400 클라이언트가 보낸 요청에 필수 매개 변수가 누락되었습니다. domain, account or event. 도메인 별 매개 변수가 누락 된 경우이 상태는 반환되지 않습니다. "Invalid 'event' parameter"
50x 이 오류 코드는 서버 측의 문제점을 나타냅니다. 귀하의 이벤트는 분석 시스템에 의해 성공적으로 기록 된 것일 수도 있고 아닐 수도 있습니다. "Server-side failure, please retry."

최소 데이터

최소한, session 이드와 video_view 세션 중에 재생 된 모든 동영상에 대한 이벤트입니다. 그만큼 video_view 보내야한다. 모든 프리 롤 광고가 완료됩니다.

session

이것은 세션 식별자입니다. 그만큼 session 본질적으로 페이지 또는 앱보기의 한보기입니다. player 그것이 지속되는 한. 세션 기간 동안 값이 일정해야합니다. 모든 행사에 발송 됨. 전역 고유 식별자 (GUID)에 가능한 한 근접해야합니다. 충돌이있는 경우 두 세션을 분리 할 수없는 경우 두 세션을 유효하지 않은 것으로 폐기 할 수 있습니다.

JavaScript로 GUID를 생성하는 방법에는 여러 가지가 있습니다. 한 가지 예가 이 GitHub 저장소. Brightcove는 타사 스크립트를 지원하지 않습니다.

성능을위한 최소 데이터 (재생 속도 및 Engage멘팅 점수)

이벤트

  • video_impression
  • video_view
  • video_engagement

속성 (모든 이벤트)

  • account
  • video

추가 속성 (video_engagement 이벤트 만)

VOD
  • range
  • video_duration
Live
  • video_seconds_viewed

HTTP 헤더

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

모범 사례

올바른 데이터를 수집기로 보내려면 일반적으로 데이터를 배포하기 전에 데이터 수집 스크립트를 테스트해야합니다. 권장 사항 :

  1. 귀하의 데이터 수집 스크립트 작성 player.
  2. 최소한 하루 동안 통제 된 환경에서 테스트하십시오.
  3. 애널리틱스 모듈 또는 애널리틱스 모듈을 통해 애널리틱스 데이터를 확인하십시오. Analytics API 수집 된 내용이 귀하의 기대치와 일치하는지 확인하십시오.

요청 보내기 - CORS 문제 방지

정크 데이터

일반적으로 수집기로 전송 된 데이터는 Analytics 시스템에서 사실로 기록됩니다. 이벤트에 부적절하거나 잘못된 정보가 포함되어 있으면 Analytics 시스템에서 데이터를 잘못 해석합니다.

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

URI 인코딩

당신이 보내는 모든 문자열 Data Collection API 공백이나 특수 문자가 포함될 수 있습니다. URI로 인코딩되어야 함 요청이 성공하기 위해 자바 스크립트를 통해 요청을 제출하는 경우 encodeURI() 메소드는 요청 문자열을 인 코드합니다. 예 :

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

이벤트

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

player_load
의도 / 의미

A player 최종 사용자가 세션을 시작했습니다. 이는 분석 세션의 시작을 나타내며 다른 이벤트보다 먼저 보내야합니다.

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
의도 / 의미

사용자가 명시 적으로 재생 버튼을 클릭하여 재생이 시작되거나 플랫폼이 자동 재생 시나리오에서 플랫폼을 재생할 때 자동으로 재생이 시작되면 보냅니다.

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
의도 / 의미

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

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
의도 / 의미

동영상 재생이 시작되었습니다 (로드 후 또는 사용자 상호 작용으로 인해 자동 재생됩니다).

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
의도 / 의미

사용자가 동영상의 타임 라인을 초 단위로 시청했습니다. 이 이벤트는 동영상 참여를 추적하기위한 하트 비트이며 사용자 상호 작용 및 동영상 길이에 따라 재생 중에 여러 번 전송 될 수 있습니다. 브라이트 코브 player 재생이 중단되지 않으면 계측은이 이벤트를 10 초마다 보냅니다. 20 초 동안 범위를 설명하는 이벤트는 웹 로그 분석 시스템에서 삭제됩니다.

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

모든 이벤트의 매개 변수

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

분야 거래증명방식 설명
account

계정 ID

domain

항상 videocloud

허용되는 값 : "videocloud"

session 가능한 유일하게 유니크 한 세션 ID입니다. 최소 데이터 자세한 내용은 위의 섹션을 참조하십시오.
device_os 선택

사용자 에이전트가 신뢰할 수없는 경우 (장치 os 및 장치 유형이 모두 포함되거나 제출 된 값이 여기에 표시된 값 목록에없는 경우 무시됩니다.) 경우 이벤트를 시작한 장치의 OS를 지정하려면 무시하십시오. 일반적으로 포함되지 않음)

허용되는 값 : "android", "bada", "ios", "linux", "mac", "tv", "os_x", "rim", "sybian", "windows", "other"

device_os_version 선택

장치에서 사용중인 운영 체제의 버전입니다. 지정되지 않은 경우 추적 요청에 대한 사용자 에이전트 문자열을 구문 분석하여 계산됩니다

device_type 선택

사용자 에이전트가 신뢰할 수없는 경우 (장치 os 및 장치 유형이 모두 포함되거나 제출 된 값이 여기에 표시된 값 목록에 포함되어 있지 않으면 무시 됨) 이벤트를 생성 한 장치의 유형을 지정하려면 무시합니다. 일반적으로 포함되지 않음)

허용되는 값 : "direct", "mobile", "tablet", "tv", "desktop", "other"

event

이벤트 유형

허용되는 값 : "player_load", "catalog_request", "catalog_response", "play_request", "ad_mode_begin", "ad_mode_complete", "video_impression", "video_view", "video_engagement", "error"

destination 선택

이벤트를 발생시킨 URI

source 선택

최종 사용자를 destination URI

time 선택 번호

에포크 타임 (밀리 초)의 이벤트 타임 스탬프

country 선택

ISO-3166 (알파 2) 지역 cISO-3166 (알파 2) 지역 코드 (시스템이 IP 주소에서 지리 정보를 감지 할 수없는 경우 대체) 일반적으로 포함되지 않음

country_name 선택

사람이 읽을 수있는 국가 이름 (시스템이 IP 주소의 지리 정보를 감지 할 수없는 경우 대체) 일반적으로 포함되지 않음

region 선택

ISO-3166 (alpha 2) 지역 코드 (시스템이 IP 주소의 지리 정보를 감지 할 수없는 경우 대체) 일반적으로 포함되지 않음

region_name 선택

사람이 읽을 수있는 지역 이름 (시스템이 IP 주소의 지리 정보를 감지 할 수없는 경우 대체) 일반적으로 포함되지 않음

city 선택

도시 이름 일반적으로 포함되지 않음

user 선택

고유 한 사용자 식별자 - 제공되지 않거나 공백 인 경우, Video Cloud 를 사용하는 대체 방법을 사용합니다. Source IP address + the User-Agent 고유 식별자로서의 문자열. Brightcove는이 정보를 사용하여 순 사용자를 계산합니다. API 또는 분석 모듈을 통해 사용자 데이터 자체를 검색 할 수 없습니다

사용자 매개 변수

  • 경우 player/ client 응용 프로그램은 사용자에 대한 고유 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 변수에 대한 참조가 할당됩니다 player. 또한 두 개의 다른 변수가 작성됩니다.
  • 그리고, 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에서 플러그인 플러그인을로드하는 섹션 player, 보여진 바와 같이.

Studio 플러그인 섹션
Studio 플러그인 섹션

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

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

플러그인 개발에 대한 자세한 내용은 단계별 : 플러그인 개발 문서를 참조하시기 바랍니다.

device_type, device_os, device_os_version, device_manufacturerbrowser_type 매개 변수

기본적으로 애널리틱스 시스템은 User-Agent 헤더에서 기기 유형 및 OS 정보를 감지합니다. 만약 device_typedevice_os 가 전송되면 User-Agent 헤더의 정보는 무시됩니다. device_typedevice_os. 대부분의 경우 장치, OS 및 브라우저 정보를 보낼 필요가 없습니다. -이 오버라이드는 사용자 에이전트가 신뢰할 수 없거나 사용할 수없는 경우에만 사용해야합니다.

웹 로그 분석 시스템이 기록합니다. other 요청에 장치 매개 변수 대체에 대해 인식 할 수없는 값이 포함 된 경우

지리 데이터 매개 변수

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

웹 로그 분석 시스템이 기록합니다. ZZ or unknown 요청에 재정의에 대해 인식 할 수없는 값이 포함 된 경우

대상 및 소스 매개 변수

그리고, destinationsource 매개 변수는 이벤트를 발생시킨 URI를 제공합니다 ( destination)와 거기에 사용자를 보낸 URI ( source).

그리고, source 매개 변수는 트래픽 소스 정보를 결정하는 데 사용됩니다. 만약 source 가 지정되지 않으면 애널리틱스 시스템에서 이벤트를 직접 트래픽으로 시작한 것으로 간주합니다.

그리고, destination 매개 변수는 트래픽 대상 정보, 즉 비디오가 시청되는 위치를 결정하는 데 사용됩니다. URI에 권한이 없으면 API는 destination_domain. 그만큼 destination_path URI의 경로로 기록됩니다.

웹 재생 중에 동영상이 재생되고있는 페이지의 검색 주소창에있는 URL은 destinationsource 리퍼러입니다 ( top.document.referrer).

예를 들어, Brightcove 지원 사이트에서 "실시간 스트리밍 와이어 캐스트"를 검색하고 결과에 나타나는 비디오를 볼 때 :

매개 변수 가치관
source
  https://support.brightcove.com/en/video-cloud/search/live%20streaming%20wirecast
  
  
destination
  https://support.brightcove.com/en/video-cloud/training-videos/live-streaming-wirecast
  
  

URL이없는 경우 (예 : 기본 재생의 경우), 둘 다 destinationsource 동영상 재생 위치와 사용자 도착 방법을 나타내는 유효한 URI 여야합니다.

가정 destination 하는 유효한 URI:

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

애널리틱스 시스템에서 다음과 같이 처리합니다.

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

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

오류 이벤트 매개 변수

다음과 같은 매개 변수를 보내야합니다. error 이벤트.

분야 거래증명방식 설명
error_code 선택 번호

이벤트와 관련된 플랫폼 관련 오류 코드

catalog_request 이벤트 매개 변수

다음과 같은 매개 변수를 보내야합니다. catalog_request 이벤트.

분야 거래증명방식 설명
catalog_url 선택

catalog_request 이벤트와 연결된 대상 URL

catalog_response 이벤트 매개 변수

다음과 같은 매개 변수를 보내야합니다. catalog_response 이벤트.

분야 거래증명방식 설명
catalog_url 선택

이 응답을 시작한 catalog_request 이벤트와 연결된 대상 URL

response_time_ms 선택 번호

catalog_request 이벤트와 catalog_response 이벤트 사이의 시간 (밀리 초)

video_impression 이벤트 매개 변수

다음과 같은 매개 변수를 보내야합니다. video_impression 이벤트.

분야 거래증명방식 설명
video 선택

동영상 ID

video_name 선택

비디오 이름

video_view 이벤트 매개 변수

다음과 같은 매개 변수를 보내야합니다. video_view 이벤트.

분야 거래증명방식 설명
video 선택

동영상 ID

video_name 선택

비디오 이름

start_time_ms 선택

재생 시작과 렌더링 될 비디오의 첫 번째 프레임 사이의 시간 (밀리 초)입니다. 경험에 따라 다를 수 있습니다. 예를 들어 프리 롤 광고가 구성되지 않은 경우이 측정은 play_requestvideo_view 이벤트. 프리 롤 광고가있는 경우 ad_mode_beginad_mode_complete 포함되지 않아야한다.

video_engagement 이벤트 매개 변수

다음과 같은 매개 변수를 보내야합니다. video_engagement 이벤트.

분야 거래증명방식 설명
video 선택

동영상 ID

video_name 선택

비디오 이름

range 선택

시청 한 동영상의 범위 video_engagement 형식의 이벤트 StartSecond..EndSecond (StartSecond 및 EndSecond 값은 정수 여야합니다.) - 범위는 참여 이벤트에서 제외되어 이벤트가 적용되는 기간 동안보기 활동이 없음을 나타낼 수 있습니다. (예를 들어, 재 버퍼링 활동 만있는 경우)

rendition_url 선택

가장 최근에 선택한 연주에 대한 URL입니다. 예를 들어, HLS 스트림의 경우 이것은 가장 최근에 선택된 변형에 대한 URL이됩니다

rendition_indicated_bps 선택

가장 최근에 선택한 연주의 비트 전송률 (비트 / 초)

rendition_mime_type 선택

가장 최근에 선택된 rendition의 MIME 형식

rendition_height 선택

비디오 렌 디션의 인코딩 된 높이 (픽셀 단위)

rendition_width 선택

비디오 렌더링의 인코딩 된 너비 (픽셀 단위)

rebuffering_seconds 선택

참여 기간 동안 요청되지 않은 지연으로 인해 사용자가 동영상을 기다리는 데 소비 한 시간 (초)

rebuffering_count 선택

참여 기간 동안 표시된 참여 기간 지연 동안 다시 버퍼링으로 인해 재생이 중지 된 횟수

forward_buffer_seconds 선택

순방향 버퍼에 현재있는 비디오의 시간 (초)

measured_bps 선택

가장 최근에 다운로드 한 세그먼트에 포함 된 비트 수와 해당 세그먼트를 다운로드하는 시간의 비율 (초당 비트 수)

player_width 선택

의 현재 픽셀 너비 player 참여 범위 끝에서

player_height 선택

의 현재 픽셀 높이 player 참여 범위 끝에서

dropped_frames 선택

dropped_frames

video_duration 선택 번호

초 단위의 비디오 재생 시간

video_seconds_viewed 선택 번호

마지막 업데이트 이후 경과 된 감시 초 수 video_engagement 이벤트

그리고, video_engagement 이벤트는 동영상이 재생되는 동안 동영상 참여를 추적하는 수단이며 재생 중에 여러 번 전송 될 수 있습니다. (플래시 / HTML5 player 재생이 중단되지 않으면 계측은이 이벤트를 10 초마다 보냅니다.) 현재 20 초 동안 범위를 설명하는 이벤트는 웹 로그 분석 시스템에서 삭제되므로 이러한 이벤트를 더 자주 전송해야합니다.

다음과 같은 두 가지 형태가 있습니다. video_engagement 이벤트가 걸릴 수 있습니다 (간결함을 위해 생략 된 다른 매개 변수).

의미
  event=video_engagement&video=123&video_duration=75&range=0..9
  
  
비디오 123 75 초의 지속 시간은 초 0에서 9까지 재생됩니다 (총 10 초를 봅니다).
event=video_engagement&video=123&video_seconds_viewed=10 10 초의 동영상 123 보았다.

두 버전 모두 조회 된 초를 추적하지만, video_durationrange 추가 참여 데이터를 계산하는 데 필요한 정보가 포함되어 있으며 선호하는 길 보내다 video_engagement 이벤트 데이터를 웹 로그 분석 시스템에 전송합니다. 라이브 스트림의 경우 또는 재생 중 비디오의 타임 라인이 지속적으로 변경되거나 신뢰할 수없는 경우, video_seconds_viewed 사용할 수있는 유일한 데이터가됩니다. VOD의 경우, duration 사용할 수 없습니다. video_engagement 이벤트에는 다음을 포함해야합니다. video_durationrange.

매개 변수 유도 참여 통계 (API)
video_duration, range video_seconds_viewed, video_percent_viewed, engagement_score; 참여 곡선 데이터
video_seconds_viewed video_seconds_viewed

세 개의 매개 변수 ( video_duration, rangevideo_seconds_viewed)와 함께 보내집니다. video_engagement 이벤트에서 애널리틱스 시스템은 video_duration+ range 매개 변수를 설정합니다.

V2 변경 사항

이 섹션에서는 v1을 사용 해본 사람들을 위해 Data Collector의 v2에서 v1로 변경된 사항을 요약하여 설명합니다.

추적기의 기본 URL

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

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

device_os_version: 장치에서 사용중인 운영 체제의 버전입니다. 지정되지 않은 경우 추적 요청에 대한 사용자 에이전트 문자열을 구문 분석하여 계산됩니다.

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

V2의 새로운 이벤트

catalog_request: 비디오 클립 카탈로그 API에 대한 요청이있을 때 전송됩니다.이 이벤트는 내부 용이며 애널리틱스 모듈이나 Analytics API.

  • catalog_url: 해당 URL과 관련된 도착 URL입니다. catalog_request 이벤트 -이 이벤트는 내부 용이며 애널리틱스 모듈 또는 Analytics API..

catalog_response: 이전에 대한 응답 catalog_request 수신 됨 -이 이벤트는 내부 용이며 애널리틱스 모듈 또는 Analytics API.

  • catalog_url: 해당 URL과 관련된 도착 URL입니다. catalog_request 이 반응을 시작한 이벤트입니다.이 이벤트는 내부 용으로 애널리틱스 모듈이나 Analytics API..
  • response_time_ms: 시간 간격 (밀리 초) catalog_request 사건과 catalog_response 이벤트 -이 이벤트는 내부 용이며 애널리틱스 모듈 또는 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_beginad_mode_complete 포함되어서는 안된다.

video_engagement: 추가 렌 디션 선택, 비트 전송률 측정 및 버퍼링 정보가 포함됩니다. 참여도 중에 시청이 발생하지 않아도 주기적으로 보내야한다는 점에서 비디오 참여에 미묘한 변화가있었습니다. 이 변경은 사용자가 재생을 기다리게하는 지연 및 카운트를 다시 버퍼링하는 것을 가능하게합니다.

  • 범위: 이제 범위 매개 변수가 선택적입니다. 범위가 참여 이벤트에서 제외되어 이벤트가 적용되는 기간 동안 조회 활동이 없음을 나타낼 수 있습니다. (예를 들어, 재 버퍼링 활동 만있는 경우)
  • rendition_url: 가장 최근에 선택한 연주에 대한 URL입니다. 예를 들어 HLS 스트림의 경우 가장 최근에 선택된 변형에 대한 URL이됩니다.
  • rendition_indicated_bps: 최근에 선택한 연주의 비트 전송률 (초당 비트 수)입니다.
  • rendition_mime_type: 가장 최근에 선택한 rendition의 MIME 형식입니다.
  • rendition_height: 비디오 렌더링의 인코딩 된 높이 (픽셀 단위)
  • rendition_width: 비디오 렌더링의 인코딩 된 너비 (픽셀 단위)
  • rebuffering_seconds: 참여 기간 동안 요청되지 않은 지연으로 인해 사용자가 동영상을 기다리는 데 소비 한 시간 (초).
  • rebuffering_count: 표시된 참여 기간 동안 다시 버퍼링으로 인해 재생이 중지 된 횟수입니다.
  • forward_buffer_seconds: 현재 전달 버퍼에있는 비디오의 초 수입니다.
  • measured_bps: 가장 최근에 다운로드 한 세그먼트에 포함 된 비트 수와 해당 세그먼트를 다운로드하는 시간의 비율 (초당 비트 수)입니다.
  • player_폭 의 현재 픽셀 너비 player 참여 범위 끝에서
  • player_신장 의 현재 픽셀 높이 player 참여 범위 끝에서
  • dropped_frames:이 참여 기간 동안 동영상 재생에서 삭제 된 프레임 수

12 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지