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

    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를 사용하지 않으므로 정확도는 떨어지지 만 개인 정보를 준수합니다.

    Dimensions

    다음과 같은 조합이 지원됩니다 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 일에 마지막으로 업데이트 된 페이지