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

Analytics API: Live 통계

이 주제에서는 사용 가능한 분석 지표에 대해 설명합니다. Live 스트리밍합니다.

소개

에 대한 재생 측정 항목 Live 에 의해 제공되는 스트림 Brightcove Live 서비스를 통해 실시간으로 사용할 수 있습니다 분석학 API. 이 데이터는 라이브 스트림 뿐; VOD 재생은 포함되어 있지 않습니다.

API는 Live 2 개의 엔드 포인트를 통한 메트릭 측정 :

  • /v1/timeseries
  • /v1/events

둘 다 동일한 데이터 세트를 쿼리하지만 결과를 다르게 집계합니다. 이 문서는 각각의 사용법과 구문을 설명합니다.

통계

이것들은 Live 끝점. 쿼리는 여러 메트릭을 요청할 수 있습니다.

메트릭 설명
alive_ss_ad_start 서버 측 광고 노출
ccu 유일한 세션; 별개의 수 (지문 + 세션)
fingerprint_count 유일한 장치; 별개의 수 지문 (아래 참조)
video_impression 비디오가로드 된 횟수 player
video_seconds_viewed 모든 시청자가 시청 한 총 시간 (초)
video_view 스트림 시작 (고유하지 않음)

유일한 추적, 우리는 할당 지문 (Remote IP + User-Agent + Player). Google은 기기 자체에서 실제 하드웨어 ID를 사용하지 않으므로 정확도는 떨어지지 만 개인 정보를 준수합니다.

치수

다음과 같은 조합이 지원됩니다 dimensionswhere 필터 키 :

  • video
  • video, country
  • video, device_type

쿼리 매개 변수

모두 Live 끝점은 쿼리의 범위와 그룹을 제어하는 ​​몇 가지 일반적인 매개 변수를 공유합니다.

매개 변수 통사론 필수 태만 설명
치수 <dim1>,<dim2>,... Y - 검색어 측정 기준 (GROUP BY)
통계 <metric1>,<metric2>,... Y - 보고 할 하나 이상의 지표
어디에 <dim1>=<value1>;... Y - 하나 이상의 쿼리 필터; 동영상을 1 개 이상 포함해야합니다
<epoch> N 0 시간 범위 시작
<epoch> N 지금 시간 범위 끝

시계열

그리고, /v1/timeseries endpoint는 각 시점에서 요청 된 메트릭 값과 함께 타임 라인을 따라 포인트 목록을 반환합니다. 포인트는 1 분 기본적으로 버킷이지만 매개 변수를 통해 변경할 수 있습니다.

이와 관련하여 고유 측정 항목 (ccu, fingerprint_count)는 최대 값 각 버킷 중 언제든지. 따라서 bucket_duration=1d 쿼리는 하루 동안 최대 동시성을 반환합니다. bucket_limit=1 스트림의 어느 시점에서나 최대 동시성을 반환합니다.

URI

/v1/timeseries/accounts/$account

추가 매개 변수

매개 변수 통사론 필수 태만 설명
bucket_duration <n>m (의사록)
<n>h (시간)
<n>d (일)
N 1m 각 포인트가 나타내는 지속 시간. 1d 달력 날짜가 아닌 24 시간입니다.
bucket_limit <n> N - 반환 할 포인트 수입니다. 둘 중 하나를 사용하십시오 bucket_duration or bucket_limit하지만 둘다는 아닙니다.

응답

{
"<metric1>": {
"data": [
  {
    "dimensions": {
        "account": "<account>",
        "<dim1>": "<key1>",
        ...
        "<dimN>": "<keyN>"
      },
    "points": [
      {
        "timestamp": <bucket1>,
        "value": <value1>
      },
      ...,
      {
        "timestamp": <bucketN>,
        "value": <valueN>
      },
    ]
  }
]
},
"<metric2>": {
...
},
...
}

이벤트

그리고, /v1/events 끝점은 전체 또는 일부에 대한 총계를 반환합니다. Live 비디오 스트림.

이와 관련하여 고유 측정 항목 (ccu, fingerprint_count)는 총 가치 검색어 범위에 예를 들어 from/to 매개 변수는 총 개수를 반환합니다. 유일한 전체 스트림에 대한 세션 (ccu) 및 / 또는 장치 (fingerprint_count)

URI

/v1/events/accounts/$account

추가 매개 변수

없음

응답

{
"data": [
{
  "dimensions": {
    "account": "<account>",
    "<dim1>": "<key1>",
    ...
    "<dimN>": "<keyN>"
  },
  "totals": {
    "<metric1>": <value1>,
    ...
    "<metricN>": <valueN>
  }
}
]
}

수출

이벤트 엔드 포인트는 또한 다운로드 가능한 보고서를 제공합니다.

/v1/events/accounts/$account/videos/$video/export?format=xlsx

응답은 XLSX ~와 함께 파일 Live 4 매의 측정 항목 :

  • 개요
  • 동시 사용자
  • 장치 유형별 조회
  • 지리 별 조회수

사용 예

이 모든 예에서 우리는 1234 계정, 동영상 5555, 현재 시간을 가정 오후 12:00:00 UTC on 15 년 2020 월 XNUMX 일.


현재 뷰어 수 (CCU)를 가져옵니다. Live 스트림 또는 채널

세트 최소 2 분 전 (오전 11시 58 분)까지 포인트 응답.

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581767880000


의 CCU 그래프 포인트 얻기 Live 지난 24 시간 동안 스트리밍

확대 (1 분 포인트)

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581681600000&bucket_duration=1m

축소 (1 시간 포인트)

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581681600000&bucket_duration=1h


하루 최대 CCU 받기 Live 지난 7 일 동안의 채널

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581206400000&bucket_duration=1d


동안 언제든지 최대 CCU를 얻을 Live 흐름

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&bucket_limit=1


여러 번 본 총 고유 뷰어 및 초 가져 오기 Live 스트림

비디오 5555가 완료되었습니다. 숫자는 최종입니다. 비디오 5556은 여전히 ​​활성화되어 있습니다. 숫자는 누계입니다.

/v1/events/accounts/1234?dimensions=video&metrics=fingerprint_count,video_seconds_viewed&where=video==5555,5556


한 시간 동안 진행되는 프로그램의 시청률 및 광고 총계를 Live 채널<

프로그램은 오전 10 시부 터 오전 00시 (UTC)까지 방영되었습니다.

/v1/events/accounts/1234?dimensions=video&metrics=alive_ss_ad_start,video_view,fingerprint_count&where=video==5555&from=1581760800000&to=1581764399999


기간 동안 국가 별 시청률 확보 Live 흐름

/v1/events/accounts/1234?dimensions=video,country&metrics=video_view,fingerprint_count&where=video==5555


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