지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    분석 API: 라이브 지표

    이 항목에서는 라이브 스트림에 사용할 수 있는 분석 메트릭에 대해 설명합니다.

    서문

    에서 제공하는 라이브 스트림에 대한 재생 메트릭 Brightcove 라이브실시간으로 서비스를 이용하실 수 있습니다. 분석 API . 이 데이터는라이브 스트림뿐; VOD 재생은 포함되어 있지 않습니다.

    API는 2 개의 엔드 포인트를 통해 라이브 스트림 메트릭을 제공합니다.

    • /v1/timeseries
    • /v1/events

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

    메트릭

    라이브 엔드 포인트를 통해 사용할 수있는 메트릭입니다. 쿼리는 여러 메트릭을 요청할 수 있습니다.

    미터법 설명
    alive_ss_ad_start 서버 측 광고 노출
    ccu 독특한세션 ; 구별 ( 지문 + 세션 )
    fingerprint_count 독특한장치 ; 구별 수지문 (아래 참조)
    video_impression 동영상이 플레이어에로드 된 횟수
    video_seconds_viewed 모든 시청자가 본 총 시간
    video_view 스트림 시작 (고유하지 않음)

    에 대한독특한추적, 우리는지문 ( Remote IP + User-Agent + Player ). 우리는 장치 자체의 실제 하드웨어 ID를 사용하지 않습니다. 이것은 정확도를 떨어 뜨리지 만 우리가 개인 정보를 준수하도록합니다.

    해상도 및 비트레이트

    다음 조합이 지원됩니다. dimensionswhere필터 키 :

    • video
    • video, country
    • video, device_type

    쿼리 매개 변수

    두 라이브 엔드 포인트는 쿼리의 범위와 그룹화를 제어하는 몇 가지 공통 매개 변수를 공유합니다.

    매개 변수 구문 필수 기본값 설명
    치수 <dim1>,<dim2>,... - 쿼리 차원 (GROUP BY)
    메트릭 <metric1>,<metric2>,... - 보고 할 하나 이상의 메트릭
    여기서 <dim1>=<value1>;... - 하나 이상의 쿼리 필터. 동영상을 1 개 이상 포함해야합니다.
    ...에서 <epoch> 아니요 '종료'값에서 32 일 시간 범위 시작
    변경 후: <epoch> 아니요 지금 시간 범위 종료

    시계열

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

    이 맥락에서 고유 메트릭 ( ccu , fingerprint_count ) 표시최대 값각 버킷 중 언제든지. 그래서 쿼리bucket_duration=1d쿼리는 매일 최대 동시성을 반환합니다. bucket_limit=1스트림의 모든 지점에서 최대 동시성을 반환합니다.

    우리

    /v1/timeseries/accounts/$account

    추가 매개변수

    매개 변수 구문 필수 기본값 설명
    bucket_duration <n>m  (의사록)
    <n>h (시간)
    <n>d (일)
    아니요 1 분 각 포인트로 표시되는 기간. 1d달력 일이 아니라 24 시간입니다.
    bucket_limit <n> 아니요 - 반환 할 포인트 수입니다. 사용bucket_duration또는bucket_limit하지만 둘 다 함께는 아닙니다.

    대응

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

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

    그만큼/v1/events끝점은 라이브 비디오 스트림의 전체 또는 일부에 대한 메트릭 합계를 반환합니다.

    이 맥락에서 고유 메트릭 ( ccu , fingerprint_count )는총 가치쿼리 범위를 초과합니다. 예를 들어from / to매개 변수는 총 개수를 반환합니다. 독특한전체 스트림에 대한 세션 (ccu) 및 / 또는 장치 (fingerprint_count).

    우리

    /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 4 개의 시트에 라이브 메트릭이있는 파일 :

    • 요약
    • 동시 사용자
    • 장치 유형별보기
    • 지역별 조회수

    사용 예

    이 모든 예에서 우리는계정 1234 , 비디오 5555 , 현재 시간을 가정합니다. 12:00:00 PM UTC의 위에 2020 년 2 월 15 일 .


    라이브 스트림 또는 채널에 대한 현재 뷰어 수 (CCU) 가져 오기

    세트 ...에서최소 2 분 전 (11:58 AM)까지, 마지막포인트응답에서.

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


    지난 24 시간 동안 라이브 스트림에 대한 CCU 그래프 포인트 얻기

    확대 (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


    지난 7 일 동안 라이브 채널에 대한 일일 최대 CCU 받기

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


    라이브 스트림 중 언제든지 최대 CCU를 받으세요

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


    여러 라이브 스트림에 대해 총 고유 시청자 수 및 조회 시간 (초) 얻기

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

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


    라이브 채널에서 1 시간 길이의 프로그램에 대한 시청률 및 광고 합계를 얻으십시오 <

    오전 10 시부 터 오전 11시 (UTC)까지 방송 된 프로그램

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


    라이브 스트림 기간 동안 국가 별 시청률 얻기

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